Sie können entweder existierende DTX-Dateien zu Ihrem Projekt hinzufügen, oder mit Hilfe des Windows Explorers oder einem anderen Programm eine DTX-Datei erzeugen.
Um DTX-Dateien zu Ihrem Projekt hinzuzufügen
Klicken Sie auf der Registerkarte Project in der Gruppe Add auf Add Files .
Blättern Sie zur Datei, die Sie hinzufügen möchten.
Klicken Sie auf Open.
Sie haben folgende Möglichkeiten:
Klicken Sie No, wenn Sie die Dateien nicht in Doc-O-Matic bearbeiten. Der Inhalt der Datei wird im Topic Preview angezeigt. Sie können den Inhalt in allen Ausgabeformaten ausgeben, aber Sie können Ihn nicht im Editor bearbeiten.
Sie Yes, wenn Sie die Dateien im Editor bearbeiten möchte. Wenn Sie die Dateien umwandeln werden lediglich die umgewandelten DTX Dateien zu Ihrem Projekt hinzugefügt. Sie können den Text im Editor bearbeiten. Die Textdatei selbst wird nicht verändert.
Um Ihre Kommentare in einer DTX-Datei abzuspeichern
Fügen Sie, wie in Zuweisen von Themen-IDs beschrieben, eine Themen-ID zum Kommentar, das dem Symbol, das Sie dokumentieren möchten, entspricht.
Schreiben Sie Kommentare sowohl für Symbole, die bereits dokumentiert sind als auch für Symbole die noch nicht dokumentiert sind.
Sie können den Editor verwenden, um die Rechtschreibung zu überprüfen.
Überprüfen Sie Ihre geschriebenen Kommentare in der Themen-Vorschau.
Kommentare, die an verschiedenen Stellen gespeichert sind, zum Beispiel in Ihrem Sourcedatei und in einer DTX-Datei, werden in verschiedenen Registern angezeigt.
Die Option Behandlung mehrerer Speicherstellen ermöglicht es Ihnen die Reihenfolge und das Erscheinen der Kommentarteile, die an verschiedenen Stellen gespeichert sind, zu kontrollieren.
Für fortgeschrittene Benutzer
Zusätzlich können Sie Dateien hinzufügen, indem Sie die Befehle Import Folder oder Add Folder auf der Registerkarte Project oder der Registerkarte Manage des Projekt-Managers verwenden. Wenn Sie Dokumentationsdateien importieren, extrahiert Doc-O-Matic alle relevanten Dateien aus dem Verzeichnis und fügt sie zum Projekt hinzu. Wenn Sie ein Verzeichnis hinzufügen, versucht Doc-O-Matic jedesmal beim Parsen relevante Dateien im Verzeichnis zu finden. Mit diesem Feature können Sie sicherstellen, dass alle Dateien die aktuell in einem Verzeichnis sind für Ihr Projekt berücksichtigt werden.