cleberg.net.git/content/templates, branch main

update links

2026-08-12T03:01:41+00:00

Finish the move off weblorg

2026-08-12T01:35:15+00:00

Remove what the migration left behind, then cut build.py down to the work orgo does not do: 443 lines to 168. - Delete publish.el and theme/templates/, superseded by content/orgo.toml and content/templates/. theme/static/ stays; orgo publishes it as assets. - Drop the tag builder, the org-source copy, and the helpers that only fed them. orgo generates /tags/ and a page per tag from a collection. - Rewrite the README and the migration-era comments that explained the config by pointing at what weblorg used to do. - Serve styles.css as authored. Minifying 1KB of CSS saved 52 bytes over the wire once compressed, which did not pay for a build step and a toolchain dependency. - Stop wiping the output directory. The .orgo-cache.json inside it is what makes a build incremental, and orgo already prunes outputs whose source is gone and re-emits any that are missing. Production keeps .build/ and development gets .build-dev/, because production rewrites image URLs in the output and a shared directory would let one environment reuse pages rendered for the other. An incremental build is byte-identical to a clean one, and the site output is unchanged apart from the /uses/ stack row.

org-ssg is called orgo now

2026-08-12T01:35:15+00:00

The config file follows the tool: content/org-ssg.toml is content/orgo.toml, and the build cache it writes is .orgo-cache.json. Nothing about the site changes — 196 pages, same output.

Make the reply footer a snippet, not a rule

2026-08-12T01:35:15+00:00

Routing garden notes and /now/ through post.html put the invitation to reply on them because a directory said so, which is the wrong thing to be automatic — it is a choice about each page, and I had made it site-wide to chase parity with the live site. Those two rules are gone; blog posts keep it. The wording now lives in templates/reply.html rather than inside post.html, so it can be edited or emptied without touching how a post is built, and editing it re-renders the 170 pages that include it and nothing else. Any page opts in for itself with `#+TEMPLATE: post.html`; any post opts out with `#+TEMPLATE: base.html`.

Settle the four remaining differences from the live site

2026-08-12T01:35:15+00:00

- **The feed carries whole posts again.** `include_content = true` on the feed collection, and the template embeds `post.content` rather than the excerpt. 169 items, 2.9 MB, same as weblorg produces. - **Section numbering on.** The live site numbers its headings — inherited from Emacs' default rather than chosen, but switching generators is the wrong moment to quietly redesign 174 pages. The contents list numbers to match. One config line to flip if you decide against it. - **The reply footer follows the live site**: blog posts, garden notes and /now/, but not /uses/, /tips/ or /salary/. Two more `[[pages]]` rules. - **Tags stay one page per tag**, deliberately unlike the live single page with every post inlined under an anchor. A tag with its own URL is worth linking to, and the index stays short. Each index entry carries the tag's slug as an `id`, so old `/tags/#audit` links still land on the right row. Also fixes the garden emoji, which I had transcribed as 🌳 where the weblorg template has 🪴 — taken from that template this time rather than typed. Content now matches the live site on 192 of 195 pages. The three that differ: footnote section markup, an `org-cite` citation neither generator renders usefully, and the tags page above.

Publish theme/static directly instead of copying it into content

2026-08-12T01:35:15+00:00

org-ssg can read asset directories outside its source now, so the four files copied in — gpg.txt, robots.txt, salary.csv and styles.css — go back to having one home. `[build] assets = ["../theme/static"]` publishes that directory at /, which is where weblorg serves it from too. That also removes the note asking whoever comes next to keep two stylesheets identical, and picks up styles.min.css as a side effect.

Render the table of contents, and group /blog/ by year

2026-08-12T01:35:15+00:00

Two of the differences the page-by-page diff against the live site turned up. The TOC was the larger one: live has one on 171 pages and the org-ssg build had none. `[html] toc = true` only *exposes* `page.toc` — rendering it is the layout's job, and base.html never did. It now emits the same `div#table-of-contents` Emacs does, from a recursive macro over the tree. The anchors already matched, so every link lands where the live one does. Pages that say `#+OPTIONS: toc:nil` get an empty tree and render nothing, which is why /uses/, /now/ and /salary/ have no TOC here either — the same three as live. /blog/ now breaks its list under year headings, as the live index does, using `page.year` and minijinja's groupby. `group_by_year` at the top of blog.html turns it off for one flat list. After both, /blog/ matches the live page's content exactly, and 171 of 171 TOCs are accounted for.

Use a straight apostrophe on the home page

2026-08-12T01:35:15+00:00

Transcribing theme/templates/index.html into home.html turned "I've" into "I’ve", so the org-ssg build rendered a curly apostrophe where the live page has an ASCII one — the only character that differed between them.

Route blog posts through post.html

2026-08-12T01:35:15+00:00

The reply-by-email and Bubbles lines were emitted from base.html behind a test on the page's URL, because org-ssg had no way for a page to pick a layout. It does now, so they live in a post.html that extends the shared one — the same split weblorg has between theme/templates/base.html and post.html — selected by a [[pages]] rule for blog/. All 169 posts carry the footer; /blog/ itself does not, being a generated listing rather than a post.

Bring the org-ssg templates to parity with the live site

2026-08-12T01:35:15+00:00

The org-ssg build rendered the right content in the wrong chrome. Closing every difference found by comparing it against theme/templates/ and the live pages: - base.html: Home link written by the layout rather than the site title, a of "Page - cleberg.net" (bare "cleberg.net" on the home page, via a subtitle block), author/description/og meta, the RSS alternate link, four rel="me" identity links, favicon, skip link, <main id="main-content">, aria-label on the nav, and the real footer. - home.html: the h1 is "Christian Cleberg" (the collection's title), and the email line has its GPG link back. - blog.html and garden.html: the two listings carry their own prose on the live site — the search/RSS hint, and the garden's growth stages — so they are no longer sharing the generic list.html. Tag pages still use it. - tags.html: "Browse posts by topic." - Blog posts get the reply-by-email and Bubbles lines. org-ssg has no per-page template selection, so the layout keys off the page's URL prefix. - Tags leaves the nav, which the live site does not have. feed.xml is new: the footer links /feed.xml and nothing was generating it. It is a collection whose template happens to be XML. Its <description> carries each post's excerpt rather than the full rendered body, which weblorg's feed does include — a collection template gets each entry's metadata, not its HTML. base_url is now set, since canonical links and a feed cannot be relative. Page links stay relative, so a preview build still works from any directory. gpg.txt, robots.txt and salary.csv are copied in from theme/static/: weblorg publishes that directory to the site root, and org-ssg publishes from content/, so /gpg.txt was a 404. styles.min.css is deliberately not copied — it is gitignored build output, and the tracked styles.css holds the same rules. </article> </main></body></html>