docbook-apps

Hello,

I try to generate a windows help file using htmlhelp. Everything worked
until i wanted to introduce an external link. When i inserted 'xlink:href="http://www.hzd.de">www.hzd.de' in my DokBook, i also
had to add
'<book lang="de"
xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink" >'.

Now generating HTML, XHTML and PDF works fine. But htmlhelp produces the
following error:

C:\HeWoG\Hilfe\XML>java com.icl.saxon.StyleSheet
Anwenderhandbuch\Anwenderhandbuch.xml
../docbook-xsl-1.71.0/htmlhelp/htmlhelp.xsl use.extensions=1
No template matches book.
No template matches info in book.
No template matches org in info.
No template matches orgname in org.
No template matches adress in org.
No template matches street in adress.
No template matches city in adress.
No template matches postcode in adress.
No template matches link in adress.
No template matches country in adress.
No template matches email in org.
No template matches title in book.
No template matches subtitle in book.
Writing ../HTMLHelp/Handbuch.tmp/htmlhelp.hhp
Writing ../HTMLHelp/Handbuch.tmp/toc.hhc

Then no html files are generated. Only htmlhelp.hhp and toc.hhc are
generated.
When I strip the xmlns declarations (just '<book lang="de">') and the
link, the helpfile will be produced.

I use docbook-xml-4.5 together with docbook-xsl-1.71.0 and saxon 6.5.5.

This is my (simplified) docbook:


<book lang="de"
xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink" >
<info>
<org>
<orgname>Hessische Zentrale für
Datenverarbeitung</orgname>
<adress>
<street>Mainzer Strasse 29</street>
<city>Wiesbaden</city> <postcode>65185</postcode>
www.hzd.de
<country>Germany</country>
</adress>
<email>info@hzd.hessen.de</email>
</org>
</info>

<subtitle>Hessisches Wohngeldverfahren</subtitle>
</book>

Kind regards
Thomas Fehling

I thought the stylesheets ignored xlink unless the document was
docbook 5 or greater.

On 10/24/06, Thomas.Fehling@hzd.hessen.de <Thomas.Fehling@hzd.hessen.de> wrote:
> Hello,
>
> I try to generate a windows help file using htmlhelp. Everything worked
> until i wanted to introduce an external link. When i inserted '> xlink:href="http://www.hzd.de">www.hzd.de' in my DokBook, i also
> had to add
> '<book lang="de"
> xmlns="http://docbook.org/ns/docbook"
> xmlns:xlink="http://www.w3.org/1999/xlink" >'.
>
> Now generating HTML, XHTML and PDF works fine. But htmlhelp produces the
> following error:
>
> C:\HeWoG\Hilfe\XML>java com.icl.saxon.StyleSheet
> Anwenderhandbuch\Anwenderhandbuch.xml
> ../docbook-xsl-1.71.0/htmlhelp/htmlhelp.xsl use.extensions=1
> No template matches book.
> No template matches info in book.
> No template matches org in info.
> No template matches orgname in org.
> No template matches adress in org.
> No template matches street in adress.
> No template matches city in adress.
> No template matches postcode in adress.
> No template matches link in adress.
> No template matches country in adress.
> No template matches email in org.
> No template matches title in book.
> No template matches subtitle in book.
> Writing ../HTMLHelp/Handbuch.tmp/htmlhelp.hhp
> Writing ../HTMLHelp/Handbuch.tmp/toc.hhc
>
> Then no html files are generated. Only htmlhelp.hhp and toc.hhc are
> generated.
> When I strip the xmlns declarations (just '<book lang="de">') and the
> link, the helpfile will be produced.
>
> I use docbook-xml-4.5 together with docbook-xsl-1.71.0 and saxon 6.5.5.
>
> This is my (simplified) docbook:
>
>
> <book lang="de"
> xmlns="http://docbook.org/ns/docbook"
> xmlns:xlink="http://www.w3.org/1999/xlink" >
> <info>
> <org>
> <orgname>Hessische Zentrale für
> Datenverarbeitung</orgname>
> <adress>
> <street>Mainzer Strasse 29</street>
> <city>Wiesbaden</city> <postcode>65185</postcode>
> www.hzd.de
> <country>Germany</country>
> </adress>
> <email>info@hzd.hessen.de</email>
> </org>
> </info>
>
> <subtitle>Hessisches Wohngeldverfahren</subtitle>
> </book>
>
> Kind regards
> Thomas Fehling
>
>
>
>
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: docbook-apps-unsubscribe@lists.oasis-open.org
> For additional commands, e-mail: docbook-apps-help@lists.oasis-open.org
>
>


--
http://chris.chiasson.name/

> -----Original Message-----
> From: Thomas.Fehling
>
> i also
> had to add
> '<book lang="de"
> xmlns="http://docbook.org/ns/docbook"
> xmlns:xlink="http://www.w3.org/1999/xlink" >'.
>
> Now generating HTML, XHTML and PDF works fine. But htmlhelp
> produces the
> following error:
>
> C:\HeWoG\Hilfe\XML>java com.icl.saxon.StyleSheet
> Anwenderhandbuch\Anwenderhandbuch.xml
> ../docbook-xsl-1.71.0/htmlhelp/htmlhelp.xsl use.extensions=1
> No template matches book.

[...]

> Then no html files are generated. Only htmlhelp.hhp and toc.hhc are
> generated.
> When I strip the xmlns declarations (just '<book lang="de">') and the
> link, the helpfile will be produced.
>
> I use docbook-xml-4.5 together with docbook-xsl-1.71.0 and
> saxon 6.5.5.


The xmlns="http://docbook.org/ns/docbook" declaration makes the stylesheets
interpret the XML file as DocBook 5, not 4.5.

You have stumbled upon the following gotcha: when producing HTML Help from a
DocBook 5 document, the profiling stylesheets (profile-htmlhelp.xsl instead
of htmlhelp.xsl) must be used.

See http://www.oasis-open.org/archives/docbook/200605/msg00018.html.

/MJ

Thomas.Fehling@hzd.hessen.de wrote:
> Hello,
>
> I try to generate a windows help file using htmlhelp. Everything worked
> until i wanted to introduce an external link. When i inserted '> xlink:href="http://www.hzd.de">www.hzd.de' in my DokBook, i also
> had to add
> '<book lang="de"
> xmlns="http://docbook.org/ns/docbook"
> xmlns:xlink="http://www.w3.org/1999/xlink" >'.
>
> Now generating HTML, XHTML and PDF works fine. But htmlhelp produces the
> following error:
>
> C:\HeWoG\Hilfe\XML>java com.icl.saxon.StyleSheet
> Anwenderhandbuch\Anwenderhandbuch.xml
> ../docbook-xsl-1.71.0/htmlhelp/htmlhelp.xsl use.extensions=1
>

You have to use profile-htmlhelp.xsl instead of htmlhelp.xsl. See
http://docbook.org/docs/howto/

--
------------------------------------------------------------------
Jirka Kosek e-mail: jirka@kosek.cz http://www.kosek.cz
------------------------------------------------------------------
Profesionální školení a poradenství v oblasti technologií XML.
Podívejte se na náš nove spuštený web http://DocBook.cz
Podrobný prehled školení http://xmlguru.cz/skoleni/
------------------------------------------------------------------
Nejbližší termíny školení:
** XSLT 23.-26.10.2006 ** XML schémata 13.-15.11.2006 **
** DocBook 11.-13.12.2006 ** XSL-FO 11.-12.12.2006 **
------------------------------------------------------------------
http://xmlguru.cz Blog mostly about XML for English readers
------------------------------------------------------------------