How to Configure Nav Listing in Hugo

Bissetii in Hugo module supplies page index listing inside each directories. Depending on available compatible components, it allows one to change from one style to another. This section guides you on how to switch them easily.

This feature is available starting from version v1.13.0.

Default Configurations File

The default configuration is located inside the data file with the following file pathing:

pathing in Bissetii:        data/bissetii/defaults.toml
your repo-docs     :  docs/.data/bissetii/defaults.toml

If you do not have such data file, create on in your repo-docs data directory.

Configurations

Inside the configuration file, you’re particularly interested with the following settings (and if they are missing, add them into your own defaults.toml configuration file):

1
2
3
4
5
6
7
8
9
...

# default nav list for index pages
[nav]
Type = "nav-toc" # either 'nav-catalog' or ' nav-toc'

[nav.catalog.card]
Width = "320px"
Height = "500px"

Available Nav.Type

Depending on development, the available nav listing types are as follows:

  1. nav-toc - list like table of content styling. See Nav - TOC Component.
  2. nav-catalog - list like catalog styling. Nav - Catalog Component.

By default, Bissetii selects nav-catalog type.

Epilogue

That’s all for configuring nav listing in Hugo. Should you have any question, please feel free to raise your queries in our Issues Section.