3 ms·
I have tried various solutions including Jekyll, some Haskell scripts, and a home made POSIX shell tool built on make, m4, awk etc. What has worked best so far
by kqr 9y ago
I have tried various solutions including Jekyll, some Haskell scripts, and a home made POSIX shell tool built on make, m4, awk etc.
What has worked best so far is Org publishing. The reasons I prefer it are primarily that
1. The Org file format is olain text, easily edited on the phone and generally great.
2. I can embed source code in many different languages and have it execute during publishing and embed its results in the document. This can be used both for a "Python notebook" style document, and to programmatically generate things like markup!
3. I can write a single coherent document and then slice it different ways to publish one technical manual as PDF, one summary blog post, and some slides with key points -- all from the same source material.
4. The publishing process is very hackable, so customizations are easy.
(Of course, you don't have to use Emacs as your editor, you can just create a git hook or alias to run Org publish in shell script mode.)