Guide

• Command reference

  Every command and flag, and what each is actually for.

  3 min read
• Configuration

  Every setting in orgo.toml, what it changes, and what it costs.

  10 min read
• Collections

  Generated pages — blog indexes, tag pages, pagination and RSS feeds.

  5 min read
• Templates

  Layouts, inheritance, every variable and filter available to a template.

  5 min read
• Org support

  Exactly which org syntax is handled, which is not, and how the rest degrades.

  7 min read
• Authoring

  URLs, drafts, excerpts, tables of contents — the metadata that shapes a page.

  3 min read
• Incremental builds

  How the cache decides what to re-render, and why that shape is the architecture.

  5 min read
• Watching and serving

  The write-save-see loop, and what the development server does and does not do.

  3 min read
• Auditing a corpus

  Find out what a tool will make of your writing before you trust it with it.

  2 min read
• Deploying

  Producing a production build, and putting it somewhere.

  4 min read
• Versioning and upgrades

  What a version number promises, what it does not, and how to upgrade safely.

  3 min read