@gethinode/mod-fontawesome
v1.10.0
Published
A Hugo module to add Font Awesome icons to your Hinode site
Downloads
37
Readme
Hinode Module - Font Awesome
About
Hinode is a clean blog theme for Hugo, an open-source static site generator. Hinode is available as a template, and a main theme. This repository maintains a Hugo module to add Font Awesome icons to a Hinode site. Visit the Hinode documentation site for installation instructions.
Configuration
This module supports the following parameters (see the section params.modules
in config.toml
):
| Setting | Default | Description |
|-------------------------|---------|-------------|
| fontawesome.embed | true | If set, generates a symbol map with embedded vector images. Only works in conjunction with inline
. Include the symbol with the partial assets/symbols.html
(requires the current page context).|
| fontawesome.inline | true | If set, uses inline vector images instead of web fonts. Both methods support Font Awesome styling and animation. However, when using vector images you cannot use aliases. Instead, use the default name of the icon. |
| fontawesome.debug | true | If set, prints the original code <i class="[...]" style=[...]></i>
as comments next to the inline vector image. |
| fontawesome.skipMissing | false | If set, displays a warning when an icon cannot be found. The missing icon is replaced with a dummy. By default, Hinode exits with an error when an icon is missing. |
Notes
The repository of Font Awesome has changed its pattern for semantic versioning. As a result, hugo does not pick up the latest version correctly. A workaround is to create a fork for version 6.x only and to use this as a source instead.
This repository (mod-fontawesome) has chosen a different approach, which is more in line with the other modules maintained by Hinode. It downloads the latest npm release of Font Awesome and redistributes several selected files and folders. The steps are fully automated as part of a CI/CD process.