Hey all. I hope your 2014 is proceeding with great success and serenity. You might have noticed some tweaking going on at hledger.org. Last month I switched from hakyll to yst for generating the site, to reduce maintenance costs and to get a nice scalable omnipresent navigation sidebar.
Then with a pang of regret, I moved our small wiki from my Zwiki engine to dokuwiki. I had recently started using it in client work, and liked it so much that it's now serving our new wiki: http://hledger.org/wiki (wiki.hledger.org also gets you there) I chose it initially for its PlantUML plugin which lets me easily maintain UML-style diagrams integrated with the text. Here's an example on the hledger wiki: http://hledger.org/wiki/developer-guide#data-model Other valuable features for me are section editing - being able to quickly edit the specific paragraph or section I'm reading, from any machine (in addition to local file editing); the nice table of contents which appears automatically on long pages; and dokuwiki's easy table syntax. I've been reminded why I like good wikis so much. I've been moving more hledger docs from the hledger git repo into the wiki. I started having grand visions of a giant wiki serving all of ledger-dom - Ledger World! - and had to go and have a lie down. At this point, even though I well know the downsides of wikis, the idea of moving the whole hledger site into one is exerting a strong gravitational pull. Having just one kind of site would be a lot clearer and more pleasant. But... the manual at least really should be revision-controlled along with the code. And dokuwiki's markdown support (I'm using the markdowku plugin) is weak; pandoc-based tools like yst are much better at rendering complex markdown docs like the manual, without having to add a lot of non-standard workarounds. Good markdown support is pretty crucial, so this has me thinking about calling pandoc from dokuwiki, or even replacing it with gitit at some point. So, I'm not satisfied with the docs yet; we'll see how things evolve. But as of now the wiki is where most of the action is. I disabled account registration for the moment due to junk signups, but I believe it's still editable by anyone. Please use it and let me know of problems, or your thoughts on the hledger/*ledger web presence and docs generally. -Simon -- --- You received this message because you are subscribed to the Google Groups "Ledger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/groups/opt_out.
