Sie sind hier: Ausgeben der Dokumentation > Anpassen des Ausgabeprozesses > Auflösen externer Hyperlinks
Close
Doc-O-Matic 10
Auflösen externer Hyperlinks

Es gibt zwei Möglichkeiten, wie Doc-O-Matic externe Hyperlinks auflöst. Wenn externe Hyperlinks mit Hilfe von Doc-O-Matics Projektdatenbanken erstellt wurden, behandelt Sie Doc-O-Matic wie interne Hyperlinks und überprüft Sie während des Ausgabeprozesses. Externe Hyperlinks werden nicht überprüft, Sie müssen selbst überprüfen, ob das Ziel gültig ist und ob Doc-O-Matic in der Lage ist, zu diesem Ziel einen Hyperlink zu erstellen.

Projektdatenbanken

Damit diese Funktion funktioniert, muss die Themen-ID, die Sie als internes Sprungziel benutzen, in einer Doc-O-Matic Projektdatenbank enthalten sein. Diese Projektdatenbank muss im Projekt-Manager zu Ihrem Projekt hinzugefügt sein. Weitere Informationen darüber, wie Sie Projektdatenbanken benutzen können, finden Sie in Verwenden von Linkdatenbanken, wenn Sie den Editor benutzen. Wenn Sie die Kommentare direkt im Sourcecode schreiben, finden Sie weitere Informationen in Verwenden von Linkdatenbanken.

HTML-Hilfe

In diesen Ausgabeformaten benötigen Sie keinen Präfix für die Linkdatenbankeinträge. Wenn Sie jedoch miteinander verknüpfte HTML-Hilfeprojekte erzeugen, müssen diese im gleichen Ausgabeverzeichnis platziert werden. Wenn Sie zum Beispiel eine HTML-Hilfe erzeugen, die mit der MFC Dokumentation verknüpft werden soll, müssen Sie die erzeugten CHM (und .CHI) Dateien in das selbe Verzeichnis wie die MFC HTML-Hilfedateien speichern. 

Der Exporter für die HTML-Hilfe löst die Hyperlinks zu dem entsprechenden Ausgabeformat automatisch auf.

Help2

In MS Help2 werden Namespaces verwendet, um jedes Projekt zu identifizieren. Daher ist es nicht notwendig zwei miteinander verknüpfte Help2 Projekte im gleichen Verzeichnis zu speichern.

Reihenfolge der Auflösung

In der Standardeinstellung versucht Doc-O-Matic zuerst interne Ziele zu finden und sucht dann nach passenden Zielen in den Linkdatenbanken. Diese Einstellung kann auf der Seite Projektdatenbanken geändert werden.

Nehmen Sie an Sie haben zwei Projekte eines mit dem Namen "3D Engine" und eines mit dem Namen "First Person Shooter". Sie platzieren die Verzeichnisse der Projekte in Verzeichnissen, die Unterverzeichnisse des selben Überverzeichnisses sind.

"C:\Projects\Docs\3DEngine"

und

"C:\Projects\Docs\Shooter".
  1. Geben Sie Präfixe für die Linkdatenbanken von jedem Projekt auf der Seite Files & Format > Files & Folders > Link Database der HTML-Konfiguration ein. Die Präfixe muss aus dem Pfad zum Unterverzeichnis relativ zum Überverzeichnis bestehen.
  2. Der Linkdatenbankeintrag für das Doc-O-Matic Projekt "3D Engine" wäre
"../3DEngine/"
  1. und für das "Shooter" Projekt wäre er
"../Shooter/".
  1. Nun erhält jeder Hyperlink zu einem Thema des Projektes 3D Engine vom Shooter Projekt einen Präfix bestehend aus dem relativen Pfad vom Verzeichnis Shooter zum Verzeichnis 3D. Das ist notwendig, da nur eine WebHilfe in einem Verzeichnis existieren kann.
  2. Erzeugen Sie jedes Projekt einmal, um die Einträge in die Linkdatenbanken zu erzeugen. Doc-O-Matic ist jetzt noch nicht in der Lage die Sprungziele zu finden.
  3. Erzeugen Sie die Ausgaben noch einmal. Diesmal können die Hyperlinks aufgelöst werden.
  4. Wenn Sie zwei PDF-Dokumente nicht im gleichen Verzeichnis platzieren möchten, müssen Sie die Projektdatenbankeinträge auch mit Präfixen wie oben beschrieben versehen. Geben Sie die Präfixe auf der Seite Files & Format > Files & Folders > Link Database ein.

Linkdatenbankoptionen (HTML), Linkdatenbankoptionen (PDF)

PDF-Settings sind verfügbar in: Doc-O-Matic Professional und Doc-O-Matic Author

Copyright © 2000-2020 toolsfactory software inc. Alle Rechte vorbehalten.