Revision 45ff2497
Von Bernd Bleßmann vor fast 10 Jahren hinzugefügt
| doc/dokumentation.xml | ||
|---|---|---|
| 1408 | 1408 |
<title>Drucken mit kivitendo</title> |
| 1409 | 1409 |
|
| 1410 | 1410 |
<para>Das Drucksystem von kivitendo benutzt von Haus aus LaTeX-Vorlagen. Um drucken zu können, braucht der Server ein geeignetes |
| 1411 |
LaTeX System. Am einfachsten ist dazu eine <literal>texlive</literal> Installation. Unter Debianoiden Betriebssystemen installiert man
|
|
| 1411 |
LaTeX System. Am einfachsten ist dazu eine <literal>texlive</literal> Installation. Unter debianoiden Betriebssystemen installiert man
|
|
| 1412 | 1412 |
die Pakete mit:</para> |
| 1413 | 1413 |
|
| 1414 | 1414 |
<para><programlisting>aptitude install texlive-base-bin texlive-latex-recommended texlive-fonts-recommended \ |
| ... | ... | |
| 1446 | 1446 |
|
| 1447 | 1447 |
<para>Nach dem Speichern wird das Vorlagenverzeichnis angelegt und ist für den aktuellen Mandanten ausgewählt. |
| 1448 | 1448 |
Der gleiche Vorlagensatz kann, wenn er mal angelegt ist, bei mehreren Mandanten verwendet werden. |
| 1449 |
Eventuell muessen Anpassungen (Logo, Erscheinungsbild, etc) noch vorgenommen werden. Den Ordner findet man im Dateisistem unter
|
|
| 1449 |
Eventuell müssen Anpassungen (Logo, Erscheinungsbild, etc) noch vorgenommen werden. Den Ordner findet man im Dateisystem unter
|
|
| 1450 | 1450 |
<filename>./templates/[Neuer Name]</filename></para> |
| 1451 | 1451 |
|
| 1452 | 1452 |
|
| ... | ... | |
| 1468 | 1468 |
<title>Feature-Übersicht</title> |
| 1469 | 1469 |
<itemizedlist> |
| 1470 | 1470 |
<listitem><para>Keine Redundanz. Es wird ein- und dieselbe LaTeX-Vorlage für alle briefartigen Dokumente verwendet. Also |
| 1471 |
Angebot, Rechnung, Performarechnung, Lieferschein, aber eben nicht für Paketaufkleber etc..</para></listitem>
|
|
| 1471 |
Angebot, Rechnung, Proformarechnung, Lieferschein, aber eben nicht für Paketaufkleber etc..</para></listitem>
|
|
| 1472 | 1472 |
|
| 1473 | 1473 |
<listitem><para>Leichte Anpassung an das Firmen-Layout durch verwendung eines Hintergrund-PDF. Dieses kann leicht mit dem |
| 1474 | 1474 |
eigenen Lieblingsprogramm erstellt werden (Openoffice, Inkscape, Gimp, Adobe*)</para></listitem> |
| ... | ... | |
| 1503 | 1503 |
<listitem><para>Editiere den Bereich "<option>settings</option>" in der datei <filename>letter.lco</filename>.</para></listitem> |
| 1504 | 1504 |
</itemizedlist> |
| 1505 | 1505 |
|
| 1506 |
<para>oder etwas Detaillierter:</para>
|
|
| 1506 |
<para>oder etwas detaillierter:</para>
|
|
| 1507 | 1507 |
|
| 1508 | 1508 |
<para> |
| 1509 | 1509 |
Es wird eine Datei <filename>sample.lco</filename> erstellt und diese nach <filename>letter.lco</filename> verlinkt. Eigentlich |
| 1510 |
ist dies die Datei die für die Firmenspezifischen Anpassungen gedacht ist. Da die Einstiegshürde in LaTeX nicht ganz niedrig
|
|
| 1511 |
ist, wird in dieser Datei auf ein Hintergrundpdf verwiesen. Ich empfehle über dieses PDF die persönlichen Layoutanpassungen
|
|
| 1512 |
vorzunehmen und <filename>sample.lco</filename> unverändert zu lassen. Die die Anpassung über eine
|
|
| 1513 |
<filename>*.lco</filename>-Datei die letztlich auf <filename>letter.lco</filename> verlinkt ist ist aber auch möglich. |
|
| 1510 |
ist dies die Datei die für die firmenspezifischen Anpassungen gedacht ist. Da die Einstiegshürde in LaTeX nicht ganz niedrig
|
|
| 1511 |
ist, wird in dieser Datei auf ein Hintergrund-PDF verwiesen. Ich empfehle über dieses PDF die persönlichen Layoutanpassungen
|
|
| 1512 |
vorzunehmen und <filename>sample.lco</filename> unverändert zu lassen. Die Anpassung über eine |
|
| 1513 |
<filename>*.lco</filename>-Datei, die letztlich auf <filename>letter.lco</filename> verlinkt ist ist aber auch möglich.
|
|
| 1514 | 1514 |
</para> |
| 1515 | 1515 |
|
| 1516 | 1516 |
<para> |
| 1517 | 1517 |
Es wird eine Datei <filename>sample_head.pdf</filename> mit ausgeliefert, diese wird nach <filename>letter_head.pdf</filename> |
| 1518 |
verlinkt. Damit gibt es schon mal eine Funktionsfähige Vorlage. Schau Dir nach Abschluss der Installation die Datei
|
|
| 1519 |
<filename>sample_haed.pdf</filename> an und erstelle ein entsprechendes PDF passend zum Briefkopf Deiner Firma, diese dann im
|
|
| 1518 |
verlinkt. Damit gibt es schon mal eine funktionsfähige Vorlage. Schau Dir nach Abschluss der Installation die Datei
|
|
| 1519 |
<filename>sample_head.pdf</filename> an und erstelle ein entsprechendes PDF passend zum Briefkopf Deiner Firma, diese dann im
|
|
| 1520 | 1520 |
Template Verzeichniss ablegen und statt <filename>sample_head.pdf</filename> nach <filename>letter_head.pdf</filename> |
| 1521 | 1521 |
verlinken. |
| 1522 | 1522 |
</para> |
| 1523 | 1523 |
|
| 1524 | 1524 |
<para> |
| 1525 |
letzlich muss <filename>letter_head.pdf</filename> auf das passende Hintergrund-PDF verweisen, welches gewünschten Briefkopf
|
|
| 1526 |
enthält. Bei Updates oder nach erneutem
|
|
| 1525 |
Letzlich muss <filename>letter_head.pdf</filename> auf das passende Hintergrund-PDF verweisen, welches gewünschten Briefkopf
|
|
| 1526 |
enthält. |
|
| 1527 | 1527 |
</para> |
| 1528 | 1528 |
|
| 1529 | 1529 |
<para> |
| 1530 | 1530 |
Es wird eine Datei <filename>mydata.tex.example</filename> ausgeliefert, die nach <filename>mytdata.tex</filename> verlinkt |
| 1531 | 1531 |
ist. Bei verwendetem Hintergrund-PDF wird nur der Eintrag für das Land verwendet. Die Datei muss also nicht angefasst |
| 1532 |
werden. Die Anderen Werte sind für das Modul 'lp' (Label Print in erp - zur Zeit nicht im öffentlichen Zweig).
|
|
| 1532 |
werden. Die anderen Werte sind für das Modul 'lp' (Label Print in erp - zur Zeit nicht im öffentlichen Zweig).
|
|
| 1533 | 1533 |
</para> |
| 1534 | 1534 |
<para> |
| 1535 | 1535 |
Alle Anpassungen zum Briefkopf, Fusszeilen, Firmenlogos, etc. sollten über die Hintergrund-PDF-Datei oder die |
| ... | ... | |
| 1541 | 1541 |
<title>f-tex Funktionsübersicht</title> |
| 1542 | 1542 |
<para> |
| 1543 | 1543 |
Das Konzept von kivitendo sieht vor, für jedes Dokument (Auftragsbestätigung, Lieferschein, Rechnung, etc.) eine LaTeX-Vorlage |
| 1544 |
vorzuhalten, dies ist sehr Wartungsunfreundlich. Auch das Einlesen einer einheitlichen Quelle für den Briefkopf bringt nur
|
|
| 1544 |
vorzuhalten, dies ist sehr wartungsunfreundlich. Auch das Einlesen einer einheitlichen Quelle für den Briefkopf bringt nur
|
|
| 1545 | 1545 |
bedingte Vorteile, da hier leicht die Pflege der Artikel-Tabellen aus dem Ruder läuft. Bei dem vorliegenden Ansatz wird für alle |
| 1546 | 1546 |
briefartigen Dokumente mit Artikel-Tabellen eine einheitliche LaTeX-Vorlage verwendet, welche über Codeweichen die |
| 1547 |
Besonderheiten der jeweiligen Dokumente Berücksichtigt.
|
|
| 1547 |
Besonderheiten der jeweiligen Dokumente berücksichtigt:
|
|
| 1548 | 1548 |
</para> |
| 1549 | 1549 |
|
| 1550 | 1550 |
<itemizedlist> |
| 1551 | 1551 |
<listitem><para>Tabellen mit oder ohne Preis</para></listitem> |
| 1552 | 1552 |
<listitem><para>Sprache der Tabellenüberschriften etc.</para></listitem> |
| 1553 | 1553 |
<listitem><para>Anpassung der Bezugs-Zeile (z.B. Rechnungsnummer versus Angebotsnummer)</para></listitem> |
| 1554 |
<listitem><para>Darstellung von Brutto oder Netto-Preisen in der Auflistung (Endverbraucher versus Gewerblicher
|
|
| 1554 |
<listitem><para>Darstellung von Brutto oder Netto-Preisen in der Auflistung (Endverbraucher versus gewerblicher
|
|
| 1555 | 1555 |
Kunde)</para></listitem> |
| 1556 | 1556 |
</itemizedlist> |
| 1557 | 1557 |
|
| ... | ... | |
| 1561 | 1561 |
LaTeX hat ohnehin eine sehr steile Lehrnkurve. Die Datei <filename>letter.tex</filename> ist sehr komplex und verstärkt damit |
| 1562 | 1562 |
diesen Effekt noch einmal erheblich. Wer LaTeX-Erfahrung hat, oder geübt ist Scriptsparachen nachzuvollziehen kann natürlich |
| 1563 | 1563 |
auch innerhalb der Tabellendarstellung gut persönliche Anpassungen vornehmen. Aber man kann sich hier bei Veränderungen sehr |
| 1564 |
schnell häftig in den Fuss schiessen.
|
|
| 1564 |
schnell heftig in den Fuss schiessen.
|
|
| 1565 | 1565 |
</para> |
| 1566 | 1566 |
|
| 1567 |
<para>Wer nicht so tief in die Materie einsteigen will oder leicht zu frustrieren ist, sollte sein Hintergrund PDF auf Basis der
|
|
| 1568 |
mitglieferten Datei <filename>sample_head.pdf</filename> erstellen, und sich an der Form der dargestellten Tabellen wie sie |
|
| 1567 |
<para>Wer nicht so tief in die Materie einsteigen will oder leicht zu frustrieren ist, sollte sein Hintergrund-PDF auf Basis der
|
|
| 1568 |
mitglieferten Datei <filename>sample_head.pdf</filename> erstellen, und sich an der Form der dargestellten Tabellen, wie sie
|
|
| 1569 | 1569 |
ausgeliefert werden, erfreuen. |
| 1570 | 1570 |
</para> |
| 1571 | 1571 |
|
| 1572 |
<para>Kleiner Tipp: Nicht zu viel auf einmal wollen, lieber kleine kontinuierliche Schritte gehen.</para> |
|
| 1572 |
<para>Kleiner Tipp: Nicht zu viel auf einmal wollen, lieber kleine, kontinuierliche Schritte gehen.</para>
|
|
| 1573 | 1573 |
|
| 1574 | 1574 |
</sect3> |
| 1575 | 1575 |
|
| ... | ... | |
| 1584 | 1584 |
Zuordung einer Default-Preisgruppe handhaben)</para> |
| 1585 | 1585 |
</listitem> |
| 1586 | 1586 |
<listitem> |
| 1587 |
<para>man darf beim Anlegen des Vorgangs nicht vergessen Dieses Häkchen zu setzen. (das ist in der Praxis wenn man sowohl
|
|
| 1588 |
Endverbraucher- wie Gewerbekunden beliefert der eigentliche Knackpunkt)</para>
|
|
| 1587 |
<para>man darf beim Anlegen des Vorgangs nicht vergessen, dieses Häkchen zu setzen. (Das ist in der Praxis, wenn man sowohl
|
|
| 1588 |
Endverbraucher als auch Gewerbekunden beliefert, der eigentliche Knackpunkt)</para>
|
|
| 1589 | 1589 |
</listitem> |
| 1590 | 1590 |
</itemizedlist> |
| 1591 | 1591 |
|
| ... | ... | |
| 1596 | 1596 |
an (einmal mit der Namensendung "_E"). Gewinn:</para> |
| 1597 | 1597 |
|
| 1598 | 1598 |
<itemizedlist> |
| 1599 |
<listitem><para>Die Entscheidung, ob Netopreise ausgewiesen werden, ist nicht mehr fix mit einer Preisliste Verbunden.</para></listitem>
|
|
| 1599 |
<listitem><para>Die Entscheidung, ob Netopreise ausgewiesen werden, ist nicht mehr fix mit einer Preisliste verbunden.</para></listitem>
|
|
| 1600 | 1600 |
<listitem><para>Die Default-Zahlart kann im Kundendatensatz hinterlegt werden, und man muss nicht mehr daran denken, "alle Preise |
| 1601 | 1601 |
Netto" auszuwählen.</para></listitem> |
| 1602 |
<listitem><para>Die Entscheidung, ob Netto- oder Bruttopreise ausgewiesen werden, kann direkt beim Drucken reviediert werden,
|
|
| 1602 |
<listitem><para>Die Entscheidung, ob Netto- oder Bruttopreise ausgewiesen werden, kann direkt beim Drucken revidiert werden, |
|
| 1603 | 1603 |
ohne dass sich der Auftragswert ändert.</para></listitem> |
| 1604 | 1604 |
</itemizedlist> |
| 1605 | 1605 |
</sect3> |
| ... | ... | |
| 1627 | 1627 |
|
| 1628 | 1628 |
<sect2 id="allgemeine-hinweise-zu-latex"> |
| 1629 | 1629 |
<title>Allgemeine Hinweise zu LaTeX Vorlagen</title> |
| 1630 |
<para>In den allermeisten Installationen sollte drucken jetzt schon |
|
| 1631 |
funktionieren. Sollte ein Fehler auftreten wirft TeX sehr lange |
|
| 1632 |
Fehlerbeschreibungen, der eigentliche Fehler ist immer die erste Zeite
|
|
| 1630 |
<para>In den allermeisten Installationen sollte das Drucken jetzt schon
|
|
| 1631 |
funktionieren. Sollte ein Fehler auftreten, wirft TeX sehr lange
|
|
| 1632 |
Fehlerbeschreibungen, der eigentliche Fehler ist immer die erste Zeile,
|
|
| 1633 | 1633 |
die mit einem Ausrufezeichen anfängt. Häufig auftretende Fehler sind zum |
| 1634 | 1634 |
Beispiel:</para> |
| 1635 | 1635 |
|
Auch abrufbar als: Unified diff
einige Schreibfehler in der Doku verbessert.