Rewrite _index.md as explanation-only — remove inline Quick Start, add Learn More links. Move section discovery explanation from features/sections.md into content-organization.md. Slim sections.md to reference-only with cross-reference.
1.3 KiB
1.3 KiB
title, description, weight
| title | description | weight |
|---|---|---|
| Sections | Section types, frontmatter, and template dispatch reference | 2 |
sukr discovers sections from your content directory structure. For an explanation of how sections work and how directories map to site structure, see Content Organization.
Section Types
The section type determines which template is used. It resolves in order:
- Frontmatter override:
section_type: blogin_index.md - Directory name:
content/blog/→ typeblog
Built-in Section Types
| Type | Behavior |
|---|---|
blog |
Sorts by date (newest first), renders individual posts |
projects |
Sorts by weight, card-style listing |
| (other) | Sorts by weight, uses default template |
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
- Create directory:
content/recipes/ - Create index:
content/recipes/_index.md - Add content:
content/recipes/pasta.md - Optionally create template:
templates/section/recipes.html
That's it. sukr handles the rest.