Site Layout Components

Named component definitions for reuse

Define components once and reference them by name in regions. When the key matches a built-in component type (e.g., "nav-tree"), the type field can be omitted.

Example:

# Type inferred from key for built-in types:
[site.layout.components.nav-tree]
collapsible = true
depth = 3

# Custom names require explicit type:
[site.layout.components.main-nav]
type = "nav-tree"
collapsible = true

Available Types

Type	Description
`logo`	Site logo image with responsive and dark mode variants
`title`	Site title text
`breadcrumbs`	Breadcrumb navigation trail
`nav-tree`	Hierarchical navigation tree
`nav-menu`	Top-level navigation menu bar
`nav-groups`	Footer-style grouped navigation
`toc-tree`	Table of contents tree from document headings
`prev-next`	Previous/next page navigation links
`color-mode`	Light/dark mode toggle
`copyright`	Copyright notice with auto-updating year
`social-links`	Social/external links (GitHub, Discord, LinkedIn, etc.)
`edit-source`	Edit source link for GitHub/GitLab/Bitbucket
`edit-on`	Edit on cloud service (Google Docs or Microsoft 365)
`copy-markdown`	Copy page as Markdown button
`site-search`	Site search

This documentation was generated from layout/components.rs by generate.rs.