Ah, I finally had a chance to try this out. Pretty slick! I'm not sure I did it right, but I got a lot of output that looks roughly correct. (I'm still getting the Olink errors, but I'm ignoring those for now, because we already know why those are there)
I have one observation/question here -- the output files seem to be "docs.sun.com-centric", in that the output files all have the Sun navbar (with Sun Logo, Products, Downloads, Service & Solutions, Support, Training, etc.) at the top. At the bottom, there's a link to the Sun Company Info, Privacy statement, Terms of Use, etc. So, the pages that are generated are really specific to Sun's Solaris website, rather than being specific to OpenSolaris itself. I noticed that the HTML files that come in the docs-20071121.tar.gz file are also Sun-branded files, rather than OpenSolaris-branded or generic files, as well.... My question: At some point, will somebody be creating an OpenSolaris template, so that the docs are OpenSolaris docs (of which Sun will have its own Solaris flavor, branded separately)? (OK, I admit this was a suggestion in the form of a question... :-) The broader question: This brings up the broader question of how the branding differentiation will be done in the docs.... Has that been figured out yet? The docs all say "Solaris" in the source .xml files. Perhaps there should be a standard ENTITY definition that could be used to distinguish these.... e.g. the docs distributed with OpenSolaris would say "OpenSolaris", and the docs distributed with Solaris would say "Solaris". Mike michelle olson wrote: > Hi Mike, > > I remembered today that we do have a GUI tool for generating HTML from > the XML. Here you go, this is just install and click one button, much > easier: > http://www.opensolaris.org/os/community/documentation/files/DocBookTrans-1.zip > <snip/>
