Dokumente für HTML-Hilfe veröffentlichen (nur Windows)
Voraussetzungen: Arbortext Publishing Engine, Arbortext Styler oder Option Desktop Composer und HTML Help Workshop
Mit Arbortext Editor können Sie XML-Dokumente in HTML-Hilfe umwandeln. Mit der Option > > wird das Dokument in unabhängige HTML-Themen unterteilt und anschließend in einer chm-Datei zusammengefügt. Standardmäßig ist Arbortext Editor so konfiguriert, dass die HTML-Hilfe für Dokumente basierend auf dem Dokumenttyp ArbortextXML DocBook (axdocbook.dtd) erstellt wird. Wenden Sie sich an den Beratungsservice, wenn Sie Dokumente auf der Basis anderer DTDs für HTML-Hilfe veröffentlichen möchten.
Die Option Für HTML-Hilfe wird im Menü Veröffentlichen angezeigt, ist aber bis zur Installation von Microsoft HTML Help Workshop nicht verfügbar. Die aktuelle Version können Sie auf der Website von Microsoft unter http://www.microsoft.com herunterladen. Suchen Sie den Download in der MSDN Library, da dieser möglicherweise nicht unter den Standarddownloads angezeigt wird. Installieren Sie die Komplettversion von Workshop, nicht nur den Viewer.
Sie müssen HTML Help Workshop einmal starten und wieder schließen, bevor Sie > > wählen können.
 |
Wenn Ihre Dokumente Grafiken enthalten, müssen Sie Attribute für Grafikbreite und -tiefe in Pixel angeben, wenn diese Attribute in der HTML-Ausgabe festgelegt werden sollen. Web-Browser können keine Attribute für Grafikbreite und -tiefe interpretieren, die in einer anderen Maßeinheit als Pixel angegeben werden.
Gleichungen mit TeX-Eingabe werden in der HTML-Ausgabe als leere Felder dargestellt.
|
So veröffentlichen Sie Dokumente für HTML-Hilfe:
1. Um HTML-Hilfe in CJK-Sprachen zu veröffentlichen, müssen Sie zunächst für das Windows-Gebietsschema und die Standardspracheinstellungen die gewünschte Sprache festlegen. Weitere Informationen zum Ändern des Gebietsschemas und der Sprachen finden Sie in der Dokumentation zum Windows-Betriebssystem.
2. Wählen Sie > > . Das Dialogfenster Für HTML-Hilfe veröffentlichen wird geöffnet.
3. Geben Sie in das Feld Speichern als den Pfad und Dateinamen ein, unter dem Sie die HTML-Hilfedatei speichern möchten. Klicken Sie auf Durchsuchen, um nach einer vorhandenen Datei zu suchen.
4. Wählen Sie die Option Hilfedatei anzeigen aus, um das Dokument nach dem Veröffentlichen im HTML-Hilfe-Viewer anzuzeigen.
|
|
Wenn Sie die Option Hilfedatei anzeigen auswählen und der Dateiname des Dokuments ein kaufmännisches Und-Zeichen (&) enthält, kann Arbortext Editor den HTML-Hilfe-Viewer nicht starten. Wählen Sie Ja aus, um das Dokument mit deaktiviertem Viewer zu veröffentlichen, oder Nein, um das Veröffentlichen abzubrechen.
|
5. Wählen Sie aus der Liste Formatvorlage die gewünschte Vorlage aus. Eine Formatvorlage, die Web-Veröffentlichung unterstützt, eignet sich auch für HTML-Hilfe. Klicken Sie auf Durchsuchen, um nach einer vorhandenen Formatvorlage zu suchen, die nicht in der Liste aufgeführt ist.
Bei Arbortext Publishing Engine zum Veröffentlichen von veröffentlichen Dokumenten verwenden werden in der Liste die auf dem Arbortext Publishing Engine Server verfügbaren Formatvorlagen angezeigt. Die Notation (pe) erscheint im Namen der Formatvorlage. Lokale Formatvorlagen werden ignoriert, und Sie können keine Formatvorlage zusammen mit dem Dokument zum Server senden.
6. Wenn Sie ein DITA-Dokument veröffentlichen, dem eine DITAVAL-Datei zugeordnet ist, wählen Sie diese Datei in der Liste DITAVAL-Datei. Klicken Sie auf Durchsuchen, um nach einer vorhandenen DITAVAL-Datei zu suchen, die nicht in der Liste aufgeführt ist.
7. Wenn für das Dokument die Änderungsverfolgung aktiviert ist, können Sie das Dokument in einem der Änderungsverfolgungszustände veröffentlichen. Die Änderungsverfolgungsansicht im Fenster "Bearbeiten" ist standardmäßig ausgewählt, es sei denn, die Veröffentlichung erfolgt in einer DITA-Map.
Beim Veröffentlichen einer DITA-Map ist das Feld Änderungen angewandt standardmäßig aktiviert. Beim Veröffentlichen von einer DITA-Map aus bezieht sich die aktivierte Ansicht Änderungsverfolgung nur auf die von den DITA-Maps referenzierten Topics. Die DITA-Map selbst sowie die anderen referenzierten Maps werden stets mit Änderungen angewandt veröffentlicht, und zwar unabhängig von der ausgewählten Ansicht Änderungen verfolgen (auch wenn eine Map eine Änderungsverfolgungsmarkierung enthält).
Sie haben folgende Wahlmöglichkeiten:
◦ Änderungen mit Hervorhebung – Zeigt alle vorgeschlagenen Änderungen mit Überarbeitungsmarkierungen an.
◦ Änderungen angewandt – Zeigt alle Änderungsvorschläge, die in das Dokument eingegeben wurden, ohne Überarbeitungsmarkierungen an.
◦ Original – Zeigt das Dokument ohne Eingliederung der vorgeschlagenen Änderungen an.
8. Wenn Sie die Option Transaktion in Warteschlange einreihen, auswählen, werden Sie dazu aufgefordert, den Dateinamen für Speichern als anzugeben und festzulegen, ob Sie die Hilfedatei anzeigen möchten, wenn Sie das Ergebnis aus der Liste Transaktionen in der Warteschlange abrufen, die Sie über das Menü Extras aufrufen. Durch Auswahl von Transaktion in Warteschlange einreihen werden die Werte in den Dialogfenstern Speichern als und Hilfedatei anzeigen gelöscht. Falls Sie Werte in diese Felder eingegeben haben, werden sie erneut angezeigt, wenn Sie das Kontrollkästchen Transaktion in Warteschlange einreihen deaktivieren.
Das Verhalten der Option Transaktion in Warteschlange einreihen wird durch verschiedene Arbortext Publishing Engine gesteuert.
9. Geben Sie an, ob Sie Transaktionsname eingeben möchten. Der Transaktionsname wird angezeigt, wenn Sie das Ergebnis aus der Liste Transaktionen in der Warteschlange über das Menü Extras abrufen.
Sie können Transaktionsnamen eingeben, die standardmäßig oder für bestimmte Ausgabetypen verwendet werden, indem Sie Werte im Dialogfenster Namen der Transaktionen in Warteschlange eingeben.
10. Wenn Sie auf das Dokument Profile anwenden möchten, klicken Sie auf Profile einstellen, um das Dialogfenster Profile einstellen aufzurufen. Klicken Sie auf OK oder auf Abbrechen, um das Dialogfenster Profile einstellen zu verlassen. Die Schaltfläche Profile einstellen ist nur verfügbar, wenn für den ausgewählten Dokumenttyp Profile konfiguriert wurden.
11. Zum Erstellen einer Publizierregel klicken Sie auf Regel erstellen, um das Dialogfenster Neue Publizierregel erstellen zu öffnen. Hier können Sie eine neue Publizierregel oder einen Regelsatz für die Veröffentlichung als HTML-Hilfe erstellen.
12. Klicken Sie auf OK (im Dialogfenster Für HTML-Hilfe veröffentlichen).
Achten Sie beim Veröffentlichen als HTML-Hilfe auf Folgendes:
• Wenn Sie Arbortext Publishing Engine zum Veröffentlichen von veröffentlichen Dokumenten verwenden, muss HTML Help Workshop auf dem Arbortext Publishing Engine Server installiert sein. Wenn beim Zurückgeben der veröffentlichten HTML-Hilfedatei Hilfedatei anzeigen aktiviert ist, zeigt Arbortext Editor diese im lokalen HTML-Hilfe-Viewer an.
• Arbortext Editor ersetzt während des Veröffentlichens einige Zeichen-Entities, die nicht ordnungsgemäß dargestellt werden. Die Ersatzzeichen-Entities werden unter dem Arbortext Pfad \composer\htmlHelpNavEntSub.xml definiert. Diese Datei steuert nur die Objektersetzungen im Navigationsfenster der HTML-Hilfe. Objektersetzungen im Inhaltsfenster der HTML-Hilfe werden nicht unterstützt.
• Arbortext Styler unterstützt drei Methoden zum Einschließen von CSS-Informationen in die HTML-Ausgabe. Weitere Informationen finden Sie unter CSS files in HTML output (CSS-Dateien in HTML-Ausgabe).
• Der Microsoft HTML-Hilfe-Compiler (hhc.exe) kann keine .chm-Dateien in einem Verzeichnis erstellen, in dessen Pfad ein Ordnername mit einem Punkt beginnt. Falls die APTCACHE-Umgebungsvariable ein Verzeichnis mit einem derartigen Ordner angibt, schlägt der Hilfe-Compiler beim Versuch, eine .chm-Datei zu generieren, fehl. Als Workaround können Sie mit der APTCACHE-Umgebungsvariablen ein Verzeichnis angeben, in dessen Pfadangabe keine Ordner enthalten sind, die mit einem Punkt beginnen.
HTML Help Workshop hat manchmal Probleme, sich in aktuellen Versionen von Microsoft Windows zu konfigurieren. Nach der Installation sollte eine Menüoption > > in Arbortext Styler angezeigt werden. Wenn diese Option deaktiviert ist, bedeutet das, dass Arbortext Styler das für HTML-Hilfedateien zu verwendende Programm nicht identifizieren kann.
Sie können die Zuordnung von *.hhp-Dateien zu Help Workshop erzwingen, um das Problem zu beheben:
1. Erstellen Sie eine leere Datei mit dem Namen "dummy.hhp".
2. Doppelklicken Sie in Windows Explorer auf die Datei. Sie werden von Windows gefragt, welches Programm Sie verwenden möchten, um die Datei zu öffnen. Wählen Sie die Option More programs aus, und navigieren Sie zu C:\Programme (x86)\HTML Help Workshop, und wählen Sie hhw.exe aus. Stellen Sie sicher, dass die Option Always use this program ausgewählt ist.
3. Wenn Arbortext Styler geöffnet ist, schließen Sie es, und öffnen Sie es erneut. Die Option "HTML-Hilfe-Veröffentlichungen" ist jetzt verfügbar.