[DOCUMENTATION] German:

- sync up to r16986

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

documentation/manual/de/manual.xml.in

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 16911 -->
+<!-- EN-Revision: 16981 -->
 <!-- Reviewed: no -->
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
     "@DOCBOOK_DTD@"
@@ -361,6 +361,7 @@
         <xi:include href="module_specs/Zend_Navigation-Introduction.xml" />
         <xi:include href="module_specs/Zend_Navigation-Pages.xml" />
         <xi:include href="module_specs/Zend_Navigation-Containers.xml" />
+        <xi:include href="module_specs/Zend_Navigation-Migration.xml" />
     </chapter>
 
     <chapter id="zend.openid">

documentation/manual/de/module_specs/Zend_Config_Xml.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 16924 -->
+<!-- EN-Revision: 16945 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.config.adapters.xml">
     <title>Zend_Config_Xml</title>

documentation/manual/de/module_specs/Zend_Db_Table_Definition.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 16831 -->
+<!-- EN-Revision: 16943 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.db.table.definition">
 

documentation/manual/de/module_specs/Zend_Feed_Reader.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 16721 -->
+<!-- EN-Revision: 16968 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.feed.reader">
     <title>Zend_Feed_Reader</title>
@@ -712,9 +712,21 @@ if(isset($links->atom)) {
                         <entry><methodname>getExtensions()</methodname></entry>
 
                         <entry>
-                            Returns an array of non-Core Extension objects loaded for
+                            Returns an array of all Extension objects loaded for
                             the current feed (note: both feed-level and entry-level Extensions
                             exist, and only feed-level Extensions are returned here).
+                            The array keys are of the form {ExtensionName}_Feed.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getExtension(string $name)</methodname></entry>
+
+                        <entry>
+                            Returns an Extension object for the feed registered under the
+                            provided name. This allows more fine-grained access to
+                            Extensions which may otherwise be hidden within the implementation
+                            of the standard API methods.
                         </entry>
                     </row>
 
@@ -973,10 +985,21 @@ if(isset($links->atom)) {
                         <entry><methodname>getExtensions()</methodname></entry>
 
                         <entry>
-                            Returns an array of non-Core Extension objects loaded for
+                            Returns an array of all Extension objects loaded for
                             the current entry (note: both feed-level and entry-level
                             Extensions exist, and only entry-level Extensions are returned
-                            here).
+                            here). The array keys are in the form {ExtensionName}_Entry.
+                        </entry>
+                    </row>
+
+                    <row>
+                        <entry><methodname>getExtension(string $name)</methodname></entry>
+
+                        <entry>
+                            Returns an Extension object for the entry registered under the
+                            provided name. This allows more fine-grained access to
+                            Extensions which may otherwise be hidden within the implementation
+                            of the standard API methods.
                         </entry>
                     </row>
 
@@ -1044,7 +1067,8 @@ if(isset($links->atom)) {
                     <row>
                         <entry>DublinCore (Feed and Entry)</entry>
 
-                        <entry>Implements support for both Dublin Core 1.0 and 1.1</entry>
+                        <entry>Implements support for Dublin Core Metadata Element Set 1.0
+                        and 1.1 </entry>
                     </row>
 
                     <row>
@@ -1062,13 +1086,26 @@ if(isset($links->atom)) {
                     <row>
                         <entry>Slash</entry>
 
-                        <entry>todo</entry>
+                        <entry>Implements support for the Slash RSS 1.0 module</entry>
                     </row>
 
                     <row>
                         <entry>WellFormedWeb</entry>
 
-                        <entry>todo</entry>
+                        <entry>Implements support for the Well Formed Web CommentAPI 1.0</entry>
+                    </row>
+
+                    <row>
+                        <entry>Thread</entry>
+
+                        <entry>Implements support for Atom Threading Extensions as described
+                        in RFC 4685</entry>
+                    </row>
+
+                    <row>
+                        <entry>Podcast</entry>
+
+                        <entry>Implements support for the Podcast 1.0 DTD from Apple</entry>
                     </row>
                 </tbody>
             </tgroup>
@@ -1078,7 +1115,7 @@ if(isset($links->atom)) {
             The Core Extensions are somewhat special since they are extremely
             common and multi-faceted. For example, we have a Core Extension for Atom.
             Atom is implemented as an Extension (not just a base class) because it
-            doubles as a valid <acronym>RSS</acronym> Extension - you can insert
+            doubles as a valid <acronym>RSS</acronym> module - you can insert
             Atom elements into <acronym>RSS</acronym> feeds. I've even seen
             <acronym>RDF</acronym> feeds which use a lot of Atom in place of more
             common Extensions like Dublin Core.
@@ -1087,10 +1124,17 @@ if(isset($links->atom)) {
         <table>
             <title>Non-Core Extensions (must register manually)</title>
 
-            <tgroup cols="1">
+            <tgroup cols="2">
                 <tbody>
                     <row>
-                        <entry>At present, no non-Core Extensions are distributed.</entry>
+                        <entry>Syndication</entry>
+                        <entry>Implements Syndication 1.0 support for RSS feeds</entry>
+                    </row>
+                    <row>
+                        <entry>CreativeCommons</entry>
+                        <entry>A RSS module that adds an element at the &lt;channel&gt;
+                        or &lt;item&gt; level that specifies which Creative Commons license
+                        applies.</entry>
                     </row>
                 </tbody>
             </tgroup>
@@ -1101,7 +1145,8 @@ if(isset($links->atom)) {
             <classname>Zend_Feed_Reader</classname> by default. If you want to
             use them, you'll need to tell
             <classname>Zend_Feed_Reader</classname> to load them in advance of
-            importing a feed.
+            importing a feed. Additional non-Core Extensions will be included
+            in future iterations of the component.
         </para>
 
         <para>
@@ -1116,21 +1161,32 @@ if(isset($links->atom)) {
         </para>
 
         <programlisting language="php"><![CDATA[
-Zend_Feed_Reader::registerExtension('Slash');
+Zend_Feed_Reader::registerExtension('Syndication');
 $feed = Zend_Feed_Reader::import('http://rss.slashdot.org/Slashdot/slashdot');
-$commentsForLastEntry = $feed->current()->getCommentCount();
+$updatePeriod = $feed->current()->getUpdatePeriod();
 ]]></programlisting>
 
         <para>
-            In the simple example above, we checked how many comments were made
-            on an entry using the <methodname>getCommentCount()</methodname>
+            In the simple example above, we checked how frequently a feed is being updated
+            using the <methodname>getUpdatePeriod()</methodname>
             method. Since it's not part of
             <classname>Zend_Feed_Reader</classname>'s core <acronym>API</acronym>, it could only be
-            a method supported by the newly registered Slash Extension (indeed
-            Slash was invented at Slashdot as an <acronym>RDF</acronym> Site Summary module and is
-            now fairly popular).
+            a method supported by the newly registered Syndication Extension.
         </para>
 
+        <para>
+            As you can also notice, the new methods from Extensions are accessible from the main
+            <acronym>API</acronym> using PHP's magic methods. As an alternative, you can also
+            directly access any Extension object for a similar result as seen below.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+Zend_Feed_Reader::registerExtension('Syndication');
+$feed = Zend_Feed_Reader::import('http://rss.slashdot.org/Slashdot/slashdot');
+$syndication = $feed->getExtension('Syndication');
+$updatePeriod = $syndication->getUpdatePeriod();
+]]></programlisting>
+
         <sect3 id="zend.feed.reader.extending.feed">
             <title>Writing Zend_Feed_Reader Extensions</title>
 
@@ -1216,7 +1272,7 @@ class My_FeedReader_Extension_JungleBooks_Entry
         if (!$isbn) {
             $isbn = null;
         }
-        $this->_data['isbn'] = $title;
+        $this->_data['isbn'] = $isbn;
         return $this->_data['isbn'];
     }
 

documentation/manual/de/module_specs/Zend_Navigation-Migration.xml

@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 16981 -->
+<!-- Reviewed: no -->
+<sect1 id="zend.navigation.migration">
+    <title>Migrating from Previous Versions</title>
+
+    <para>
+        This chapter documents primarily backwards compatibility breaks made in
+        Zend_Navigation and Zend_View_Helper_Navigation, and should serve to aid
+        in migration from previous versions.
+    </para>
+
+    <sect2 id="zend.view.navigation.zf7341">
+        <title>Migrating from versions prior to 1.9</title>
+
+        <para>
+            Prior to the 1.9 release, the menu helper
+            (<classname>Zend_View_Helper_Navigation_Menu</classname>) did not
+            render sub menus correctly. When the <code>onlyActiveBranch</code>
+            was <code>true</code> and the option <code>renderParents</code>
+            <code>false</code>, nothing would be rendered if the deepest active
+            page was at a depth lower than the <code>minDepth</code> option.
+        </para>
+
+        <para>
+            In simpler words; if <code>minDepth</code> was set to <code>1</code>
+            and the active page was at one of the first level pages, nothing
+            would be rendered, as the following example shows.
+        </para>
+
+        <para>
+            Consider the following container setup:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+<?php
+$container = new Zend_Navigation(array(
+    array(
+        'label' => 'Home',
+        'uri'   => '#'
+    ),
+    array(
+        'label'  => 'Products',
+        'uri'    => '#',
+        'active' => true,
+        'pages'  => array(
+            array(
+                'label' => 'Server',
+                'uri'   => '#'
+            ),
+            array(
+                'label' => 'Studio',
+                'uri'   => '#'
+            )
+        )
+    ),
+    array(
+        'label' => 'Solutions',
+        'uri'   => '#'
+    )
+));
+]]></programlisting>
+
+        <para>
+            The following code is used in a view script:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+<?php echo $this->navigation()->menu()->renderMenu($container, array(
+    'minDepth'         => 1,
+    'onlyActiveBranch' => true,
+    'renderParents'    => false
+)); ?>]]></programlisting>
+
+        <para>
+            Before release 1.9, the code snippet above would output nothing.
+        </para>
+
+        <para>
+            Since release 1.9, the <code>_renderDeepestMenu()</code> method in
+            <classname>Zend_View_Helper_Navigation_Menu</classname> will accept
+            active pages at one level below <code>minDepth</code>, as long as
+            the page has children.
+        </para>
+
+        <para>
+            The same code snippet will now output the following:
+        </para>
+
+        <programlisting language="html"><![CDATA[
+<ul class="navigation">
+    <li>
+        <a href="#">Server</a>
+    </li>
+    <li>
+        <a href="#">Studio</a>
+    </li>
+</ul>]]></programlisting>
+    </sect2>
+</sect1>

documentation/manual/de/module_specs/Zend_Queue-Framework.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 16603 -->
+<!-- EN-Revision: 16949 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.queue.framework">
     <title>Framework</title>

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 16883 -->
+<!-- EN-Revision: 16952 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.translate.additional">
 
@@ -33,7 +33,7 @@
 
         <example id="zend.translate..additional.options.example">
             <title>Benutzen von Übersetzungsoptionen</title>
-            <programlisting role="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 // Definiere ':' als Trenner für die Quelldatei der Übersetzung
 $options = array('delimiter' => ':');
 $translate = new Zend_Translate(
@@ -75,7 +75,7 @@ $translate->addTranslation('/path/to/new.csv', 'fr', $options);
                             Das kann statt dem Erstellen einer neuen Instanz verwendet werden wenn
                             neue Übersetzungsdaten gelesen werden
                         </entry>
-                        <entry><emphasis role="strong">false</emphasis></entry>
+                        <entry><emphasis>false</emphasis></entry>
                     </row>
                     <row>
                         <entry>disableNotices</entry>
@@ -85,7 +85,7 @@ $translate->addTranslation('/path/to/new.csv', 'fr', $options);
                             vorhandenen Übersetzungen ausgeschaltet. Man sollte diese Option in
                             einer Produktionsumgebung auf true setzen
                         </entry>
-                        <entry><emphasis role="strong">false</emphasis></entry>
+                        <entry><emphasis>false</emphasis></entry>
                     </row>
                     <row>
                         <entry>ignore</entry>
@@ -99,7 +99,7 @@ $translate->addTranslation('/path/to/new.csv', 'fr', $options);
                             Dateien wie z.B. <code>'tmpImages'</code> und <code>'tmpFiles'</code>,
                             sowie alle darunter liegenden Verzeichnisse, werden ignoriert.
                         </entry>
-                        <entry><emphasis role="strong">.</emphasis></entry>
+                        <entry><emphasis>.</emphasis></entry>
                     </row>
                     <row>
                         <entry>log</entry>
@@ -108,7 +108,7 @@ $translate->addTranslation('/path/to/new.csv', 'fr', $options);
                             Eine Instanz von <classname>Zend_Log</classname> wohin nicht
                             übersetzbare Meldungen und Notizen geschrieben werden
                         </entry>
-                        <entry><emphasis role="strong">null</emphasis></entry>
+                        <entry><emphasis>null</emphasis></entry>
                     </row>
                     <row>
                         <entry>logMessage</entry>
@@ -116,7 +116,7 @@ $translate->addTranslation('/path/to/new.csv', 'fr', $options);
                         <entry>
                             Die Nachricht die in das Log geschrieben werden soll
                         </entry>
-                        <entry><emphasis role="strong">Untranslated message within '%locale%': %message%</emphasis></entry>
+                        <entry><emphasis>Untranslated message within '%locale%': %message%</emphasis></entry>
                     </row>
                     <row>
                         <entry>logUntranslated</entry>
@@ -125,7 +125,7 @@ $translate->addTranslation('/path/to/new.csv', 'fr', $options);
                             Wenn diese Option auf true gesetzt wird, werden alle Nachrichten Id's
                             die nicht übersetzt werden können in das angehängte Log geschrieben
                         </entry>
-                        <entry><emphasis role="strong">false</emphasis></entry>
+                        <entry><emphasis>false</emphasis></entry>
                     </row>
                     <row>
                         <entry>scan</entry>
@@ -138,7 +138,7 @@ $translate->addTranslation('/path/to/new.csv', 'fr', $options);
                             wird das Gebietsschema im Dateinamen gesucht. Siehe
                             <xref linkend="zend.translate.using.detection" /> für Details
                         </entry>
-                        <entry><emphasis role="strong">null</emphasis></entry>
+                        <entry><emphasis>null</emphasis></entry>
                     </row>
                     <row>
                         <entry>delimiter</entry>
@@ -147,7 +147,7 @@ $translate->addTranslation('/path/to/new.csv', 'fr', $options);
                             Definiert welches Zeichen als Trenner für Quelle und Übersetzung
                             verwendet wird
                         </entry>
-                        <entry><emphasis role="strong">;</emphasis></entry>
+                        <entry><emphasis>;</emphasis></entry>
                     </row>
                     <row>
                         <entry>enclosure</entry>
@@ -156,7 +156,7 @@ $translate->addTranslation('/path/to/new.csv', 'fr', $options);
                             Definiert die maximale Länge einer CSV Zeile. Auf 0 gesetzt wird sie
                             automatisch erkannt
                         </entry>
-                        <entry><emphasis role="strong">"</emphasis></entry>
+                        <entry><emphasis>"</emphasis></entry>
                     </row>
                     <row>
                         <entry>length</entry>
@@ -165,7 +165,7 @@ $translate->addTranslation('/path/to/new.csv', 'fr', $options);
                             Definiert das zu verwendende Einschließungszeichen. Standard ist das
                             doppelte Hochkomma
                         </entry>
-                        <entry><emphasis role="strong">0</emphasis></entry>
+                        <entry><emphasis>0</emphasis></entry>
                     </row>
                 </tbody>
             </tgroup>
@@ -229,7 +229,7 @@ $translate->addTranslation('/path/to/new.csv', 'fr', $options);
 
         <example id="zend.translate.additional.languages.example">
             <title>Handhabung von Sprachen mit Adaptern</title>
-            <programlisting role="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 // gibt die aktuell gesetzte Sprache zurück
 $actual = $translate->getLocale();
 
@@ -272,7 +272,7 @@ if ($translate->isAvailable("fr")) {
 
             <example id="zend.translate.additional.languages.automatic.example">
                 <title>Automatische Erkennen der Sprache</title>
-                <programlisting role="php"><![CDATA[
+                <programlisting language="php"><![CDATA[
 // Angenommen der Browser gibt folgende Spracheneinstellungen zurück:
 // HTTP_ACCEPT_LANGUAGE = "de_AT=1;fr=1;en_US=0.8";
 
@@ -335,7 +335,7 @@ $translate->setLocale('it_IT');
                 verwenden will.
             </para>
 
-            <programlisting role="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 // In der Bootstrap Datei
 $locale = new Zend_Locale();
 Zend_Registry::set('Zend_Locale', $locale);
@@ -383,7 +383,7 @@ $translate->getLocale();
 
         <example id="zend.translate.additional.languages.directory.example">
             <title>Scannen nach Quellen in einer Verzeichnisstruktur</title>
-            <programlisting role="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 // Angenommen wir haben die folgende Struktur
 //  /language/
 //  /language/login/login.tmx
@@ -440,7 +440,7 @@ $translate = new Zend_Translate('tmx', '/language');
 
             <example id="zend.translate.additional.detection.directory.example">
                 <title>Verzeichnisse nach Sprachen durchsuchen</title>
-                <programlisting role="php"><![CDATA[
+                <programlisting language="php"><![CDATA[
 // Angenommen wir haben die folgende Struktur
 //  /language/
 //  /language/de/login/login.mo
@@ -493,7 +493,7 @@ $translate = new Zend_Translate(
 
             <example id="zend.translate.additional.detection.filename.example">
                 <title>Suchen nach Sprachen im Dateinamen</title>
-                <programlisting role="php"><![CDATA[
+                <programlisting language="php"><![CDATA[
 // Angenommen wir haben die folgende Struktur
 //  /language/
 //  /language/login/login_en.mo
@@ -622,7 +622,7 @@ $translate = new Zend_Translate(
 
         <example id="zend.translate.additional.istranslated.example">
             <title>Prüfen ob ein Text übersetzbar ist</title>
-            <programlisting role="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $english = array(
     'message1' => 'Nachricht 1',
     'message2' => 'Nachricht 2',
@@ -666,7 +666,7 @@ if ($translate->isTranslated('message1', false, 'de')) {
 
         <example id="zend.translate.additional.logging.example">
             <title>Übersetzungen loggen</title>
-            <programlisting role="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $translate = new Zend_Translate('gettext', $path, 'de');
 
 // Eine Log Instanz erstellen
@@ -714,7 +714,7 @@ $translate->translate('unbekannter String');
 
         <example id="zend.translate.additional.logging.example2">
             <title>Selbstdefinierte Logmeldungen</title>
-            <programlisting role="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 $translate = new Zend_Translate('gettext', $path, 'de');
 
 // Eine Loginstanz erstellen
@@ -779,7 +779,7 @@ $translate->translate('unknown string');
 
         <example id="zend.translate.additional.sourcedata.example">
             <title>Handhabung von Quelldaten</title>
-            <programlisting role="php"><![CDATA[
+            <programlisting language="php"><![CDATA[
 // gibt alle bekannten Übersetzungs Ids zurück
 $messageIds = $translate->getMessageIds();
 print_r($messageIds);