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.

Read more →

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”.

Read more →

Theme Guide

Installing, configuring and writing for tufte.hugo

Above all else show the data.

Edward Tufte, The Visual Display of Quantitative Information

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.

Read more →

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:

Read more →

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.

Read more →