Windows Hilfe

DocBook in das HTML Help Format umwandeln

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>