Tufte Hugo
tufte.hugo is a theme for the Hugo static site generator that renders your Markdown into exactly the markup Tufte CSS expects: articles split into sections, sidenotes and margin notes,Footnotes written with the usual [^1] syntax become sidenotes automatically. margin and full-width figures, epigraphs, and the ET Book typeface.
Start with the port of the Tufte CSS demo page, then read the theme guide to set up your own site.
Tufte CSS
Dave Liepmann
Tufte CSS provides tools to style web articles using the ideas demonstrated by Edward Tufte’s books and handouts. Tufte’s style is known for its simplicity, extensive use of sidenotes, tight integration of graphics with text, and carefully chosen typography.
Tufte CSS was created by Dave Liepmann and is now an Edward Tufte project. The original idea was cribbed from Tufte-LaTeX and R Markdown’s Tufte Handout format. We give hearty thanks to all the people who have contributed to those projects.
From LaTeX to Hugo
Every feature of tufte-handout and tufte-book, in Markdown
This page maps every feature of the tufte-handout and tufte-book LaTeX
classes to the Markdown, shortcode or setting that does the same with this
theme, and then shows each shortcode at work. The two ports of the
Tufte-LaTeX samples, the handout and the
book, show them in context.
The table is in “The cheat sheet”, and the live examples start with “Notes”.
Theme Guide
Installing, configuring and writing for tufte.hugo
Above all else show the data.
This guide walks through everything needed to publish a site with tufte.hugo: installing the theme, the settings it reads, the front matter it understands, and the shortcodes that produce Tufte’s layouts. The README of the theme is the complete reference; this page is the tour.
The theme needs the latest Hugo release (0.169.0 or later); the standard edition is enough, since the theme ships plain CSS and needs neither Sass nor JavaScript tooling.
Figures and Tables
Main-column, margin and full-width graphics; tables that keep to the grid
Graphics belong next to the words that discuss them. Tufte CSS knows three places to put them: the main text column, the margin, and the full width of the page. tufte.hugo gives each one a shortcode, and handles plain Markdown images too.
A Markdown image on a line of its own becomes a figure. Its title, the quoted text after the path, becomes the caption, shown as a margin note beside the image:
An Example of the Usage of the Tufte-Handout Style
The Tufte-LaTeX document classes define a style similar to the
style Edward Tufte uses in his books and handouts. Tufte’s style is known
for its extensive use of sidenotes, tight integration of graphics with
text, and well-set typography. This document aims to be at once a
demonstration of the features of the Tufte-LaTeX document classes
and a style guide to their use.This page is a port of sample-handout.tex from the Tufte-LaTeX project. Every LaTeX construct is replaced by its Markdown or shortcode equivalent; the LaTeX to Hugo cheat sheet lists them all.