SectionConfig

docblock

Configuration for a navbar section (supports multiple dropdowns).

Each section can have its own directory of .qmd files that appear as a dropdown in the navbar and as a sidebar when browsing that section.

Fields

• title::String: Display title in navbar (required)
• dir::String: Directory containing .qmd files for this section
• desc::String: Description for the section index page
• dropdown::Bool: Whether to show as dropdown menu (default: true)
• dropdown_limit::Int: Max items before falling back to index link (default: 15)
• index_file::String: Name of index file (default: “{dir}.qmd” in docs/)
• sidebar::Bool: Whether to show sidebar when in this section (default: true)
• order::Int: Order in navbar (lower = more left, default: 100)

Example

sections = [
    SectionConfig(title="Tutorials", dir="tutorials", order=1),
    SectionConfig(title="Explanation", dir="explanation", order=2),
    SectionConfig(title="How-to Guides", dir="how-to", order=3, dropdown_limit=20)
]