Hi Mike, Thanks so much for working on this document and the Makefile. This will be first re-publishing of it on osol since it was opened up and converted to XML. So, I really appreciate your patience with this process.
We should test the one big HTML file presentation and linking before we overwrite existing. Can you upload the XML and HTML to the Files page, so I can take a look? http://opensolaris.org/os/community/documentation/files/ I've added you as leader on docs community, so you can do this. I think the XML errors are just flagging elements without IDs, and should not be a problem, but I want to dbl-check. Thanks again, Michelle Mike Kupfer wrote: > I finally got around to getting the DevRef to build HTML. The patch to > the DevRef makefile is below. > > I did get a few warnings and errors: > > athyra$ echo $DOCBOOK > /home/kupfer/lib/docbook5-xsl-1.72.0 > athyra$ make -e all > xsltproc --nonet --stringparam html.stylesheet "format.css" > --stringparam chunker.output.doctype-public "-//W3C//DTD HTML 4.01 > Transitional//EN" --stringparam chunker.output.doctype-system > "http://www.w3.org/TR/html4/loose.dtd"; -o devref.html > /home/kupfer/lib/docbook5-xsl-1.72.0/html/docbook.xsl devref.xml > docbookx.dtd:101: warning: failed to load external entity "dbnotnx.mod" > %dbnotn; > ^ > Entity: line 1: > %dbnotn; > ^ > docbookx.dtd:123: warning: failed to load external entity "dbcentx.mod" > %dbcent; > ^ > Entity: line 1: > %dbcent; > ^ > docbookx.dtd:136: warning: failed to load external entity "dbpoolx.mod" > %dbpool; > ^ > Entity: line 1: > %dbpool; > ^ > docbookx.dtd:155: warning: failed to load external entity "dbhierx.mod" > %dbhier; > ^ > Entity: line 1: > %dbhier; > ^ > docbookx.dtd:166: warning: failed to load external entity "dbgenent.mod" > %dbgenent; > ^ > Entity: line 1: > %dbgenent; > ^ > Adding DocBook namespace to version 4 DocBook document > ERROR: xref linking to _Install has no generated link text. > Error: no ID for constraint linkend: _Install. > ERROR: xref linking to _1_3_2_3_Upgrading_to_the_Lates has no generated > link text. > Error: no ID for constraint linkend: _1_3_2_3_Upgrading_to_the_Lates. > ERROR: xref linking to _3_4_1_Getting_Ready_to_Work has no generated link > text. > Error: no ID for constraint linkend: _3_4_1_Getting_Ready_to_Work. > ERROR: xref linking to _7_2_3_Non_formatting_Considera has no generated > link text. > Error: no ID for constraint linkend: _7_2_3_Non_formatting_Considera. > ERROR: xref linking to _7_2_3_Non_formatting_considera has no generated > link text. > Error: no ID for constraint linkend: _7_2_3_Non_formatting_considera. > ID recommended on sect1 > ID recommended on sect2: ACR > > Note that this produces a single monolithic HTML file. There's no > "chunk" target, which I assume is for producing one HTML file per > chapter. > > Are the warnings anything I need to be concerned with? I assume that > the xref errors are due to bugs in the XML. > > mike > > -- > # HG changeset patch > # User mike.kupfer at sun.com > # Date 1181348144 25200 > # Node ID 37bcda597cf287914cc71d9d6f9065a62e1dd56e > # Parent 03f4c8799d4df828e74809fbd191a1b6f0245714 > fix HTML generation > > diff -r 03f4c8799d4d -r 37bcda597cf2 Makefile > --- a/Makefile Wed May 02 14:26:25 2007 -0700 > +++ b/Makefile Fri Jun 08 17:15:44 2007 -0700 > @@ -51,7 +51,6 @@ > # here gives the document an opensolaris.org look-and-feel. > # > DOCBOOK=SET_THIS_TO_THE_LOCATION_OF_YOUR_DOCBOOK_FILES > -XSLDIR=$(DOCBOOK)/XSL > XSLTPROC=xsltproc > XMLLINT=xmllint > XSLTPROC_OPTS= \ > @@ -61,8 +60,8 @@ XSLTPROC_OPTS= \ > "-//W3C//DTD HTML 4.01 Transitional//EN" \ > --stringparam chunker.output.doctype-system \ > "http://www.w3.org/TR/html4/loose.dtd"; > -XSLT_DB2HTML=$(XSLDIR)/docbook/html/docbook.xsl > -XSLT_DB2IDXHTML=$(XSLDIR)/docbook/html/chunk.xsl > +XSLT_DB2HTML=$(DOCBOOK)/html/docbook.xsl > +XSLT_DB2IDXHTML=$(DOCBOOK)/html/chunk.xsl > > ALLFILES= \ > devref.xml > _______________________________________________ > docs-discuss mailing list > docs-discuss at opensolaris.org >
