Sections

sukr discovers sections from your content directory structure recursively, supporting multi-level nested site hierarchies. For an explanation of how sections work and how directories map to site structure, see Content Organization.

Section Discovery & Virtual Sections¶

During a build, sukr scans directories recursively to assemble sections:

• Explicit Sections: Defined by creating an _index.md file in a directory. This file holds the section's frontmatter configuration and description.
• Virtual Sections: If a subdirectory contains Markdown files but does not contain an _index.md file, sukr automatically generates a virtual section for it. This virtual section uses default frontmatter settings and derives its title from the directory name.

Section Types¶

The section type determines which template is used. It resolves in order:

1. Frontmatter override: section_type = "blog" in _index.md
2. Directory name: content/blog/ → type blog

Built-in Section Types¶

Section Frontmatter¶

In _index.md:

+++
title = "My Blog"
description = "Thoughts and tutorials"
section_type = "blog"  # Optional, defaults to directory name
weight = 1             # Nav order
+++

Adding a New Section¶

1. Create directory: content/recipes/
2. Create index: content/recipes/_index.md
3. Add content: content/recipes/pasta.md
4. Optionally create template: templates/section/recipes.html

If no section/recipes.html template exists, sukr falls back to section/default.html. A custom template is only needed when you want a different layout for that section.