doc/html/ch02s13.html

   1 <html><head>
   2       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   3    <title>2.13. OpenDocument-Vorlagen</title><link rel="stylesheet" type="text/css" href="style.css"><meta name="generator" content="DocBook XSL Stylesheets V1.76.1-RC2"><link rel="home" href="index.html" title="kivitendo 3.1.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s12.html" title="2.12. Drucken mit kivitendo"><link rel="next" href="ch02s14.html" title="2.14. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung: EUR"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">2.13. OpenDocument-Vorlagen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s12.html">Zurück</a>&nbsp;</td><th width="60%" align="center">Kapitel 2. Installation und Grundkonfiguration</th><td width="20%" align="right">&nbsp;<a accesskey="n" href="ch02s14.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.13. OpenDocument-Vorlagen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="OpenDocument-Vorlagen"></a>2.13. OpenDocument-Vorlagen</h2></div></div></div><p>kivitendo unterstützt die Verwendung von Vorlagen im
   4       OpenDocument-Format, wie es OpenOffice.org ab Version 2 erzeugt.
   5       kivitendo kann dabei sowohl neue OpenDocument-Dokumente als auch aus
   6       diesen direkt PDF-Dateien erzeugen. Um die Unterstützung von
   7       OpenDocument-Vorlagen zu aktivieren muss in der Datei
   8       <code class="filename">config/kivitendo.conf</code> die Variable
   9       <code class="literal">opendocument</code> im Abschnitt
  10       <code class="literal">print_templates</code> auf ‘<code class="literal">1</code>’ stehen.
  11       Dieses ist die Standardeinstellung.</p><p>Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
  12       weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
  13       OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss
  14       neben OpenOffice.org ab Version 2 auch der “X virtual frame buffer”
  15       (xvfb) installiert werden. Bei Debian ist er im Paket “xvfb” enthalten.
  16       Andere Distributionen enthalten ihn in anderen Paketen.</p><p>Nach der Installation müssen in der Datei
  17       <code class="filename">config/kivitendo.conf</code> zwei weitere Variablen
  18       angepasst werden: <code class="literal">openofficeorg_writer</code> muss den
  19       vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.
  20       <code class="literal">xvfb</code> muss den Pfad zum “X virtual frame buffer”
  21       enthalten. Beide stehen im Abschnitt
  22       <code class="literal">applications</code>.</p><p>Zusätzlich gibt es zwei verschiedene Arten, wie kivitendo mit
  23       OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die
  24       Variable <code class="literal">$openofficeorg_daemon</code> gesetzt ist, startet
  25       ein OpenOffice, das auch nach der Umwandlung des Dokumentes gestartet
  26       bleibt. Bei weiteren Umwandlungen wird dann diese laufende Instanz
  27       benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung deutlich
  28       reduziert wird, weil nicht für jedes Dokument ein OpenOffice gestartet
  29       werden muss. Der Nachteil ist, dass diese Methode Python und die
  30       Python-UNO-Bindings benötigt, die Bestandteil von OpenOffice 2
  31       sind.</p><div class="note" title="Anmerkung" style="margin-left: 0.5in; margin-right: 0.5in;"><table border="0" summary="Note"><tr><td rowspan="2" align="center" valign="top" width="25"><img alt="[Anmerkung]" src="system/docbook-xsl/images/note.png"></td><th align="left">Anmerkung</th></tr><tr><td align="left" valign="top"><p>
  32           Für die Verbindung zu OpenOffice wird normalerweise der Python-Interpreter <code class="filename">/usr/bin/python</code> benutzt. Sollte
  33           dies nicht der richtige sein, so kann man mit zwei Konfigurationsvariablen entscheiden, welcher Python-Interpreter genutzt
  34           wird. Mit der Option <code class="literal">python_uno</code> aus dem Abschnitt <code class="literal">applications</code> wird der Interpreter selber
  35           festgelegt; sie steht standardmäßig auf dem eben erwähnten Wert <code class="literal">/usr/bin/python</code>.
  36         </p><p>
  37           Zusätzlich ist es möglich, Pfade anzugeben, in denen Python neben seinen normalen Suchpfaden ebenfalls nach Modulen gesucht wird,
  38           z.B. falls sich diese in einem gesonderten OpenOffice-Verzeichnis befinden. Diese zweite Variable heißt
  39           <code class="literal">python_uno_path</code> und befindet sich im Abschnitt <code class="literal">environment</code>. Sie ist standardmäßig
  40           leer. Werden hier mehrere Pfade angegeben, so müssen diese durch Doppelpunkte voneinander getrennt werden. Der Inhalt wird an den
  41           Python-Interpreter über die Umgebungsvariable <code class="literal">PYTHONPATH</code> übergeben.
  42         </p></td></tr></table></div><p>Ist <code class="literal">$openofficeorg_daemon</code> nicht gesetzt, so
  43       wird für jedes Dokument OpenOffice neu gestartet und die Konvertierung
  44       mit Hilfe eines Makros durchgeführt. Dieses Makro muss in der
  45       Dokumentenvorlage enthalten sein und
  46       “Standard.Conversion.ConvertSelfToPDF()” heißen. Die Beispielvorlage
  47       ‘<code class="literal">templates/mastertemplates/German/invoice.odt</code>’
  48       enthält ein solches Makro, das in jeder anderen Dokumentenvorlage
  49       ebenfalls enthalten sein muss.</p><p>Als letztes muss herausgefunden werden, welchen Namen
  50       OpenOffice.org Writer dem Verzeichnis mit den Benutzereinstellungen
  51       gibt. Unter Debian ist dies momentan
  52       <code class="literal">~/.openoffice.org2</code>. Sollte der Name bei Ihrer
  53       OpenOffice.org-Installation anders sein, so muss das Verzeichnis
  54       <code class="literal">users/.openoffice.org2</code> entsprechend umbenannt werden.
  55       Ist der Name z.B. einfach nur <code class="literal">.openoffice</code>, so wäre
  56       folgender Befehl auszuführen:</p><p>
  57             <code class="literal">mv users/.openoffice.org2
  58       users/.openoffice</code>
  59          </p><p>Dieses Verzeichnis, wie auch das komplette
  60       <code class="literal">users</code>-Verzeichnis, muss vom Webserver beschreibbar
  61       sein. Dieses wurde bereits erledigt (siehe <a class="xref" href="ch02s03.html" title="2.3. Manuelle Installation des Programmpaketes">Manuelle Installation des Programmpaketes</a>), kann aber
  62       erneut überprüft werden, wenn die Konvertierung nach PDF
  63       fehlschlägt.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s12.html">Zurück</a>&nbsp;</td><td width="20%" align="center"><a accesskey="u" href="ch02.html">Nach oben</a></td><td width="40%" align="right">&nbsp;<a accesskey="n" href="ch02s14.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.12. Drucken mit kivitendo&nbsp;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Zum Anfang</a></td><td width="40%" align="right" valign="top">&nbsp;2.14. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung:
  64       EUR</td></tr></table></div></body></html>