Skip to content

Latest commit

 

History

History
38 lines (29 loc) · 2.1 KB

index.md

File metadata and controls

38 lines (29 loc) · 2.1 KB
layout title nav_title head_title subtitle weight
page-hero
jekyll-theme-tufte
About
jekyll-theme-tufte
A modern Jekyll theme based on tufte-css
1

jekyll-theme-tufte is a Jekyll theme that implements the design ideas of Edward Tufte. It is enabled by tufte-css, a CSS file providing the Tufte-inspired styles.

This is a gem-packaged theme that can be easily installed by including jekyll-theme-tufte in your Gemfile.

Large portions of the theme are derived from prior work to bring tufte-css to Jekyll, including:

  • tufte-css-jekyll, a classic-style Jekyll theme {% sidenote 'origins' "This theme started out as a gem repackaging of tufte-css-jekyll, but then I decided to clean up the layout" %}
  • tufte-jekyll, a classic-style theme with a lot of extra visual stuff added
  • tufte-pandoc-jekyll, a gem-style theme that uses pandoc under the hood
  • ET-Jekyll, a classic-style theme that makes a number of CSS changes

This theme is minimalist and tries to stick closely to the original tufte-css styles. As a gem-based theme, it is also easier to install and manage compared to classic style themes. (Classic Jekyll themes are installed by mixing all the files in with your site's files, which creates a big mess.)

Edward Tufte's style is known for extensive use of sidenotes, which tufte-css displays next to a half-width layout. {% sidenote "layouts" 'See Layouts for more layout options.' %}

To read more about the Tufte style and its usage, have a look at the Tufte CSS demo page.

This theme is responsive and adapts to desktop and mobile screens. (Margin notes are displayed inline on narrow screens.) It also supports dark mode detection via prefers-color-scheme, looking good on dark and light backgrounds alike.

An Atom RSS feed is provided at [/feed.xml]({{ site.baseurl }}/feed.xml).