Folder Configuration¶

Section Index Pages¶

The Section Index Pages plugin allows you to turn a standard Zensical navigation section title into a clickable link that opens a specific landing document. By default, Zensical treats folder titles in your navigation sidebar strictly as collapsible headers that cannot hold content. To make a folder’s name clickable as a page, enable the navigation.indexes plugin:

[project.theme]
features = [
    "navigation.indexes",
]

nav = [
  { "Home" = "index.md" },
  { "Tutorials" = [
      { "Overview" = "tutorials/index.md" },
      { "Installing" = "tutorials/install.md" },
      { "Configuration" = "tutorials/config.md" },
    ] },
  { "Etc" = "etc.md" },
]

Auto-Expand Folders¶

The navigation.expand feature in Zensical automatically expands all nested folders and subsections in your documentation sidebar by default. Users see all pages and child items without needing to click and open each folder manually.

[project.theme]
features = [
    "navigation.expand",
]

Group Top-level categories¶

In Zensical, the navigation.sections configuration option changes how multi-level documentation structures are visualized in the sidebar by turning top-level groups into distinct, collapsible Navigation sections.

Default Behavior: Zensical clusters your folders and files into a standard, deeply nested accordion list in the sidebar.

With navigation.sections Enabled: Top-level categories are visually grouped into defined headers or sections, rather than just expanding list items, creating a more structural breakdown of large documentation spaces. See the Navigation Reference.

[project.theme]
features = [
    "navigation.sections",
]