Guides
Content structure, navigation, authors and release pages.
-
Content, layouts and overrides
How Zola content, DevLab collections and site overrides fit together.
-
Content layouts
Use generic pages and sections outside the specialized Docs, Blog and Downloads layouts.
-
Docs navigation
Select top-level documentation sections and derive their descendants from the Zola content tree.
-
Content components
Compose card grids, status timelines and Docs overview icons from reusable Markdown components.
-
Create and publish a blog
Create a section, write a post, connect tags and authors, then publish.
-
Blog authors
Define an author once, credit one or more people on a post and give every writer a page of their own.
-
Interface controls
Search shortcuts, result navigation and color modes.
-
Downloads
Publish a single product with release channels, files and verification instructions.
-
Download catalog
Offer an optional product catalog with filters and individual release pages.
-
Simple download cards
Publish release artifacts, unavailable channels and verification links.
-
Community cards
Introduce maintainers, contributors and community members wherever their work belongs.
-
Release announcements
Publish a header notice and control its saved dismissal.
-
Publishing
Set up metadata, feeds, favicon, 404 and syntax highlighting.
-
Upgrade from v0.8 to v0.9
Move retired homepage and reading settings to blocks and collections.
-
Deploy a site
Build public output, upload it to a static host and verify the live site.
Start with site architecture for the content and template model. The remaining guides describe one task at a time: add content, configure navigation, publish releases or prepare deployment. Field types and defaults belong in the reference.