Single page with icon

Description#


A content section or page can be identified using an icon from the FontAwesome library in order to ease navigation.

Two possible parametrization (with the several FontAwesome classes for each parameter value):

  • standard parametrization using the default theme configuration
  • per-page parametrization using the titleIcon variable in front matter

Standard parametrization#


themeParams.toml
...
[sidebar]
  # FontAwesome classes associated with the default icon of the home page
  homeSectionIconDefault = "fa-solid fa-house-chimney"
  # FontAwesome classes associated with the default icon of the first level sections/pages
  firstSectionIconDefault = "fa-solid fa-ban"
  # FontAwesome classes associated with the default icon for 1+ level sections/pages
  nestedSectionIconDefault = "fa-solid fa-turn-up fa-rotate-90 fa-xs"
...

Per-page parametrization#


  • example of the current page:
    page.md
    ---
    titleIcon: "fa-solid fa-icons"
    ---