cmc/cleberg.net

  1# orgo configuration for cleberg.net.
  2#
  3# Lives in content/ because that directory is the site's URL root: content/blog/post.org
  4# publishes at /blog/post.html. Neither this file nor templates/ is published.
  5#
  6#   orgo serve content -o /tmp/preview      # write and preview
  7#   orgo build content -o _site --strict    # build for real, failing on broken links
  8
  9[site]
 10title = "cleberg.net"
 11description = "Stillness amidst the chaos."
 12language = "en"
 13# Set, because the layout emits canonical links and /feed.xml — a feed is read away from
 14# the site that served it, so its links cannot be relative. Ordinary page-to-page links
 15# stay relative regardless, so a preview build still works from a directory.
 16base_url = "https://cleberg.net"
 17
 18[nav]
 19# Explicit, because the pages that belong in the nav are not all top-level: /blog/ and
 20# /garden/ are generated below, and salary/ is a section index one level down. index.org
 21# is deliberately absent — the layout writes the Home link itself.
 22#
 23# Generated pages are named by their output path, authored ones by their source. Listing
 24# them together is what puts Salary last: a collection with `nav = true` that is not
 25# listed here gets appended after everything that is — which is why the tags collection
 26# below does not set `nav = true`: the live nav has no Tags entry.
 27mode = "explicit"
 28pages = ["blog/index.html", "garden/index.html", "salary/index.org"]
 29
 30[build]
 31# theme/static/ is the site's static root, published at /. orgo reads it from here
 32# rather than needing its files copied next to the writing — one copy, not two.
 33assets = ["../theme/static"]
 34
 35[templates]
 36dir = "templates"
 37
 38# Blog posts render through post.html, which adds the reply snippet. Nothing else does:
 39# the live site also invites replies on garden notes and /now/, and that is a choice
 40# rather than something a directory should decide. Any page opts in for itself with
 41# `#+TEMPLATE: post.html`, and any post opts out with `#+TEMPLATE: base.html`.
 42[[pages]]
 43match = "blog"
 44template = "post.html"
 45
 46[highlight]
 47# Two themes, because the site follows the reader's colour scheme and one theme cannot.
 48# orgo writes both into syntax.css, each behind its own prefers-color-scheme query. The
 49# block surface they sit on is styles.css' business, and it changes with the scheme too.
 50theme = "InspiredGitHub"
 51theme_dark = "base16-ocean.dark"
 52
 53[html]
 54# Level-1 org headings become <h2>, beneath the page title the layout renders as <h1> —
 55# which is what the current site does too.
 56heading_offset = 1
 57toc = true
 58# On, because the live site has numbered headings — inherited from Emacs' default rather
 59# than chosen, but changing it is a design decision to make deliberately rather than a
 60# side effect of switching generators. One line to flip when you want to.
 61section_numbers = true
 62
 63# --- Generated pages -------------------------------------------------------------
 64# These have no source .org file.
 65
 66# The home page. Generated rather than authored, because it is a hand-written
 67# introduction *plus* the most recent posts — and the post list is not something to
 68# maintain by hand. The prose lives in templates/home.html.
 69#
 70# content/index.org was deleted to make room: it held only #+title and #+description,
 71# both of which are now [site] settings above. Restore it any time with
 72# `git checkout content/index.org`, but then this collection must output somewhere else —
 73# two pages cannot claim one URL, and orgo fails the build rather than picking a winner.
 74[[collections]]
 75source = "blog"
 76output = "index.html"
 77template = "home.html"
 78title = "Christian Cleberg"
 79sort = "date"
 80order = "desc"
 81
 82[[collections]]
 83source = "blog"
 84output = "blog/index.html"
 85template = "blog.html"
 86title = "Blog"
 87sort = "date"
 88order = "desc"
 89nav = true
 90
 91[[collections]]
 92source = "garden"
 93output = "garden/index.html"
 94template = "garden.html"
 95title = "Garden"
 96sort = "date"
 97order = "desc"
 98nav = true
 99
100# One page per tag, plus the index the live site already has at /tags/. `source` is empty
101# so it groups across the whole site rather than one section, which is how #+FILETAGS: is
102# used here — tags appear on blog posts and garden notes alike.
103[[collections]]
104source = ""
105group_by = "tags"
106output = "tags/{tag}.html"
107template = "list.html"
108title = "Tagged: {tag}"
109index_output = "tags/index.html"
110index_template = "tags.html"
111index_title = "Tags"
112
113# The RSS feed. Not a separate feature — a collection whose template happens to be XML,
114# which is why /feed.xml is declared here alongside the HTML listings.
115[[collections]]
116source = "blog"
117output = "feed.xml"
118template = "feed.xml"
119title = "cleberg.net"
120sort = "date"
121order = "desc"
122# Whole posts, not excerpts. The live feed carries full content, and a subscriber handed
123# excerpts instead would notice. Costs a render of every listed post whenever the feed is
124# rebuilt, which is the trade this is worth making for.
125include_content = true