Commit Graph

142 Commits

Author SHA1 Message Date
Simon Michael
c700a5524f tools: require pandoc 1.16 for the site
For the {width=100 height=20} image attribute syntax.
Also give it a stack.yaml of its own for now, since hledger
is stuck at lts 4.2 for hledger-api.
2016-02-22 09:09:02 -08:00
Simon Michael
671ade5062 site: simplify, clean up, refresh
- Docs are now collected on a single page
- Lots of copy updates
- The front page is less cluttered
- More whitespace at the sides
- The (still WIP) man pages are now linked
- Describe and link to plaintextaccounting.org
2016-02-21 12:39:32 -08:00
Simon Michael
848309c3f9 site: home: normal font size, remove screencast 2016-02-21 07:11:41 -08:00
Simon Michael
a1340b6515 doc: fixup for web manual 2016-02-21 02:38:58 -08:00
Simon Michael
931a1d5b9e hlint 2016-02-21 02:37:59 -08:00
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
Simon Michael
ed0ec6d849 Revert "doc: try making hledger-ui web manual from man page"
This wasn't right, leave the UI doc in the manual as it was for now.
2016-02-20 23:58:07 -08:00
Simon Michael
cc445a24a1 Merge pull request #325 from jungle-boogie/patch-1
minor copyedits
2016-02-20 17:41:21 -08:00
jungle-boogie
a2289dc196 Update step-by-step.md 2016-02-20 17:38:11 -08:00
Simon Michael
87e9421abe site: download: move vagrant, drop old screencast 2016-02-20 16:59:56 -08:00
jungle-boogie
71ce7e3a08 minor copyedits
some small edits
2016-02-20 16:59:42 -08:00
Simon Michael
c97d2cfe6b doc: timedot: link to account aliases 2016-02-20 10:30:09 -08:00
Simon Michael
e5adaff188 doc: timedot: add sample reports 2016-02-20 10:26:42 -08:00
Simon Michael
baeca07440 doc: note include does not support * 2016-02-19 22:51:18 -08:00
Simon Michael
269f7afe33 doc: try making hledger-ui web manual from man page 2016-02-19 22:49:45 -08:00
Simon Michael
00656e62bf site: faq: history: today's cleanup/brighten-up 2016-02-19 19:55:37 -08:00
Simon Michael
176f27a884 doc: manual: begin "timelog" -> "timeclock" rename 2016-02-19 19:55:15 -08:00
Simon Michael
8badaf3b87 doc: timedot doc fixes 2016-02-19 18:04:33 -08:00
Simon Michael
06b54bf05e lib: timedot format, convenient for time logging
Timedot is a plain text format for logging dated, categorised
quantities (eg time), supported by hledger.  It is convenient for
approximate and retroactive time logging, eg when the real-time
clock-in/out required with a timeclock file is too precise or too
interruptive.  It can be formatted like a bar chart, making clear at a
glance where time was spent.
2016-02-19 17:55:57 -08:00
Simon Michael
bd84942349 site: faq: history: cleanup 2016-02-18 10:09:14 -08:00
Simon Michael
8370d2ec63 site: faq: history: yet another cleanup/cheer-up 2016-02-18 09:43:20 -08:00
Simon Michael
aa1fc3f2f2 site: faq: history: clean up, cheer up 2016-02-17 15:25:21 -08:00
Simon Michael
64c77e776e site: devguide: update sandstorm links 2016-02-09 13:14:11 -08:00
Simon Michael
82404952ed doc: manual: mention LEDGER_FILE env var gotcha 2016-02-05 18:06:49 -08:00
Simon Michael
05572f4a08 site: download, devguide: mention homebrew 2016-02-04 06:46:46 -08:00
Simon Michael
ec1472e27e site: download: remove unnecessary --resolver 2016-02-03 16:33:33 -08:00
Simon Michael
a2b989d898 journal: support ledger3-compatible "apply account" 2016-01-29 07:39:26 -08:00
Simon Michael
eaaaf6ddec site: home: link to other main package haddocks 2016-01-28 17:08:57 -08:00
Simon Michael
a0437bb959 site: faq: mention include limitation 2016-01-28 17:08:30 -08:00
Simon Michael
cf5dda72b1 site: download: hledger-ui now on stackage (#301) 2016-01-14 09:44:26 -08:00
Simon Michael
dedaefbd27 site: devguide: quick links tweaks, add nix 2015-12-18 09:04:24 -08:00
Simon Michael
b573fbe519 site: home: tweaks to ui screencast 2015-12-18 09:04:24 -08:00
Simon Michael
860f6501b3 site: download: more correct stack install cmd 2015-12-18 09:04:24 -08:00
Simon Michael
5dcd733907 site: update stack link 2015-12-18 09:04:23 -08:00
Simon Michael
fb407c4da0 site: download: nix update 2015-12-18 09:04:23 -08:00
Simon Michael
1ec5a49d56 doc: relnotes tweaks 2015-11-22 08:37:35 -08:00
Simon Michael
7ab12bae70 doc: user manual tweak 2015-11-16 15:04:18 -08:00
Simon Michael
60327c3ada site: download: #packaged/released/unreleased targets 2015-11-09 14:10:59 -08:00
Simon Michael
2dc71f6518 site: download: add a screencast of stack install 2015-11-09 14:10:25 -08:00
Simon Michael
54fded4b16 site: home: fix screencast url, now full size 2015-11-09 14:09:04 -08:00
Simon Michael
a185725001 site: home: heading/text tweaks 2015-11-09 13:17:32 -08:00
Simon Michael
4e58224a3a site: embed asciinema hledger-ui screencast 2015-11-09 13:17:01 -08:00
Simon Michael
11aa4f1fef site: misc updates 2015-11-08 12:25:10 -08:00
Simon Michael
b52d5622a1 site: faq: re-tell the history 2015-11-08 12:24:56 -08:00
Simon Michael
4723b36987 site: home: front page rewrites 2015-11-08 12:24:22 -08:00
Simon Michael
267afb0759 site: home: a simpler single-column layout 2015-11-07 11:27:00 -08:00
Simon Michael
57791cf248 site: tweak home link 2015-11-07 11:26:23 -08:00
Simon Michael
b34d1fbad8 site: improve page titles in search results 2015-11-07 11:26:08 -08:00
Simon Michael
707d01ba8b site: download page updates 2015-11-07 11:22:57 -08:00
Simon Michael
e9a475f38e site: home: simplify home page text a bit 2015-11-07 09:15:23 -08:00