Hilfe > Übersicht über die DITA-Erstellung > Generierung von DITA-IDs anpassen
Generierung von DITA-IDs anpassen
Arbortext Editor ermöglicht das Generieren von IDs für Elemente in DITA-Dokumenten. Diese IDs werden auf Grundlage von Titel, Text und Elementen des aktuellen Dokuments generiert. Standardmäßig wird an die ursprüngliche ID eine achtstellige Hexadezimalzahl gehängt, die auf dem aktuellen Datum und der aktuellen Uhrzeit beruht (z.B. DITAAuthoringOverview-030963B9). Diese generierten IDs sind innerhalb einer Gruppe von DITA-Dokumenten sehr wahrscheinlich eindeutig. DITA-IDs werden mit der Funktion generate_id generiert. Sie können IDs auch manuell eingeben, falls dies in der Dokumenttyp-Konfigurationsdatei (.dcf) für den Dokumenttyp aktiviert ist.
Sie können DITA-IDs auf folgende Weise generieren:
Wählen Sie die Befehlsfolge Einfügen > ID generieren aus.
Klicken Sie auf die Symbolleistenschaltfläche ID generieren.
Klicken Sie im Dialogfenster Attribute ändern auf die Schaltfläche ID generieren, wählen Sie die Attributdarstellung der Strukturansicht aus, klicken Sie in der Spaltenansicht auf die Spalte "Attribute ändern" oder auf die Spalte ID.
Erstellen Sie auf der Registerkarte Neues Topic der Quellenverwaltung ein neues DITA-Topic.
Speichern Sie ein DITA-Topic, das mithilfe einer der Schablonendateien für DITA-Dokumenttypen erstellt wurde.
In diesem Fall generiert Arbortext Editor beim erstmaligen Speichern des Dokuments automatisch eine ID für das Topic.
Standardmäßig werden IDs nicht in den Spalten der Spaltenansicht oder in der Quellenverwaltung angezeigt. IDs werden in der Bearbeitungsansicht und im Dialogfenster Attribute ändern angezeigt.
Sie können IDs an folgenden Stellen ändern:
Dialogfenster Attribute ändern
Attributdarstellung der Strukturansicht
Spalte "Attribute ändern" der Spaltenansicht
Spalte ID der Spaltenansicht
Sie können eine aktualisierte ID manuell eingeben oder auf die Schaltfläche ID generieren klicken, um eine neue ID zu generieren. Wenn Sie versuchen, eine vorhandene ID mit der Schaltfläche ID generieren zu ändern, müssen Sie bestätigen, dass die vorhandene ID durch eine neue ID ersetzt werden soll. Bei der manuellen Eingabe einer neuen ID wird diese Aufforderung nicht angezeigt.
Sie können das Standardverhalten beim Generieren von DITA-Dokument-IDs auf folgende Weise anpassen:
Stellen Sie die Option ditahideids auf off ein.
Damit werden IDs in der Quellenverwaltung angezeigt, und die Option ID wird in der Quellenverwaltung auf der Registerkarte Neues Topic angezeigt.
Stellen Sie die Option generateuniqueid auf off ein.
Mit dieser Option werden die Standard-IDs um die an die ID gehängte Hexadezimalzeichenfolge gekürzt.
Stellen Sie in der Dokumenttyp-Konfigurationsdatei (.dcf) für einen DITA-Dokumenttyp das Attribut dialogHidden oder screenHidden im AttributeOptions-Element auf true für das DITA-Attribut id ein.
Damit wird das Attribut id in den Arbortext Editor Dialogfenstern und Ansichten ausgeblendet.
Stellen Sie in der .dcf-Datei das Attribut assignId im Element Options auf no ein.
Dadurch werden die Benutzer daran gehindert, automatisch generierte IDs zu ändern.
Aktivieren Sie in der Kategorie Spalten des Dialogfensters Einstellungen das Feld für die Spalte ID.
Damit wird die Spalte ID in der Spaltenansicht einer DITA-Map angezeigt. In diesem Dialogfenster können Sie auch die Anzeigereihenfolge für die Spalte ID ändern.
War dies hilfreich?