Structure your site for different content types, audiences, or topics using Zorto’s section system.

Multiple content sections #

A typical site might have:

📂content/
├── 📝_index.mdsection: homepage
├── 📂posts/
    ├── 📝_index.mdsection: blog
├── 📂docs/
    ├── 📝_index.mdsection: documentation
├── 📂projects/
    ├── 📝_index.mdsection: portfolio
├── 📝about.mdpage

Each section is independent — its own sort order, pagination, and template.

Section-specific templates #

Assign templates per section:

# content/docs/_index.md
+++
title = "Documentation"
template = "docs-section.html"
+++

Pages within the section can also use a custom template:

# content/docs/getting-started.md
+++
title = "Getting started"
template = "docs-page.html"
+++

Nested sections #

Sections can nest:

📂content/docs/
├── 📝_index.mdsection
├── 📂getting-started/
    ├── 📝_index.mdsection
    ├── 📝installation.mdpage
├── 📂reference/
    ├── 📝_index.mdsection
    ├── 📝cli.mdpage

Access subsections in templates via section.subsections.

External content directories #

Pull content from outside the content/ directory:

# config.toml
[[content_dirs]]
path = "../docs"
url_prefix = "docs"
template = "docs.html"
section_template = "docs-section.html"
sort_by = "title"
rewrite_links = true

This is useful for documentation that lives alongside source code in a separate directory or repository.