As many of you know, I’ve started keeping the manual up to date in a separate github repository, using Webby to build the HTML:

http://github.com/bsag/tracks_manual/tree/

I’ve now sorted out the formatting and organisation of the chapters sufficiently to publish it to the main Tracks site:

http://getontracks.org/doc/index.html

With webby and the appropriate settings in my Sitefile, all I need to do is issue the command:

webby deploy

to update all the files on the Tracks site, thus making it much easier than before to keep the manual up to date. I’ve changed the link for the ‘Manual’ navbar link on the main site to point to the new documentation.

In addition, with Prince XML installed, you can do the following on your local copy of the manual (with webby running) to generate a nice PDF file:

prince http://localhost:4331/printed/manual.html -o ~/Desktop/manual.pdf

I need to do a bit more CSS work to get the manual exactly how I want it to appear as a PDF, but it’s not bad. I’ve just uploaded it to my Bingodisk to replace the old manual, so you can have a look if you want:

http://bsag.bingodisk.com/public/files/manual.pdf

At the moment, the manual is more or less as it was before, with instructions for installing and upgrading Tracks, but I’d like to add other chapters on usage, tips and tricks etc.