Apple Help Book (HTML)

Apple, Inc. bietet seit Mac OS X einen cleveren Hilfe-Betrachter namens Apple Help Viewer für Programme. Dabei muss ein sogenanntes Apple Help Book für das Programm im System angemeldet werden, das in einem bestimmten Ordner des Programm-Bundles vorhanden ist. Ein Apple Help Book ist prinzipiell ein Ordner mit einer Sammlung von HTML-Seiten, Bildern und CSS-Anweisungen, vergleichbar einer Website. Wichtig ist, dass in der Homepage dieser HTML-Seiten zwei bestimmte Meta-Tags für den Apple Help Viewer enthalten sind, damit es anhand dieser erkannt wird.

Somit ist das von UDO erzeugte Apple-Help-Book-Format prinzipiell immer ein HTML-Format, nur dass eben in der Homepage (index.htm o.ä.) folgende Meta-Tags eingefügt werden:

Beispiel:

Vorher:

# preamble
!macro   PROD          iCalamus
!docinfo [appletitle]  (!PROD)-Handbuch
!docinfo [appleicon]   (!PROD)%20Help/img/iC_feather_16.png

Nachher:

Hinweise:

Der im Beispiel gezeigte AppleTitle (hier: iCalamus-Hilfe) muss nicht mit dem Ordnernamen des Apple Help Books (hier: iCalamus Help) übereinstimmen.
CSS-Anweisungen in Apple Help Books dürfen keine Elemente (z.B. Bilder) einbinden, die außerhalb des Ordners liegen, in dem sich das Apple Help Book befindet. UDO kann dies nicht überprüfen. Suchen Sie nach Remote-Dateizugriffen z.B. in Safaris Fehler-Konsole.
Mit Mac OS X v10.6 (Snow Leopard) hat Apple das Format des Apple Help Books verändert. Die von UDO zur Zeit erzeugten Apple Help Books unterstützen noch das Format bis einschließlich Mac OS X v10.5 (Leopard).