[MANUAL] German:

  - added review
  - fixed XML structure: <programmlisting> not allowed in <para>

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

documentation/manual/de/module_specs/Zend_Validate.xml

@@ -1,33 +1,33 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!-- EN-Revision: 21661 -->
-<!-- Reviewed: no -->
+<!-- Reviewed: 21661 -->
 <sect1 id="zend.validate.introduction">
     <title>Einführung</title>
 
     <para>
-        Die <classname>Zend_Validate</classname> Komponente bietet ein Set von üblich verwendeten
-        Prüfungen. Sie bietet auch einen einfachen Prüf-Ketten-Mechanismus mit welchem mehrfache
-        Prüfungen zu einem einfachen Wert in einer benutzer-definierten Art und Weise zugeordnet
-        werden können.
+        Die Komponente <classname>Zend_Validate</classname> bietet ein Reihe von häufig benötigten
+        Prüfungen. Sie bietet auch einen einfachen Verkettungsmechanismus für Prüfungen, mit welchem
+        mehrfache Prüfungen in einer benutzerdefinierten Reihenfolge auf einen einzelnen Wert
+        angewendet werden können.
     </para>
 
     <sect2 id="zend.validate.introduction.definition">
         <title>Was ist eine Prüfung?</title>
 
         <para>
-            Eine Prüfung untersucht seine Eingabe mit Obacht auf einige Anforderungen und produziert
-            ein boolsches Ergebnis - wenn die Eingabe erfolgreich gegen die Anforderungen geprüft
+            Eine Prüfung untersucht ihre Eingabe hinsichtlich einiger Anforderungen und produziert
+            ein boolesches Ergebnis - wenn die Eingabe erfolgreich gegen die Anforderungen geprüft
             werden konnte. Wenn die Eingabe den Anforderungen nicht entspricht, kann die Prüfung
             zusätzliche Informationen darüber bieten, welche der Anforderungen die Eingabe nicht
             entspricht.
         </para>
 
         <para>
-            Eine WebAnwendung, zum Beispiel, könnte erfordern das ein Benutzername zwischen sechs
-            und zwölf Zeichen lang ist und dürfte nur alphanummerische Zeichen enthalten. Eine
-            Prüfung kann dafür verwendet werden um sicherzustellen das Benutzernamen diesen
+            Zum Beispiel könnte eine Webanwendung erfordern, dass ein Benutzername zwischen sechs
+            und zwölf Zeichen lang sein soll und nur alphanumerische Zeichen enthalten soll. Eine
+            Prüfung kann dafür verwendet werden um sicherzustellen, dass Benutzernamen diesen
             Anforderungen entsprechen. Wenn ein gewählter Benutzername einer oder beiden
-            Anforderungen nicht entspricht, wäre es nützlich zu wissen welche der Anforderungen der
+            Anforderungen nicht entspricht, wäre es nützlich zu wissen, welche der Anforderungen der
             Benutzername nicht entsprochen hat.
         </para>
     </sect2>
@@ -36,33 +36,33 @@
         <title>Standardnutzung von Prüfungen</title>
 
         <para>
-            Prüfungen auf diesem Weg definiert zu haben, bietet die Sammlung für
-            <classname>Zend_Validate_Interface</classname> welche zwei Methoden definiert,
+            Prüfungen auf diesem Weg definiert zu haben, bietet die Grundlage für
+            <classname>Zend_Validate_Interface</classname>, welche zwei Methoden definiert,
             <methodname>isValid()</methodname> und <methodname>getMessages()</methodname>. Die
-            <methodname>isValid()</methodname> Methode führt eine Prüfung über die angegebenen Werte
-            aus, und gibt nur dann <constant>TRUE</constant> zurück wenn der Wert gegenüber den
+            Methode <methodname>isValid()</methodname> führt eine Prüfung über die angegebenen Werte
+            aus und gibt nur dann <constant>TRUE</constant> zurück, wenn der Wert gegenüber den
             Kriterien der Prüfung entsprochen hat.
         </para>
 
         <para>
             Wenn <methodname>isValid()</methodname> <constant>FALSE</constant> zurück gibt, bietet
-            <methodname>getMessages()</methodname> ein Array von Nachrichten welche die Gründe für
-            die fehlgeschlagene Prüfung beschreiben. Die Arrayschlüssel sind kurze Strings die die
-            Gründe für eine fehlgeschlagene Prüfung identifizieren, und die Arraywerte sind die
-            entsprechend menschlich-lesbaren String Nachrichten. Die Schlüssel und Werte sind
-            Klassenabhängig; jede Prüfklasse definiert Ihr eigenes Set von Nachrichten für
-            fehlgeschlagene Prüfungen und die eindeutigen Schlüssel die diese identifizieren. Jede
+            <methodname>getMessages()</methodname> ein Array von Nachrichten, welches die Gründe für
+            die fehlgeschlagene Prüfung beschreiben. Die Arrayschlüssel sind kurze Strings, welche die
+            Gründe für eine fehlgeschlagene Prüfung identifizieren und die Arraywerte sind die
+            entsprechend menschenlesbaren String-Nachrichten. Die Schlüssel und Werte sind
+            klassenabhängig; jede Prüfklasse definiert ihr eigenes Set von Nachrichten für
+            fehlgeschlagene Prüfungen und die eindeutigen Schlüssel, welche diese identifizieren. Jede
             Klasse hat also eine const Definition die jedem Identifikator für eine
             fehlgeschlagene Prüfung entspricht.
         </para>
 
         <note>
             <para>
-                Die <methodname>getMessages()</methodname> gibt die Information für Prüfungsfehler
+                Die Methode <methodname>getMessages()</methodname> gibt die Information für Prüfungsfehler
                 nur für den zuletzt durchgeführten Aufruf von <methodname>isValid()</methodname>
                 zurück. Jeder Aufruf von <methodname>isValid()</methodname> löscht jegliche
-                Nachricht und Fehler welche durch vorhergehende <methodname>isValid()</methodname>
-                Aufrufe vorhanden waren, weil normalerweise jeder Aufruf von
+                Nachricht und Fehler, welche durch vorhergehende Aufrufe von
+                <methodname>isValid()</methodname> vorhanden waren, weil normalerweise jeder Aufruf von
                 <methodname>isValid()</methodname> für einen unterschiedlichen Eingabewert gemacht
                 wird.
             </para>
@@ -70,6 +70,7 @@
 
         <para>
             Das folgende Beispiel zeigt die Prüfung einer E-Mail Adresse:
+        </para>
 
             <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_EmailAddress();
@@ -86,42 +87,39 @@ if ($validator->isValid($email)) {
         echo "Validation failure '$messageId': $message\n";
     }
 }
-]]></programlisting>
-        </para>
-    </sect2>
+]]></programlisting></sect2>
 
     <sect2 id="zend.validate.introduction.messages">
         <title>Nachrichten anpassen</title>
 
         <para>
-            Prüf Klassen bieten eine <methodname>setMessage()</methodname> Methode mit der das
-            Format der Nachricht definiert werden kann die von
+            Prüfklassen bieten eine Methode <methodname>setMessage()</methodname>, mit der das
+            Format der Nachricht definiert werden kann, die von
             <methodname>getMessages()</methodname> im Fall einer fehlerhaften Prüfung zurückgegeben
-            wird. Das erste Argument dieser Methode ist ein String der die Fehlernachricht enthält.
-            Es können Kürzel in den String eingebaut werden welche mit den für die Prüfung
+            wird. Das erste Argument dieser Methode ist ein String, der die Fehlernachricht enthält.
+            Es können Kürzel in den String eingebaut werden, welche mit den für die Prüfung
             relevanten Daten aufgefüllt werden. Das Kürzel <emphasis>%value%</emphasis> wird von
             allen Prüfungen unterstützt; es ist verbunden mit dem Wert der an
-            <methodname>isValid()</methodname> übergeben wird. Andere Kürzel können unterstützt
-            werden von Fall-zu-Fall in jeder Prüfer-Klasse. Zum Beispiel ist
-            <emphasis>%max%</emphasis> das Kürzel welches von
+            <methodname>isValid()</methodname> übergeben wird. Andere Kürzel können in jeder Prüfklasse
+            von Fall zu Fall unterstützt werden. Zum Beispiel ist
+            <emphasis>%max%</emphasis> das Kürzel, welches von
             <classname>Zend_Validate_LessThan</classname> unterstützt wird. Die
-            <methodname>getMessageVariables()</methodname> Methode give ein Array von variablen
-            Kürzel zurück welche vom Prüfer unterstützt werden.
+            <methodname>getMessageVariables()</methodname> Methode gibt ein Array von variablen
+            Kürzeln zurück, welche vom Prüfer unterstützt werden.
         </para>
 
         <para>
-            Das zweite optionale Argument ist ein String der das Template der fehlerhaften
-            Prüfnachricht die gesetzt werden soll identifiziert. Das ist nützlich wenn eine
+            Das zweite optionale Argument ist ein String, der das Template der fehlerhaften
+            Prüfnachricht identifiziert, die gesetzt werden soll. Das ist nützlich wenn eine
             Prüfklasse mehr als einen Grund für einen Fehlschlag definiert. Wenn das zweite Argument
-            nicht angegeben wird, nimmt <methodname>setMessage()</methodname> an das die
-            spezifizierte Nachricht für das erste Messagetemplate verwendet werden soll das in der
+            nicht angegeben wird, nimmt <methodname>setMessage()</methodname> an, dass die
+            spezifizierte Nachricht für das erste Messagetemplate verwendet werden soll, das in der
             Prüfklasse definiert ist. Viele Prüfklassen haben nur ein Template für eine
-            Fehlernachricht definiert, sodas es nicht notwendig ist anzugeben welches Template für
+            Fehlernachricht definiert, sodass es nicht notwendig ist anzugeben, welches Template für
             Fehlernachrichten geändert werden soll.
         </para>
 
-        <para>
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_StringLength(8);
 
 $validator->setMessage(
@@ -136,12 +134,12 @@ if (!$validator->isValid('word')) {
     // "Der String 'word' ist zu kurz; er muss mindestens 8 Zeichen sein"
 }
 ]]></programlisting>
-        </para>
 
         <para>
-            Es können mehrere Nachrichten gesetzt werden durch Verwendung der
-            <methodname>setMessages()</methodname> Methode. Dessen Argument ist ein Array welches
-            Schlüssel/Nachrichten Paare enthält.
+            Es können mehrere Nachrichten durch Verwendung der Methode
+            <methodname>setMessages()</methodname> gesetzt werden. Dessen Argument ist ein Array,
+            welches Schlüssel/Nachrichten Paare enthält.
+        </para>
 
             <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_StringLength(array('min' => 8, 'max' => 12));
@@ -153,17 +151,17 @@ $validator->setMessages( array(
         'Der String \'%value%\' ist zu lang'
 ));
 ]]></programlisting>
-        </para>
 
         <para>
             Wenn die Anwendung mehr Flexibilität benötigt in der Art und Weise wie Prüffehler
-            gemeldet werden, kann auf die Eigenschaften durch den selben Namen zugegriffen
-            werden wie mit dem Nachrichten Kürzel das von einer Prüfklasse unterstützt wird.
-            Die <property>value</property> Eigenschaft ist immer in einem Prüfer vorhanden; Das ist
-            der Wert der als Argument von <methodname>isValid()</methodname> definiert wurde. Andere
+            gemeldet werden, kann auf die Eigenschaften durch denselben Namen zugegriffen
+            werden, wie mit dem Nachrichtenkürzel, das von einer Prüfklasse unterstützt wird.
+            Die Eigenschaft <property>value</property> ist immer in einem Prüfer vorhanden; Das ist
+            der Wert, der als Argument von <methodname>isValid()</methodname> definiert wurde. Andere
             Eigenschaften können von Fall zu Fall in jeder Prüfklasse unterstützt werden.
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 $validator = new Zend_Validate_StringLength(array('min' => 8, 'max' => 12));
 
 if (!validator->isValid('word')) {
@@ -175,60 +173,58 @@ if (!validator->isValid('word')) {
         . $validator->max
         . "\n";
 }
-]]></programlisting>
-        </para>
-    </sect2>
+]]></programlisting></sect2>
 
     <sect2 id="zend.validate.introduction.static">
         <title>Verwenden der statischen is() Methode</title>
 
         <para>
-            Wenn es nicht gebräuchlich ist eine gegebenen Prüfklasse zu laden und eine Instanz
+            Wenn es unpassend ist, eine gegebenen Prüfklasse zu laden und eine Instanz
             des Prüfers zu erstellen, kann die statische Methode
-            <methodname>Zend_Validate::is()</methodname> verwendet werden als alternativer Stil des
-            Aufrufs. Das erste Argument dieser Methode ist ein Datenwert, der an die
-            <methodname>isValid()</methodname> Methode übergeben werden würde. Das zweite Argument
+            <methodname>Zend_Validate::is()</methodname> als alternativer Stil des Aufrufs
+            verwendet werden. Das erste Argument dieser Methode ist ein Datenwert, der an die
+            Methode <methodname>isValid()</methodname> übergeben werden würde. Das zweite Argument
             ist ein String, welcher mit dem Basisnamen der Prüfklasse übereinstimmt, relativ zum
-            Namensraum von <classname>Zend_Validate</classname>. Die <methodname>is()</methodname>
-            Methode lädt die Klasse automatisch, erstellt eine Instanz und wendet die
-            <methodname>isValid()</methodname> Methode an den Eingabedaten an.
+            Namensraum von <classname>Zend_Validate</classname>. Die Methode
+            <methodname>is()</methodname> lädt die Klasse automatisch, erstellt eine Instanz und
+            wendet die Methode <methodname>isValid()</methodname> auf die Eingabedaten an.
+        </para>
 
-            <programlisting language="php"><![CDATA[
+        <programlisting language="php"><![CDATA[
 if (Zend_Validate::is($email, 'EmailAddress')) {
     // Ja, die Email Adresse scheint gültig zu sein
 }
 ]]></programlisting>
 
-        </para>
 
         <para>
-            Es kann auch ein Array von Konstruktor Argumenten übergeben werden, wenn diese für die
+            Es kann auch ein Array von Konstruktor-Argumenten übergeben werden, wenn diese für die
             Prüfung benötigt werden.
+        </para>
 
             <programlisting language="php"><![CDATA[
 if (Zend_Validate::is($value, 'Between', array('min' => 1, 'max' => 12))) {
     // Ja, $value ist zwischen 1 und 12
 }
 ]]></programlisting>
-        </para>
 
         <para>
-            Die <methodname>is()</methodname> Methode gibt einen boolschen Wert zurück, denselben
-            wie die <methodname>isValid()</methodname> Methode. Wird die statische
-            <methodname>is()</methodname> Methode verwendet, sind Nachrichten für Prüffehler nicht
+            Die Methode <methodname>is()</methodname> gibt einen booleschen Wert zurück, denselben
+            wie die Methode <methodname>isValid()</methodname>. Wird die statische
+            Methode <methodname>is()</methodname> verwendet, sind Nachrichten für Prüffehler nicht
             vorhanden.
         </para>
 
         <para>
-            Die statische Verwendung kann bequem sein für das ad hoc Verwenden eines Prüfers,
-            aber wenn ein Prüfer für mehrere Eingaben verwendet werden soll ist es effizienter
-            die nicht statische Verwendung zu benutzen, indem eine Instanz des Prüf Objektes
-            erstellt wird und dessen <methodname>isValid()</methodname> Methode aufgerufen wird.
+            Die statische Verwendung kann für das ad hoc Verwenden eines Prüfers bequem sein,
+            aber wenn ein Prüfer für mehrere Eingaben verwendet werden soll, ist es effizienter
+            die nicht statische Verwendung zu benutzen, indem eine Instanz des Prüfobjekts
+            erstellt wird und dessen Methode <methodname>isValid()</methodname> aufgerufen wird.
         </para>
 
         <para>
-            Die <classname>Zend_Filter_Input</classname> Klasse erlaubt es auch mehrfache Filter und
-            Prüfklassen zu instanzieren und bei Bedarf aufzurufen um Sets von Eingabedaten zu
+            Die Klasse <classname>Zend_Filter_Input</classname> erlaubt es, auch mehrfache Filter und
+            Prüfklassen zu instanzieren und bei Bedarf aufzurufen, um Sets von Eingabedaten zu
             bearbeiten. Siehe <xref linkend="zend.filter.input" />.
         </para>
 
@@ -249,9 +245,9 @@ if (Zend_Validate::is($value, 'MyValidator', array('min' => 1, 'max' => 12),
 ]]></programlisting>
 
             <para>
-                <classname>Zend_Validate</classname> erlaubt es auch standardmäßige Namespaces zu
-                setzen. Das bedeutet das man Sie einmal in der Bootstrap setzt und sie nicht mehr
-                bei jedem Aufruf von <methodname>Zend_Validate::is()</methodname> angeben muß. Der
+                <classname>Zend_Validate</classname> erlaubt es auch, standardmäßige Namespaces zu
+                setzen. Das bedeutet, dass man sie einmal in der Bootstrap setzt und sie nicht mehr
+                bei jedem Aufruf von <methodname>Zend_Validate::is()</methodname> angeben muss. Der
                 folgende Codeschnipsel ist identisch mit dem vorherigen.
             </para>
 
@@ -267,7 +263,7 @@ if (Zend_Validate::is($value, 'OtherValidator', array('min' => 1, 'max' => 12))
 ]]></programlisting>
 
             <para>
-                Der Bequemlichkeit halber gibt es die folgenden Methoden welche die Behandlung von
+                Der Bequemlichkeit halber gibt es die folgenden Methoden, welche die Behandlung von
                 Namespaces erlauben:
             </para>
 
@@ -284,7 +280,7 @@ if (Zend_Validate::is($value, 'OtherValidator', array('min' => 1, 'max' => 12))
                         <emphasis><methodname>Zend_Validate::setDefaultNamespaces()</methodname></emphasis>:
                         Setzt neue standardmäßige Namespaces und überschreibt alle vorher
                         gesetzten. Es wird entweder ein String für einen einzelnen Namespace
-                        akzeptiert, oder ein Array für mehrere Namespaces.
+                        akzeptiert oder ein Array für mehrere Namespaces.
                     </para>
                 </listitem>
 
@@ -292,7 +288,7 @@ if (Zend_Validate::is($value, 'OtherValidator', array('min' => 1, 'max' => 12))
                     <para>
                         <emphasis><methodname>Zend_Validate::addDefaultNamespaces()</methodname></emphasis>:
                         Fügt zusätzliche Namespaces zu den bereits gesetzten hinzu. Es wird
-                        entweder ein String für einen einzelnen Namespace akzeptiert, oder ein
+                        entweder ein String für einen einzelnen Namespace akzeptiert oder ein
                         Array für mehrere Namespaces.
                     </para>
                 </listitem>
@@ -300,8 +296,8 @@ if (Zend_Validate::is($value, 'OtherValidator', array('min' => 1, 'max' => 12))
                 <listitem>
                     <para>
                         <emphasis><methodname>Zend_Validate::hasDefaultNamespaces()</methodname></emphasis>:
-                        Gibt <constant>TRUE</constant> zurück wenn ein oder mehrere standardmäßige
-                        Namespaces gesetzt sind, und <constant>FALSE</constant> wenn keine
+                        Gibt <constant>TRUE</constant> zurück, wenn ein oder mehrere standardmäßige
+                        Namespaces gesetzt sind und <constant>FALSE</constant>, wenn keine
                         standardmäßigen Namespaces gesetzt sind.
                     </para>
                 </listitem>
@@ -313,8 +309,8 @@ if (Zend_Validate::is($value, 'OtherValidator', array('min' => 1, 'max' => 12))
         <title>Meldungen übersetzen</title>
 
         <para>
-            Prüfungsklassen bieten eine <methodname>setTranslator()</methodname> Methode mit der man
-            eine Instanz von <classname>Zend_Translate</classname> definieren kann die Nachrichten
+            Prüfungsklassen bieten eine Methode <methodname>setTranslator()</methodname>, mit der man
+            eine Instanz von <classname>Zend_Translate</classname> definieren kann, die Nachrichten
             im Falle eines Prüfungsfehlers übersetzt. Die <methodname>getTranslator()</methodname>
             Methode gibt die gesetzte Übersetzungsinstanz zurück.
         </para>
@@ -336,9 +332,9 @@ $validator->setTranslator($translate);
 
         <para>
             Mit der statischen Methode <methodname>setDefaultTranslator()</methodname> kann eine
-            Instanz von <classname>Zend_Translate</classname> gesetzt werden, und mit
-            <methodname>getDefaultTranslator()</methodname> empfangen. Das verhindert das man den
-            Übersetzer manuell für alle Prüfungsklassen setzen muß und vereinfacht den Code.
+            Instanz von <classname>Zend_Translate</classname> gesetzt werden und mit
+            <methodname>getDefaultTranslator()</methodname> empfangen. Das verhindert, dass man den
+            Übersetzer manuell für alle Prüfungsklassen setzen muss und vereinfacht den Code.
         </para>
 
         <programlisting language="php"><![CDATA[
@@ -356,16 +352,16 @@ Zend_Validate::setDefaultTranslator($translate);
 
         <note>
             <para>
-                Wenn man ein Anwendungsweites Gebietsschema in der Registry gesetzt hat, wird
+                Wenn man ein anwendungsweites Gebietsschema in der Registry gesetzt hat, wird
                 dieses Gebietsschema als standardmäßiger Übersetzer verwendet.
             </para>
         </note>
 
         <para>
-            Machmal ist es notwendig den Übersetzer in einer Prüfklasse auszuschalten. Um das zu
-            tun kann die <methodname>setDisableTranslator()</methodname> Methode verwendet werden,
-            welche einen boolschen Wert akzeptiert und
-            <methodname>translatorIsDisabled()</methodname> um den gesetzten Wert zu erhalten.
+            Manchmal ist es notwendig, den Übersetzer in einer Prüfklasse auszuschalten. Um das zu
+            tun, kann die Methode <methodname>setDisableTranslator()</methodname> verwendet werden,
+            welche einen booleschen Wert akzeptiert und
+            <methodname>translatorIsDisabled()</methodname>, um den gesetzten Wert zu erhalten.
         </para>
 
         <programlisting language="php"><![CDATA[
@@ -376,9 +372,9 @@ if (!$validator->isTranslatorDisabled()) {
 ]]></programlisting>
 
         <para>
-            Es ist auch möglich einen Übersetzer zu verwenden statt eigene Meldungen mit
+            Es ist auch möglich einen Übersetzer zu verwenden, statt eigene Meldungen mit
             <methodname>setMessage()</methodname> zu setzen. Aber wenn man das tut, sollte man im
-            Kopf behalten das der Übersetzer auch mit den Meldungen arbeitet die man selbst gesetzt
+            Kopf behalten, dass der Übersetzer auch mit den Meldungen arbeitet, die man selbst gesetzt
             hat.
         </para>
     </sect2>