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
