doc/html/ch02s12.html

   1 <html><head>
   2       <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
   3    <title>2.12. 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.0.0: Installation, Konfiguration, Entwicklung"><link rel="up" href="ch02.html" title="Kapitel 2. Installation und Grundkonfiguration"><link rel="prev" href="ch02s11.html" title="2.11. Drucken mit kivitendo"><link rel="next" href="ch02s13.html" title="2.13. 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.12. OpenDocument-Vorlagen</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="ch02s11.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="ch02s13.html">Weiter</a></td></tr></table><hr></div><div class="sect1" title="2.12. OpenDocument-Vorlagen"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="OpenDocument-Vorlagen"></a>2.12. 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>Weiterhin muss in der Datei
  12       <code class="filename">config/kivitendo.conf</code> die Variable
  13       <code class="literal">dbcharset</code> im Abschnitt <code class="literal">system</code> auf
  14       die Zeichenkodierung gesetzt werden, die auch bei der Speicherung der
  15       Daten in der Datenbank verwendet wird. Diese ist in den meisten Fällen
  16       "UTF-8".</p><p>Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
  17       weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
  18       OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss
  19       neben OpenOffice.org ab Version 2 auch der “X virtual frame buffer”
  20       (xvfb) installiert werden. Bei Debian ist er im Paket “xvfb” enthalten.
  21       Andere Distributionen enthalten ihn in anderen Paketen.</p><p>Nach der Installation müssen in der Datei
  22       <code class="filename">config/kivitendo.conf</code> zwei weitere Variablen
  23       angepasst werden: <code class="literal">openofficeorg_writer</code> muss den
  24       vollständigen Pfad zur OpenOffice.org Writer-Anwendung enthalten.
  25       <code class="literal">xvfb</code> muss den Pfad zum “X virtual frame buffer”
  26       enthalten. Beide stehen im Abschnitt
  27       <code class="literal">applications</code>.</p><p>Zusätzlich gibt es zwei verschiedene Arten, wie kivitendo mit
  28       OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn die
  29       Variable <code class="literal">$openofficeorg_daemon</code> gesetzt ist, startet
  30       ein OpenOffice, das auch nach der Umwandlung des Dokumentes gestartet
  31       bleibt. Bei weiteren Umwandlungen wird dann diese laufende Instanz
  32       benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung deutlich
  33       reduziert wird, weil nicht für jedes Dokument ein OpenOffice gestartet
  34       werden muss. Der Nachteil ist, dass diese Methode Python und die
  35       Python-UNO-Bindings benötigt, die Bestandteil von OpenOffice 2
  36       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>
  37           Für die Verbindung zu OpenOffice wird normalerweise der Python-Interpreter <code class="filename">/usr/bin/python</code> benutzt. Sollte
  38           dies nicht der richtige sein, so kann man mit zwei Konfigurationsvariablen entscheiden, welcher Python-Interpreter genutzt
  39           wird. Mit der Option <code class="literal">python_uno</code> aus dem Abschnitt <code class="literal">applications</code> wird der Interpreter selber
  40           festgelegt; sie steht standardmäßig auf dem eben erwähnten Wert <code class="literal">/usr/bin/python</code>.
  41         </p><p>
  42           Zusätzlich ist es möglich, Pfade anzugeben, in denen Python neben seinen normalen Suchpfaden ebenfalls nach Modulen gesucht wird,
  43           z.B. falls sich diese in einem gesonderten OpenOffice-Verzeichnis befinden. Diese zweite Variable heißt
  44           <code class="literal">python_uno_path</code> und befindet sich im Abschnitt <code class="literal">environment</code>. Sie ist standardmäßig
  45           leer. Werden hier mehrere Pfade angegeben, so müssen diese durch Doppelpunkte voneinander getrennt werden. Der Inhalt wird an den
  46           Python-Interpreter über die Umgebungsvariable <code class="literal">PYTHONPATH</code> übergeben.
  47         </p></td></tr></table></div><p>Ist <code class="literal">$openofficeorg_daemon</code> nicht gesetzt, so
  48       wird für jedes Dokument OpenOffice neu gestartet und die Konvertierung
  49       mit Hilfe eines Makros durchgeführt. Dieses Makro muss in der
  50       Dokumentenvorlage enthalten sein und
  51       “Standard.Conversion.ConvertSelfToPDF()” heißen. Die Beispielvorlage
  52       ‘<code class="literal">templates/mastertemplates/German/invoice.odt</code>’
  53       enthält ein solches Makro, das in jeder anderen Dokumentenvorlage
  54       ebenfalls enthalten sein muss.</p><p>Als letztes muss herausgefunden werden, welchen Namen
  55       OpenOffice.org Writer dem Verzeichnis mit den Benutzereinstellungen
  56       gibt. Unter Debian ist dies momentan
  57       <code class="literal">~/.openoffice.org2</code>. Sollte der Name bei Ihrer
  58       OpenOffice.org-Installation anders sein, so muss das Verzeichnis
  59       <code class="literal">users/.openoffice.org2</code> entsprechend umbenannt werden.
  60       Ist der Name z.B. einfach nur <code class="literal">.openoffice</code>, so wäre
  61       folgender Befehl auszuführen:</p><p>
  62             <code class="literal">mv users/.openoffice.org2
  63       users/.openoffice</code>
  64          </p><p>Dieses Verzeichnis, wie auch das komplette
  65       <code class="literal">users</code>-Verzeichnis, muss vom Webserver beschreibbar
  66       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
  67       erneut überprüft werden, wenn die Konvertierung nach PDF
  68       fehlschlägt.</p></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="ch02s11.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="ch02s13.html">Weiter</a></td></tr><tr><td width="40%" align="left" valign="top">2.11. 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.13. Konfiguration zur Einnahmenüberschussrechnung/Bilanzierung:
  69       EUR</td></tr></table></div></body></html>