[MANUAL] German:

- some translations

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

documentation/manual/de/tutorials/lucene-index-opening.xml

@@ -2,16 +2,16 @@
 <!-- EN-Revision: 19777 -->
 <!-- Reviewed: no -->
 <sect1 id="learning.lucene.index-opening">
-    <title>Index Opening and Creation</title>
+    <title>Indezes öffnen und erstellen</title>
 
     <para>
-        All index operations (e.g., creating a new index, adding a document to the index, deleting a
-        document, searching through the index) need an index object. One can be obtained using one
-        of the following two methods.
+        Alle Index Operationen (z.B. Erstellung eines neuen Index, hinzufügen eines Dokuments zum
+        Index, löschen eines Dokuments, suchen durch den Index) benötigen ein Index Objekt. Es kann
+        empfangen werden indem eine der folgenden zwei Methoden verwendet wird.
     </para>
 
     <example id="learning.lucene.index-opening.creation">
-        <title>Lucene Index Creation</title>
+        <title>Lucene Index Erstellung</title>
 
         <programlisting language="php"><![CDATA[
 $index = Zend_Search_Lucene::create($indexPath);
@@ -19,7 +19,7 @@ $index = Zend_Search_Lucene::create($indexPath);
     </example>
 
     <example id="learning.lucene.index-opening.opening">
-        <title>Lucene Index Opening</title>
+        <title>Lucene Index Öffnen</title>
 
         <programlisting language="php"><![CDATA[
 $index = Zend_Search_Lucene::open($indexPath);

documentation/manual/de/tutorials/lucene-index-structure.xml

@@ -2,117 +2,129 @@
 <!-- EN-Revision: 19777 -->
 <!-- Reviewed: no -->
 <sect1 id="learning.lucene.index-structure">
-    <title>Lucene Index Structure</title>
+    <title>Lucene Index Struktur</title>
 
     <para>
-        In order to fully utilize <classname>Zend_Search_Lucene</classname>'s capabilities with
-        maximum performance, you need to understand it's internal index structure.
+        Um <classname>Zend_Search_Lucene</classname>'s Mögichkeiten mit maximaler Performance
+        kompett anzuwenden, muss man die interne Struktur des Index verstehen.
     </para>
 
     <para>
-        An <emphasis>index</emphasis> is stored as a set of files within a single directory.
+        Ein <emphasis>index</emphasis> wird als Set von Dateien in einem einzelnen Verzeichnis
+        gespeichert.
     </para>
 
     <para>
-        An <emphasis>index</emphasis> consists of any number of independent
-        <emphasis>segments</emphasis> which store information about a subset of indexed documents.
-        Each <emphasis>segment</emphasis> has its own <emphasis>terms dictionary</emphasis>, terms
-        dictionary index, and document storage (stored field values) <footnote><para>Starting with
-                Lucene 2.3, document storage files can be shared between segments; however,
-                <classname>Zend_Search_Lucene</classname> doesn't use this
-                capability</para></footnote>. All segment data is stored in
-        <filename>_xxxxx.cfs</filename> files, where <emphasis>xxxxx</emphasis> is a segment name.
+        Ein <emphasis>index</emphasis> besteht auf einer beliebigen Anzahl von unabhängigen
+        <emphasis>Segmenten</emphasis> welche Informationen über ein Subset von indizierten
+        Dokumenten speichern. Jedes <emphasis>Segment</emphasis> hat sein eigenes
+        <emphasis>Wörterbuch an Ausdrücken</emphasis>, Ausdrucks Wörterbuch Indezes, und Dokument
+        Speicher (speichert Feld Werte)
+        <footnote>
+            <para>
+                Beginnend mit Lucene 2.3, können Dokument Speicherdateien zwischen Segmenten geteilt
+                werden; trotzdem verwendet <classname>Zend_Search_Lucene</classname> diese
+                Möglichkeit nicht
+            </para>
+        </footnote>.
+        Alle Segmentdaten werden in <filename>_xxxxx.cfs</filename> Dateien gespeichert, wobei
+        <emphasis>xxxxx</emphasis> der Name des Segments ist.
     </para>
 
     <para>
-        Once an index segment file is created, it can't be updated. New documents are added to new
-        segments. Deleted documents are only marked as deleted in an optional
-        <filename>&lt;segmentname&gt;.del</filename> file.
+        Sobald die Index Segment Datei erstellt wurde kann Sie nicht mehr aktualisiert werden. Neue
+        Dokumente werden in neuen Segmenten hinzugefügt. Gelöschte Dokumente werden nur in einer
+        optionalen <filename>&lt;segmentname&gt;.del</filename> Datei als gelöscht markiert.
     </para>
 
     <para>
-        Document updating is performed as separate delete and add operations, even though it's done
-        using an <methodname>update()</methodname> <acronym>API</acronym> call
-        <footnote><para>This call is provided only by Java Lucene now, but it's planned to extend
-            the <classname>Zend_Search_Lucene</classname> <acronym>API</acronym> with similar
-            functionality</para></footnote>.
-        This simplifies adding new documents, and allows updating concurrently with search
-        operations.
+        Die Aktualisierung von Dokumenten wird als seperate Lösch- und Hinzufüge Operation
+        durchgeführt selbst wenn Sie als <acronym>API</acronym> Aufruf mit
+        <methodname>update()</methodname> durchgeführt wird <footnote><para>Dieser Aufruf wird
+        aktuell nur von Java Lucene unterstützt, es ist aber geplant die
+        <classname>Zend_Search_Lucene</classname> <acronym>API</acronym> mit Ähnlicher
+        Funktionalität zu erweitern</para></footnote>. Das vereinfacht das hinzufügen neuer
+        Dokumente und erlaubt das Aktualisieren gleichzeitig mit Such Operationen.
     </para>
 
     <para>
-        On the other hand, using several segments (one document per segment as a borderline case)
-        increases search time:
+        Auf der anderen Seite verlängert die Verwendung mehrerer Segmente (ein Dokument pro Segment
+        als extremster Fall) die Suchzeit:
     </para>
 
     <itemizedlist>
         <listitem>
             <para>
-                retrieving a term from a dictionary is performed for each segment;
+                Das Empfangen von Ausdrücken von einem Verzeichnis wird für jedes Segment
+                durchgeführt;
             </para>
         </listitem>
 
         <listitem>
             <para>
-                the terms dictionary index is pre-loaded for each segment (this process takes the
-                most search time for simple queries, and it also requires additional memory).
+                Der Index des Ausdrucks Verzeichnisses wird für jedes Segment vorgeladen (dieser
+                Prozess nimmt für einfache Abfragen die meiste Zeit in Anspruch, und er benötigt
+                auch zusätzlichen Speicher).
             </para>
         </listitem>
     </itemizedlist>
 
     <para>
-        If the terms dictionary reaches a saturation point, then search through one segment is
-        <emphasis>N</emphasis> times faster than search through <emphasis>N</emphasis> segments
-        in most cases.
+        Wenn das Ausdrucks Verzeichnis einen Wendepunkt erreicht, dann ist die Suche durch ein
+        Segment <emphasis>N</emphasis> in den meisten Fällen mal schneller als die Suche durch
+        <emphasis>N</emphasis> Segmente.
     </para>
 
     <para>
-        <emphasis>Index optimization</emphasis> merges two or more segments into a single new one. A
-        new segment is added to the index segments list, and old segments are excluded.
+        <emphasis>Index Optimierung</emphasis> verbindet zwei oder mehr Segmente in ein einzelnes
+        Segment. Ein neues Segment wird der Liste der Index Segmente hinzugefügt, und alte Segmente
+        werden ausgeschlossen.
     </para>
 
     <para>
-        Segment list updates are performed as an atomic operation. This gives the ability of
-        concurrently adding new documents, performing index optimization, and searching through the
-        index.
+        Aktualisierungen von Segment Listen werden als atomsche Operation durchgeführt. Das gibt
+        die Möglichkeit gleichzeitig neue Dokumente hinzuzufügen, Index Operationen durchzuführen,
+        und den Index zu durchsuchen.
     </para>
 
     <para>
-        Index auto-optimization is performed after each new segment generation. It merges sets of
-        the smallest segments into larger segments, and larger segments into even larger segments,
-        if we have enough segments to merge.
+        Die automatische Optimierung des Index wird nach jeder Segment Erzeugung durchgeführt. Sie
+        verbindet Sets der kleinsten Segmente in größere Segmente, und größere Segmente in noch
+        größere Segmente, wenn wir genug Segmente zum verbinden haben.
     </para>
 
     <para>
-        Index auto-optimization is controlled by three options:
+        Die automatische Optimierung wird von drei Optionen kontrolliert:
     </para>
 
     <itemizedlist>
         <listitem>
             <para>
-                <emphasis>MaxBufferedDocs</emphasis> (the minimal number of documents required
-                before the buffered in-memory documents are written into a new segment);
+                <emphasis>MaxBufferedDocs</emphasis> (die minimale Anzahl an notwendigen Dokumenten
+                bevor die im Speicher gepufferten Dokumente in ein neues Segment geschrieben
+                werden);
             </para>
         </listitem>
 
         <listitem>
             <para>
-                <emphasis>MaxMergeDocs</emphasis> (the largest number of documents ever merged by
-                an optimization operation); and
+                <emphasis>MaxMergeDocs</emphasis> (die größte Anzahl an Dokumenten die von einer
+                Optimierungs Operation verbunden werden); und
             </para>
         </listitem>
 
         <listitem>
             <para>
-                <emphasis>MergeFactor</emphasis> (which determines how often segment indices are
-                merged by auto-optimization operations).
+                <emphasis>MergeFactor</emphasis> (welcher definiert wie oft Segment Indezes von
+                automatischen Optimierungs Operationen verbunden werden).
             </para>
         </listitem>
     </itemizedlist>
 
     <para>
-        If we add one document per script execution, then <emphasis>MaxBufferedDocs</emphasis> is
-        actually not used (only one new segment with only one document is created at the end of
-        script execution, at which time the auto-optimization process starts).
+        Wenn wir pro Skript Ausführung ein Dokument hinzufügen, wird
+        <emphasis>MaxBufferedDocs</emphasis> nicht verwendet (es wird nur ein neues Segmente mit nur
+        einem Dokument am Ende der Skript Ausführung erstellt, zu einer Zeit zu welcher der
+        automatische Optimierungs Prozess startet).
     </para>
 </sect1>

documentation/manual/de/tutorials/lucene-indexing.xml

@@ -2,10 +2,11 @@
 <!-- EN-Revision: 19777 -->
 <!-- Reviewed: no -->
 <sect1 id="learning.lucene.indexing">
-    <title>Indexing</title>
+    <title>Indizierung</title>
 
     <para>
-        Indexing is performed by adding a new document to an existing or new index:
+        Indizierung wird durch das Hinzufügen eines neuen Dokuments zu einem bestehenden oder neuen
+        Index durchgeführt:
     </para>
 
     <programlisting language="php"><![CDATA[
@@ -13,11 +14,11 @@ $index->addDocument($doc);
 ]]></programlisting>
 
     <para>
-        There are two ways to create document object. The first is to do it manually.
+        Es gibt zwei Wege Dokument Objekte zu erstellen. Der erste ist es manuell zu tun.
     </para>
 
     <example id="learning.lucene.indexing.doc-creation">
-        <title>Manual Document Construction</title>
+        <title>Manuelle Dokument Erstellung</title>
 
         <programlisting language="php"><![CDATA[
 $doc = new Zend_Search_Lucene_Document();
@@ -29,11 +30,12 @@ $doc->addField(Zend_Search_Lucene_Field::binary('avatar', $avatarData));
     </example>
 
     <para>
-        The second method is to load it from <acronym>HTML</acronym> or Microsoft Office 2007 files:
+        Die zweite Methode ist das Laden von <acronym>HTML</acronym> oder von Microsoft Office 2007
+        Dateien:
     </para>
 
     <example id="learning.lucene.indexing.doc-loading">
-        <title>Document loading</title>
+        <title>Laden vom Dokument</title>
 
         <programlisting language="php"><![CDATA[
 $doc = Zend_Search_Lucene_Document_Html::loadHTML($htmlString);
@@ -44,15 +46,16 @@ $doc = Zend_Search_Lucene_Document_Xlsx::loadXlsxFile($path);
     </example>
 
     <para>
-        If a document is loaded from one of the supported formats, it still can be extended manually
-        with new user defined fields.
+        Wenn ein Dokument von einem der unterstützten Formate geladen wird, kann es trotzdem noch
+        manuell mit einem neuen benutzerdefinierten Feld erweitert werden.
     </para>
 
     <sect2 id="learning.lucene.indexing.policy">
-        <title>Indexing Policy</title>
+        <title>Indizierungs Policy</title>
 
         <para>
-            You should define indexing policy within your application architectural design.
+            Man sollte eine Indizierungs Policy im Architektur Design der eigenen Anwendung
+            definieren.
         </para>
 
         <para>

documentation/manual/de/tutorials/lucene-searching.xml

@@ -2,14 +2,14 @@
 <!-- EN-Revision: 19777 -->
 <!-- Reviewed: no -->
 <sect1 id="learning.lucene.searching">
-    <title>Searching</title>
+    <title>Suchen</title>
 
     <para>
-        Searching is performed by using the <methodname>find()</methodname> method:
+        Suchen wird durch Verwendung der <methodname>find()</methodname> Methode durchgeführt:
     </para>
 
     <example id="learning.lucene.searching.search-example">
-        <title>Searching through the index</title>
+        <title>Den Index durchsuchen</title>
 
         <programlisting language="php"><![CDATA[
 $hits = $index->find($query);
@@ -21,18 +21,18 @@ foreach ($hits as $hit) {
     </example>
 
     <para>
-        This example demonstrates the usage of two special search hit properties -
-        <property>id</property> and <property>score</property>.
+        Dieses Beispiel demonstriert die Verwendung von zwei speziellen Suchtreffer Eigenschaften -
+        <property>id</property> und <property>score</property>.
     </para>
 
     <para>
-        <property>id</property> is an internal document identifier used within a Lucene index.
-        It may be used for a variety of operations, including deleting a document from the
-        index:
+        <property>id</property> ist ein interner Dokument Identifikator der im Lucene Index
+        verwendet wird. Er kann in unterschiedlichen Operationen verwendet werden, inklusive dem
+        Löschen eines Dokuments vom Index:
     </para>
 
     <example id="learning.lucene.searching.delete-example">
-        <title>Deleting an Indexed Document</title>
+        <title>Löschen eines indizierten Dokuments</title>
 
         <programlisting language="php"><![CDATA[
 $index->delete($id);
@@ -40,11 +40,11 @@ $index->delete($id);
     </example>
 
     <para>
-        Or retrieving the document from the index:
+        Oder Empfangen eines Dokuments vom Index:
     </para>
 
     <example id="learning.lucene.searching.retrieve-example">
-        <title>Retrieving an Indexed Document</title>
+        <title>Empfangen eines indizierten Dokuments</title>
 
         <programlisting language="php"><![CDATA[
 $doc = $index->getDocument($id);
@@ -52,44 +52,47 @@ $doc = $index->getDocument($id);
     </example>
 
     <note id="learning.lucene.searching.identifiers">
-        <title>Internal Document Identifiers</title>
+        <title>Interne Dokument Identifikatoren</title>
 
         <para>
-            Important note! Internal document identifiers may be changed by index optimization or
-            the auto-optimization process, but it's never changed within a single script's execution
-            unless the <methodname>addDocument()</methodname> (which may involve an
-            auto-optimization procedure) or <methodname>optimize()</methodname> methods are called.
+            Wichtiger Hinweis! Interne Dokument Identifikatoren können durch eine Index Optimierung
+            oder den automatischen Optimierungsprozess geändert werden, aber Sie werden niemals bei
+            der Ausführung eines einzelnen Skripts geändert solange die
+            <methodname>addDocument()</methodname> (welche eine automatische Optimierungsprozedur
+            beinhalten kann) oder die <methodname>optimize()</methodname> Methoden aufgerufen
+            werden.
         </para>
     </note>
 
     <para>
-        The <property>score</property> field is a hit score. Search results are ordered by score by
-        default (best results returned first).
+        Das <property>score</property> Feld sind Trefferpunkte. Such Ergebnisse werden standardmäßig
+        nach Trefferpunkten sortiert (die besten Ergebnisse werden als erstes zurückgegeben).
     </para>
 
     <para>
-        It's also possible to order result sets by specific field values. See the <link
-            linkend="zend.search.lucene.searching.sorting">
-            <classname>Zend_Search_Lucene</classname> documentation</link> for more details about
-        this possibility.
+        Es ist auch möglich Ergebnissets anhand von spezifischen Feldwerten zu sortieren. Siehe die
+        <link linkend="zend.search.lucene.searching.sorting">
+            <classname>Zend_Search_Lucene</classname> Dokumentation</link> für mehr Details über
+        diese Möglichkeit.
     </para>
 
     <para>
-        The example also demonstrates an ability to access stored fields (e.g.,
-        <command>$hit->title</command>). At the first access to any hit property other than
-        <property>id</property> or <property>score</property>, document stored fields are loaded,
-        and the corresponding field value is returned.
+        Das Beispiel demonstriert auch eine Möglichkeit um auf gespeicherte Felder zugreifen zu
+        können (z.B. <command>$hit->title</command>). Beim ersten Zugriff auf jede
+        Treffer-Eigenschaft, die sich von <property>id</property> oder <property>score</property>
+        unterscheidet, wird jedes dokumentierte gespeicherte Feld geladen, und die
+        korrespondierenden Feldwerte werden zurückgegeben.
     </para>
 
     <para>
-        This causes an ambiguity for documents having their own <property>id</property> or
-        <property>score</property> fields; as a result, it's not recommended to use these field
-        names within stored documents. Nevertheless, they still can be accessed via the
-        <methodname>getDocument()</methodname> method:
+        Das verursacht eine Doppeldeutigkeit für Dokumente die Ihre eigenen <property>id</property>
+        oder <property>score</property> Felder haben; als Ergebnis wird empfohlen diese Feldnamen
+        nicht in gespeicherten Dokumenten zu verwenden. Trotzdem kann auf Sie über die
+        <methodname>getDocument()</methodname> Methode zugegriffen werden:
     </para>
 
     <example id="learning.lucene.searching.id-score-fields">
-        <title>Accessing the original document's "id" and "score" fields</title>
+        <title>Zugriff auf die originalen "id" und "score" Felder von Dokumenten</title>
 
         <programlisting language="php"><![CDATA[
 $id    = $hit->getDocument()->id;

documentation/manual/de/tutorials/paginator-intro.xml

@@ -2,7 +2,7 @@
 <!-- EN-Revision: 19777 -->
 <!-- Reviewed: no -->
 <sect1 id="learning.paginator.intro">
-    <title>Introduction</title>
+    <title>Einführung</title>
 
     <para>
         Let's say you're creating a blogging application that will be home to your vast