Erste Schritte mit DocBook und OpenOffice.org

OpenOffice.org als DocBook-XML-Editor

Herausgegeben durch das OpenOffice.org Germanophone Project

Produktnamen und Warenzeichen

Alle in diesem Dokument erwähnten Produktnamen und eingetragenen oder nicht eingetragenen Warenzeichen sind nur zum Zweck der Identifizierung erwähnt und sind das ausschließliche Eigentum ihrer Halter.

Historie

Titel	Version	Datum	Autoren
UserGuide DocBook/ OpenOffice.org			XML-Projekt (englisch)
Erste Schritte mit DocBook und Open­Office.org		16.07.03	Übersetzung: Timo Kozlowski

Inhaltsverzeichnis

An wen wendet sich dieser Führer?	4

Bevor Sie beginnen	5

Navigation durch ein Dokument	6

Den Titel des Dokuments festlegen	7

Sect1, Sect2,Sect3 anlegen	8

Eine Tabelle hinzufügen	9

Alternative Zeichenvorlagen	10

Als DocBook speichern	11

Beispiel	12

An wen wendet sich dieser Führer?

Dieser Führer soll ein Startpunkt für denjenigen sein, der mit OpenOffice.org DocBook-Dokumente erstellen oder bearbeiten möchte. Er behandelt nicht alle Funktionen, die der DocBook-Filter im Moment unterstützt, sondern konzentriert sich auf die häufiger Schritte, um mit OpenOffice.org DocBook-Dateien zu bearbeiten und zu erstellen.

	In OpenOffice.org 1.1 Beta 2 Deutsch sind die DocBook-Filter schon aktiviert. Wenn Sie OpenOffice.org 1.1 Beta 1 benutzen, müssen Sie die Filter manuell installieren.

Bevor Sie beginnen

Es gibt eine Dokumentenvorlage, die alle derzeit unterstützten Benutzervorlagen enthält. Laden Sie die Vorlage DocBookTemplate.stw, damit alle von DocBook benötigten Vorlagen zur Verfügung stehen. Öffnen Sie den Stylisten mit <F11> und wählen Sie „Alle“, damit Sie alle vorhanden Vorlagen sehen können.

Abb. 1 Absatzvorlagen mit DocBook-Stilen

Navigation durch ein Dokument

Wenn Sie sehen möchten, wie Bereiche verbunden sind, dann öffnen Sie mit <F5> den Navigator. Klappen Sie das Bereichs-Tag, um das Layout der Bereiche dieses Dokuments darzustellen. Sie können zum Anfang eines bestimmten Bereichs springen, indem Sie ihn im Navigator doppelklicken.

Abb. 2 Navigator mit DocBook-Bereichen

Den Titel des Dokuments festlegen

Gehen Sie zum Bereich ArticleInfo, indem Sie ihn im Navigator doppelklicken. Wählen Sie die Vorlage Document Title aus der Vorlagenliste und geben Sie dann den Titel des Dokuments ein. Dieser Titel wird das ArticleInfo-Titel-Element, wenn das Dokument als im DocBook-Format gespeichert wird.

Abb. 3 Bestimmen des Dokument-Titels mit dem Article Info-Bereich

Sect1, Sect2,Sect3 anlegen

Um einen Bereich anzulegen, wählen Sie Einfügen -> Bereich aus dem Menü. Geben Sie dem Bereich einen Namen und klicken Sie auf Einfügen. Der neue Bereich wird nun angezeigt. Der Name, den Sie dem Bereich gegeben haben, wird die Bereichs-ID im fertigen DocBook-Dokument. Um einem Bereich einen Titel zu geben, wählen Sie entweder Section Title oder eine der Section# Title-Vorlage. Im endgültigen DocBook-Dokument wird die Vorlage Section Title in ein Title-Tag innerhalb dieses Bereichs umgewandelt.

Wenn Sie während der Texteingabe den im Moment editierten Bereich verlassen möchten, dann drücken Sie <ALT> + <Return>.

Eine Tabelle hinzufügen

Wählen Sie Einfügen -> Tabelle aus dem Menü, um eine Tabelle einzufügen. Im Dialog Tabelle einfügen können Sie die Eigenschaften der Tabelle einstellen. Ist dies getan, dann klicken Sie auf OK. Der Name der Tabelle wird das id-Attribut der DocBook-Tabelle.

Um der Tabelle einen Namen zu geben und sie somit zu einer Formalen Tabelle zu machen, rechtsklicken Sie auf die Tabelle im Editor-Fenster und wählen Sie im Kontextmenü Beschriftung. Der Beschriftungstext wird zum Titel der Tabelle.

Abb. 4 Tabellen für DocBook

Alternative Zeichenvorlagen

DocBook erlaubt es, dass Absätze verschiedene Arten von formatiertem Text (stark betont, hoch gestellt, tief gestellt, Dateiname, Befehl etc.) enthalten können. Um diese Vorlagen einem markierten Text zu applizieren, gehen Sie folgendermaßen vor.

Wählen Sie den Text, den sie modifizieren möchten.

Wählen Sie das Zeichenvorlagen-Icon im Stylisten.

Wählen die Zeichenvorlage, die sie applizieren möchten, aus.

Als DocBook speichern

Um Ihr Dokument im DocBook-Format zu speichern, wählen Sie Datei -> Speichern unter aus dem Menü. In der Auswahlliste Dateityp wählen DocBook (vereinfacht) (.xml). Mit dem Speichern-Button können Sie das Dokument dann im DocBook-Format speichern.

Abb. 5 DocBook-XML speichern

Beispiel

Hier finden Sie ein Beispiel, was der DocBook-Filter ausgibt.

<?xml version="1.0" encoding="UTF-8"?>

<article lang="en-US">

<articleinfo>

<title>My Document Title</title>

<subtitle>My Document Subtitle</subtitle>

<edition />

</articleinfo>

<sect1 id="Sect1">

<title>Section1 title </title>

<para>Some random text</para>

<sect2 id="Sect2">

<title>Section 2 Title</title>

<para>Some more Text with
<emphasis>emphasis</emphasis>

</para>

<table frame="all" id="myTable">

<title>My table Name</title>

<tgroup cols="6">

<colspec colnum="1" colname="c1" />

<colspec colnum="2" colname="c2" />

<colspec colnum="3" colname="c3" />

<colspec colnum="4" colname="c4" />

<colspec colnum="5" colname="c5" />

<colspec colnum="6" colname="c6" />

<thead>

<row>

<entry>

<para>Header</para>

</entry>

<entry>

<para>Rows</para>

</entry>

<entry>

<para />

</entry>

<entry>

<para />

</entry>

<entry>

<para />

</entry>

</row>

</thead>

<tbody>

<row>

<entry>

<para />

</entry>

<entry>

<para>Content </para>

</entry>

<entry>

<para>Rows</para>

</entry>

<entry>

<para />

</entry>

<entry>

<para />

</entry>

</row>

</tbody>

</tgroup>

</table>

<para />

</sect2>

</sect1>

</article>

Diese PDF-Datei wurde mit OpenOffice.org 1.1 Beta 2 generiert.

Erste Schritte mit DocBook und OpenOffice.org	Beispiel

10

Erste Schritte mit DocBook und OpenOffice.org

OpenOffice.org als DocBook-XML-Editor

OpenOffice.org DocBook

Andre Schnabel

2003-06-22T15:51:28