Kompatibel mit DokuWiki

• 2024-02-06 "Kaos" unbekannt
• 2023-04-04 "Jack Jackrum" ja
• 2022-07-31 "Igor" unbekannt
• 2020-07-29 "Hogfather" ja

• Herunterladen
• Fehler melden

Exportiert eine Seite ins Open Document format welches von OpenOffice.org und anderen Textbearbeitungen verwendet wird

Letzte Aktualisierung

2023-03-03

Beinhaltet

Syntax, Render

Verwaltung

Quellcode

Kollidiert mit

header2, inlineeditor, quickedit

Diese Erweiterung ist weder im "plugin" noch im "template" Namensraum und wird deswegen ignoriert.

Ähnlich zu bookcreator, mellelexport, odp

Markiert mit export, odt, pdf

Benötigt für bookcreator, odtsupport, symbols4odt

Von Andreas Gohr, Aurélien Bompard, Florian Lamml, Lars (LarsDW223)

Dieses Plugin ermöglicht es Ihnen eine Seite in das OpenDocument Format zu exportieren welches von OpenOffice.org, LibreOffice.org und anderen Textbearbeitungen verwendet wird. Dies ist besonders nützlich wenn Sie eine einzelne Seite für einen Kunden drucken oder an ihn geben müssen. (Tip: OpenOffice.org kann auch nach PDF exportieren). Seit Release-Version 2016-04-23 kann eine Seite auch direkt nach PDF exportiert und heruntergeladen werden. Siehe Abschnitt PDF-Konvertierung für weitere Details.

Dieses Plugin wurde angelegt von Andreas Gohr, und wurde dann weiterentwickelt und verwaltet von Aurelien Bompard.

Die ältere Version vom ODT-Plugin mit Default-Template Unterstützung war von Florian Lamml.

Aktuell wird das ODT Plugin von LarsDW223 weiter verwaltet.

PHP 5.5 (für PHP 5.3.3+ und PHP 5.4.X, siehe dieser Workaround)

Es gibt keine generellen Voraussetzungen aber manche Funktionen haben Voraussetzungen:

• Bookcreator: für Bookcreator-Unterstützung muss zusätzlich das Bookcreator Plugin installiert werden.
• Pagebreak: um manuelle Seitenumbrüche einfügen zu können muss zusätzlich das Pagebreak Plugin installiert werden.

Benutzer von PHP 7 sollten in Erwägung ziehen auf Release 2016-04-23 (aktuelles Release) zu gehen um zu verhindern das ihre Logdateien voll laufen mit überflüssigen Fehlern (PHP 7 signature errors).

Fügen Sie das folgende Makro zu einer Seite hinzu, um eine einzelne Seite exportierbar zu machen:

~~ODT~~

Eine bessere Möglichkeit ist die Integration einer Export-Schaltfläche in Ihr template.

Wenn sie das Default Template von Dokuwiki benutzen können Sie den Export Button einfach im Konfigurationsmenü aktivieren.

Ansonsten gehen Sie folgendermaßen vor, um eine Schaltfläche in die obere oder untere Zeile des Templates hinzuzufügen: ¹⁾

<form class="button" method="get" action="<?php wl($ID)?>">
  <div class="no">
    <input type="submit" value="Export nach ODT" class="button" />
    <input type="hidden" name="do" value="export_odt" />
    <input type="hidden" name="id" value="<?php echo $ID?>" />
  </div>
</form>

Oder benutzen Sie dieses einfache 16×16 Icon irgendwo in Ihrem Template:

  <a href="<?php echo exportlink($ID, 'odt')?>"><img src="<?php echo DOKU_BASE?>lib/images/fileicons/odt.png" alt="ODT Export" /></a>

Sie können die beiden vorherigen Methoden mischen, und erhalten eine Schaltfläche mit einem Bild darin, mittels des folgenden Codes:

<form class="button" method="get" action="<?php wl($ID)?>">
  <div class="no">
    <button type="submit" class="button">
      <img src="<?php echo DOKU_BASE?>lib/images/fileicons/odt.png" alt="ODT Export" />
      Export nach ODT
    </button>
    <input type="hidden" name="do" value="export_odt" />
    <input type="hidden" name="rev" value="<?php global $REV; echo $REV?>" />
    <input type="hidden" name="id" value="<?php echo $ID?>" />
  </div>
</form>

Die meisten Einstellungen oder Konfigurationsoptionen im ODT-Plugin können vorgenommen werden in der ODT-Plugin Konfiguration, durch übergeben der Einstellung als einen Parameter im URL-Request oder durch Verwendung eines Syntax-Tags.

Die Priorität ist folgende (der erste Eintrag hat die höchste Priorität, der Letzte die Niedrigste):

1. Syntax-Tag
2. Parameter im URL-Request
3. ODT-Plugin Konfiguration
4. DokuWiki Konfiguration
   (nur relevant für 'toc_maxlevel', siehe Abschnitt Konfiguration unten)

Es folgt ein Beispiel um die Einstellung Orientierung (orientation) als URL-Request Parameter zu übergeben:

https://www.dokuwiki.org/plugin:odt?orientation=landscape&do=export_odt

Das Gleiche funktioniert für Syntax-Tags. Die Syntax-Tags für Einstellungen haben immer das gleiche Format:

{{odt>Parameter:Wert}}

Hier wieder das Beispiel für die Einstellung Orientierung (orientation):

{{odt>orientation:landscape}}

Das aktuelle Release hat folgende Konfigurationsoptionen:

Es gibt einige zusätzliche Syntax-Tags für Zusatz-Funktionen die nicht in der Konfiguration alleine gesetzt werden können, da z.B. die Position wichtig ist oder mehr Flexibilität gegeben werden soll. Diese Tags werden in diesem Abschnitt beschrieben.

Ein manueller Seitenumbruch kann durch hinzufügen des Syntax-Tags <pagebreak> in der Wiki-Seite eingefügt werden. Diese Funktion benötigt das Pagebreak Plugin.

Das Syntax-Tag page kann verwendet werden um das Seitenformat, die Orientierung und die Seitenränder mit einem Befehl einzustellen. Das Format ist folgendes:

{{odt>page:format,orientation,margin_top,margin_right,margin_bottom,margin_left}}

Das folgende Beispiel setzt das Seitenformat A3, die Orientierung landscape (Querformat) und alle Seitenränder werden auf 1 Zentimeter gesetzt.

{{odt>page:A3,landscape,1,1,1,1}}

Sie können auch Einstellungen welche Sie nicht ändern wollen weglassen, z.B.:

{{odt>page:A3,landscape}}

Das ändert das Seitenformat und die Orientierung aber nicht die Seitenränder.

Wenn Sie nur eine einzelne der Seiteneinstellungen verändern möchten, dann können Sie die Tags für das Seitenformat, die Orientierung und die Seitenränder alleine verwenden. Hier ein paar Beispiele:

{{odt>format:A3}}
{{odt>format:A4}}

{{odt>orientation:portrait}}
{{odt>orientation:landscape}}

{{odt>margin_top:1}}
{{odt>margin_right:2}}
{{odt>margin_left:3}}
{{odt>margin_bottom:4}}

Eine Änderung des Seitenformats beendet die aktuelle Seite, fügt einen Seitenumbruch ein und die nächste Seite verwendet dann das neu gesetzte Seitenformat.

Das toc Syntax-Tag wird verwendet um ein Inhaltsverzeichnis an der Position des Tags einzufügen. Wenn kein toc Syntax-Tag eingefügt wird, wird auch überhaupt kein Inhaltsverzeichnis angelegt. Die minimale Ausführung ist:

{{odt>toc}}

Dies legt ein Inhaltsverzeichnis an, bei dem alle relevanten Einstellungen aus der Plugin-Konfiguration geholt werden. Der Titel wird 'Inhaltsverzeichnis' sein (in Abhängigkeit der eingestellten Sprache)

Es gibt folgende Optionen für das Syntax-Tag toc:

• maxlevel: überschreibt toc_maxlevel
• title: überschreibt den sprachabhängigen Standard-Titel 'Inhaltsverzeichnis'
• leader_sign: überschreibt toc_leader_sign
• indents: überschreibt toc_indents
• pagebreak: überschreibt toc_pagebreak
• styleH: überschreibt den Style Contents Heading aus der Datei styles.xml
• styleL1 … styleLN: N = maxlevel, überschreibt toc_style

Sie haben alle die gleiche Bedeutung wie die entsprechende Konfigurationseinstellung. Die einzige Ausnahme ist styleL1 … styleLN. Die Konfigurationsoption toc_style setzt den Style für das gesamte Inhaltsverzeichnis. styleL1 setzt nur den Style für Ebene 1, styleL2 setzt nur den Style für Ebene 2…

Die Option syntaxH arbeitet genau so wie die styleL Option oben allerdings setzt sie den Style für den Titel bzw. die Überschrift des Inhaltsverzeichnisses.

All diese Optionen sind optional. Wenn Sie eine weglassen wird die entsprechende Einstellung aus der Konfiguration (oder aus dem URL-Request-Parameter) verwendet. Jede Option muss mit einem ; abgeschlossen werden.

Es folgen ein paar Beispiele (alles eine Zeile):

{{odt>toc:title=Content;leader_sign=.;indents=0,0.5,1;pagebreak=true;
styleL1="font-weight:bold;";styleL2="font-style:italic;";
styleL3="font-style:normal;";}}

{{odt>toc:title=Content;leader_sign=_;indents=0,2,2;pagebreak=false;
styleL1="font-weight:bold;";styleL2="font-style:normal;";
styleL3="font-style:normal;";}}

Das chapter-index Syntax-Tag wird verwendet um ein Kapitelverzeichnis an der Position des Tags einzufügen. Wenn kein chapter-index Syntax-Tag eingefügt wird, wird auch überhaupt kein Kapitelverzeichnis angelegt. Die minimale Ausführung ist:

{{odt>chapter-index}}

Dies legt ein Kapitelverzeichnis an, bei dem alle relevanten Einstellungen aus der Plugin-Konfiguration geholt werden und zwar aus den Einstellungen für das Inhaltsverzeichnis. Standardmäßig hat das Kapitelverzeichnis keinen Titel.

Die Optionen für das chapter-index Syntax-Tag sind die selben wie die des toc Syntax-Tags.

Diese Tags aktivieren oder deaktivieren die Link-Generierung genau so wie die zugehörige Konfigurationseinstellung. Es folgt die Syntax:

{{odt>disablelinks}}
{{odt>enablelinks}}

Diese Tag wird verwendet um eine Wiki-Seite als CSS-Template anzugeben. Das bedeutet, dass der Inhalt der Seite als CSS-Code importiert wird. Ein Beispiel:

{{odt>templatepage:mycsspage}}

Es ist vollkommen in Ordnung wenn der CSS-Code der Templatepage von <code css>…</code> Tags umgeben ist um die Lesbarkeit zu verbessern.

Diese Funktion gibt dem Anwender die Möglichkeit ein CSS-Template zu verwenden ohne ein Datei hochladen zu müssen. ACHTUNG: die Verwendung einer Templatepage kann bereits importierte Style-Einstellungen aus einer ODT- oder CSS-Template-Datei überschreiben.

Diese Tags fügen den Inhalt zwischen ihnen in einem ODT-Frame (Rahmen) ein wenn die Seite nach ODT exportiert wird. Die HTML-Ansicht bleibt unverändert. Es folgt die Syntax:

{{odt>frame-open:...options...}}
{{odt>frame-close}}

Inhalt in einen Frame/Rahmen zu setzen kann z.B. verwendet werden um den Inhalt an einer festen Position auf der Seite einzufügen. Dies kann z.B. nützlich sein um Briefe zu schreiben.

Siehe Details zur Anwendung von ODT-Frames für weitere Informationen.

: Seite anlegen, Anwendung von Frames im Detail beschreiben

Änderungen:

Aktuellstes Release:

• Updated version/plugin.info.txt.
• Merge branch 'master' of https://github.com/LarsGit223/dokuwiki-plugi…
• Fixed problems regarding CSS import and media selectors:
• Bugfix: the border width in the border shorthand property was not con…
• Update plugin.info.txt
• Merge pull request #44 from Klap-in/master
• phpdocs, unused var
• unused vars, undefined vars,phpdocs

Entwicklungs- master branch:

• Merge pull request #322 from eduardomozart/patch-7
• Fix ODTUtility.php inline file loading
• Merge pull request #317 from eduardomozart/patch-3
• Merge pull request #318 from eduardomozart/patch-4
• Merge pull request #319 from eduardomozart/patch-5
• Revert unused conf variable
• Revert PHP detect language
• Update ODTDocument.php

Release 20101030 mit Default-Template Unterstützung: dokuwiki-odt-20140210. Ältere Releases sind verfügbar auf dieser Webseite.

Dieses Plugin funktioniert mit DokuWiki 2007-06-26 und neueren Versionen.

Wenn Sie Entwickler sind und sich für die Realsierung von ODT-Unterstützung in einem Plugin interessieren, dann könnten Sie folgende Seiten interessieren:

• ODT Unterstützung implementieren
• CSSColorsHelper
• CSSImportHelper

Um Informationen zum aktuellen Entwicklung-Releases/master-Branch zu bekommen, werfen Sie einen Blick auf die development preview-Seite.

Es gibt drei Methoden um das Aussehen der Ausgabe anzupassen:

• Ändere das Export-Ergebnis der wiki:syntax Seite. Dann öffnen Sie das Ergebnis mit einem ZIP-Archivierungs-Programm und ersetzen die vorhandene styles.xml mit der aus Ihrem Dokument. Seien Sie vorsichtig, DokuWiki's Caching-System kann Ihnen dabei im Weg stehen. Denken Sie daran Ihren Cache zu löschen.
• Verwenden Sie diese OpenOffice-Funktion um Styles aus einer existierenden Datei oder einem existierendem Template zu laden:
  • exportieren Sie Ihre Seite nach ODT und öffnen Sie sie in OpenOffice,
  • rufen Sie die styles Leiste auf (F11),
  • klicken Sie auf das rechte, obere Icon,
  • wählen Sie „Load styles…“ im Menü,
  • selektieren Sie alle Optionen in der Schaltfläche (including „overwrite“),
  • klicken Sie auf „From file…“ unten Rechts und wählen Sie Ihre angepasste Datei aus, oder selektieren Sie ein existierendes Template aus der Liste.
• Verwenden Sie ein vorgefertigtes Template, schauen Sie sich den folgenden Absatz an um Details über dieses Feature zu erfahren.

Sie können Templates verwenden um Ihr Dokument zu exportieren. Eine Template ist eine reguläre ODT-Datei, so, wie Sie mit OpenOffice erstellt wurde. (Als ein Beispiel, nicht getestet mit anderen Applikationen die ODT unterstützen).

Fügen Sie folgenden Code zu Ihrer Wiki-Seite hinzu:

  {{odt>template:ihr template dateiname.odt}}

und laden Sie ihr Template in das Wiki hoch mit Hilfe des Media-Managers. Laut Voreinstellung, muss das Template in einem :odt Namensraum abgelegt werden (Dies bedeutet ein „odt“ Verzeichnis direkt unter der Wurzel des Wikis). Der Verzeichnisname kann auf der Admin-Seite konfiguriert werden.

Die exportierte Seite wird hinter dem Inhalt Ihres Templates angehängt werden. Wenn Sie die Zeichenkette DOKUWIKI-ODT-INSERT in Ihrem Dokument einbauen, wird die Wikiseite genau an der Stelle eingefügt (als Ersatz für die Zeichenkette).

Warnung : die DOKUWIKI-ODT-INSERT Zeichenkette DARF NICHT in irgendeiner Weise formatiert werden. Um dies zu garantieren, selektieren Sie die Zeile mit der Zeichenkette, gehen in das Format-Menü, und klicken auf die „Direkte Formatierung löschen“ (der Oberste Eintrag).

Es gibt zwei weitere Tags die Sie in Ihrem Template verwenden können: DOKUWIKI-ODT-CUT-START und DOKUWIKI-ODT-CUT-STOP. Der gesammte Text zwischen diesen beiden Tags wird beim Export gelöscht. Es gibt einen guten Grund für diese Funkion: in einer ODT-Datei werden nur die Styles gespeichert, die auch auf einem Inhalt im Dokument angewendet wurden, d.h. alle nicht verwendeten Styles werden gelöscht. Wenn Sie ein leeres ODT-Dokument für dieses Plugin anlegen möchten und trotzdem Styles definieren möchten, die auf den Wiki-Inhalt angewendet werden sollen, müssen Sie einen Dummy-Text bzw. Blindtext schreiben, die Styles auf diesen Text anwenden und den Text mit den Tags DOKUWIKI-ODT-CUT-START und DOKUWIKI-ODT-CUT-STOP einschliessen. Auf diese Art bleiben die Styles in der ODT-Datei enthalten aber der Blindtext wird beim Export entfernt.

Sie können Templates verwenden um Ihr Dokument zu exportieren. Ein CSS-Template ist eine reguläre CSS-Textdatei. Fügen Sie folgenden Code auf Ihrer Wiki-Seite ein:

  {{odt>template:your template file name.css}}

und laden Sie Ihr Template mit Hilfe des Media-Managers hoch. Dies erfordert normalerweise die Konfiguration der Mime-Types welche beim Hochladen von Dateien erlaubt werden, siehe mime. Standardmäßig müssen Sie ein :odt Namespace anlegen (Also ein Unterverzeichnis „odt“ direkt unter dem Hauptverzeichis ihres Wikis). Der Verzeichnisname kann konfiguriert werden.

Anders als bei einem ODT-Template erzeugt ein CSS-Template keinen Inhalt im exportierten Dokument. Es steuert nur die Styles/das Aussehen für die DokuWiki-Basic-Syntax.

Werfen Sie einen Blick auf die Datei example.css im ODT-Plugin-Verzeichnis um einen Überblick über die aktuell unterstützten Optionen zu bekommen, die angewendet werden können um das Aussehen des exportierten ODT-Dokumentes zu verändern.

Seit Release-Version 2016-04-23 kann ein CSS-Template auch aus einer Wiki-Seite bestehen. Siehe Abschnitt templatepage für Details.

Seit Release-Version 2016-04-23 wird optional eine PDF-Konvertierung unterstützt. Die exportierte ODT-Datei kann nach PDF konvertiert werden indem do=export_odt_pdf statt do=export_odt verwendet wird. Die Funktion benötigt die Installation eines externen Programms welches die Konvertierung durchführt, z.B. LibreOffice. Die Befehlszeile zum Durchführen der Konvertierung kann konfiguriert werden. Ein Fehlerbericht wird angezeigt, falls die Konvertierung fehlschlägt.

Wenn LibreOffice für die PDF-Konvertierung verwendet wird, kann es zu folgender Fehlermeldung kommen wenn versucht wird ein ODT-Dokument im PDF-Format herunterzuladen:

[Java framework] Error in function createSettingsDocument (elements.cxx). javaldx failed! Warning: failed to read path from javaldx

In diesem Fall versagt LibreOffice weil es kein Konfigurationsverzeichnis hat welches zum webserver/PHP user gehört oder nicht von selbigem lesen kann.

Auf meinem Ubuntu-PC wurde der Webserver-User www-data verwendet, das home Verzeichnis war /var/www und das Konfigurationsverzeichis für LibreOffice war .config/libreoffice. Also musste ich das Verzeichnis /var/www/.config/libreoffice anlegen und den Besitzen auf www-data setzen um es ans Laufen zu bekommen.

Wenn Sie andere Syntax-Plugins verwenden, kann es vorkommen das ihre Ausgabe nicht im exportierten ODT-Dokument erscheint: diese Plugins müssen erst modifiziert werden um das ODT-Ausgabeformat zu unterstützen. Einige Plugins unterstützen es bereits.

Die Seite ODT render support zeigt eine Liste der Plugins die bereits den Export ins ODT-Format unterstützen. Auf der Seite können Sie auch Plugins hinzufügen für die Sie sich ODT-Unterstützung wünschen würden.

Das Plugin wurde übersetzt in Englisch, Deutsch, Dänisch, Französisch, Koreanisch, Holländisch und Japanisch. Vielen Dank an die Übersetzer, neue Sprachen sind herzlich willkommen!

Bitte das Translation Tool verwenden.

Um Bugs zu melden oder Funktionen vorzuschlagen, verwenden Sie bitte GitHub Issues. Der Autor überwacht diese Seite nicht.

Um Bugs zu melden oder Funktionen vorzuschlagen, verwenden Sie bitte GitHub Issues. Der Autor überwacht diese Seite nicht.