docbook: Docbook XML questions
Subject:
Docbook XML questions
From:
Simon Anderson ####@####.####
Date:
31 Jul 2003 10:01:40 -0000
Message-Id: <1059685210.1541.17.camel@dalton>
I have just started using Docbook and XML and have some questions.
1- How can I fix the syntax of complex URLs?
This XML;
<ulink
url="http://hostap.epitest.di/cgi-bin/viewcvs.cgi/*checkout*/hostap/README?rev=HEAD&content-type=text/plain">
instructions</ulink>
Causes the following error from xsltproc;
<sect1 id="install-redhat">
^
accesspoint.xml:928: error: xmlParseEntityRef: expecting ';'
ap.epitest.di/cgi-bin/viewcvs.cgi/*checkout*/hostap/README?rev=HEAD&content-typ
^
unable to parse accesspoint.xml
I assume that it doesn't like some of the characters inside the URL
string. How can I fix this?
2- Indexing
3rd level sections and beyond are not getting a contents page entry. I
have modelled the XML on some HOWTO's I grabbed from TLDP, the
associated HTML for these examples _do_ have 3rd level contents entries
even though the syntax used is indetical to mine.
3- Contents
I am structuring my HOWTO to have each chapter as a seperate HTML page.
The first two <sect1> tags in the XML are essentially identical, only
the first one is appended to the index.html page (which I don't want)
while the second (and subsequent) <sect1> tags do have a seperate HTML
page created for them.
!-- section1: intro -->
<sect1 id="introduction">
<title>Introduction</title>
<indexterm>
<primary>accesspoint!introduction</primary>
</indexterm>
<!-- section2: prerequisites -->
<sect1 id="prerequisites">
<title>Prerequisites</title>
<indexterm>
<primary>accesspoint!prerequisites</primary>
</indexterm>
How can I force section 1 to be created as a sperate HTML page as Sectio
2 is, rather than being appended to index.html?
I am using this command to xsltproc;
xsltproc --nonet -stringparam base.dir output/
~/docbook/xsl/xhtml/chunk.xsl accesspoint.xml
Also, I have been unable to assign the resultant HTML pages a filename,
instead a random one is generated. How can I set a file name for a
<sect1> tag?
Thanks in advance,
Simon.