Developer notes on publishing GenBoard/Manual
Automatically published HTML
[HTML Manual 1] and [HTML Manual 2] are generated on sourceforge server, by /home/groups/m/me/megasquirtavr/bin/daily_snapshot.sh script.
This [naughty page] still links the old unmaintained manual, there are serious errors in it. Use the new one above. TODO: fix the link (it's not an editable wiki page).
Two solutions:
-
Use the 2 XSL documents written by Peter.Done. The script has been edited to suit. The script can be re-enabled in a few hours when pserver gets the XSL updates... again. - Fix the confusion within manual.xml to let it work with DocBook XSL. Some local tests suggest it's OK, but that XSL import paths were messed up. Who knows... lets see what happens when CVS is updated.
It will be called via a CGI from time to time (triggered via wget from remote servers).
Other output formats
Producing formatted output is fairly easy with the XML files. Currently we've got chunked HTML and PDF output working:
- HTML is produced by running a slightly tweaked DocBook transform. We use a file called vems.xsl which sets the stylesheet then imports the standard chunk.xsl. The output can be seen [here].
- PDF is produced by running the fo/docbook.xsl transform to make a FO (Formatting Object) file, then using [Apache FOP] to convert this to PDF. There are other options for output such as PS, PCL, and even SVG, but PDF is the most useful to us. We'll probably make a custom XSL for this conversion too, so we can tweak the output to our needs. A "first cut" example of the PDF output is [here] (781 kB PDF file).
See also