[MANUAL] German:

- sync to r19710

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@19795 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/de/manual.xml.in

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 19661 -->
+<!-- EN-Revision: 19695 -->
 <!-- Reviewed: no -->
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     "@DOCBOOK_DTD@"
@@ -69,6 +69,14 @@
         <xi:include href="module_specs/Zend_Auth_Adapter_OpenId.xml" />
     </chapter>
 
+    <chapter id="zend.barcode">
+        <title>Zend_Barcode</title>
+        <xi:include href="module_specs/Zend_Barcode-Introduction.xml" />
+        <xi:include href="module_specs/Zend_Barcode-Creation.xml" />
+        <xi:include href="module_specs/Zend_Barcode-Objects.xml" parse="xml"/>
+        <xi:include href="module_specs/Zend_Barcode-Renderers.xml" />
+    </chapter>
+
     <chapter id="zend.cache">
         <title>Zend_Cache</title>
         <xi:include href="module_specs/Zend_Cache-Introduction.xml" />

documentation/manual/de/module_specs/Zend_Barcode-Creation.xml

@@ -0,0 +1,198 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 19695 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.barcode.creation">
+    <title>Barcodes mit Hilfe der Zend_Barcode Klasse erstellen</title>
+
+    <sect2 id="zend.barcode.creation.configuration">
+        <title>Verwendung von Zend_Barcode::factory</title>
+
+        <para>
+            <classname>Zend_Barcode</classname> verwendet eine Factory Methode um die Instanz eines
+            Renderers zu erstellen der <classname>Zend_Barcode_Renderer_RendererAbstract</classname>
+            erweitert. Die Factory Methode akzeptiert fünf Argumente.
+        </para>
+
+        <orderedlist>
+            <listitem>
+                <para>Der Name des Barcode Formats (z.B., "code39") (benötigt)</para>
+            </listitem>
+
+            <listitem>
+                <para>Der Name des Renderers (z.B., "image") (benötigt)</para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    Optionen die an das Barcode Objekt übergeben werden (ein Array oder
+                    <classname>Zend_Config</classname> Objekt) (optional)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    Optionen die an das Renderer Objekt übergeben werden (ein Array oder
+                    <classname>Zend_Config</classname> Object) (optional)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    Ein Boolean um anzuzeigen ob Fehler automatisch dargestellt werden sollen oder
+                    nicht. Wenn eine Exception stattfindet, wird das angegebene Barcode Objekt mit
+                    der Repräsentation des Fehlers ersetzt (optional der Standardwert
+                    <constant>TRUE</constant>)
+                </para>
+            </listitem>
+        </orderedlist>
+
+        <example id="zend.barcode.creation.configuration.example-1">
+            <title>Einen Renderer mit Zend_Barcode::factory() erhalten</title>
+
+            <para>
+                <methodname>Zend_Barcode::factory()</methodname> instanziert Barcode Objekte und
+                Renderer und verbindet diese miteinander. In diesem ersten Beispiel verwenden wir
+                den <emphasis>Code39</emphasis> Barcode Typ zusammen mit dem
+                <emphasis>Image</emphasis> Renderer.
+            </para>
+
+            <programlisting language="php"><![CDATA[
+// Nur der darzustellende Text wird benötigt
+$barcodeOptions = array('text' => 'ZEND-FRAMEWORK');
+
+// Keine Optionen benötigt
+$rendererOptions = array();
+$renderer = Zend_Barcode::factory(
+    'code39', 'image', $barcodeOptions, $rendererOptions
+);
+]]></programlisting>
+        </example>
+
+        <example id="zend.barcode.creation.configuration.example-2">
+            <title>Zend_Barcode::factory() mit Zend_Config Objekten verwenden</title>
+
+            <para>
+                Man kann ein <classname>Zend_Config</classname> Objekt an die Factory übergeben um
+                die notwendigen Objekte zu erstellen. Das folgende Beispiel ist funktionell identisch
+                mit dem vorherigen.
+            </para>
+
+            <programlisting language="php"><![CDATA[
+// Nur ein Zend_Config Objekt verwenden
+$config = new Zend_Config(array(
+    'barcode'        => 'code39',
+    'barcodeParams'  => array('text' => 'ZEND-FRAMEWORK'),
+    'renderer'       => 'image',
+    'rendererParams' => array('imageType' => 'gif'),
+));
+
+$renderer = Zend_Barcode::factory($config);
+]]></programlisting>
+        </example>
+    </sect2>
+
+    <sect2 id="zend.barcode.creation.drawing">
+        <title>Einen Barcode zeichnen</title>
+
+        <para>
+            Wenn der Barcode <emphasis>gezeichnet</emphasis> wird, empfängt man die Ressource in
+            welcher der Barcode gezeichnet wird. Um einen Barcode zu zeichnen kann man die
+            <methodname>draw()</methodname> Methode des Renderers aufrufen, oder einfach die von
+            <classname>Zend_Barcode</classname> angebotene Proxy Methode verwenden.
+        </para>
+
+        <example id="zend.barcode.creation.drawing.example-1">
+            <title>Einen Barcode mit dem Renderer Objekt zeichnen</title>
+
+            <programlisting language="php"><![CDATA[
+// Nur der zu zeichnende Text wird benötigt
+$barcodeOptions = array('text' => 'ZEND-FRAMEWORK');
+
+// Keine Optionen benötigt
+$rendererOptions = array();
+
+// Zeichne den Barcode in einem neuen Bild
+$imageResource = Zend_Barcode::factory(
+    'code39', 'image', $barcodeOptions, $rendererOptions
+)->draw();
+]]></programlisting>
+        </example>
+
+        <example id="zend.barcode.creation.drawing.example-2">
+            <title>Einen Barcode mit Zend_Barcode::draw() zeichnen</title>
+
+            <programlisting language="php"><![CDATA[
+// Nur der zu zeichnende Text wird benötigt
+$barcodeOptions = array('text' => 'ZEND-FRAMEWORK');
+
+// Keine Optionen benötigt
+$rendererOptions = array();
+
+// Zeichne den Barcode in einem neuen Bild
+$imageResource = Zend_Barcode::draw(
+    'code39', 'image', $barcodeOptions, $rendererOptions
+);
+]]></programlisting>
+        </example>
+    </sect2>
+
+    <sect2 id="zend.barcode.creation.renderering">
+        <title>Einen Barcode darstellen</title>
+
+        <para>
+            Wenn man einen Barcode darstellt, zeichnet man den Barcode, man sendet die Header und
+            man sendet die Ressource (z.B. zu einem Browser). Um einen Barcode darzustellen muss
+            man die <methodname>render()</methodname> Methode des Renderers aufrufen, oder einfach
+            die Proxy Methode verwenden die von <classname>Zend_Barcode</classname> angeboten wird.
+        </para>
+
+        <example id="zend.barcode.creation.renderering.example-1">
+            <title>Einen Barcode mit dem Renderer Objekt darstellen</title>
+
+            <programlisting language="php"><![CDATA[
+// Nur der zu zeichnende Text wird benötigt
+$barcodeOptions = array('text' => 'ZEND-FRAMEWORK');
+
+// Keine Optionen benötigt
+$rendererOptions = array();
+
+// Zeichne den Barcode in einem neuen Bild
+// Sende die Header und das Bild
+Zend_Barcode::factory(
+    'code39', 'image', $barcodeOptions, $rendererOptions
+)->render();
+]]></programlisting>
+
+            <para>
+                Das wird diesen Barcode erstellen:
+            </para>
+
+            <para>
+                <inlinegraphic width="275" align="center" valign="middle"
+                    fileref="figures/zend.barcode.introduction.example-1.png" format="PNG"/>
+            </para>
+        </example>
+
+        <example id="zend.barcode.creation.renderering.example-2">
+            <title>Einen Barcode mit Zend_Barcode::render() darstellen</title>
+
+            <programlisting language="php"><![CDATA[
+// Nur der zu zeichnende Text wird benötigt
+$barcodeOptions = array('text' => 'ZEND-FRAMEWORK');
+
+// Keine Optionen benötigt
+$rendererOptions = array();
+
+// Zeichne den Barcode in einem neuen Bild
+// Sende die Header und das Bild
+Zend_Barcode::render(
+    'code39', 'image', $barcodeOptions, $rendererOptions
+);
+]]></programlisting>
+
+            <para>
+                Das wird den selben Barcode erzeugen wie im vorherigen Beispiel.
+            </para>
+        </example>
+    </sect2>
+</sect1>

documentation/manual/de/module_specs/Zend_Barcode-Introduction.xml

@@ -0,0 +1,14 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 19695 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.barcode.introduction">
+    <title>Einführung</title>
+
+    <para>
+        <classname>Zend_Barcode</classname> bietet einen generischen Weg um Barcode zu erzeugen. Die
+        <classname>Zend_Barcode</classname> Komponente ist in zwei Unterkomponenten  unterteilt:
+        Barcode Objekte und Renderer. Objekte erlauben es Barcodes unabhängig von Renderern zu
+        erstellen. Renderer erlauben es Barcodes basieren auf der benötigten Unterstützung zu
+        zeichnen.
+    </para>
+</sect1>

documentation/manual/de/module_specs/Zend_Barcode-Objects.xml

@@ -0,0 +1,457 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 19695 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.barcode.objects" xmlns:xi="http://www.w3.org/2001/XInclude">
+    <title>Zend_Barcode Objekte</title>
+
+    <para>
+        Barcode Objekte erlauben es Barcodes unabhängig von der Unterstützung eines Renderers zu
+        erstellen. Nach der Erstellung kann der Barcode als Array von Zeichen Anweisungen empfangen
+        werden die an einen Renderer übergeben werden können.
+    </para>
+
+    <para>
+        Objekte haben eine große Anzahl an Optionen. Die meisten von Ihnen sind allen Objekten
+        gemein. Diese Optionen können auf vier Wegen gesetzt werden:
+    </para>
+
+    <itemizedlist>
+        <listitem>
+            <para>
+                Als Array oder <classname>Zend_Config</classname> Objekt welches dem Constructor
+                übergeben wird.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                Als Array das der <methodname>setOptions()</methodname> Methode übergeben wird.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                Als <classname>Zend_Config</classname> Objekt welches der
+                <methodname>setConfig()</methodname> Methode übergeben wird.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>Über individuelle Setter für jeden Konfigurations Typ.</para>
+        </listitem>
+    </itemizedlist>
+
+    <example id="zend.barcode.objects.configuration">
+        <title>Unterschiedliche Wege ein Barcode Objekt zu parametrisieren</title>
+
+        <programlisting language="php"><![CDATA[
+$options = array('text' => 'ZEND-FRAMEWORK', 'barHeight' => 40);
+
+// Fall 1: Constructor
+$barcode = new Zend_Barcode_Object_Code39($options);
+
+// Fall 2: setOptions()
+$barcode = new Zend_Barcode_Object_Code39();
+$barcode->setOptions($options);
+
+// Fall 3: setConfig()
+$config  = new Zend_Config($options);
+$barcode = new Zend_Barcode_Object_Code39();
+$barcode->setConfig($config);
+
+// Fall 4: individuelle Setter
+$barcode = new Zend_Barcode_Object_Code39();
+$barcode->setText('ZEND-FRAMEWORK')
+        ->setBarHeight(40);
+]]></programlisting>
+    </example>
+
+    <sect2 id="zend.barcode.objects.common.options">
+        <title>Gemeinsame Optionen</title>
+
+        <para>
+            In der folgenden Liste haben die Werte keine Einheit; wir werden den Ausdruck "Einheit"
+            verwenden. Zum Beispiel, ist der Standardwert "dünner Balken" genau "1 Einheit". Die
+            echte Einheit hängt von der Unterstützung beim Darstellen ab (siehe
+            <link linkend="zend.barcode.renderers">die Renderer Dokumentation</link> für mehr
+            Informationen). Setter werden benannt indem der erste Buchstabe der Option
+            großgeschrieben und dem Namen "set" vorangestellt wird (z.B. "barHeight" =>
+            "setBarHeight"). Alle Optionen haben einen entsprechenden Getter dem "get" vorangestellt
+            ist (z.B. "getBarHeight"). Die vorhandenen Optionen sind:
+        </para>
+
+        <table id="zend.barcode.objects.common.options.table">
+            <title>Gemeinsame Optionen</title>
+
+            <tgroup cols="4">
+                <thead>
+                    <row>
+                        <entry>Option</entry>
+
+                        <entry>Daten Typ</entry>
+
+                        <entry>Standardwert</entry>
+
+                        <entry>Beschreibung</entry>
+                    </row>
+                </thead>
+
+                <tbody>
+                    <row>
+                        <entry><emphasis>barcodeNamespace</emphasis></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry><classname>Zend_Barcode_Object</classname></entry>
+
+                        <entry>
+                            Namespace des Renderers; zum Beispiel wenn man den Renderer erweitern
+                            muss
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>barHeight</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>50</entry>
+
+                        <entry>Höhe der Balken</entry>
+                    </row>
+                    <row>
+                        <entry><emphasis>barThickWidth</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>3</entry>
+
+                        <entry>Breite des dicken Balken</entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>barThinWidth</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>1</entry>
+
+                        <entry>Breite des dünnen Balkens</entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>factor</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>1</entry>
+
+                        <entry>
+                            Faktor mit dem die Balkenbreiten und Schriftgrößen multipliziert werden
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>foreColor</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>0 (schwarz)</entry>
+
+                        <entry>
+                            Farbe des Balken und des Textes. Könnte als Integer oder als
+                            <acronym>HTML</acronym> Wert übergeben werden (z.B. "#333333")
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>backgroundColor</emphasis></entry>
+
+                        <entry><type>Integer</type> oder <type>String</type></entry>
+
+                        <entry>16777125 (white)</entry>
+
+                        <entry>
+                            Farbe des Hintergrundes. Könnte als Integer oder als
+                            <acronym>HTML</acronym> Wert übergeben werden (z.B. "#333333")
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>reverseColor</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>FALSE</constant></entry>
+
+                        <entry>
+                            Erlaubt die Änderung der Farbe des Balken und des Hintergrunds
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>orientation</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>0</entry>
+
+                        <entry>Orientierung des Barcodes</entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>font</emphasis></entry>
+
+                        <entry><type>String</type> oder <type>Integer</type></entry>
+
+                        <entry><constant>NULL</constant></entry>
+
+                        <entry>
+                            Pfad zu einer <acronym>TTF</acronym> Schriftart oder eine Zahl zwischen
+                            1 und 5 wenn die Bilderstellung mit GD verwendet wird (interne
+                            Schriftarten)
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>fontSize</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>10</entry>
+
+                        <entry>
+                            Größe der Schriftart (nicht anwendbar bei nummerischen Schriftarten)
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>withBorder</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>FALSE</constant></entry>
+
+                        <entry>Zeichnet einen Rahmen um den Barcode und die Randzonen</entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>drawText</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>TRUE</constant></entry>
+
+                        <entry>Setzt ob der Text unter dem Barcode angezeigt wird</entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>stretchText</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>FALSE</constant></entry>
+
+                        <entry>
+                            Spezifiziert ob der Text entlang des kompletten Barcodes gestreckt
+                            werden soll
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>withChecksum</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>FALSE</constant></entry>
+
+                        <entry>
+                            Zeigt ob die Checksumme dem Barcode automatisch hinzugefügt wird oder
+                            nicht
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>withChecksumInText</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>FALSE</constant></entry>
+
+                        <entry>
+                            Zeigt ob die Checksumme in der textuellen Repräsentation angezeigt wird
+                            oder nicht
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>text</emphasis></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry><constant>NULL</constant></entry>
+
+                        <entry>Der Text der repräsentiert wird, als Barcode</entry>
+                    </row>
+                </tbody>
+            </tgroup>
+        </table>
+
+        <sect3 id="zend.barcode.objects.common.options.barcodefont">
+            <title>Spezieller Fall der statischen setBarcodeFont()</title>
+
+            <para>
+                Man kann eine gemeinsame Schriftart für alle eigenen Objekte setzen indem die
+                statische Methode <methodname>Zend_Barcode_Object::setBarcodeFont()</methodname>
+                verwendet wird. Dieser Wert wird von individuellen Objekten immer überschrieben
+                wenn die <methodname>setFont()</methodname> Methode verwendet wird.
+            </para>
+
+            <programlisting language="php"><![CDATA[
+// In der eigenen Bootstrap Datei:
+Zend_Barcode_Object::setBarcodeFont('my_font.ttf');
+
+// Später im eigenen Code:
+Zend_Barcode::render(
+    'code39',
+    'pdf',
+    array('text' => 'ZEND-FRAMEWORK')
+); // will use 'my_font.ttf'
+
+// oder:
+Zend_Barcode::render(
+    'code39',
+    'image',
+    array(
+        'text' => 'ZEND-FRAMEWORK',
+        'font' => 3
+    )
+); // will use the 3rd GD internal font
+]]></programlisting>
+        </sect3>
+    </sect2>
+
+    <sect2 id="zend.barcode.objects.common.getters">
+        <title>Gemeinsame zusätzliche Getter</title>
+
+        <para></para>
+
+        <table id="zend.barcode.objects.common.getters.table">
+            <title>Gemeinsame Getter</title>
+
+            <tgroup cols="3">
+                <thead>
+                    <row>
+                        <entry>Getter</entry>
+
+                        <entry>Daten Typ</entry>
+
+                        <entry>Beschreibung</entry>
+                    </row>
+                </thead>
+
+                <tbody>
+                    <row>
+                        <entry><methodname>getType()</methodname></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry>
+                            Gibt den Namen der Barcode Klasse ohne den Namespace zurück (z.B.
+                            gibt <classname>Zend_Barcode_Object_Code39</classname> einfach
+                            "code39" zurück)
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getRawText()</methodname></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry>
+                            Gibt den originalen Text zurück der beim Objekt angegeben wurde
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getTextToDisplay()</methodname></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry>
+                            Gibt den Text zurück welche angezeigt wird, inklusive, wenn aktiviert,
+                            den Wert der Checksumme
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getQuietZone()</methodname></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>
+                            Gibt die Größe des Raumes an der vor und nach dem Barcode benötigt wird
+                            und keine Zeichnung enthält
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getInstructions()</methodname></entry>
+
+                        <entry><type>Array</type></entry>
+
+                        <entry>
+                            Gibt die Zeichenanweisungen als Array zurück.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getHeight($recalculate = false)</methodname></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>
+                            Gibt die Höhe des Barcodes berechnet nach einer möglichen Rotation
+                            zurück
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getWidth($recalculate = false)</methodname></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>
+                            Gibt den Wert des Barcodes berechnet nach einer möglichen Rotation
+                            zurück
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getOffsetTop($recalculate = false)</methodname></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>
+                            Gibt die oberste Position des Barcodes berechnet nach einer möglichen
+                            Rotation zurück
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getOffsetLeft($recalculate = false)</methodname></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>
+                            Gibt die linke Position des Barcodes berechnet nach einer möglichen
+                            Rotation zurück
+                        </entry>
+                    </row>
+                </tbody>
+            </tgroup>
+        </table>
+    </sect2>
+
+    <xi:include href="Zend_Barcode-Objects_Details.xml" />
+</sect1>

documentation/manual/de/module_specs/Zend_Barcode-Objects_Details.xml

@@ -0,0 +1,249 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 19695 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.barcode.objects.details">
+    <title>Beschreibung der ausgelieferten Barcodes</title>
+
+    <para>
+        Anbei findet man detailierte Informationen über alle Barcode Typen welche standardmäßig
+        mit Zend Framework ausgeliefert werden.
+    </para>
+
+    <sect3 id="zend.barcode.objects.details.error">
+        <title>Zend_Barcode_Object_Error</title>
+
+        <para>
+            <inlinegraphic width="400" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.error.png" format="PNG"/>
+        </para>
+
+        <para>
+            Dieser Barcode ist ein spezieller Fall. Er wird intern verwendet um eine Exception
+            automatisch darzustellen wenn diese von der <classname>Zend_Barcode</classname>
+            Komponente gefangen wird.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.code25">
+        <title>Zend_Barcode_Object_Code25</title>
+
+        <para>
+            <inlinegraphic width="152" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.code25.png" format="PNG"/>
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Name:</emphasis> Code 25 (oder Code 2 of 5 oder Code 25 Industrial)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Erlaubte Zeichen:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksumme:</emphasis> Optional (Modulo 10)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Länge:</emphasis> Variabel
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Es gibt keine speziellen Optionen für diesen Barcode.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.code39">
+        <title>Zend_Barcode_Object_Code39</title>
+
+        <para>
+            <inlinegraphic width="275" align="center" valign="middle"
+                fileref="figures/zend.barcode.introduction.example-1.png" format="PNG"/>
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Name:</emphasis> Code 39
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Erlaubte Zeichen:</emphasis>
+                    '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ -.$/+%'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksum:</emphasis> Optional (Modulo 43)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Länge:</emphasis> Variabel
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <note>
+            <para>
+                <classname>Zend_Barcode_Object_Code39</classname> fügt automatisch die Start und
+                Stop Zeichen ('*') hinzu.
+            </para>
+        </note>
+
+        <para>
+            Es gibt keine speziellen Optionen für diesen Barcode.
+        </para>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.itf14">
+        <title>Zend_Barcode_Object_Itf14</title>
+
+        <para>
+            <inlinegraphic width="155" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.itf14.png" format="PNG"/>
+        </para>
+
+        <para>
+            Dieser Barcode erweitert <classname>Zend_Barcode_Object_Int25</classname> (Code 2 of 5
+            Interleaved), und erweitert einige seiner Möglichkeiten; er hat auch selbst einige
+            spezielle.
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Name:</emphasis> ITF-14
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Erlaubte Zeichen:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksumme:</emphasis> zwingend (Modulo 10)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Länge:</emphasis> 14 Zeichen (inklusive Checksumme)
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Es gibt keine speziellen Optionen für diesen Barcode.
+        </para>
+
+        <note>
+            <para>
+                Wenn die Anzahl der Zeichen nicht 14 ist, wird
+                <classname>Zend_Barcode_Object_Itf14</classname> fehlende Nullen dem Barcode Text
+                automatisch anhängen.
+            </para>
+        </note>
+    </sect3>
+
+    <sect3 id="zend.barcode.objects.details.int25">
+        <title>Zend_Barcode_Object_Int25</title>
+
+        <para>
+            <inlinegraphic width="101" align="center" valign="middle"
+                fileref="figures/zend.barcode.objects.details.int25.png" format="PNG"/>
+        </para>
+
+        <para>
+            Dieser Barcode erweitert <classname>Zend_Barcode_Object_Code25</classname> (Code 2 of 5)
+            und hat die selben Eigenschaften und Optionen, und fügt die folgenden hinzu:
+        </para>
+
+        <itemizedlist>
+            <listitem>
+                <para>
+                    <emphasis>Name:</emphasis> Code 2 of 5 Interleaved
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Erlaubte Zeichen:</emphasis> '0123456789'
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Checksumme:</emphasis> Optional (Modulo 10)
+                </para>
+            </listitem>
+
+            <listitem>
+                <para>
+                    <emphasis>Länge:</emphasis> Variabel (immer eine berage Anzahl von Zeichen)
+                </para>
+            </listitem>
+        </itemizedlist>
+
+        <para>
+            Vorhandene Optionen enthalten:
+        </para>
+
+        <table id="zend.barcode.objects.details.int25.table">
+            <title>Zend_Barcode_Object_Int25 Options</title>
+
+            <tgroup cols="4">
+                <thead>
+                    <row>
+                        <entry>Option</entry>
+
+                        <entry>Daten Typ</entry>
+
+                        <entry>Standardwert</entry>
+
+                        <entry>Beschreibung</entry>
+                    </row>
+                </thead>
+
+                <tbody>
+                    <row>
+                        <entry><emphasis>withBearerBars</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>FALSE</constant></entry>
+
+                        <entry>
+                            Zeichnet einen dicken Balken am Anfang und dem Ende des Barcodes.
+                        </entry>
+                    </row>
+                </tbody>
+            </tgroup>
+        </table>
+
+        <note>
+            <para>
+                Wenn die Anzahl der Zeichen nicht gerade ist, werden
+                <classname>Zend_Barcode_Object_Int25</classname> dem Barcode Text automatisch
+                fehlende Nullen vorangestellt.
+            </para>
+        </note>
+    </sect3>
+</sect2>

documentation/manual/de/module_specs/Zend_Barcode-Renderers.xml

@@ -0,0 +1,291 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 19695 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.barcode.renderers">
+    <title>Zend_Barcode Renderer</title>
+
+    <para>
+        Renderer haben einige gemeinsame Optionen. Diese Optionen können auf vier Wegen gesetzt
+        werden:
+    </para>
+
+    <itemizedlist>
+        <listitem>
+            <para>
+                Als Array oder <classname>Zend_Config</classname> Objekt das dem Constructor
+                übergeben wird.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                Als Array das der <methodname>setOptions()</methodname> Methode übergeben wird.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>
+                Als <classname>Zend_Config</classname> Objekt das der
+                <methodname>setConfig()</methodname> Methode übergeben wird.
+            </para>
+        </listitem>
+
+        <listitem>
+            <para>Als diskreter Wert der an individuelle Setter übergeben wird.</para>
+        </listitem>
+    </itemizedlist>
+
+    <example id="zend.barcode.renderers.configuration">
+        <title>Unterschiedliche Wegen ein Renderer Objekt zu parametrisieren</title>
+
+        <programlisting language="php"><![CDATA[
+$options = array('topOffset' => 10);
+
+// Fall 1
+$renderer = new Zend_Barcode_Renderer_Pdf($options);
+
+// Fall 2
+$renderer = new Zend_Barcode_Renderer_Pdf();
+$renderer->setOptions($options);
+
+// Fall 3
+$config   = new Zend_Config($options);
+$renderer = new Zend_Barcode_Renderer_Pdf();
+$renderer->setConfig($config);
+
+// Fall 4
+$renderer = new Zend_Barcode_Renderer_Pdf();
+$renderer->setTopOffset(10);
+]]></programlisting>
+    </example>
+
+    <sect2 id="zend.barcode.renderers.common.options">
+        <title>Gemeinsame Optionen</title>
+
+        <para>
+            In der folgenden Liste haben die Werte keine Einheit; wir werden den Ausdruck "Einheit"
+            verwenden. Zum Beispiel, ist der Standardwert "dünner Balken" genau "1 Einheit". Die
+            echte Einheit hängt von der Unterstützung beim Darstellen ab. Die individuellen Setter
+            werden erkannt indem der erste Buchstabe der Option großgeschrieben und dem Namen
+            "set" vorangestellt wird (z.B. "barHeight" => "setBarHeight"). Alle Optionen haben einen
+            entsprechenden Getter dem "get" vorangestellt ist (z.B. "getBarHeight"). Die vorhandenen
+            Optionen sind:
+        </para>
+
+        <table id="zend.barcode.renderers.common.options.table">
+            <title>Gemeinsame Optionen</title>
+
+            <tgroup cols="4">
+                <thead>
+                    <row>
+                        <entry>Option</entry>
+
+                        <entry>Daten Typ</entry>
+
+                        <entry>Standardwert</entry>
+
+                        <entry>Beschreibung</entry>
+                    </row>
+                </thead>
+
+                <tbody>
+                    <row>
+                        <entry><emphasis>rendererNamespace</emphasis></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry><classname>Zend_Barcode_Renderer</classname></entry>
+                        <entry>
+                            Namespace des Renderers; zum Beispiel wenn man den Renderer erweitern
+                            muss
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>horizontalPosition</emphasis></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry>"left"</entry>
+
+                        <entry>
+                            Kann "left", "center" oder "right" sein. Das kann bei
+                            <acronym>PDF</acronym> nützlich sein, oder wenn die
+                            <methodname>setWidth()</methodname> Methode mit einem Image Renderer
+                            verwendet wird.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>verticalPosition</emphasis></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry>"top"</entry>
+
+                        <entry>
+                            Kann "top", "middle" oder "bottom" sein. Das kann bei
+                            <acronym>PDF</acronym> nützlich sein, oder wenn die
+                            <methodname>setHeight()</methodname> Methode mit einem Image Renderer
+                            verwendet wird.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>leftOffset</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>0</entry>
+
+                        <entry>
+                            Oberste Position des Barcodes innerhalb des Renderers. Wenn er verwendet
+                            wird, überschreibt dieser Wert die Option "horizontalPosition".
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>topOffset</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>0</entry>
+
+                        <entry>
+                            Oberste Position des Barcodes innerhalb des Renderers. Wenn er verwendet
+                            wird, überschreibt dieser Wert die Option "verticalPosition".
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>automaticRenderError</emphasis></entry>
+
+                        <entry><type>Boolean</type></entry>
+
+                        <entry><constant>TRUE</constant></entry>
+
+                        <entry>
+                            Ob Fehler automatisch dargestellt werden sollen oder nicht. Wenn eine
+                            Exception stattfindet, wird das angegebene Barcode Objekt mit einer
+                            Repräsentation des Fehlers ersetzt. Es ist zu beachten das einige Fehler
+                            (oder Exceptions) nicht dargestellt werden können.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>moduleSize</emphasis></entry>
+
+                        <entry><type>Float</type></entry>
+
+                        <entry>1</entry>
+
+                        <entry>
+                            Größe eines darstellenden Moduls im Support.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>barcode</emphasis></entry>
+
+                        <entry><classname>Zend_Barcode_Object</classname></entry>
+
+                        <entry><constant>NULL</constant></entry>
+
+                        <entry>
+                            Das Barcode Objekt welches dargestellt werden soll.
+                        </entry>
+                    </row>
+                </tbody>
+            </tgroup>
+        </table>
+
+        <para>
+            Es existiert ein zusätzlicher Getter: <methodname>getType()</methodname>. Er gibt den
+            Namen der Renderer Klasse ohne den Namespace zurück (z.B. gibt
+            <classname>Zend_Barcode_Renderer_Image</classname> "image" zurück.
+        </para>
+    </sect2>
+
+    <sect2 id="zend.barcode.renderers.image">
+        <title>Zend_Barcode_Renderer_Image</title>
+
+        <para>
+            Der Image Renderer zeichnet die Anweisungsliste des Barcode Obejekts in eine Bild
+            Ressource. Die Komponente benötigt die GD Erweiterung. Die Standardbreite eines
+            Moduls ist 1 Pixel.
+        </para>
+
+        <para>Vorhandene Optionen sind:</para>
+
+        <table id="zend.barcode.renderers.image.table">
+            <title>Zend_Barcode_Renderer_Image Optionen</title>
+
+            <tgroup cols="4">
+                <thead>
+                    <row>
+                        <entry>Option</entry>
+
+                        <entry>Daten Typ</entry>
+
+                        <entry>Standardwert</entry>
+
+                        <entry>Beschreibung</entry>
+                    </row>
+                </thead>
+
+                <tbody>
+                    <row>
+                        <entry><emphasis>height</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>0</entry>
+
+                        <entry>
+                            Erlaubt es die Höhe des ergebenen Bildes zu spezifizieren. Wenn diese
+                            "0" ist wird die Höhe vom Barcode Objekt kalkuliert.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>width</emphasis></entry>
+
+                        <entry><type>Integer</type></entry>
+
+                        <entry>0</entry>
+
+                        <entry>
+                            Erlaubt es die Breite des ergebenden Bildes zu spezifizieren. Wenn diese
+                            "0" ist wird die Breite vom Barcode Objekt kalkuliert.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><emphasis>imageType</emphasis></entry>
+
+                        <entry><type>String</type></entry>
+
+                        <entry>"png"</entry>
+
+                        <entry>
+                            Spezifiziert das Bildformat. Kann "png", "jpeg", "jpg" oder "gif" sein.
+                        </entry>
+                    </row>
+                </tbody>
+            </tgroup>
+        </table>
+    </sect2>
+
+    <sect2 id="zend.barcode.renderers.pdf">
+        <title>Zend_Barcode_Renderer_Pdf</title>
+
+        <para>
+            Der <acronym>PDF</acronym> Renderer zeichnet die Anweisungsliste des Barcode Objekts in
+            ein <acronym>PDF</acronym> Dokument. Die Standardbreite eines Moduls ist 0.5 Punkt.
+        </para>
+
+        <para>
+            Es gibt keine speziellen Optionen für diesen Renderer.
+        </para>
+    </sect2>
+</sect1>