[DOCUMENTATION] German:

- sync up to r15051

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

documentation/manual/de/manual.xml.in

@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding='UTF-8' ?>
-<!-- EN-Revision: 14945 -->
+<!-- EN-Revision: 15048 -->
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     "@DOCBOOK_DTD@"
 [
@@ -468,6 +468,12 @@
         <xi:include href="module_specs/Zend_Soap_AutoDiscovery.xml" />
     </chapter>
 
+    <chapter id="zend.tag">
+        <title>Zend_Tag</title>
+        <xi:include href="module_specs/Zend_Tag-Introduction.xml" />
+        <xi:include href="module_specs/Zend_Tag_Cloud.xml" />
+    </chapter>
+
     <chapter id="zend.test">
         <title>Zend_Test</title>
         <xi:include href="module_specs/Zend_Test.xml" />

documentation/manual/de/module_specs/Zend_Search_Lucene-Overview.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 14978 -->
+<!-- EN-Revision: 15050 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.search.lucene.overview">
     <title>Überblick</title>
@@ -313,6 +313,17 @@ $index->addDocument($doc);
             vom Index empfangen werden. Standardmäßig wird der Body nur Tokenized und Indiziert, aber nicht
             gespeichert.
         </para>
+        <para>
+            Der dritte Parameter der <code>loadHTML()</code> und <code>loadHTMLFile()</code>
+            Methoden spezifiziert optional die Kodierung des Quell- HTML Dokuments. Wenn er nicht
+            angegeben wird, wird die Kodierung automatisch vom Metatag content type charset
+            erkannt.
+        </para>
+        <para>
+            Die Kodierung kann später mit den Methoden
+            <code>getEncoding()</code>/<code>setEncoding($encoding)</code> empfangen/überschrieben
+            werden.
+        </para>
 
         <para>
             Andere Dokument Header Meta Tags produzieren zusätzliche Dokument Felder. Der Feld 'name' wird vom

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

@@ -0,0 +1,59 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 15048 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.tag.introduction">
+    <title>Einführung</title>
+
+    <para>
+        <classname>Zend_Tag</classname> ist eine Komponenten Suite welche zwei Klassen anbietet
+        um mit Tags zu arbeiten, <classname>Zend_Tag_Item</classname> und
+        <classname>Zend_Tag_ItemList</classname>. Zusätzlich kommt Sie mit dem Interface
+        <classname>Zend_Tag_Taggable</classname>, welches es erlaubt jedes eigene Modell als
+        markiertes Element, in Verbindung mit <classname>Zend_Tag</classname>, zu verwenden.
+    </para>
+
+    <para>
+        <classname>Zend_Tag_Item</classname> ist eine grundsätzliche Implementation eines
+        markierten Elements, welche mit der essentiellen Funktionalität kommt, die notwendig ist
+        um mit der <classname>Zend_Tag</classname> Suite zu arbeiten. Ein markierbares Element
+        besteht immer auf einem Titel und einem relativen Gewicht (z.B. die Anzahl der
+        Vorkommnisse). Es speichert auch Parameter welche, von den unterschiedlichen
+        Sub-Komponenten von <classname>Zend_Tag</classname>, verwendet werden.
+    </para>
+
+    <para>
+        Um mehrere Element miteinander zu gruppieren, existiert
+        <classname>Zend_Tag_ItemList</classname> als Array Iterator und bietet zusätzliche
+        Funktionalitäten um die Werte des absoluten Gewichts, basierend auf dem angegebenen
+        relativen Gewicht jedes Elements in diesem, zu kalkulieren.
+    </para>
+
+    <example id="zend.tag.example.using">
+        <title>Verwenden von Zend_Tag</title>
+        <para>
+            Dieses Beispiel zeigt wie eine Liste von Tags erstellt werden, und Werte des
+            absoluten Gewichts auf diesen verteilt werden kann.
+        </para>
+        <programlisting role="php"><![CDATA[
+// Erstellen des Elementliste
+$list = new Zend_Tag_ItemList();
+
+// Tags auf Ihr hinzufügen
+$list[] = new Zend_Tag_Item(array('title' => 'Code', 'weight' => 50));
+$list[] = new Zend_Tag_Item(array('title' => 'Zend Framework', 'weight' => 1));
+$list[] = new Zend_Tag_Item(array('title' => 'PHP', 'weight' => 5));
+
+// Absolute Werte auf den Elementen verteilen
+$list->spreadWeightValues(array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10));
+
+// Die Werte mit Ihren absoluten Werten ausgeben
+foreach ($list as $item) {
+    printf("%s: %d\n", $item->getTitle(), $item->getParam('weightValue'));
+}
+]]></programlisting>
+        <para>
+            Das wird die drei Elemente Code, Zend Framework und PHP, mit den absoluten Werten
+            10, 1 und 2, ausgeben.
+        </para>
+    </example>
+</sect1>

documentation/manual/de/module_specs/Zend_Tag_Cloud.xml

@@ -0,0 +1,213 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 15048 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.tag.cloud">
+
+    <title>Zend_Tag_Cloud</title>
+
+    <para>
+        <classname>Zend_Tag_Cloud</classname> ist der Darstellungs-Teil von
+        <classname>Zend_Tag</classname>. Standardmäßig kommt Sie mit einem Set von HTML Dekoratoren
+        welche es erlauben Tag Wolken für WebSites zu erstellen, bietet aber auch zwei abstrakte
+        Klassen für die Erstellung eigener Dekoratore, um zum Beispiel Tag Wolken in PDF Dokumenten
+        zu erstellen.
+    </para>
+
+    <para>
+        Man kann <classname>Zend_Tag_Cloud</classname> entweder programmtechnisch instanziieren und
+        konfigurieren, oder komplett über ein Array oder eine Instanz von
+        <classname>Zend_Config</classname>. Die vorhandenen Optionen sind:
+    </para>
+
+    <itemizedlist>
+        <listitem>
+            <para>
+                <code>cloudDecorator</code>: definiert den Dekorator für die Wolke. Das kann
+                entweder der Name der Klasse sein, die vom PluginLoader geladen werden soll, eine
+                Instanz von <classname>Zend_Tag_Cloud_Decorator_Cloud</classname>, oder ein Array
+                das den String <code>decorator</code> enthält, und optional ein
+                <code>options</code> Array, welches an den Contructor des Dekorators übergeben
+                wird.
+            </para>
+        </listitem>
+        <listitem>
+            <para>
+                <code>tagDecorator</code>: definiert den Dekorator für individuelle Tags. Das kann
+                entweder der Name der Klasse sein, die vom PluginLoader geladen werden soll, eine
+                Instanz von <classname>Zend_Tag_Cloud_Decorator_Tag</classname>, oder ein Array
+                das den String <code>decorator</code> enthält, und optional ein
+                <code>options</code> Array, welches an den Contructor des Dekorators übergeben
+                wird.
+            </para>
+        </listitem>
+        <listitem>
+            <para>
+                <code>pluginLoader</code>: ein anderer Plugin Loader der zu verwenden ist. Muß eine
+                Instanz von <classname>Zend_Loader_PluginLoader_Interface</classname> sein.
+            </para>
+        </listitem>
+        <listitem>
+            <para>
+                <code>prefixPath</code>: Präfix Pfade die dem Plugin Loader hinzugefügt werden.
+                Muß ein Array sein das die Schlüssel prefix und path oder mehrere Arrays
+                enthält, welche die Schlüssel prefix und path enthalten. Ungültige Elemente
+                werden übersprungen.
+            </para>
+        </listitem>
+        <listitem>
+            <para>
+                <code>itemList</code>: eine andere Liste von Elementen die verwendet wird. Muß
+                eine Instanz von <classname>Zend_Tag_ItemList</classname> sein.
+            </para>
+        </listitem>
+        <listitem>
+            <para>
+                <code>tags</code>: eine Liste von Tags die der Wolke zugeordnet werden. Jedes Tag
+                muß entweder <classname>Zend_Tag_Taggable</classname> implementieren oder ein
+                Array sein welches verwendet werden kann um <classname>Zend_Tag_Item</classname>
+                implementieren.
+            </para>
+        </listitem>
+    </itemizedlist>
+
+    <example id="zend.tag.cloud.example.using">
+
+        <title>Verwenden von  Zend_Tag_Cloud</title>
+
+        <para>
+            Dieses Beispiel zeigt ein grundsätzliches Beispiel davon wie eine Tag Wolke erstellt
+            wird, und Ihr mehrere Tags hinzugefügt, und Sie letztendlich dargestellt wird.
+        </para>
+        <programlisting role="php"><![CDATA[
+// Die Wolke erstellen und Ihr statische Tags zuordnen
+$cloud = new Zend_Tag_Cloud(array(
+    'tags' => array(
+        array('title' => 'Code', 'weight' => 50,
+              'params' => array('url' => '/tag/code')),
+        array('title' => 'Zend Framework', 'weight' => 1,
+              'params' => array('url' => '/tag/zend-framework')),
+        array('title' => 'PHP', 'weight' => 5,
+              'params' => array('url' => '/tag/php')),
+    )
+));
+
+// Die Woke darstellen
+echo $cloud;
+]]></programlisting>
+        <para>
+            Das gibt die Tag Wolke mit drei Tags aus, welche mit den standardmäßigen Schriftgrößen
+            ausgebreitet wird.
+        </para>
+    </example>
+
+    <sect2 id="zend.tag.cloud.decorators">
+
+        <title>Dekoratore</title>
+
+        <para>
+            <classname>Zend_Tag_Cloud</classname> benötigt zwei Typen von Dekoratoren die fähig
+            sein müssen eine Tag Wolke darzustellen. Das beinhaltet einen Dekorator welcher ein
+            einzelnes Tag darstellt, sowie einen Dekorator welcher die umgebende Wolke darstellt.
+            <classname>Zend_Tag_Cloud</classname> liefert ein standardmäßiges Set von Dekoratoren
+            für die Formatierung einer Tag Wolke in HTML. Dieses Set wird eine Tag Wolke
+            standardmäßig als ul/li-Liste darstellen, und diese mit unterschiedlichen
+            Schriftgrößen, abhängig vom Gewicht der Werte Ihrer zugeordneten Tags, dargestellt.
+        </para>
+
+        <sect3 id="zend.tag.cloud.decorators.htmltag">
+
+            <title>Der HTML Tag Dekorator</title>
+
+            <para>
+                Der HTML Tag Dekorator stellt standardmäßig jedes Tag in einem Anker Element dar,
+                umgeben von einem li Element. Der Anker selbst ist fixiert und kann nicht geändert
+                werden, aber die umgebenden Elemente können geändert werden.
+            </para>
+
+            <note>
+                <title>URL Parameter</title>
+                <para>
+                    Da der HTML Tag Dekorator immer den Titel des Tags mit einem Anker umgibt,
+                    sollte man einen URL Parameter, für jedes in Ihm verwendete Tag, definiert
+                    werden.
+                </para>
+            </note>
+
+            <para>
+                Der Tag Dekorator kann entweder unterschiedliche Schriftgrößen über die Anker,
+                oder eine definierte Liste von Klassennamen, verteilen. Wenn Optionen für eine
+                dieser Möglichkeiten gesetzt werden, werden die korrespondierenden automatisch
+                aktiviert. Die folgenden Konfigurationsoptionen sind vorhanden:
+            </para>
+
+            <itemizedlist>
+                <listitem>
+                    <para>
+                        <code>fontSizeUnit</code>: definiert die Einheit die für alle Schriftgrößen
+                        verwendet wird. Die möglichen Werte sind:
+                        em, ex, px, in, cm, mm, pt, pc und &#37;.
+                    </para>
+                </listitem>
+                <listitem>
+                    <para>
+                        <code>minFontSize</code>: die minimale Schriftgröße die an die Tags
+                        verteilt wird (muß ein Integer sein).
+                    </para>
+                </listitem>
+                <listitem>
+                    <para>
+                        <code>maxFontSize</code>: die maximale Schriftgröße die an die Tags
+                        verteilt wird (muß ein Integer sein).
+                    </para>
+                </listitem>
+                <listitem>
+                    <para>
+                        <code>classList</code>: ein Array von Klassen die an die Tags verteilt
+                        werden soll.
+                    </para>
+                </listitem>
+                <listitem>
+                    <para>
+                        <code>htmlTags</code>: ein Array von HTML Tags die den Anker umgeben.
+                        Jedes Element kann entweder ein String sein, welches als Elementtyp
+                        verwendet wird, oder ein Array das eine Liste von Attributen für das
+                        Element enthält, welches wiederum als Schlüssel/Werte Paar definiert ist.
+                        In diesem Fall, wird der Array Schlüssel als Elementtyp verwendet.
+                    </para>
+                </listitem>
+            </itemizedlist>
+        </sect3>
+
+        <sect3 id="zend.tag.cloud.decorators.htmlcloud">
+
+            <title>HTML Cloud Dekorator</title>
+
+            <para>
+                Der HTML Cloud Dekorator umgibt die HTML Tags standardmäßig mit einem ul-Element
+                und fügt keine Trennung hinzu. Wie im Tag Dekorator, können mehrere umgebende
+                HTML Tags und zusätzlich ein Trennzeichen definiert werden. Die vorhandenen
+                Optionen sind:
+            </para>
+
+            <itemizedlist>
+                <listitem>
+                    <para>
+                        <code>separator</code>: definiert das Trennzeichen welches zwischen alle
+                        Tags platziert wird.
+                    </para>
+                </listitem>
+                <listitem>
+                    <para>
+                        <code>htmlTags</code>: ein Array von HTML Tags welche alle Tags umgeben.
+                        Jedes Element kann entweder ein String sein, welches als Elementtyp
+                        verwendet wird, oder ein Array das eine Liste von Attributen für das
+                        Element enthält, und als Schlüssel/Werte Paar definiert ist. In diesem
+                        Fall wird der Arrayschlüssel als Elementtyp verwendet.
+                    </para>
+                </listitem>
+            </itemizedlist>
+        </sect3>
+
+    </sect2>
+
+</sect1>