colophon docs
← colophon docs

colophon documentation

End-user guides for authoring, theming and publishing a colophon site.

End-user guides for authoring, theming and publishing a colophon site.

  • Authoring content — frontmatter, supported Markdown, the rich blocks (maths, diagrams, callouts, code) and how they render, wikilinks, embeds and images.

  • Themes — selecting a theme, per-environment theme overrides, writing or overriding a theme, the template variables, and progressive enhancement.

  • SEO & social — the seo: frontmatter block and the canonical / Open Graph / Twitter / JSON-LD metadata colophon emits.

  • Image & audio generation — gen: image prompts, AI or recorded post audio (podcast feeds), providers, the --generate-ai step, the kill switch, and pruning.

  • Authors & personas — the author (the shown byline + h-card) vs the persona (a hidden, shareable writing voice), and the persona context command that emits write-as context (style guide + relevant exemplars) for an AI author.

  • Publishing — environments vs publishers, credentials, and routing assets to an object store.

  • Syndication (POSSE) — cross-post to Mastodon/Bluesky/anywhere with colophon syndicate: the ledger, gating, and the command/mastodon/bluesky/bridgy drivers.

  • Agent skills (design) — the planned authoring skills (seo, draft, tag, social…) and the prompt packs that drive them.

  • How-to guides — short zero-to-published recipes: federate via Bridgy Fed, show webmentions, syndicate to Mastodon/Bluesky. Each notes whether it's shipped or planned.

  • Changelog — user-facing changes per release, each pointing at the guide that documents it in full.

Design notes and the roadmap live in PLAN.md and design/.

Generated from docs/README.md — edit it there.