About This Site

What this site is made with, whose design it follows, and where its source lives.

Alok Singh·412 words

This is a static site. A single Lean program reads the essays, checks them, and writes every page you can visit here. This page lists what that program is made of and whose work it stands on. The design essay explains how the parts fit together and why.

Design

The reading experience follows gwern.net: the table of contents beside the text, notes in the margin, previews when you hover over a link, backlinks, and the typography. Gwern Branwen and Said Achmiz designed those. This site reimplements them from the reader's side; none of their code is used, and the mistakes are mine.

Where I had no opinion of my own about how a page should read, I took theirs.

Made with

  • Lean 4, version 4.36.0, is the language of the generator, of the newer essays, and of the small programs that run in your browser when you zoom an image or step through a proof.

  • Verso, at revision 6674cf83c82a, is the Lean authoring system the essays are written in. It checks the code in an essay with the same compiler that builds the site.

  • Mathematics is typeset by the generator when the site is built, as MathML, and set in STIX Two Math, © The STIX Fonts Project Authors, used under the SIL Open Font License 1.1. A device that does not have the font is sent a subset of it. MathJax is loaded only on a page that holds a formula the generator cannot typeset.

  • Source Serif 4 and Source Sans 3 are the typefaces, © Adobe, used under the SIL Open Font License 1.1.

The version and revision above are not typed into this page. They are read from the compiler and from the dependency lock file each time the site is built.

Writing

Older essays are plain Markdown files, and new ones can still be written that way: a file with a title and a date becomes a page. Essays that contain programs or proofs are written in Verso, where the compiler checks every example before the page is published. The authoring page shows both.

Source

The generator is called GwernPort. Its source is not public yet. It builds the whole site in a few seconds and has no server: what you are reading is a file.

Privacy

There are no comments, advertisements, or cookies of mine. The design essay states exactly what is measured when analytics is enabled, and how to block it.