You are looking at historical revision 21746 of this page. It may differ significantly from its current revision.
Generate static HTML pages from Chicken wiki manual files.
A command-line program called manual-labor is installed with the extension. It takes two arguments: the directory containing the man pages (such as /path/to/chicken-core/manual) and the output directory, which should be a new or empty directory.
$ manual-labor --help usage: manual-labor [options] mandir htmldir options: --support DIR Look in DIR for support files (CSS, JS, etc.) (default: "/usr/local/lib/chicken/5/manual-labor-support")
All files in mandir are converted to HTML by way of svnwiki->sxml and chicken-doc-sxml->html. Uninteresting files (backup files, dotfiles, symlinks, directories) are skipped. Output files are named like the input, adding an .html extension.
High-level API[procedure] (generate-html-manual mandir outdir)
Process the wiki manual directory mandir and output HTML to outdir, which will be created if it does not exist. Also copies any support files from (manual-labor-support-dir).[parameter] (manual-labor-support-dir DIR)
Directory for manual-labor support files. Any .css and .js files in this directory are copied into the output directory and linked into the generated pages. (Order of inclusion is not currently guaranteed.)
Defaults to (make-pathname (repository-path) "manual-labor-support").
Not currently exported.
Bugs and limitations
- No section table of contents is generated
- No definition contents sidebar, as in chickadee
- HTML IDs may not be unique, which is illegal but will render ok
Copyright (c) 2010 Jim Ursetto. 3-clause BSD license.