Journal

Welcome to the Journal

What this journal is for, and how its articles are put together.

This is a home for long-form writing: notes, experiments and essays that need more room than a commit message and more care than a chat thread.

How articles are published

Every article lives in the repository under apps/journal/articles/, filed by year and month. A push to master builds every article that isn't a draft and publishes the result to Cloudflare Pages. Drafts — anything with .draft in its name — stay in the repository and never reach the site.

What an article can be

An article can be written in Markdown or HTML. Markdown is turned into HTML when the site is built, with support for maths like eiπ+1=0e^{i\pi} + 1 = 0, footnotes,1 highlighted code and figures. An article that needs its own images, figures or scripts gets a folder of its own.

Footnotes

  1. Like this one. ↩