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.
cheers,
bsag
--
but she's a girl - the weblog of a female geek
http://www.rousette.org.uk
[email protected]
_______________________________________________
Tracks-discuss mailing list
[email protected]
http://lists.rousette.org.uk/mailman/listinfo/tracks-discuss
