This is the mail archive of the
kawa@sourceware.org
mailing list for the Kawa project.
Building documentation, chunkfast.xsl URL in doc/style/kawa.xsl
- From: "Sudarshan S Chawathe" <chaw at eip10 dot org>
- To: kawa <kawa at sourceware dot org>
- Date: Sun, 30 Apr 2017 13:26:17 -0400
- Subject: Building documentation, chunkfast.xsl URL in doc/style/kawa.xsl
- Authentication-results: sourceware.org; auth=none
- Reply-to: "Sudarshan S Chawathe" <chaw at eip10 dot org>
In order to build the Kawa documentation (with sources for the invoke
branch from the Gitlab repo) following the instructions at
https://www.gnu.org/software/kawa/Source-distribution.html
I found that I needed to edit the URL for chunkfast.xsl in
doc/style/kawa.xsl. (Otherwise I got errors about failing to load
external entity style/chunkfast.xsl.) I have included a patch below for
completeness, even though the change it is quite trivial.
The Debian docs seem to suggest the change should be generally
applicable but I am not sure. Even if the patch doesn't make sense in
general, this message may help others with a setup similar to mine,
which is Debian 8 (Jessie). I got the idea for the replacement URL from
/usr/share/doc/docbook-xsl/README.Debian.gz file of the docbook-xsl
package on Debian.
With this change, I was able to build the HTML documentation and the
resulting HTML pages look like the ones on the gnu.org Kawa site, with
the exception that the table of contents in the left pane are missing,
and in their place is a link to the table of contents. (I didn't
investigate that issue further yet.)
Regards,
-chaw
diff --git a/doc/style/kawa.xsl b/doc/style/kawa.xsl
index 5fbca2b..e0f904b 100644
--- a/doc/style/kawa.xsl
+++ b/doc/style/kawa.xsl
@@ -2,7 +2,7 @@
xmlns:d="http://docbook.org/ns/docbook"
version="1.0">
<!--<xsl:import href="html/chunktoc.xsl"/>-->
-<xsl:import href="chunkfast.xsl"/>
+<xsl:import href="http://docbook.sourceforge.net/release/xsl/current/html/chunkfast.xsl"/>
<xsl:import href="docbook-to-html.xsl"/>
<xsl:param name="html.namespace"></xsl:param>