Tufte Pandoc Jekyll

Overview:

tufte-pandoc-jekyll is a Jekyll theme that allows users to use Tufte CSS alongside pandoc-sidenote. This theme is based on Tufte CSS and Tufte Pandoc CSS, and it enables users to use Markdown with Tufte CSS. The main difference between tufte-pandoc-jekyll and tufte-jekyll is that tufte-pandoc-jekyll utilizes pandoc-sidenote, which allows users to use [^1] instead of {% sidenote %} and provides a more convenient way to use normal Pandoc markdown. If you want to see a demo of this theme, you can check out the link: https://jez.io/talks/.

Features:

• Allows users to use Tufte CSS alongside pandoc-sidenote
• Uses Markdown in combination with Tufte CSS
• Provides an alternative to using {% sidenote %} with [^1]
• External dependencies: you can install them through your package manager
• Provides variables for customization, including site.title, site.author, site.baseurl, site.header_includes, page.header_includes, site.include_after, page.include_after, site.include_before, page.include_before, page.layout
• Supports displaying math formulas with KaTeX
• Licensed under the MIT License

Installation:

To install the tufte-pandoc-jekyll theme, follow these steps:

1. Install the required external dependencies through your package manager (e.g. apt-get or brew).

2. Add the following line to your Jekyll site’s Gemfile:

   gem 'tufte-pandoc-jekyll'
   

3. Add the following lines to your Jekyll site’s _config.yml file:

   theme: tufte-pandoc-jekyll
   

4. Execute the following command:

   bundle install
   

   Alternatively, you can install it manually with:

   gem install tufte-pandoc-jekyll
   

Summary:

tufte-pandoc-jekyll is a Jekyll theme that allows users to combine Tufte CSS with pandoc-sidenote. It provides additional functionalities compared to tufte-jekyll, such as using [^1] instead of {% sidenote %}. The installation process involves installing external dependencies, adding lines to the Gemfile and _config.yml, and executing the necessary commands. This theme is customizable, supports displaying math formulas with KaTeX, and is licensed under the MIT License.