hledger/tools
Simon Michael e1c9e51775 tools: new build system for man/web docs
Goal:

Generate man pages and web docs from one source.

Current plan:

The master docs for each package are now the pandoc-style
manpage-markdown files in the package directories -
hledger/hledger.1.md, hledger-lib/hledger_journal.5.md, etc.

Parts of these will be marked as web-only, and parts as man-only, using
divs recognisable by custom pandoc filters.

When generating man pages we strip the web-only parts, and all html
blocks, inline html and hyperlinks.

When generating web docs we strip the man-only parts and apply any other
tweaks needed for easy presentation, perhaps combining them into a
single web page similar to the old user manual.

Shake:

This was hard to do with GNU Make, and so I've introduced Shake, which
is working very well. Both coexist for now but it's probably time to
switch.
2016-02-21 02:21:41 -08:00
..
.gitignore tools: new build system for man/web docs 2016-02-21 02:21:41 -08:00
criterionbench.hs tools: make tools/* executable 2014-05-01 08:14:04 -07:00
dayssincetag.hs tools: make tools/* executable 2014-05-01 08:14:04 -07:00
doctest.hs tools: make tools/* executable 2014-05-01 08:14:04 -07:00
generatejournal.hs tools: add sample journals with wide characters 2015-10-10 11:51:07 -07:00
generatetimelog.hs tools: generatetimelog 2015-07-12 12:32:53 -07:00
listbydeps.hs strip trailing whitespace from all Haskell files 2014-10-14 18:48:24 -07:00
pandocCapitalizeHeaders.hs tools: pandoc filters used when making man pages 2015-10-26 06:56:33 -07:00
pandocRemoveHtmlBlocks.hs tools: new build system for man/web docs 2016-02-21 02:21:41 -08:00
pandocRemoveHtmlInlines.hs tools: new build system for man/web docs 2016-02-21 02:21:41 -08:00
pandocRemoveLinks.hs tools: pandoc filters used when making man pages 2015-10-26 06:56:33 -07:00
pandocRemoveManonlyBlocks.hs tools: new build system for man/web docs 2016-02-21 02:21:41 -08:00
pandocRemoveNotes.hs tools: pandoc filters used when making man pages 2015-10-26 06:56:33 -07:00
pandocRemoveWebonlyBlocks.hs tools: new build system for man/web docs 2016-02-21 02:21:41 -08:00
progressionbench.hs tools: make tools/* executable 2014-05-01 08:14:04 -07:00
regressiontest.py tools: make tools/* executable 2014-05-01 08:14:04 -07:00
runhledgercov tools: update profiling rules 2015-07-22 08:52:30 -07:00
simplebench.hs tools: fix warnings in simplebench 2014-10-19 09:34:46 -07:00
simplifyprof.hs strip trailing whitespace from all Haskell files 2014-10-14 18:48:24 -07:00
trhsx tools: make tools/* executable 2014-05-01 08:14:04 -07:00
unittest.hs tools: make tools/* executable 2014-05-01 08:14:04 -07:00