Typeset

Typeset 0.1.0

2 min read

Typeset is a Zola theme inspired by the clean, professional aesthetics of LaTeX and Typst documents. This initial release brings together the essential features for academic and technical writing on the web.

Design Philosophy

The theme prioritizes readability and content-first design. Drawing from Edward Tufte's principles of information design, Typeset uses wide margins for supplementary content, careful typography choices, and minimal visual noise.

Core Features

Academic Typography

Typeset uses Crimson Pro for body text and EB Garamond for headings, providing a scholarly appearance while maintaining excellent readability on screens. The typography system follows a modular scale for consistent visual hierarchy.

Tufte-Style Sidenotes

One of the signature features is support for sidenotes and margin notes. Like this one! Sidenotes keep supplementary information visible without interrupting the main flow of text. These allow you to include citations, clarifications, and tangential thoughts without cluttering your prose.

Mathematical Typography

Full KaTeX support enables beautiful mathematical equations. Enable it globally or per-page:

When $a \ne 0$, the solutions to $ax^2 + bx + c = 0$ are:

$$x = \frac{-b \pm \sqrt{b^2-4ac}}{2a}$$

Syntax Highlighting

Code blocks feature Catppuccin color schemes with automatic light/dark mode support:

fn fibonacci(n: u32) -> u32 {
    match n {
        0 => 0,
        1 => 1,
        _ => fibonacci(n - 1) + fibonacci(n - 2),
    }
}

Dark Mode

A toggle in the header switches between light and dark themes, with your preference saved across sessions. The theme also respects system preferences by default.

Table of Contents

Long-form content benefits from an automatically generated table of contents in the left sidebar, with scroll tracking to highlight the current section.

Shortcodes

Typeset includes several shortcodes for interactive content:

  • Spoilers - Collapsible sections for hidden content
  • Slideshows - Image galleries with navigation
  • Sidenotes - Numbered margin notes
  • Margin notes - Unnumbered margin content

Blog Features

The blog layout groups posts by year, supports tags and categories, and includes RSS feeds. Each post shows reading time estimates and maintains clean, scannable listings.

Getting Started

Install Typeset by cloning it into your Zola themes directory:

git clone https://github.com/rutrum/typeset themes/typeset

Then set theme = "typeset" in your config.toml and you're ready to write.

This release establishes the foundation for Typeset. Future updates will expand functionality while maintaining the theme's commitment to clean, readable design.