Awesome Asciidoc: Changing the FontAwesome CSS Location
To use font icons from FontAwesome we set the document attribute icons with the value font. The default link to the CSS location is https://cdnjs.cloudflare.com/ajax/libs/font-awesome/4.1.0/css/font-awesome.min.css. We can change the location for the FontAwesome CSS with document attributes.
If we want to use a different CDN to serve the CSS we can set the document attribute iconfont-cdn and set the URI as a value:
:icons: font
// Set new URI for reference to FontAwesome CSS
:iconfont-cdn: //maxcdn.bootstrapcdn.com/font-awesome/4.1.0/css/font-awesome.min.css
== Sample doc
To reference the FontAwesome CSS from a relative location from our generated HTML page we can first unset the attribute `iconfont-remote` and set the attribute `iconfont-name`:
:icons: font
// First unset attribute to remotely link FontAwesome CSS
:iconfont-remote!:
// Specify name of FontAwesome CSS.
:iconfont-name: fontawesome-4.1.0
// We can optionally set the directory where CSS is stored.
:stylesdir: css
== Sample doc
In the generated HTML source we see the following `link` element:
...
...
Written with Asciidoctor 1.5.0.
