| <html><head> |
| <meta HTTP-EQUIV="content-type" CONTENT="text/html; charset=UTF-8"> |
| </head> |
| <body> |
| <H1>1 DocBook-Filter |
| für OpenOffice.org</H1> |
| <P>In diesem Dokument |
| soll dargestellt werden, wie OpenOffice.org als WYSIWYG-Editor für |
| XML-Dateien verwendet werden kann. Das Prinzip basiert darauf, |
| Dokumente zu erstellen, die durch Stilvorlagen strukturiert werden. |
| Beim Export werden diese Stilvorlagen in XML-Tags |
| umgewandelt.</P> |
| <P>Dieses How-To zeigt Ihnen, wie man den DocBook-Filter ansprechen und benutzen |
| kann. Es zeigt auch, wo die entsprechenden Vorlagen zu finden sind. Die Benutzer |
| können sie also herunterladen und immer die neueste Version verwenden.</P> |
| <table width=100% cellpadding=4 cellspacing=1 frame=VOID> |
| <col > <col > <thead> |
| <tr> |
| <td width=7%> |
| <p align=CENTER"> <img src="pics/hinweis.png" name="Grafik2" align=MIDDLE vspace=11 border=0></p> |
| </td> |
| <td width=93% valign=TOP bgcolor="#f0f0f0"> |
| <p>Die Angaben zu diesem Dokument beziehen sich auf OpenOffice.org 1.1 Beta |
| 1. Kleine technische Details können sich in späteren Versionen |
| leicht verändert haben.</p> |
| </td> |
| </tr> |
| </thead> |
| </table> |
| <P>Anfangs benutzte OpenOffice.org Bereiche, um |
| DocBook-Bereiche umzusetzen. Es hat sich allerdings herausgestellt, |
| dass Benutzer die gebräuchlichen Textverarbeitungsvorlagen wie |
| Überschrift1, Überschrift2 etc. vorziehen. Die mit OOo1.1 |
| Beta mitgelieferten Stylesheets und Vorlagen benutzen |
| OpenOffice.org-Bereiche. Sie finden unten Links zu Stylesheets, die |
| OOo-Überschriften benutzen, und Installationsanweisungen dafür. |
| Die Stylesheets unterstützen im Moment nur DocBook-Artikel. |
| Unterstützung für Bücher und Kapitel ist geplant.</P> |
| <P>Sie finden die Stylesheets in einer .jar-Datei. Der Inhalt dieser Datei wird |
| später in diesem Dokument erklärt. In der Zukunft soll OOo Im- und |
| Export von XSLT direkt unterstützen.</P> |
| <P>Für einen Überblick, was im Moment schon |
| geht, beachten Sie bitte:</P> |
| <UL> |
| <LI><P>Ein |
| Beispiel-DocBook-Dokument. |
| </P> |
| </UL> |
| <UL> |
| <LI><P>Das zugehörige Writer |
| (.sxw)-Dokument nach dem Import der DocBook-Datei.</P> |
| </UL> |
| <TABLE WIDTH=100% BORDER=0 CELLPADDING=4 CELLSPACING=1> |
| <COL > |
| <COL > |
| <THEAD> |
| <TR> |
| <TD WIDTH=7%> |
| <P ALIGN=CENTER> |
| <IMG SRC="pics/hinweis.png" NAME="Grafik4" ALIGN=MIDDLE VSPACE=11 BORDER=0></P> |
| </TD> |
| <TD WIDTH=93% VALIGN=TOP BGCOLOR="#f0f0f0"> |
| <P>Nested Bereiche werden unterstützt. Siehe |
| dazu Verwendete oder Benutzervorlangen im Stylisten, welche Tags |
| unterstützt werden.</P> |
| </TD> |
| </TR> |
| </THEAD> |
| </TABLE> |
| <P> |
| </P> |
| <TABLE WIDTH=100% CELLPADDING=4 CELLSPACING=1 FRAME=VOID> |
| <COL > |
| <COL > |
| <THEAD> |
| <TR> |
| <TD WIDTH=7%> |
| <P ALIGN=CENTER"> |
| <IMG SRC="pics/hinweis.png" NAME="Grafik2" ALIGN=MIDDLE VSPACE=11 BORDER=0></P> |
| </TD> |
| <TD WIDTH=93% VALIGN=TOP BGCOLOR="#f0f0f0"> |
| <P>Siehe auch Eric Bellots Ooo2sdbk.</P> |
| </TD> |
| </TR> |
| </THEAD> |
| </TABLE> |
| <P> |
| </P> |
| <H1 >2 DocBook in OpenOffice.org 1.1 benutzen</H1> |
| <P>Die DocBook-Filter |
| können bei der Installation von OpenOffice.org ebenfalls |
| installiert werden. Wählen Sie „Benutzergesteuerte |
| Installation“. In der darauf erscheinenden Komponentenauswahl |
| suchen Sie Bereich <CITE >Optionale Komponenten</CITE> |
| und wählen <CITE >Filter für mobile Geräte</CITE>.</P> |
| <TABLE WIDTH=100% CELLPADDING=4 CELLSPACING=1 FRAME=VOID RULES=NONE> |
| <COL > |
| <COL > |
| <THEAD> |
| <TR> |
| <TD WIDTH=7%> |
| <P ALIGN=CENTER> |
| <IMG SRC="pics/hinweis.png" NAME="Grafik1" ALIGN=MIDDLE VSPACE=11 BORDER=0></P> |
| </TD> |
| <TD WIDTH=93% VALIGN=TOP BGCOLOR="#f0f0f0"> |
| <P>In <CITE >OpenOffice.org |
| 1.1 Beta 2 Deutsch</CITE> sind die DocBook-Filter schon |
| aktiviert. Die folgenden Schritte können Benutzer dieser |
| Version überspringen.</P> |
| </TD> |
| </TR> |
| </THEAD> |
| </TABLE> |
| <P>Um die |
| DocBook-Filter zu aktivieren, müssen Sie die folgende Datei |
| bearbeiten: <BR><OOo Install |
| Dir>/share/registry/data/org/openoffice/Office/TypeDetection.xcu;</P> |
| <UL> |
| <LI>Suchen Sie die Zeile <CODE><node |
| oor:name="DocBook File" oor:op="replace"></CODE><p></P> |
| </UL> |
| <UL> |
| <LI>Vor dem dazu gehörendem Endtag <CODE></node></CODE> |
| fügen Sie die folgenden Zeilen ein:<p></P> |
| <PRE><CODE><prop oor:name="Installed" oor:type="xs:boolean"> |
| <value>true</value> |
| </prop></CODE></PRE> |
| |
| </UL> |
| <UL> |
| <LI>Ähnlich verfahren Sie für XHTML. |
| Der Unterschied: Sie suchen nach der Zeile <node |
| oor:name="XHTML File" oor:op="replace">.<p></P> |
| </UL> |
| <UL> |
| <LI>Ähnlich verfahren Sie für Flat XML |
| File. Der Unterschied: Sie suchen nach der Zeile <node |
| oor:name="Flat XML File" oor:op="replace">.<p></P> |
| </UL> |
| <P>Ist der Filter aktiviert, dann starten Sie OOo und |
| überprüfen Sie, ob DocBook als Dateiformat in den Öffnen- |
| und Speicherdialogen zur Verfügung steht. |
| </P> |
| <TABLE WIDTH=100% CELLPADDING=4 CELLSPACING=1 FRAME=VOID RULES=NONE STYLE="page-break-after: avoid"> |
| <COL > |
| <COL > |
| <THEAD> |
| <TR> |
| <TD WIDTH=7%> |
| <P ALIGN=CENTER> |
| <IMG SRC="pics/tip.png" NAME="Grafik3" ALIGN=MIDDLE VSPACE=11 BORDER=0></P> |
| </TD> |
| <TD WIDTH=93% VALIGN=TOP BGCOLOR="#f0f0f0"> |
| <P>Öffnen Sie die Auswahlliste |
| für den Dateityp und tippen Sie mehrmals „d“.</P> |
| </TD> |
| </TR> |
| </THEAD> |
| </TABLE> |
| <P>Wenn Ihr Rechner an |
| ein Netzwerk angeschlossen ist und das DocBook-Format eine |
| öffentliche DTD-Kennung hat, müssen Sie die |
| OpenOffice.org-Einstellungen für HTTP-Proxy-Server noch |
| einstellen.</P> |
| <UL> |
| <LI>Extras -> Optionen<p></P> |
| <LI>Internet -> Proxy<p></P> |
| <LI>Geben Sie den Namen des HTTP-Proxy-Servers |
| und seine Port-Nummer ein.<p></P> |
| </UL> |
| <P>Diese Schritte sind nötig, weil der Crimson XML-Parser versucht, das Dokument |
| entsprechend seiner DTD zu validieren.<BR> |
| </P> |
| <TABLE WIDTH=100% CELLPADDING=4 CELLSPACING=1> |
| <COL > |
| <COL > |
| <THEAD> |
| <TR> |
| <TD WIDTH=7%> |
| <P ALIGN=CENTER > |
| <IMG SRC="pics/hinweis.png" NAME="Grafik5" ALIGN=MIDDLE VSPACE=11 BORDER=0></P> |
| </TD> |
| |
| <TD WIDTH=93% VALIGN=TOP BGCOLOR="#f0f0f0"> |
| <P>Der Filter basiert auf Java. Damit er korrekt funktioniert, muss die |
| Java Runtime Umgebung während der Installation von OpenOffice.org |
| angegeben werden. OpenOffice.org 1.1 Beta 2 benötigt die JRE 1.4.1 |
| oder neuer. Diese Version enthält auch einen XML-Parser (Crimson) |
| und einen XSLT-Prozessor (Xalan).</P> |
| </TD> |
| </TR> |
| </THEAD> |
| </TABLE> |
| <H1 >3 DocBook-XML mit OpenOffice. org anlegen und |
| bearbeiten</H1> |
| <H2 >3.1 Eine DocBook-Vorlage anlegen</H2> |
| <P>Es ist nicht |
| möglich, vordefinierten Vorlagen DocBook-Vorlagen in |
| OpenOffice.org zur Verfügung zu stellen. Gehen Sie dazu wie |
| folgt vor:</P> |
| <UL> |
| <LI>Laden Sie ein einfaches <A HREF="http://xml.openoffice.org/xmerge/downloads/docbook_template.xml">DocBook |
| XML-Dokument</A> herunter. |
| <p></P> |
| <LI>Öffnen Sie es in OpenOffice.org.<p></P> |
| <LI>Öffnen Sie den Stylisten mit F11 und |
| wählen Sie in der unteren Auswahlliste „Alle“. Nun |
| werden alle enthaltenen DocBook-Vorlagen dargestellt.<p></P> |
| </UL> |
| <P>Informationen, wie man |
| den Filter benutzt, finden Sie im <A HREF="docbook-user-guide-de.html">UserGuide</A>.</P> |
| <H2 >3.2 Bereiche/Überschriften</H2> |
| <P><STRONG >Wie |
| man das Stylesheet ändert</STRONG></P> |
| <P>Der DocBook-Filter benutzt die Funktionen des |
| Frameworks XSLT von XMerge. Das <A HREF="http://xml.openoffice.org/xmerge/downloads/docbook.jar">docbook.jar</A> |
| enthält <A HREF="http://xml.openoffice.org/source/browse/xml/xmerge/java/org/openoffice/xmerge/converter/xml/xslt/docbook/">zwei |
| XSLT Stylesheets</A>. Mit einem können Sie von DocBook nach |
| OpenOffice.org konvertieren und mit dem anderen von OpenOffice.org |
| nach DocBook.</P> |
| <P>Die Datei enthält im Verzeichnis META-INF |
| auch die Datei converter.xml. Darin werden die unterstützten |
| MIME-Typen, die Stylesheet-Namen und das benutzte XMerge-Plugin |
| beschrieben.</P> |
| <P>Zum Bearbeiten:</P> |
| <UL> |
| <LI>Legen Sie ein temp-Verzeichnis an. |
| <ul> |
| <LI><CODE>mkdir temp</CODE> |
| </ul> |
| <LI>Entpacken Sie das Jar in das temp-Verzeichnis. |
| <ul> |
| <LI><CODE>jar -xvf docbook.jar temp</CODE> |
| </ul> |
| <LI>Danach finden Sie diese Dateien im <code>temp</code>-Verzeichnis: |
| <ul> |
| <CODE>META-INF/MANIFEST.MF |
| <LI>META-INF/converter.xml</CODE> |
| <LI>sofftodocbook.xsl |
| |
| <LI>docbooktosoff.xsl |
| </ul> |
| </UL> |
| <P>Die beiden Stylesheets können nun beliebig |
| bearbeitet werden. Sie können auch die <A HREF="http://xml.openoffice.org/source/browse/xml/xmerge/java/org/openoffice/xmerge/converter/xml/xslt/docbook/">neuesten |
| Kopien</A> herunterladen.</P> |
| <P>So packen Sie die veränderten Dateien in das |
| Jar zurück:</P> |
| <UL> |
| <LI><code>cd temp </CODE> |
| <LI><code>jar -cvf ../docbook.jar</code> |
| <LI>Kopieren Sie die Datei nach <code><OOo installation>/program/classes </CODE> |
| <LI>Starten Sie OpenOffice.org neu. |
| <p></P> |
| </UL> |
| <P>Ein Beispiel: Wollen Sie die neuen |
| XSLT-Stylesheets benutzen, dann ersetzen Sie die Stylesheets im |
| temp-Verzeichnis mit den heruntergeladenen Versionen. Die |
| converter.xml-Datei enthält Informationen für die |
| Konvertierungen, die der Filter bietet. Diese Information wird von |
| XMerge benutzt, wenn eine Konvertierung angefordert wird.</P> |
| <pre><CODE> |
| <converters> |
| <converter type="staroffice/sxw" version="1.0"> |
| <converter-display-name> |
| XSLT Transformation sxw |
| </converter-display-name> |
| <converter-description> |
| Converter which performs xslt transformations |
| </converter-description> |
| <converter-vendor> |
| OpenOffice.org |
| </converter-vendor> |
| <converter-class-impl> |
| org.openoffice.xmerge.converter.xml.xslt.PluginFactoryImpl |
| </converter-class-impl> |
| <converter-xslt-serialize> |
| sofftodocbookheadings.xsl |
| </converter-xslt-serialize> |
| <converter-xslt-deserialize> |
| docbooktosoffheadings.xsl |
| </converter-xslt-deserialize> |
| <converter-target type="application/x-docbook" /> |
| </converter> |
| </converters> |
| </CODE> |
| </pre> |
| <H2 >3.3 Momentan unterstützte Tags</H2> |
| <P>Die <A HREF="http://xml.openoffice.org/xmerge/docbook/DocBookTags.html">aktuelle |
| Liste</A> der im Moment unterstützten DocBook-Tags.</P> |
| <H1 >4 ToDo</H1> |
| <UL> |
| <LI>Unterstützung weiterer DocBook-Tags<p></P> |
| <LI>Unterstützung von XML Entities. |
| Entity-Referenzen gehen momentan verloren. Man kann sie vielleicht |
| erhalten, indem man sie wie Felder behandelt.<p></P> |
| <LI>ArticleInfo sollte ursprünglich die |
| Dokument-Eigenschaften unterstützen. Dies bedeutet allerdings |
| zu viele Tags. Also wird dies vielleicht ein eigener Bereich.<p></P> |
| <LI>Bilder (Wir haben Platzhalter für die |
| benötigten Informationen)<p></P> |
| <LI>Hyperlinks<p></P> |
| <LI>Kapitel<p></P> |
| |
| <LI>Referenzen |
| <p></P> |
| </UL> |
| |
| <H1 >5 Einschränkungen</H1> |
| <P>Wir wollen auf diese Einschränkungen |
| hinweisen, betrachten sie aber nicht als unüberwindbares Hindernis. Wenn |
| es genügend Interesse an diesem Projekt gibt, dann wird den Wünschen |
| nach Erweiterungen auch nachgekommen.</P> |
| <UL> |
| <LI>Benutzer können in OOo nicht festlegen, welche Vorlagen (Tags) wofür |
| benutzt werden. Sie müssen sich an die Vorgaben halten. |
| <p></P> |
| <LI>Keine Validierung des Exports. |
| <p></P> |
| </UL> |
| <H1 >6 Offene Fehler</H1> |
| <UL> |
| <LI>Keine Unterstützung für Nested Tags in Text Spans.<BR> |
| Benutzen Sie zum Beispiel: |
| <pre><code><menuchoice> |
| <guimenu> |
| File |
| </guimenu> |
| <guimenuitem> |
| New |
| </guimenuitem> |
| </menuchoice></CODE></pre> |
| In HTML erschient dies so:<BR> |
| <BR> |
| Use File -> New |
| <p></P> |
| </UL> |
| <UL> |
| <LI>Kommentare werden importiert (Der Parser ignoriert sie. Man muss vielleicht |
| ein Kommentar-Tag benutzen). |
| <p></P> |
| <LI>Nested Listen werden in OpenOffice.org in drei einzelne Listen aufgeteilt |
| und müssen auch als drei einzelne Listen exportiert werden. |
| <p></P> |
| <LI>Vorlagen werden im Import-Stylesheet definiert. |
| <p></P> |
| <LI>Import in ein vorhandenes Stylesheet wäre schön. |
| <p></P> |
| </UL> |
| </body> |
| </html> |
| |
