I've been working on some changes to the ON Developers Reference
sources, so that it's easy to generate HTML that matches the existing
structure at the ON community site.  The idea is that you'd follow these
steps when making changes:

  (edit the XML source)
  $ make -e <DOCBOOK_path> chunks
  $ hg stat on-chunks
  (upload HTML files that Mercurial reports as changed)
  (edit http://www.opensolaris.org/os/community/on/devref_toc/ if needed)

The "make chunks" step uses a custom table-of-contents file to control
how the HTML is chunked.  Then it runs the HTML through a script to fix
up links and remove unwanted tags.

I still have some work to do, like fixing the section links in the XML
source to match the links that are currently in use.  But I thought I'd
post a preliminary webrev in case anyone wants to look at what I have
now.  I'm hoping to have a more complete webrev ready in the next week
or so.

  http://cr.opensolaris.org/~kupfer/devref-chunks/

I'm fairly new to Python, so recommendations on how to improve the
fixup.py script are particularly welcome.

mike

Reply via email to