[MANUAL] German:

- sync up to 19170

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

documentation/manual/de/module_specs/Zend_Config_Writer.xml

@@ -1,8 +1,9 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 18867 -->
+<!-- EN-Revision: 19161 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.config.writer.introduction">
     <title>Zend_Config_Writer</title>
+
     <para>
         <classname>Zend_Config_Writer</classname> gibt einem die Möglichkeit Configdateien aus
         <classname>Zend_Config</classname> Objekten heraus zu schreiben. Es arbeitet mit einem
@@ -37,8 +38,9 @@
     <para>
         Der Ini Writer hat zwei Modi für die Darstellung bezüglich Sektionen. Standardmäßig wird die
         Top-Level Konfiguration immer in Sektionsnamen geschrieben. Durch den Aufruf von
-        <code>$writer->setRenderWithoutSections()</code> werden alle Optionen in den globalen
-        Namespace der INI Datei geschrieben und es werden keine Sektionen angehängt.
+        <command>$writer->setRenderWithoutSections()</command> werden alle Optionen in den globalen
+        Namespace der <acronym>INI</acronym> Datei geschrieben und es werden keine Sektionen
+        angehängt.
     </para>
 
     <para>
@@ -137,10 +139,10 @@ $writer->write();
     </note>
 
     <para>
-        Für alle Datei-basierenden Writer (INI, XML und PHP Array) wird intern
-        <methodname>render()</methodname> verwendet um den Konfigurationsstring zu erstellen. Diese
-        Methode kann auch von ausserhalb aus verwendet werden wenn man Zugriff auf eine
-        String-Repräsentation der Konfigurationsdaten benötigt.
+        Für alle Datei-basierenden Writer (<acronym>INI</acronym>, <acronym>XML</acronym> und
+        <acronym>PHP</acronym> Array) wird intern <methodname>render()</methodname> verwendet um den
+        Konfigurationsstring zu erstellen. Diese Methode kann auch von ausserhalb aus verwendet
+        werden wenn man Zugriff auf eine String-Repräsentation der Konfigurationsdaten benötigt.
     </para>
 </sect1>
 <!--

documentation/manual/de/module_specs/Zend_Controller-Plugins-PutHandler.xml

@@ -1,13 +1,14 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 16603 -->
+<!-- EN-Revision: 19161 -->
 <!-- Reviewed: no -->
 <sect3 id="zend.controller.plugins.standard.puthandler">
     <title>Zend_Controller_Plugin_PutHandler</title>
 
     <para>
         <classname>Zend_Controller_Plugin_PutHandler</classname> bietet ein Drop-In Plugin für die
-        Verwendung von PUT Request Bodies in Anfrage Parametern, so wie POST Anfrage Parameter. Er
-        betrachtet die Anfrage und, wenn diese PUT ist, wird parse_str verwendet um den rohen PUT
+        Verwendung von <acronym>PUT</acronym> Request Bodies in Anfrage Parametern, so wie
+        <acronym>POST</acronym> Anfrage Parameter. Er betrachtet die Anfrage und, wenn diese
+        <acronym>PUT</acronym> ist, wird parse_str verwendet um den rohen <acronym>PUT</acronym>
         Body in ein Array von Parametern zu parsen welches dann bei der Anfrage gesetzt wird. z.B.,
     </para>
 
@@ -28,8 +29,8 @@ $front->registerPlugin(new Zend_Controller_Plugin_PutHandler());
 ]]></programlisting>
 
     <para>
-        Anschließend kann man auf die Parameter des PUT Bodies durch Ihren Namen zugreifen, von der
-        Anfrage im eigenen Controller aus:
+        Anschließend kann man auf die Parameter des <acronym>PUT</acronym> Bodies durch Ihren Namen
+        zugreifen, von der Anfrage im eigenen Controller aus:
     </para>
 
     <programlisting language="php"><![CDATA[

documentation/manual/de/module_specs/Zend_Controller-Router-Route-Rest.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17991 -->
+<!-- EN-Revision: 19161 -->
 <!-- Reviewed: no -->
 <sect3 id="zend.controller.router.routes.rest">
     <title>Zend_Rest_Route</title>
@@ -29,39 +29,39 @@
             </thead>
             <tbody>
                 <row>
-                    <entry>GET</entry>
+                    <entry><acronym>GET</acronym></entry>
                     <entry><filename>/product/ratings/</filename></entry>
                     <entry><methodname>Product_RatingsController::indexAction()</methodname></entry>
                 </row>
                 <row>
-                    <entry>GET</entry>
+                    <entry><acronym>GET</acronym></entry>
                     <entry><filename>/product/ratings/:id</filename></entry>
                     <entry><methodname>Product_RatingsController::getAction()</methodname></entry>
                 </row>
                 <row>
-                    <entry>POST</entry>
+                    <entry><acronym>POST</acronym></entry>
                     <entry><filename>/product/ratings</filename></entry>
                     <entry><methodname>Product_RatingsController::postAction()</methodname></entry>
                 </row>
                 <row>
-                    <entry>PUT</entry>
+                    <entry><acronym>PUT</acronym></entry>
                     <entry><filename>/product/ratings/:id</filename></entry>
                     <entry><methodname>Product_RatingsController::putAction()</methodname></entry>
                 </row>
                 <row>
-                    <entry>DELETE</entry>
+                    <entry><acronym>DELETE</acronym></entry>
                     <entry><filename>/product/ratings/:id</filename></entry>
                     <entry>
                         <methodname>Product_RatingsController::deleteAction()</methodname>
                     </entry>
                 </row>
                 <row>
-                    <entry>POST</entry>
+                    <entry><acronym>POST</acronym></entry>
                     <entry><command>/product/ratings/:id?_method="PUT"</command></entry>
                     <entry><methodname>Product_RatingsController::putAction()</methodname></entry>
                 </row>
                 <row>
-                    <entry>POST</entry>
+                    <entry><acronym>POST</acronym></entry>
                     <entry><command>/product/ratings/:id?_method="DELETE"</command></entry>
                     <entry>
                         <methodname>Product_RatingsController::deleteAction()</methodname>

documentation/manual/de/module_specs/Zend_Date-Constants.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 18842 -->
+<!-- EN-Revision: 19162 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.date.constants">
     <title>Konstanten für generelle Datums Funktionen</title>

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 18842 -->
+<!-- EN-Revision: 19162 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.date.overview">
     <title>Zend_Date API Übersicht</title>

documentation/manual/de/module_specs/Zend_Db_Select.xml

@@ -2,11 +2,9 @@
 <!-- EN-Revision: 19109 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.db.select">
-
     <title>Zend_Db_Select</title>
 
     <sect2 id="zend.db.select.introduction">
-
         <title>Einführung</title>
 
         <para>

documentation/manual/de/module_specs/Zend_Feed_Reader.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 18514 -->
+<!-- EN-Revision: 19170 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.feed.reader">
     <title>Zend_Feed_Reader</title>
@@ -429,6 +429,86 @@ foreach ($links as $link) {
         </para>
   </sect2>
 
+    <sect2 id="zend.feed.reader.attribute-collections">
+        <title>Attribut Sammlungen</title>
+
+        <para>
+            In einem Versuch die Rückgabetypen zu vereinfachen, können Rückgabetypen für die
+            verschiedenen Feed und Entry Level Methoden ab Zend Framework 1.10 ein Objekt vom Typ
+            <classname>Zend_Feed_Reader_Collection_CollectionAbstract</classname> enthalten.
+            Abgesehen vom speziellen Klassennamen der anbei erklärt wird, ist es nur eine einfache
+            Subklasse von SPL's <classname>ArrayObject</classname>.
+        </para>
+
+        <para>
+            Der Hauptzweck hierbei besteht darin, die Präsentation von so vielen Daten wie möglich
+            von den angefragten Elementen zu erlauben, wärend trotzdem der Zugriff auf die meisten
+            relevanten Daten über ein einfaches Array erlaubt wird. Das erzwingt auch einen
+            Standardweg um solche Daten zurückzugeben, was vorher zwischen Arrays und Objekten
+            gewandert ist.
+        </para>
+
+        <para>
+            Der neue Klassentyp arbeitet identisch zu <classname>ArrayObject</classname>, mit der
+            gleichen kleinen Änderung dass eine neue Methode <methodname>getValues()</methodname>
+            existiert welche ein einfaches flaches Array zurückgibt dass die meisten relevanten
+            Informationen enthält.
+        </para>
+
+        <para>
+            Ein einfaches Beispiel hiervon ist
+            <methodname>Zend_Feed_Reader_FeedInterface::getCategories()</methodname>. Wenn es in
+            irgendeinem RSS oder Atom Feed verwendet wird, gibt diese Methode Daten der Kategorie
+            als Container Objekt zurück welches
+            <classname>Zend_Feed_Reader_Collection_Category</classname> genannt wird. Das Container
+            Objekt wird, für jede Kategorie, drei Felder an Daten enthalten: Typ, Schema und Label.
+            "type" ist der grundsätzliche Name der Kategorie, oft Maschinen lesbar (normalerweise
+            ein URI Identifikator) und in RSS 2.0 auch bekannt als "domain". "label" ist ein
+            menschlich lesbarer Kategorie Name welcher Html Entities unterstützt.
+        </para>
+
+        <para>
+            Um auf die Label der Kategorie selbst als einfache Array Werte zuzugreifen könnte man
+            das folgende verwenden:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$feed = Zend_Feed_Reader::import('http://www.example.com/atom.xml');
+$categories = $feed->getCategories();
+$labels = array();
+foreach ($categories as $cat) {
+    $labels[] = $cat['label']
+}
+]]></programlisting>
+
+        <para>
+            Es ist ein erfundenes Beispiel, aber der Punkt ist, dass Label zusammen mit anderen
+            Informationen gebunden sind.
+        </para>
+
+        <para>
+            Trotzdem erlaubt die Container Klasse den Zugriff auf die "relevantesten" Daten als
+            einfaches Array indem die Methode <methodname>getValues()</methodname> verwendet wird.
+            Das Konzept der "relevantesten" Daten ist offensichtlich ein beurteilter Aufruf. Für
+            Kategorien bedeutet es die Label der Kategorien (nicht die Typen oder Schemata) wärend
+            es für Autoren der Name des Autors wäre (nicht deren Email Adressen oder die URLs). Das
+            einfache Array ist flach (nur Werte) und durchläuft
+            <methodname>array_unique</methodname> um doppelte Werte zu entfernen.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$feed = Zend_Feed_Reader::import('http://www.example.com/atom.xml');
+$categories = $feed->getCategories();
+$labels = $categories->getValues();
+]]></programlisting>
+
+        <para>
+            Das obige Beispiel zeigt wie nur die Label und sonst nichts extrahiert wird. Das gibt
+            einen einfachen Zugriff auf die Label der Kategorie ohne zusätzliche Arbeit die Daten
+            selbst zu extrahieren.
+        </para>
+    </sect2>
+
   <sect2 id="zend.feed.reader.retrieve-info">
         <title>Empfangen von Feed Informationen</title>
 
@@ -593,6 +673,22 @@ foreach ($links as $link) {
                             für Feeds für Real-Time Updates.
                         </entry>
                     </row>
+
+                    <row>
+                        <entry><methodname>getCategories()</methodname></entry>
+
+                        <entry>
+                            Gibt ein <classname>Zend_Feed_Reader_Collection_Category</classname>
+                            Objekt zurück welches die Details aller Kategorien enthält die im
+                            kompletten Feed enthalten sind. Die unterstützten Felder enthalten
+                            "type" (den Maschinen lesbaren Namen der Kategorie), "scheme"
+                            (dem Schema der Kategorisierung für diese Kategorie), und "label" (ein
+                            Html dekodierter menschlich lesbarer Kategoriename). Wenn irgendeines
+                            der drei Felder abwesend ist, werden Sie entweder auf die näheste
+                            vorhandene Alternative gesetzt, oder im Fall von "scheme", auf NULL
+                            gesetzt.
+                        </entry>
+                    </row>
                 </tbody>
             </tgroup>
         </table>
@@ -925,6 +1021,21 @@ foreach ($links as $link) {
                             aktuellen Feed Typ).
                         </entry>
                     </row>
+
+                    <row>
+                        <entry><methodname>getCategories()</methodname></entry>
+
+                        <entry>
+                            Gibt ein <classname>Zend_Feed_Reader_Collection_Category</classname>
+                            Objekt zurück welches die Details jeder Kategorie enthält welche mit dem
+                            Eintrag assoziiert ist. Die unterstützten Felder sind "type" (der
+                            Maschinen lesbare Name der Kategorie), "scheme" (der Name des Schemas
+                            der Kategorisierung für diese Kategorie), und "label" (ein Html
+                            dekodierter menschlich lesbarer Name der Kategorie). Wenn eines der drei
+                            Felder nicht vorhanden ist, werden Sie entweder auf den näheste
+                            vorhandene Alternative, oder im Fall von "scheme", auf NULL gesetzt.
+                        </entry>
+                    </row>
                 </tbody>
             </tgroup>
         </table>

documentation/manual/de/module_specs/Zend_Rest.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 19118 -->
+<!-- EN-Revision: 19162 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.rest.introduction">
     <title>Einführung</title>

documentation/manual/de/module_specs/Zend_Translate-Plurals.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17110 -->
+<!-- EN-Revision: 19161 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.translate.plurals">