Die Umwandlung in das von Windows genutzte HTML Help Format müssen zwei Schritte befolgt werden. Zuerst muss DocBook in HTML mit dem Stylesheet htmlhelp/htmlhelp.xsl gewandelt werden, danach werden diese HTML-Dateien vom HTML Help Workshop, den man bei Microsoft herunterladen kann, in das HTML Help Format umgewandelt werden.
Beispiel 3.6. Umwandlung von Docbook in Windows Hilfe
In diesem Beispiel erfolgt die Umwandlung von DocBook in HTML unter Linux, könnte aber mit geänderten Pfaden genausogut auf Windows ausgeführt werden.
lars@notebook doctutorial $ java -jar /opt/saxon/saxon.jar vortrag.xml /opt/docbook-xsl/htmlhelp/htmlhelp.xsl Writing ch01s02.html for section Writing ch01s03.html for section Writing ch01s04.html for section Writing ch01s05.html for section Writing ch01.html for chapter Writing ch02s02.html for section Writing ch02s03.html for section Writing ch02s04.html for section Writing ch02s05.html for section Writing ch02s06.html for section Writing ch02s07.html for section Writing ch02.html for chapter Writing ld-d0e4785.html for imagedata Writing ch03s02.html for section Writing ch03s03.html for section Writing ch03s04.html for section Writing ch03s05.html for section Writing ch03s06.html for section Writing ch03s07.html for section Writing ch03s08.html for section Writing ch03s09.html for section Writing ch03.html for chapter Writing ch04s02.html for section Writing ch04s03.html for section Writing ch04s04.html for section Writing ch04s05.html for section Writing ch04s06.html for section Writing ch04s07.html for section Writing ch04s08.html for section Writing ch04.html for chapter Writing apa.html for appendix Writing go01.html for glossary Writing bi01.html for bibliography Writing index.html for book Writing htmlhelp.hhp Writing toc.hhc Writing index.hhk
Die Umwandlung mittels HTML Help Workshop muss aber unter Windows erfolgen. Dazu benutze ich an dieser Stelle die Kommandozeilen-Version des HTML Help Workshop.
C:\Program Files\HTML Help Workshop>hhc x:\doctutorial\htmlhelp.hhp Microsoft HTML Help Compiler 4.74.8702 Compiling x:\doctutorial\htmlhelp.chm index.html ch01.html ch01s02.html ch01s03.html ch01s04.html ch01s05.html ch02.html ch02s02.html ch02s03.html ch02s04.html ch02s05.html ch02s06.html ch02s07.html ch03.html ld-d0e4785.html ch03s02.html ch03s03.html ch03s04.html ch03s05.html ch03s06.html ch03s07.html ch03s08.html ch03s09.html ch04.html ch04s02.html ch04s03.html ch04s04.html ch04s05.html ch04s06.html ch04s07.html ch04s08.html apa.html go01.html HHC5003: Error: Compilation failed while compiling ix01.html. bi01.html toc.hhc index.hhk images\callouts\1.png images\callouts\2.png images\callouts\3.png images\callouts\4.png images\jedit.png images\xxe.png images\morphon.png images\epc.png images\xmetal.png images\xmlspy.png images\oxygen.png images\collab.png images\cover.png images\bocbook5.png The following files were not compiled: ix01.html C:\Program Files\HTML Help Workshop>