FAQ

Fragen und Antworten

1. Wie kann man die Dokumenttitel in HTML und WinHelp ändern?
2. Die HTML-Seiten, die DocBuilder generiert, zeigten das englische Schlüsselwort "Classes" und "Class". Ist dies der Standard-Output oder kann ich den Output konfigurieren, um andere Keywords zu erhalten?
3. Wie werden mit DocBuilder Inhaltsverzeichnisse und Indizes in RTF-Dokumentationen erstellt?
4. Wie werden Filialdokumente in das Zentraldokument in Microsoft® Word 97 eingebunden?
5. Wie kann man Kopf- und Fußzeilen in Filialdokumenten in den Formaten "RTF" und "WinHelp" erzeugen?
6. Wie kann man eine Lizenz von DocBuilder erwerben?

1. Wie kann man die Dokumenttitel in HTML und WinHelp ändern?

   Die Dokumenttitel, die als Fenstertitel des Browsers bzw. des Hilfefensters verwendet werden (Standard: "Dokumentation"), können wie folgt verändert werden:

• HTML: Die Datei index.htm im HTML-Ausgabeverzeichnis mit einem Texteditor öffnen und den Text zwischen @tt{} ändern.
• WinHelp: Die Help-Projektdatei (Erweiterung hpj) im WinHelp-Ausgabeverzeichnis mit dem Help-Workshop (hcw.exe) öffnen und im Abschnitt [OPTIONS] den Eintrag TITLE durch Doppelklick bearbeiten. Anschließend mit "Save and Compile" die Hilfedatei neu erstellen.

2. Die HTML-Seiten, die DocBuilder generiert, zeigten das englische Schlüsselwort "Classes" und "Class". Ist dies der Standard-Output oder kann ich den Output konfigurieren, um andere Keywords zu erhalten?

   Es handelt sich hier nicht um ein "Keyword", sondern um Ausgabetext, den man frei definieren kann. Der Text "Classes" ist eine typische Überschrift (headline), und solche Überschriften werden im aktuell benutzten DocBuilder Script-File (*.dbs) unter dem Keyword @hdline definiert. Hier können Sie Ihre eigenen Überschriften definieren. (übrigens, durch das Platzieren einer jeden Überschrift auf den gewünschten Überschriften-Level können Sie eine beliebige Struktur der Dokumentation erzeugen.) Wenn Ihr Output einen falschen Text wie "Class" im Titel einer Dok-Einheit zeigt, ist auch dieser Text kein Keyword, sondern der Text bezeichnet den Typ der Dok-Einheit. Der Typ der Dok-Einheit wird mit dem DocBuilder Attribut UNITTYPE beschrieben. Bitte öffnen Sie dazu den Dialog unter Menü "Definitionen / Attribute". Hier wird ersichtlich, daß die Erscheinungsform des jeweiligen Attribut-Wertes (das Attribut UNITTYPE hat Werte wie "class", "function" etc., und ggf. zusätzliche, user-definierte UNITTYPE's) ein Text ist, den Sie definieren (möglicherweise auch als leer), wenn Sie den Default nicht mögen.

3. Wie werden mit DocBuilder Inhaltsverzeichnisse und Indizes in RTF-Dokumentationen erstellt?

   Die erstellten RTF-Dokumentationen enthalten Textfelder für das Inhaltsverzeichnis, den Index u.a. Diese Felder müssen nach dem Öffnen des Dokuments aktualisiert werden (z.B. durch CTRL-A und F9 in Microsoft® Word).

4. Wie werden Filialdokumente in das Zentraldokument in Microsoft® Word 97 eingebunden?

   Word 97 stellt Filialdokumente standardmäßig nur als Verweise dar. Um sie im Zentraldokument darzustellen, sind folgende Schritte erforderlich:

1. Öffnen Sie das Zentraldokument, evtl. vorhandene Filialdokumente werden als Verweise dargestellt.
2. Wählen Sie im Menü "Ansicht" den Punkt "Zentraldokument" aus, die Zentraldokument-Symbolleiste erscheint.
3. Aktivieren Sie das erste Symbol dieser Leiste, "Filialdokumente erweitern". Die eingebundenen Filialdokumente werden nun im Zentraldokument abgebildet.

5. Wie kann man Kopf- und Fußzeilen in Filialdokumenten in den Formaten "RTF" und "WinHelp" erzeugen?

   Bei der Erstellung von Filialdokumenten werden Kopf- und Fußzeilen, die mit den Kommandos @headprint bzw. @footprint bei der Definition der Section-Templates in der Scriptdatei angegeben wurden, nicht in die Dokumentation übernommen. Die Kopf- und Fußzeilen werden in die Dokumentation übernommen, wenn keine Filialdokumente erzeugt werden. Dies kann erreicht werden, indem das zugehörige @section-Kommando im Script ohne die output-Option verwendet wird.

6. Wie kann man eine Lizenz von DocBuilder erwerben?

   DocBuilder ist in der derzeitig verfügbaren Version Freeware.

DocBuilder Home | Überblick | Vorteile | Konzepte | Beispiele | Download