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) $ DOCBOOK=<docbook_path> make -e 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. You may recall that I posted a preliminary webrev for this back in November[1]. I have finally gotten back to this, and I think it's more or less done. The overall structure is the same as it was in November. The changes since then have primarily been tweaks to the link names and text. The link tweaks were to match what's already posted on the ON Community site, so as not to break existing bookmarks. The text tweaks were typo fixes and resolving some conflicts between the XML text and the posted HTML. I've made two webrevs. http://cr.opensolaris.org/~kupfer/devref-chunks/ has the changes to the DevRef repo. http://cr.opensolaris.org/~kupfer/devref-html/ shows the changes to the DevRef HTML that's currently posted.[2] I'd like to get a final review of this before proceeding. Once this is done, I can get started on more interesting content changes, like all the updates to track the move from Teamware to Mercurial. Oh, one last question: does anyone care if I squash the deltas (recommit) before pushing to the DevRef repo? thanks, mike Footnotes: [1] http://mail.opensolaris.org/pipermail/on-discuss/2008-November/000480.html [2] the Frames view appears to be broken in both webrevs; I don't know why.
