0c91c701208821edb5130176ce82c9670d1d4a43
[kivitendo-erp.git] / 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.3.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>