A Hugo module to add Font Awesome icons to your Hinode site
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.
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. |
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.
This module uses semantic-release to automate the release of new versions. The package uses husky and commitlint to ensure commit messages adhere to the Conventional Commits specification. You can run npx git-cz from the terminal to help prepare the commit message.