projekt kivitendo

            <para>Debian</para>

            <itemizedlist>

               <listitem>

                 <para>6.0 Squeeze (hier muss allerdings das Modul FCGI in der Version >= 0.72 compiled werden)</para>

               </listitem>

               <listitem>

                 <para>7.0 Wheezy</para>

               </listitem>

            </itemizedlist>

            <para>Ubuntu 10.04 LTS Lucid Lynx bis 12.10 Oneiric Ocelot</para>

	“template1” “UTF8”, so braucht man nichts weiteres diesbezüglich

	<para>Die Frage, ob der neue User Superuser sein soll, können Sie mit nein

	beantworten, genauso ist die Berechtigung neue User (Roles) zu

	generieren nicht nötig.</para>

      Debianoiden Betriebssystemen installiert man die Pakete mit:</para>

      <para><programlisting>aptitude install \

      texlive-base-bin \

texlive-latex-recommended \

texlive-fonts-recommended \

texlive-latex-extra \

texlive-lang-german \

texlive-generic-extra

      </programlisting></para>

      <para>kivitendo bringt 3 alternative Vorlagensätze mit:</para>

        <itemizedlist>

          <listitem>Standard</listitem>

          <listitem>f-tex</listitem>

          <listitem>RB</listitem>

        </itemizedlist>

      <sect2 id="Vorlagenverzeichnis-anlegen" xreflabel="Vorlagenverzeichnis anlegen">

        <title>Vorlagenverzeichnis anlegen</title>

        <para>Bei einem neuen Benutzer/Mandanten lässt sich einer dieser Vorlagensätze

        als Basis für die zu druckenden Dokumente auswählen:</para>

        <para><programlisting>unter:

Administration -> Benutzerverwaltung -> [ein Benutzer]

   Erzeuge Vorlagen, Name: [Name für das neue Vorlagenverzeichnis]

   Vorlagen auswählen: [Default, f-tex oder RB]

   -> Speichern

        </programlisting></para>

        <para>der gleiche Vorlagensatz kann, wenn er mal angelegt ist, bei mehreren Benutzern verwendet werden.</para>

        <para>Die Abhängigkeiten kann man prüfen mit:</para>

        <para><programlisting>/scripts/installation_check.pl -l</programlisting></para>

      </sect2>

      <sect2 id="Standard">

        <title>Default</title>

        <para>Der standard Vorlagensatz von Kivitendo. Wie unter

        <ulink url="http://demo.kivitendo.org">http://demo.kivitendo.org</ulink> zu sehen.</para>

      </sect2>

      <sect2 id="f-tex">

        <title>f-tex</title>

        <para>Ein Vorlagensatz, der in Wenigen Minuten alle Dokumente zur stellt.</para>

        <sect3 id="f-tex-Feature-Übersicht">

          <title>f-tex Feature Übersicht</title>

          <itemizedlist>

            <listitem>Keine Retundanz. Es wird ein und die selbe Latex-Vorlage für alle

            briefartigen Dokumente verwendet. Also Angebot, Rechnung,

            Performarechnung, Lieferschein, aber eben nicht für Paketaufkleber

            etc.. </listitem>

            <listitem>Leichte Anpassung an das Firmen Layout durch verwendung eines Hintergrund-PDF

            dieses kann leicht mit dem eigenen Lieblingsprogramm erstellt werden

            (Openoffice, Inkscape, Gimp, Adobe*)

            </listitem>

            <listitem>Hintergrundpdf um schaltbar auf "nur erste Seite" (default) oder "alle Seiten"

            (option "bgPdfFirstPageOnly" in Datei letter.lco)

            </listitem>

            <listitem>Hintergrundpdf für Ausdruck auf bereits bedrucktem Briefpapier Abschaltbar,

            es wird dann nur bei per email versendeten Dokumenten eingebunden.

            (Option "bgPdfEmailOnly" in Datei letter.lco)

            </listitem>

            <listitem>Nutzung der Layout-Funktionen von Latex für Seitenumbruch,

            wiederholung von Kopfzeilen, Zwischensummen etc. (danke an Kai-Martin für

            die Vorarbeit)

            </listitem>

            <listitem>Anzeige des Empfängerlandes im Adressfeld nur, wenn es vom Land des

            eigenen Unternehmens abweicht (also die Rechnung das Land verlässt).

            </listitem>

            <listitem>Multisprachfähig leicht um weitere Sprachen zu erweitern, alle

            Übersetzungen in der Datei translatinos.tex.

            </listitem>

            <listitem>Auflistung von Bruttopreisen für Endverbraucher.

            </listitem>

          </itemizedlist>

        </sect3>

        <sect3 id="f-tex-installation">

          <title>f-tex Die Installation</title>

          <itemizedlist>

            <listitem>Vorlagenverzeichnis mit Option f-tex anlegen, siehe: 

              <xref linkend="Vorlagenverzeichnis-anlegen"/>

              Das Vorlagensystem funktioniert jetzt schon, hat allerdings noch einen

              Beispiel Briefkopf

            </listitem>

            <listitem>

              Erstelle eine pdf-Hintergrund Datei und verlinke sie nach

              <programlisting>./letter_head.pdf</programlisting>

            </listitem>

            <listitem>

              Editiere den Bereich "settings" in der datei letter.lco

            </listitem>

          </itemizedlist>

          <para>oder etwas Detaillierter:</para>

          <para>

            Es wird eine Datei sample.lco erstellt und diese nach letter.lco verlinkt.

            Eigentlich ist dies die Datei die für die Firmenspezifischen Anpassungen

            gedacht ist.  Da die Einstiegshürde in LaTeX nicht ganz niedrig ist, wird in

            dieser Datei auf ein Hintergrundpdf verwiesen. Ich empfehle über dieses pdf

            die persönlichen Layoutanpassungen vorzunehmen und sample.lco unverändert zu

            lassen. Die die Anpassung über eine *.lco Datei die letztlich auf letter.lco

            verlinkt ist ist aber auch möglich.

          </para>

          <para>

            Es wird eine Datei sample_head.pdf mit ausgeliefert, diese wird nach

            letter_head.pdf verlinkt. Damit gibt es schon mal eine Funktionsfähige

            Vorlage. Schau Dir nach Abschluss der Installation die Datei sample_haed.pdf

            an und erstelle ein entsprechendes pdf passend zum Briefkopf Deiner Firma,

            diese dann im Template Verzeichniss ablegen und statt sample_head.pdf nach

            letter_head.pdf verlinken.

          </para>

          <para>

            letzlich muss ./letter_head.pdf auf das passende Hintergrundpdf verweisen,

            welches gewünschten Briefkopf enthält. Bei Updates oder nach erneutem

          </para>

          <para>

            Es wird eine Datei mydata.tex.example ausgeliefert die nach mytdata.tex

            verlinkt ist. Bei verwendetem Hintergrundpdf wird nur der Eintrag für das

            Land verwendet die Datei muss  also nicht angefasst werden. Die Anderen Werte

            sind für das Modul  lp (Label Print in erp - zur Zeit nicht im

            öffentlichen Zweig).

          </para>

          <para>

            Alle Anpassungen zum Briefkopf, Fusszeilen, Firmenlogos, etc.

            sollten über die Hintergrund pdf datei oder die *.lco Datei erfolgen.

          </para>

        </sect3>

        <sect3 id="f-tex-Funktionsübersicht">

          <title>f-tex Funktionsübersicht</title>

          <para>

            Das Konzept von kivitendo sieht vor, für jedes Dokument

            (Auftragsbestätigung, Lieferschein, Rechnung, etc.) eine

            Latex-Vorlage vorzuhalten, dies ist sehr Wartungsunfreundlich. Auch

            das Einlesen einer einheitlichen Quelle für den Briefkopf bringt nur

            bedingte Vorteile, da hier leicht die Pflege der Artikel-Tabellen aus

            dem Ruder läuft. Bei dem vorliegenden Ansatz wird für alle

            Briefartigen Dokumente mit Artikel-Tabellen eine einheitliche

            Latexvorlage verwendet, welche über Codeweichen die Besonderheiten

            der jeweiligen Dokumente Berücksichtigt

          </para>

          <itemizedlist>

            <listitem>Tabellen mit oder ohne Preis

            </listitem>

            <listitem>Sprache der Tabellenüberschriften etc.

            </listitem>

            <listitem>Anpassung der Bezugs-Zeile (z.B. Rechnungsnummer versus

               Angebotsnummer)

            </listitem>

            <listitem>Darstellung von Brutto oder Netto-Preisen in der Auflistung

              (Endverbraucher versus Gewerblicher Kunde)

            </listitem>

           </itemizedlist>

           <para>Nachteil:</para>

           <para>

             Latex hat ohnehin eine sehr steile Lehrnkurve. Die Datei letter.tex

             ist sehr komplex und verstärkt damit diesen Effekt noch einmal erheblich.

             Wer Latex-Erfahrung hat, oder geübt ist Scriptsparachen nachzuvollziehen kann

             natürlich auch innerhalb der Tabellendarstellung gut persönliche Anpassungen

             vornehmen. Aber man kann sich hier bei Veränderungen sehr schnell häftig in

             den Fuss schiessen.

           </para>

           <para>Wer nicht so tief in die Materie einsteigen will oder leicht zu

              frustrieren ist, sollte sein Hintergrund PDF auf Basis der mitglieferten

              Datei sample_head.pdf erstellen, und sich an der Form der dargestellten Tabellen

              wie sie ausgeliefert werden, erfreuen.

           </para>

           <para>Kleiner Tipp:

             Nicht zu viel auf einmal wollen, lieber kleine kontinuierliche

             Schritte gehen.

           </para>

           <para>Bruttopreise für Endvorbraucher</para>

	   <para>Der auszuweisende Bruttopreis wird innerhalb der LaTeX

             Umgebung berechnet.  es gibt zwar ein Feld um bei Aufträgen "alle Preise

             Brutto" auszuwählen, aber:</para>

          <itemizedlist>

            <listitem>

              hierfür müssen die Preise auch in Brutto in der Datenbank stehen

              (ja - das lässt sich über die Preisgruppen und die Zuordung einer Default-Preisgruppe

              handhaben)

            </listitem>

            <listitem>

              man darf beim Anlegen des Vorgangs nicht vergessen Dieses Häkchen zu setzen.

               (das ist in der Praxis wenn man sowohl Endverbraucher- wie Gewerbekunden beliefert

              der eigentliche Knackpunkt)

            </listitem>

          </itemizedlist>

          <para>

            Es gibt mit f-tex eine weitere Alternative. Die Information ob Brutto oder

            Nettorechnung wird mit den Zahlarten verknüpft. Zahlarten bei denen

            Rechnungen, Angebote, etc, in Brutto ausgegeben werden sollen enden mit "_E"

            (für Endverbraucher) Falls identische Zahlarten für Gewerbekunden und

            Endverbraucher vorhanden sind legt man diese einfach doppelt an (einmal mit

            der Namensendung "_E"). Gewinn:</para>

          <itemizedlist>

            <listitem>

               die Entscheidung ob Netopreise ausgewiesen werden ist nicht mehr fix

               mit einer Preisliste Verbunden.

            </listitem>

            <listitem>

              die Default-Zahlart kann im Kundendatensatz hinterlegt werden und man

              muss nicht mehr daran denken "alle Preise Netto" auszuwählen.

            </listitem>

            <listitem>

              Die Entscheidung ob Netto/Oder Bruttopreise ausgewiesen werden kann direkt

              beim Drucken reviediert werden, ohne dass sich der Auftragswert ändert.

            </listitem>

          </itemizedlist>

          <para>Lieferadressen</para>

          <itemizedlist>

            <listitem>

              in Lieferscheinen kommen shipto* -Variablen im Adressfeld zum Einsatz

            </listitem>

            <listitem>

              wenn die shipto*variable leer ist wird die entsprechende

              Adressvariable eingesetzt.  Wenn Also die Lieferadresse in Strasse,

              Hausnummer und Ort abweicht, müssen auch nur diese Felder in der

              Lieferadresse ausgefüllt werden. Für den Firmenname wird der Wert der

              Hauptadresse angezeigt.

            </listitem>

          </itemizedlist>

        </sect3>

      </sect2>

      <sect2 id="RB">

        <title>RB</title>

        <para>Vollständiger Dokumentensatz mit alternativen Design</para>

      </sect2>

      <sect2 id="Allgemeine Hinweise zu LaTeX">

        <title>Allgemeine Hinweise zu LaTeX Vorlagen</title>

        <para>In den allermeisten Installationen sollte drucken jetzt schon

        funktionieren. Sollte ein Fehler auftreten wirft TeX sehr lange

        Fehlerbeschreibungen, der eigentliche Fehler ist immer die erste Zeite

        die mit einem Ausrufezeichen anfängt. Häufig auftretende Fehler sind zum

        Beispiel:</para>

        <itemizedlist>

          <listitem>

            <para>! LaTeX Error: File `eurosym.sty' not found. Die entsprechende

            LaTeX-Bibliothek wurde nicht gefunden. Das tritt vor allem bei

            Vorlagen aus der Community auf. Installieren Sie die entsprechenden

            Pakete.</para>

          </listitem>

          <listitem>

            <para>! Package inputenc Error: Unicode char \u8:桜 not set up for

            use with LaTeX. Dieser Fehler tritt auf, wenn sie versuchen mit

            einer Standardinstallation exotische utf8 Zeichen zu drucken.

            TeXLive unterstützt von Haus nur romanische Schriften und muss mit

            diversen Tricks dazu gebracht werden andere Zeichen zu akzeptieren.

            Adere TeX Systeme wie XeTeX schaffen hier Abhilfe.</para>

          </listitem>

        </itemizedlist>

        <para>Wird garkein Fehler angezeigt sondern nur der Name des Templates,

        heißt das normalerweise, dass das LaTeX Binary nicht gefunden wurde.

        Prüfen Sie den Namen in der Konfiguration (Standard:

        <literal>pdflatex</literal>), und stellen Sie sicher, dass pdflatex

        (oder das von Ihnen verwendete System) vom Webserver ausgeführt werden

        darf.</para>

        <para>Wenn sich das Problem nicht auf Grund der ausgabe im Webbrowser verifizieren lässt:</para>

        <itemizedlist>

          <listitem>

             <para> editiere [kivitendo-home]/config/kivitendo.conf und ändere "keep_tmp_files" auf 1</para>

             <para><programlisting>keep_temp_files = 1;</programlisting></para>

          </listitem>

          <listitem>

             <para>bei fastcgi oder mod_perl den Webserver neu Starten</para>

          </listitem>

          <listitem>

            <para>Nochmal einen Druckversuch im Webfrontend auslösen</para>

          </listitem>

          <listitem>

            <para>wechsele in das users Verzeichnis von kivitendo</para>

            <para><programlisting>cd [kivitendo-home]/users</programlisting></para>

          </listitem>

          <listitem>

            <para>LaTeX Suchpfad anpassen:</para>

            <para><programlisting>export TEXINPUTS=".:[kivitendo-home]/templates/[aktuelles_template_verzeichniss]:"</programlisting></para>

          </listitem>

          <listitem>

            <para>Finde herraus welche Datei kivitendo beim letzten Durchlauf erstellt hat</para>

            <para><programlisting>ls -lahtr ./1*.tex</programlisting></para>

            <para>Es sollte die letzte Datei ganz unten sein</para>

          </listitem>

          <listitem>

            <para>für besseren Hinweis auf Fehler texdatei nochmals übersetzen</para>

            <para><programlisting>pdflatex ./1*.tex</programlisting></para>

            <para>in der *.tex datei nach dem Fehler suchen.</para>

          </listitem>

        </itemizedlist>

      </sect2>