[DOCUMENTATION] German:

- sync up to r18305

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

documentation/manual/de/module_specs/Zend_Feed-Importing.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17502 -->
+<!-- EN-Revision: 18274 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.feed.importing">
     <title>Feeds importieren</title>
@@ -337,11 +337,11 @@ $atomFeedFromArray =
 // Die folgende Zeile ist mit der obigen äquivalent; standardmäßig
 // wird eine Zend_Feed_Atom Instanz zurückgegeben
 $atomFeedFromArray =
-    Zend_Feed::importArray(new Zend_Feed_Builder($array), 'atom');
+    Zend_Feed::importBuilder(new Zend_Feed_Builder($array), 'atom');
 
 // Einen RSS Feeed von einem Array von eigenen Erstellungsquellen importieren
 $rssFeedFromArray =
-    Zend_Feed::importArray(new Zend_Feed_Builder($array), 'rss');
+    Zend_Feed::importBuilder(new Zend_Feed_Builder($array), 'rss');
 ]]></programlisting>
         </sect3>
 

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

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 18260 -->
+<!-- EN-Revision: 18298 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.mail.introduction">
 

documentation/manual/de/module_specs/Zend_Validate-Callback.xml

@@ -0,0 +1,223 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 18270 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.validate.set.callback">
+    <title>Callback</title>
+
+    <para>
+        <classname>Zend_Validate_Callback</classname> erlaubt es einen Callback anzugeben der
+        verwendet wird um einen angegebenen Wert zu prüfen.
+    </para>
+
+    <sect3 id="zend.validate.set.callback.basic">
+        <title>Grundsätzliche Verwendung</title>
+
+        <para>
+            Der einfachste Anwendungsfall besteht darin eine einzelne Funktion zu haben und diese
+            als Callback zu verwenden. Angenommen wir haben die folgende Funktion.
+        </para>
+
+        <programlisting language="php"><![CDATA[
+function myMethod($value)
+{
+    // einige Prüfungen
+    return true;
+}
+]]></programlisting>
+
+        <para>
+            Um diese in <classname>Zend_Validate_Callback</classname> zu verwenden muss man Sie
+            nur auf folgende Weise aufrufen:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$valid = new Zend_Validate_Callback('myMethod');
+if ($valid->isValid($input)) {
+    // Input scheint gültig zu sein
+} else {
+    // Input ist ungültig
+}
+]]></programlisting>
+    </sect3>
+
+    <sect3 id="zend.validate.set.callback.closure">
+        <title>Verwendung mit Closures</title>
+
+        <para>
+            PHP 5.3 führt <ulink url="http://php.net/functions.anonymous">Closures</ulink> ein,
+            welche grundsätzlich selbst-enthaltene oder <emphasis>anonyme</emphasis> Funktionen
+            sind. PHP nimmt an das Closures eine andere Form eines Callbacks sind, und können daher
+            als solche mit <classname>Zend_Validate_Callback</classname> verwendet werden. Als
+            Beispiel:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$valid = new Zend_Validate_Callback(function($value){
+    // einige Prüfungen
+    return true;
+});
+
+if ($valid->isValid($input)) {
+    // Input scheint gültig zu sein
+} else {
+    // Input ist ungültig
+}
+]]></programlisting>
+    </sect3>
+
+    <sect3 id="zend.validate.set.callback.class">
+        <title>Verwendung mit klassenbasierten Callbacks</title>
+
+        <para>
+            Natürlich ist es auch möglich eine Klassenmethode als Callback zu verwenden. Angenommen
+            wir haben die folgende Klassenmethode:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+class MyClass
+{
+    public function myMethod($value)
+    {
+        // einige Prüfungen
+        return true;
+    }
+}
+]]></programlisting>
+
+        <para>
+            Die Definition des Callbacks ist in diesem Fall fast die gleiche. Man muss nur eine
+            Instanz der Klasse vor der Methode erstellen und ein Array das den Callback beschreibt:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$object = new MyClass;
+$valid = new Zend_Validate_Callback(array($object, 'myMethod'));
+if ($valid->isValid($input)) {
+    // Input scheint gültig zu sein
+} else {
+    // Input ist ungültig
+}
+]]></programlisting>
+
+        <para>
+            Man kann auch eine statische Methode als Callback definieren. Angenommen wir haben die
+            folgende Klassendefinition dann ist die Verwendung des Prüfers wie folgt:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+class MyClass
+{
+    public static function test($value)
+    {
+        // Einige Prüfungen
+        return true;
+    }
+}
+
+$valid = new Zend_Validate_Callback(array('MyClass, 'test'));
+if ($valid->isValid($input)) {
+    // Input scheint gültig zu sein
+} else {
+    // Input ist ungültig
+}
+]]></programlisting>
+
+        <para>
+            Letztendlich kann man, wenn man PHP 5.3 verwendet, die magische Methode
+            <methodname>__invoke()</methodname> in der eigenen Klasse definieren. Wenn man das tut
+            dann funktioniert die Angabe einer Instanz der Klasse genauso:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+class MyClass
+{
+    public function __invoke($value)
+    {
+        // some validation
+        return true;
+    }
+}
+
+$object = new MyClass();
+$valid = new Zend_Validate_Callback($object);
+if ($valid->isValid($input)) {
+    // Input scheint gültig zu sein
+} else {
+    // Input ist ungültig
+}
+]]></programlisting>
+    </sect3>
+
+    <sect3 id="zend.validate.set.callback.options">
+        <title>Optionen hinzufügen</title>
+
+        <para>
+            <classname>Zend_Validate_Callback</classname> erlaubt auch die Verwendung von Optionen
+            welche als zusätzliche Argumente dem Callback übergeben werden.
+        </para>
+
+        <para>
+            Nehmen wir die folgende Klassen und Methoden Definition an:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+class MyClass
+{
+    function myMethod($value, $option)
+    {
+        // einige Prüfungen
+        return true;
+    }
+}
+]]></programlisting>
+
+        <para>
+            Es gibt zwei Wege um den Prüfer über zusätzliche Optionen zu informieren: Diese im
+            Constructor übergeben, oder Sie mit der Methode <methodname>setOptions()</methodname>
+            übergeben.
+        </para>
+
+        <para>
+            Um Sie im Contructor zu übergeben, muss ein Array übergeben werden das die zwei
+            Schlüssel "callback" und "options" enthält:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$valid = new Zend_Validate_Callback(array(
+    'callback' => array('MyClass', 'myMethod'),
+    'options'  => $option,
+));
+
+if ($valid->isValid($input)) {
+    // Input scheint gültig zu sein
+} else {
+    // Input ist ungültig
+}
+]]></programlisting>
+
+        <para>
+            Andererseits können Sie dem Prüfer auch nach der Instanzierung übergeben werden:
+        </para>
+
+        <programlisting language="php"><![CDATA[
+$valid = new Zend_Validate_Callback(array('MyClass', 'myMethod'));
+$valid->setOptions($option);
+
+if ($valid->isValid($input)) {
+    // Input scheint gültig zu sein
+} else {
+    // Input ist ungültig
+}
+]]></programlisting>
+
+        <para>
+            Wenn der Aufruf zu einem Callback durchgeführt wird, dann wird der Wert der zu
+            überprüfen ist als erstes Argument an den Callback übergeben; alle anderen Optionen
+            folgen Ihm. Die anzahl und der Typ der Optionen welche verwendet werden ist nicht
+            limitiert.
+        </para>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->

documentation/manual/de/module_specs/Zend_Validate-PostCode.xml

@@ -0,0 +1,119 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- EN-Revision: 18288 -->
+<!-- Reviewed: no -->
+<sect2 id="zend.validate.set.post_code">
+
+    <title>PostCode</title>
+
+    <para>
+        <classname>Zend_Validate_PostCode</classname> erlaubt es zu eruieren ob ein angegebener
+        Wert eine gültige Postleitzahl ist. Postleitzahlen sind spezifisch für Städte und in einigen
+        Gebietsschemata auch als ZIP Codes bezeichnet.
+    </para>
+
+    <para>
+        <classname>Zend_Validate_PostCode</classname> kennt mehr als 160 unterschiedliche Formate
+        für Postleitzahlen. Um das richtige Format auszuwählen gibt es 2 Wege. Man kann entweder
+        ein voll qualifiziertes Gebietsschema verwenden, oder ein eigenes Format manuall setzen.
+    </para>
+
+    <para>
+        Die Verwendung eines Gebietsschemas ist bequemer da Zend Framework bereits die
+        entsprechenden Formate für Postleitzahlen für jedes Gebietsschema kennt; aber muss man
+        ein voll qualifiziertes Gebietsschema verwenden (eines das eine Region spezifiziert) damit
+        es funktioniert. Das Gebietsschema "de" zum Beispiel ist zwar ein Gebietsschema, kann aber
+        nicht mit <classname>Zend_Validate_PostCode</classname> verwendet werden da es keine
+        Region enthält; "de_AT" andererseits würde ein gültiges Gebietsschema sein da es den
+        Region Code spezifiziert ("AT", für Österreich).
+    </para>
+
+    <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_PostCode('de_AT');
+]]></programlisting>
+
+    <para>
+        Wenn man das Gebietsschema nicht selbst setzt, dann verwendet
+        <classname>Zend_Validate_PostCode</classname> das anwendungsweit gesetzte Gebietsschema,
+        oder wenn keines vorhanden ist, das Gebietsschema welches von
+        <classname>Zend_Locale</classname> zurückgegeben wird.
+    </para>
+
+    <programlisting language="php"><![CDATA[
+// Anwendungsweites Gebietsschema in der Bootstrap
+$locale = new Zend_Locale('de_AT');
+Zend_Registry::set('Zend_Locale', $locale);
+
+$validator = new Zend_Validate_PostCode();
+]]></programlisting>
+
+    <para>
+        Man kann das Gebietsschema auch im Nachhinein ändern, indem man
+        <methodname>setLocale()</methodname> aufruft. Und natürlich kann man das aktuelle
+        Gebietsschema erhalten indem <methodname>getLocale()</methodname> aufgerufen wird.
+    </para>
+
+    <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_PostCode('de_AT');
+$validator->setLocale('en_GB');
+]]></programlisting>
+
+    <para>
+        Postleitzahlen Formate selbst sind einfache Regular Expression Strings. Wenn das
+        internationale Postleitzahlen Format, welches durch das Setzen des Gebietsschemas verwendet
+        wird, den eigenen Bedüfnissen nicht entspricht, dann kann man ein Format auch manuell setzen
+        indem <methodname>setFormat()</methodname> aufgerufen wird.
+    </para>
+
+    <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_PostCode('de_AT');
+$validator->setFormat('AT-\d{5}');
+]]></programlisting>
+
+    <note>
+        <title>Konventionen für selbst definierte Formate</title>
+
+        <para>
+            Wenn selbst definierte Formate verwendet werden sollten die Start-
+            (<command>'/^'</command>) und Endetags (<command>'$/'</command>) nicht angegeben werden.
+            Sie werden automatisch hinzugefügt.
+        </para>
+
+        <para>
+            Man sollte darauf achtgeben das Postleitzahlen Werte immer auf einer strikte Art
+            geprüft werden. Das bedeutet das Sie alleinstehend geschrieben werden müssen, ohne
+            zusätzliche Zeichen, wenn diese nicht durch das Format abgedeckt werden.
+        </para>
+    </note>
+
+    <sect3 id="zend.validate.set.post_code.constructor">
+        <title>Optionen des Constructors</title>
+
+        <para>
+            Grundsätzlich kann man dem Contructor von <classname>Zend_Validate_PostCode</classname>
+            entweder ein <classname>Zend_Locale</classname> Objekt, oder einen String der ein voll
+            qualifiziertes Gebietsschema repräsentiert, angeben.
+        </para>
+
+    <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_PostCode('de_AT');
+$validator = new Zend_Validate_PostCode($locale);
+]]></programlisting>
+
+        <para>
+            Zusätzlich kann man dem Contructor entweder ein Array oder ein
+            <classname>Zend_Config</classname> Objekt übergeben. Wenn man das tut, muss man
+            entweder den Schlüssel "locale" oder "format" verwenden; diese werden verwendet um die
+            betreffenden Werte im Prüfobjekt zu setzen.
+        </para>
+
+    <programlisting language="php"><![CDATA[
+$validator = new Zend_Validate_PostCode(array(
+    'locale' => 'de_AT',
+    'format' => 'AT_\d+'
+));
+]]></programlisting>
+    </sect3>
+</sect2>
+<!--
+vim:se ts=4 sw=4 et:
+-->

documentation/manual/de/module_specs/Zend_Validate-Set.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17172 -->
+<!-- EN-Revision: 18298 -->
 <!-- Reviewed: no -->
 <sect1 id="zend.validate.set" xmlns:xi="http://www.w3.org/2001/XInclude">
 
@@ -62,6 +62,8 @@
         </para>
     </sect2>
 
+    <xi:include href="Zend_Validate-Callback.xml" />
+
     <sect2 id="zend.validate.set.ccnum">
         <title>Ccnum</title>
         <para>
@@ -202,15 +204,7 @@ if ($validator->isValid(1)) { // Token gültig
 ]]></programlisting>
     </sect2>
 
-    <sect2 id="zend.validate.set.in_array">
-        <title>InArray</title>
-        <para>
-            Gibt nur dann <constant>TRUE</constant> zurück wenn ein "needle"
-            <varname>$value</varname> in einem "haystack" Array enthalten ist. Wenn die Strict
-            Option <constant>TRUE</constant> ist, wird der Typ von <varname>$value</varname> auch
-            geprüft.
-        </para>
-    </sect2>
+    <xi:include href="Zend_Validate-InArray.xml" />
 
     <sect2 id="zend.validate.set.int">
         <title>Int</title>
@@ -248,6 +242,8 @@ if ($validator->isValid(1)) { // Token gültig
         </para>
     </sect2>
 
+    <xi:include href="Zend_Validate-PostCode.xml" />
+
     <sect2 id="zend.validate.set.regex">
         <title>Regex</title>
         <para>

documentation/manual/de/module_specs/Zend_View-Helpers-Navigation.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="UTF-8"?>
-<!-- EN-Revision: 17615 -->
+<!-- EN-Revision: 18277 -->
 <!-- Reviewed: no -->
 <sect3 id="zend.view.helpers.initial.navigation">
     <title>Navigations Helfer</title>
@@ -1717,7 +1717,7 @@ echo $this->navigation()->menu()->render();
 
             <programlisting language="php"><![CDATA[
 foreach ($this->container as $page) {
-    echo $this->menu()->htmlify($page), PHP_EOL;
+    echo $this->navigation()->menu()->htmlify($page), PHP_EOL;
 }
 ]]></programlisting>
 
@@ -2179,4 +2179,4 @@ echo $this->navigation()
            </listitem>
        </itemizedlist>
     </sect4>
-</sect3>
+</sect3>