Sonderbehandlung im template
[kivitendo-erp.git] / 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>