Merge branch 'master' into after-262
[kivitendo-erp.git] / doc / INSTALL / OpenDocument_002dVorlagen.html
1 <html lang="en">
2 <head>
3 <title>OpenDocument-Vorlagen - Lx-Office Installationsanleitung</title>
4 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5 <meta name="description" content="Lx-Office Installationsanleitung">
6 <meta name="generator" content="makeinfo 4.11">
7 <link title="Top" rel="start" href="index.html#Top">
8 <link rel="prev" href="Benutzer_002d-und-Gruppenverwaltung.html#Benutzer_002d-und-Gruppenverwaltung" title="Benutzer- und Gruppenverwaltung">
9 <link rel="next" href="Lx_002dOffice-ERP-verwenden.html#Lx_002dOffice-ERP-verwenden" title="Lx-Office ERP verwenden">
10 <link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
11 <meta http-equiv="Content-Style-Type" content="text/css">
12 <style type="text/css"><!--
13   pre.display { font-family:inherit }
14   pre.format  { font-family:inherit }
15   pre.smalldisplay { font-family:inherit; font-size:smaller }
16   pre.smallformat  { font-family:inherit; font-size:smaller }
17   pre.smallexample { font-size:smaller }
18   pre.smalllisp    { font-size:smaller }
19   span.sc    { font-variant:small-caps }
20   span.roman { font-family:serif; font-weight:normal; } 
21   span.sansserif { font-family:sans-serif; font-weight:normal; } 
22 --></style>
23 </head>
24 <body>
25 <div class="node">
26 <p>
27 <a name="OpenDocument-Vorlagen"></a>
28 <a name="OpenDocument_002dVorlagen"></a>
29 n&auml;chstes:&nbsp;<a rel="next" accesskey="n" href="Lx_002dOffice-ERP-verwenden.html#Lx_002dOffice-ERP-verwenden">Lx-Office ERP verwenden</a>,
30 voriges:&nbsp;<a rel="previous" accesskey="p" href="Benutzer_002d-und-Gruppenverwaltung.html#Benutzer_002d-und-Gruppenverwaltung">Benutzer- und Gruppenverwaltung</a>,
31 aufw&auml;rts:&nbsp;<a rel="up" accesskey="u" href="index.html#Top">Top</a>
32 <hr>
33 </div>
34
35 <h2 class="chapter">8 OpenDocument-Vorlagen</h2>
36
37 <p>Lx-Office unterstützt die Verwendung von Vorlagen im
38 OpenDocument-Format, wie es OpenOffice.org ab Version 2
39 erzeugt. Lx-Office kann dabei sowohl neue OpenDocument-Dokumente als
40 auch aus diesen direkt PDF-Dateien erzeugen.  Um die Unterstützung von
41 OpenDocument-Vorlagen zu aktivieren muss in der Datei
42 <code>config/lx_office.conf</code> die Variable <code>opendocument</code> im
43 Abschnitt <code>print_templates</code> auf &lsquo;<samp><span class="samp">1</span></samp>&rsquo; stehen.  Dieses ist die
44 Standardeinstellung.
45
46    <p>Weiterhin muss in der Datei <code>config/lx_office.conf</code> die Variable
47 <code>dbcharset</code> im Abschnitt <code>system</code> auf die Zeichenkodierung
48 gesetzt werden, die auch bei der Speicherung der Daten in der
49 Datenbank verwendet wird. Diese ist in den meisten Fällen "UTF-8".
50
51    <p>Während die Erzeugung von reinen OpenDocument-Dateien keinerlei
52 weitere Software benötigt, wird zur Umwandlung dieser Dateien in PDF
53 OpenOffice.org benötigt. Soll dieses Feature genutzt werden, so muss
54 neben OpenOffice.org ab Version 2 auch der &ldquo;X virtual frame buffer&rdquo;
55 (xvfb) installiert werden.  Bei Debian ist er im Paket &ldquo;xvfb&rdquo;
56 enthalten. Andere Distributionen enthalten ihn in anderen Paketen.
57
58    <p>Nach der Installation müssen in der Datei <code>config/lx_config.conf</code>
59 zwei weitere Variablen angepasst werden: <code>openofficeorg_writer</code>
60 muss den vollständigen Pfad zur OpenOffice.org Writer-Anwendung
61 enthalten. <code>xvfb</code> muss den Pfad zum &ldquo;X virtual frame buffer&rdquo;
62 enthalten. Beide stehen im Abschnitt <code>applications</code>.
63
64    <p>Zusätzlich gibt es zwei verschiedene Arten, wie Lx-Office mit
65 OpenOffice kommuniziert. Die erste Variante, die benutzt wird, wenn
66 die Variable <code>$openofficeorg_daemon</code> gesetzt ist, startet ein
67 OpenOffice, das auch nach der Umwandlung des Dokumentes gestartet
68 bleibt. Bei weiteren Umwandlungen wird dann diese laufende Instanz
69 benutzt. Der Vorteil ist, dass die Zeit zur Umwandlung deutlich
70 reduziert wird, weil nicht für jedes Dokument ein OpenOffice gestartet
71 werden muss. Der Nachteil ist, dass diese Methode Python und die
72 Python-UNO-Bindings benötigt, die Bestandteil von OpenOffice 2 sind.
73
74    <p>Ist <code>$openofficeorg_daemon</code> nicht gesetzt, so wird für jedes
75 Dokument OpenOffice neu gestartet und die Konvertierung mit Hilfe
76 eines Makros durchgeführt. Dieses Makro muss in der Dokumentenvorlage
77 enthalten sein und &ldquo;Standard.Conversion.ConvertSelfToPDF()&rdquo;
78 heißen. Die Beispielvorlage &lsquo;<samp><span class="samp">templates/German-invoice.odt</span></samp>&rsquo;
79 enthält ein solches Makro, das in jeder anderen Dokumentenvorlage
80 ebenfalls enthalten sein muss.
81
82    <p>Als letztes muss herausgefunden werden, welchen Namen OpenOffice.org
83 Writer dem Verzeichnis mit den Benutzereinstellungen gibt. Unter
84 Debian ist dies momentan <code>~/.openoffice.org2</code>. Sollte der Name
85 bei Ihrer OpenOffice.org-Installation anders sein, so muss das
86 Verzeichnis <code>users/.openoffice.org2</code> entsprechend umbenannt
87 werden. Ist der Name z.B. einfach nur <code>.openoffice</code>, so wäre
88 folgender Befehl auszuführen:
89
90    <p><code>mv users/.openoffice.org2 users/.openoffice</code>
91
92    <p>Dieses Verzeichnis, wie auch das komplette <code>users</code>-Verzeichnis, muss vom
93 Webserver beschreibbar sein. Dieses wurde bereits erledigt
94 (siehe <a href="Manuelle-Installation-des-Programmpaketes.html#Manuelle-Installation-des-Programmpaketes">Manuelle Installation des Programmpaketes</a>), kann aber erneut überprüft
95 werden, wenn die Konvertierung nach PDF fehlschlägt.
96
97 <!--  -->
98    </body></html>
99