Das Editieren von DocBook-Dokumenten ähnelt dem gewohnten Editieren mit einer Textverarbeitung: Texte können eingefügt, geändert, kopiert, gelöscht, verschoben werden. Es existieren jedoch einige grundlegende Unterschiede:
Es werden nur Inhalte bearbeitet, keine Formatierungen
Es existieren Beschränkungen, welcher Inhalt wo vorkommen kann oder muß
Inhalte werden mit Tags "ausgezeichnet", welche den auszuzeichnenden Inhalt möglichst gut beschreiben.
Es können z.B. auch nicht mehrere aufeinanderfolgende Leerzeichen eingegeben werden. Auch existieren keine Tabulatoren oder sonstige Möglichkeiten zur Definition von selbst grundlegenden Formatierungen.
Die Taste Enter bewirkt nicht einen
gewöhnlichen Zeilenumbruch, sondern fügt ein neues Absatz-Element
(para
) ein.
Einige Bereiche/Texte sind nicht direkt editierbar. So werden z.B. die Verzeichnisse für den Inhalt, die Abbildungen, die Nummerierung der Abbildungen und Kapitel etc. automatisch vorgenommen.
In vielen Fällen hilft der Editor, sich im Wald der DocBook-Tags zurechtzufinden. Da der Editor nur valide Eingaben zulässt, bzw. nur valide Dokumente bearbeitet, und dem Benutzer bei der Auswahl eines passenden und validen DocBook-Tags unter die Arme greift, muß der Anwender kein DocBook-Experte sein. Existieren bei der Eingabe mehrere Möglichkeiten, mit welchem Element (DocBook-Tag) es "weitergeht", so stellt der Editor dem Benutzer auch nur die an dieser Stelle möglichen Elemente zur Auswahl. Ist an dieser Stelle zwingend ein bestimmtes Element nötig, so fordert der Editor offensiv zu einer Auswahl aus:
Dokumente werden editiert, indem entweder der Inhalt von vorhanden Tags bearbeitet wird, oder indem neue Tags mit neuem Inhalt dem Dokument hinzugefügt werden. Die genannten 'Tags' dienen dabei als Container - entweder für tatsächlichen Inhalt oder für weitere Tags. Für ein effizientes Bearbeiten von Dokumenten kann komfortabel im Tag-Baum eines Dokumentes navigiert werden. Im Standardfall wird vorhandener Inhalt editiert und erweitert - hierzu kann man, wie von anderen Textverarbeitungssystemen gewohnt, an die gewünschte Textstelle klicken und tippen. Der Editor zeigt zu jedem Element, welches den Focus besitzt, zu welchem DocBook-Tag es in der Hierarchie gehört (der entsprechende Pfad wird in der Fußzeile des Editors sowie in der ContentMap bzw. TOC in der Seitenleiste angezeigt):
In der Seitenleiste kann zwischen den Registerkarten
ContentMap und TOC umgeschaltet werden. In der Ansicht
ContentMap werden die XML-Knoten wie auch der
Inhalt hierarchisch dargestellt, in der Ansicht TOC
werden lediglich die Knoten mit eventuell vorhandenen
<title>
-Tags dargestellt. In beiden Ansichten kann
komfortabel durch das Dokument navigiert werden, momentan nicht
benötigte Abschnitte können ein- bzw. aufgeklappt werden.