From 92288eec7f1444cb9e1e5634abbebbbe54033723 Mon Sep 17 00:00:00 2001 From: Felix Crux Date: Sun, 25 Nov 2018 12:37:17 -0500 Subject: [PATCH] Document Pandoc installation on Debian stable The default version of Pandoc available on the stable ("Stretch") release of Debian is too old, so running `make` fails. A newer version is required. This change updates the docs to mention that. --- CONTRIBUTING.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index 80fe1a4..490bfab 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -43,6 +43,14 @@ For all reloading options: brew install fswatch npm caskroom/cask/livereload && \ npm install -g livereloadx +#### Debian (and derivatives) Linux + +The version of Pandoc shipped in Debian Stretch is old and lacks required +features (specifically, the "smart" extension for Markdown), so you'll need to +install it from a newer repository. For example: + + sudo apt install -t unstable pandoc + ## Making changes Once you've cloned the repository and setup the tools, make changes to whatever is necessary. **Don't change the `html` files**. The `html` is automatically generated!