cvs: phpdoc /de/functions mnogosearch.xml
| From: | Sebastian Nohn | Date: | Sun, 11 Nov 2001 20:19:48 +0000 |
| Subject: | cvs: phpdoc /de/functions mnogosearch.xml | ||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969338705@lists.php.net to get a copy of this message | ||
nohn Sun Nov 11 15:19:48 2001 EDT
Modified files:
/phpdoc/de/functions mnogosearch.xml
Log:
fixed some typos, fixed linelengths.
Index: phpdoc/de/functions/mnogosearch.xml diff -u phpdoc/de/functions/mnogosearch.xml:1.1 phpdoc/de/functions/mnogosearch.xml:1.2 --- phpdoc/de/functions/mnogosearch.xml:1.1 Sun Nov 11 13:57:35 2001 +++ phpdoc/de/functions/mnogosearch.xml Sun Nov 11 15:19:47 2001 @@ -1,15 +1,15 @@ <?xml encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <reference id="ref.mnogo"> <title>mnoGoSearch Funktionen</title> <titleabbrev>mnoGoSearch</titleabbrev> <partintro> <simpara> Diese Funktionen erlauben den Zugriff auf die mnoGoSearch - früher als UdmSearch bekannt) Suchmaschine. Um auf diese + früher als UdmSearch bekannt) Suchmaschine. Um auf diese Funktionen zugreifen zu können, muß php mittels der <link linkend="install.configure.with-mnogosearch"><option role="configure"> - --with-mnogosearch</option></link>-Option mit mnoGoSearch-Unterstützung + --with-mnogosearch</option></link>-Option mit mnoGoSearch-Unterstützung compiliert worden sein. Wird diese Option ohne Pfadangabe zu mnoGoSearch verwendet, wird mnoGoSearch in /usr/local/mnoGoSearch gesucht. Wurde mnoGoSearch unter einem anderen Pfad installiert, kann der Pfad mittels @@ -17,29 +17,31 @@ --with-mnogosearch=DIR</option></link> spezifiziert werden. </simpara> <para> - mnoGoSearch ist eine vollwertige Suchmaschine für den Intra- und Interneteinsatz, - vertrieben unter der GPL. mnoGoSearch hat einige einzigartige Funktionen, die es - für weite Einsatzbereiche tauglich machen. Es bietet Volltextindizierung von - HTML, PDF und Textdokumenten. mnoGoSearch besteht aus zwei Teilen: Der erste ist - der sogenannte indexer, der den Indizierungsmechanismus bereitstellt. Er spidered - HTTP, FTP und Newsserver oder lokale Dateisysteme, indiziert die gefundenen - Dokumente und speichert Meta-Daten über die Dokumente in einer SQL-Datenbank. + mnoGoSearch ist eine vollwertige Suchmaschine für den Intra- und + Interneteinsatz, vertrieben unter der GPL. mnoGoSearch hat einige + einzigartige Funktionen, die es für weite Einsatzbereiche tauglich machen. + Es bietet Volltextindizierung von HTML, PDF und Textdokumenten. mnoGoSearch + besteht aus zwei Teilen: Der erste ist der sogenannte indexer, der den + Indizierungsmechanismus bereitstellt. Er spidered HTTP, FTP und Newsserver + oder lokale Dateisysteme, indiziert die gefundenen Dokumente und speichert + Meta-Daten über die Dokumente in einer SQL-Datenbank. </para> <note> <para> php beinhaltet zwar einen eingebauten MySQL-Support, dieser ist jedoch nicht mit mnoGoSearch kompatibel, deshalb muß php gegen die selben generischen MySQL-Bibliotheken wie mnoGoSearch gelinkt werden, also z.B.: - <link linkend="install.configure.with-mnogosearch"><option role="configure"> + <link linkend="install.configure.with-mnogosearch"> + <option role="configure"> --with-mnogosearch --with-mysql=/usr</option></link>. </para> </note> <simpara> - Es wird mindestens Version 3.1.10 von mnoGoSearch vorausgesetzt, um die folgenden - Funktionen nutzen zu lönnen. + Es wird mindestens Version 3.1.10 von mnoGoSearch vorausgesetzt, um die + folgenden Funktionen nutzen zu können. </simpara> <simpara> - Weitere Informationen über mnoGoSearch können unter + Weitere Informationen über mnoGoSearch können unter <ulink url="&url.mnogo;">&url.mnogo;</ulink> abgerufen werden. </simpara> </partintro> @@ -47,7 +49,7 @@ <refentry id="function.udm-add-search-limit"> <refnamediv> <refname>udm_add_search_limit</refname> - <refpurpose>Verschiedene Beschränkungen bei der Suche anwenden</refpurpose> + <refpurpose>Verschiedene Beschränkungen bei der Suche anwenden</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -61,7 +63,7 @@ </funcsynopsis> <para> <function>udm_add_search_limit</function> gibt &true; bei Erfolg, - &false; bei einem Fehler zurück. Fügt Suchrestritktionen + &false; bei einem Fehler zurück. Fügt Suchrestritktionen hinzu. </para> <para> @@ -69,33 +71,35 @@ <function>udm_alloc_agent</function>. </para> <para> - <parameter>var</parameter> - Definiert den Parameter der die Einschränkung angibt. + <parameter>var</parameter> - Definiert den Parameter der die Einschränkung + angibt. </para> <para> <parameter>val</parameter> - Definiert den Wert des aktuellen Parameters. </para> <para> - Mögliche Werte für <parameter>var</parameter>: + Mögliche Werte für <parameter>var</parameter>: </para> <itemizedlist> <listitem> <simpara> UDM_LIMIT_URL - - definiert URL Limitationen, um die Suche auf Unterbereiche einzuschränken - SQL % und _ LIKE Wildcards werden unterstützt, % entspricht dabei einer - beliebigen Anzahl von Zeichen, wobei auch keine Zeichen eingeschlossen werden, - _ entspricht genau einem Zeichen. So entspricht also http://my.domain__/catalog - sowohl http://my.domain.ru/catalog als auch http://my.domain.ua/catalog. + definiert URL Limitationen, um die Suche auf Unterbereiche einzuschränken + SQL % und _ LIKE Wildcards werden unterstützt, % entspricht dabei einer + beliebigen Anzahl von Zeichen, wobei auch keine Zeichen eingeschlossen + werden, _ entspricht genau einem Zeichen. So entspricht also + http://my.domain__/catalog sowohl http://my.domain.ru/catalog als auch + http://my.domain.ua/catalog. </simpara> </listitem> <listitem> <simpara> UDM_LIMIT_TAG - - definiert TAG Limitationen. In der indexer-conf können bestimmeten + definiert TAG Limitationen. In der indexer-conf können bestimmeten Sites und Teilen von Sites sogenannte Tags zugewiesen werden. Auch bei - Tags werden % und _ unterstützt. Metasymbole erlauben die Suche - über Gruppen von Tags. So werden also die Tags ABCD und ABCE bei - einer Einschränkung auf ABC_ eingeschlossen. + Tags werden % und _ unterstützt. Metasymbole erlauben die Suche + über Gruppen von Tags. So werden also die Tags ABCD und ABCE bei + einer Einschränkung auf ABC_ eingeschlossen. </simpara> </listitem> <listitem> @@ -106,21 +110,21 @@ <listitem> <simpara> UDM_LIMIT_CAT - Definiert Dokumentenkategorielimitationen. Kategorien - sind den Tags ähnlich, jedoch im Gegensatz zu diesen verschachtelt. Eine - Kategorie kann also Unterkategorie einer anderen sein. Für jede Ebene - werden müssen zwei Zeichen verwendendet werden, entweder hexadezimale + sind den Tags ähnlich, jedoch im Gegensatz zu diesen verschachtelt. Eine + Kategorie kann also Unterkategorie einer anderen sein. Für jede Ebene + werden müssen zwei Zeichen verwendendet werden, entweder hexadezimale Zahlen von 0-F oder Zahlen zur Basis 36 von 0-Z. Eine Kategorie der - obersten Ebene, z.B. 'Auto' hätte die Zahl 01, die Unterkategorie 'Ford' - hätte ebenfalls die 01 als Zahl. Zusammen ergäbe das dann die 0101. Eine - weitere Kategorie 'VW' unterhalb der Kategorie 'Auto' hätte dann die Zahl - 0102 usw. Wenn 'VW' eine Unterkategorie 'Golf' hätte, wäre desren ID + obersten Ebene, z.B. 'Auto' hätte die Zahl 01, die Unterkategorie 'Ford' + hätte ebenfalls die 01 als Zahl. Zusammen ergäbe das dann die 0101. Eine + weitere Kategorie 'VW' unterhalb der Kategorie 'Auto' hätte dann die Zahl + 0102 usw. Wenn 'VW' eine Unterkategorie 'Golf' hätte, wäre desren ID 010201. </simpara> </listitem> <listitem> <simpara> - UDM_LIMIT_DATE - Definiert Einschränkungen in Bezug auf das Datum, wann - das Dokument zuletzt verändert wurde. + UDM_LIMIT_DATE - Definiert Einschränkungen in Bezug auf das Datum, wann + das Dokument zuletzt verändert wurde. </simpara> <simpara> Der Wert dieses Parameters ist das kleiner bzw. größer-Zeichen @@ -130,10 +134,10 @@ Udm_Add_Search_Limit($udm,UDM_LIMIT_DATE,"<908012006"); </simpara> <simpara> - Wenn das >-Zeichen benutzt wird, wird die Suche auf diejenigen Dokumente - eingeschränkt, deren Veränderungsdatum jünger als das eigegebene ist, - beim <-Zeichen erfolgt die Einschränkung dementsprechend auf Dokumente, - die Älter sind. + Wenn das >-Zeichen benutzt wird, wird die Suche auf diejenigen + Dokumente eingeschränkt, deren Veränderungsdatum jünger als das + eingegebene ist, beim <-Zeichen erfolgt die Einschränkung + dementsprechend auf Dokumente, die Älter sind. </simpara> </listitem> </itemizedlist> @@ -150,48 +154,51 @@ <funcprototype> <funcdef>int <function>udm_alloc_agent</function></funcdef> <paramdef>string <parameter>dbaddr</parameter></paramdef> - <paramdef>string<parameter><optional>dbmode</optional></parameter></paramdef> + <paramdef>string<parameter><optional>dbmode</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para><function>udm_alloc_agent</function> Gibt bei Erfolg einen eindeutigen Zeiger auf einen mnoGoSearch-Agenten - zurück, bei einem Fehler wird &false; zurücckgegeben. Diese Funktion + zurück, bei einem Fehler wird &false; zurückgegeben. Diese Funktion kreiert eine Sitzung mit Datenbankparametern. </para> <para> <parameter>dbaddr</parameter> - - Datenbankadresse im URL-Stil. Wird verwendet, um mit den Daten Datenbanktyp, - Datenbankhost, Datenbankname, Datenbankport, Datenbankuser und Datenbankpasswort - eine Verbindung zu einer SQL-Datenbank herzustellen. Das Format lautet: + Datenbankadresse im URL-Stil. Wird verwendet, um mit den Daten + Datenbanktyp, Datenbankhost, Datenbankname, Datenbankport, Datenbankuser + und Datenbankpasswort eine Verbindung zu einer SQL-Datenbank herzustellen. + Das Format lautet: DBAddr DBType:[//[DBUser[:DBPass]@]DBHost[:DBPort]]/DBName/. </para> <para> <parameter>dbmode</parameter> - - Mit dem Parameter dbmode wird der Modus spezifiziert, in dem die Daten in der - Datenbank vorliegen. Wird der Modus 'single' gewählt, werden alle Wörter in - der selben Tablelle gespeichert. Der Modus 'multi' speichert die Wörter - in verschiedenene Tabellen, abhängig von deren Länge. Weitere Modi sind der - CRC-Modus und der Multi-CRC-Modus, wobei der CRC-Modus schneller als der - Single- und der Multimodus sind, und der Multi-CRC-Modus die Technik des - CRC-Modus mit der Speicherstruktur des Multi-Modus verbindet. + Mit dem Parameter dbmode wird der Modus spezifiziert, in dem die Daten in + der Datenbank vorliegen. Wird der Modus 'single' gewählt, werden alle + Wörter in der selben Tablelle gespeichert. Der Modus 'multi' speichert die + Wörter in verschiedenene Tabellen, abhängig von deren Länge. Weitere Modi + sind der CRC-Modus und der Multi-CRC-Modus, wobei der CRC-Modus schneller + als der Single- und der Multimodus sind, und der Multi-CRC-Modus die + Technik des CRC-Modus mit der Speicherstruktur des Multi-Modus verbindet. Format: DBMode single/multi/crc/crc-multi </para> <note> <para> - <parameter>dbaddr</parameter> und <parameter>dbmode</parameter> müssen mit - den Werten übereinstimmen, die beim Indizieren verwendet wurden. + <parameter>dbaddr</parameter> und <parameter>dbmode</parameter> müssen mit + den Werten übereinstimmen, die beim Indizieren verwendet wurden. </para> </note> <note> <para> Eigentlich öffnet diese Funktion keine Verbindung zur Datenbank, folglich - werden auch keine User- und Passwortüberprüfungen durchgeführt. Die Verbindung - zur Datenbank wird von der Funktion <function>udm_find</function> übernommen, - hier findet dann auch eine Überprüfung der Logindaten statt. + werden auch keine User- und Passwortüberprüfungen durchgeführt. Die + Verbindung zur Datenbank wird von der Funktion + <function>udm_find</function> übernommen, hier findet dann auch eine + Überprüfung der Logindaten statt. </para> </note> </refsect1> @@ -200,7 +207,7 @@ <refentry id="function.udm-api-version"> <refnamediv> <refname>udm_api_version</refname> - <refpurpose>Gibt die Version der mnoGoSearch API zurück.</refpurpose> + <refpurpose>Gibt die Version der mnoGoSearch API zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -212,14 +219,15 @@ </funcsynopsis> <para> - <function>udm_api_version</function> gibt die mnoGoSearch API-Versionsnummer - zurück. Wird als z.B. die mnoGoSearch 3.1.10 API benutzt, gibt diese Funktion - <literal>30110</literal> zurück. + <function>udm_api_version</function> gibt die mnoGoSearch + API-Versionsnummer zurück. Wird als z.B. die mnoGoSearch 3.1.10 API + benutzt, gibt diese Funktion <literal>30110</literal> zurück. </para> - <para>Diese Funktion erlaubt es dem Benutzer zu erfahren, welche Funktionen der - mnoGoSearch-API verfügbar sind. - <function>udm_get_doc_count</function> diese Funktion ist erst ab mnoGoSearch 3.1.11 oder später verfügbar. </para> + <para>Diese Funktion erlaubt es dem Benutzer zu erfahren, welche Funktionen + der mnoGoSearch-API verfügbar sind. <function>udm_get_doc_count</function> + diese Funktion ist erst ab mnoGoSearch 3.1.11 oder später verfügbar. + </para> <simpara>Beispiel:</simpara> <informalexample> @@ -235,7 +243,7 @@ <refentry id="function.udm-cat-path"> <refnamediv> <refname>udm_cat_path</refname> - <refpurpose>Liefert den Pfad zur aktuellen Kategorie zurück.</refpurpose> + <refpurpose>Liefert den Pfad zur aktuellen Kategorie zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -247,8 +255,8 @@ </funcprototype> </funcsynopsis> <para> - <function>udm_cat_path</function> gibt einen Array zurück, der den Pfad - im Kategorienbaum von der Wurzel an bis zur aktuellen Kategorie enthält. + <function>udm_cat_path</function> gibt einen Array zurück, der den Pfad + im Kategorienbaum von der Wurzel an bis zur aktuellen Kategorie enthält. </para> <para> @@ -256,11 +264,12 @@ </para> <para> - <parameter>category</parameter> - aktuelle Kategorie - diejenige, zu der der Pfad herausgefunden werden soll. + <parameter>category</parameter> - aktuelle Kategorie - diejenige, zu der + der Pfad herausgefunden werden soll. </para> <para> - Gibt einen Array mit dem folgenden Format zurück: + Gibt einen Array mit dem folgenden Format zurück: </para> <para> @@ -269,8 +278,8 @@ Kategorienamen. </para> <para> - So könnte der Aufruf <literal>$array=udm_cat_path($agent, '02031D');</literal> - folgenden Array zurückliefern: + So könnte der Aufruf <literal>$array=udm_cat_path($agent, + '02031D');</literal> folgenden Array zurückliefern: </para> <literallayout> @@ -306,7 +315,8 @@ <refentry id="function.udm-cat-list"> <refnamediv> <refname>udm_cat_list</refname> - <refpurpose>Liefert alle Kategorien auf der selben Ebene wie der aktuellen zurück.</refpurpose> + <refpurpose>Liefert alle Kategorien auf der selben Ebene wie der aktuellen + zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -319,15 +329,17 @@ </funcsynopsis> <para> - <function>udm_cat_list</function> Gibt einen Array zurück, der alle Kategorien - auf dem selben Level im Kategorienbaum wie dei aktuelle Kategorie liegen. + <function>udm_cat_list</function> Gibt einen Array zurück, der alle + Kategorien auf dem selben Level im Kategorienbaum wie die aktuelle + Kategorie liegen. </para> <para> - Diese Funktion kann nützlich sein, um einen Kategorienbrowser zu entwickeln. + Diese Funktion kann nützlich sein, um einen Kategorienbrowser zu + entwickeln. </para> <para> - Gibt einen Array mit dem folgenden Format zurück: + Gibt einen Array mit dem folgenden Format zurück: </para> <para> @@ -386,8 +398,8 @@ </funcsynopsis> <para> - <function>udm_clear_search_limits</function> setzt definierte Sucheinschränkungen - zurück und gibt &true; zurück. + <function>udm_clear_search_limits</function> setzt definierte + Sucheinschränkungen zurück und gibt &true; zurück. </para> </refsect1> </refentry> @@ -395,7 +407,7 @@ <refentry id="function.udm-errno"> <refnamediv> <refname>udm_errno</refname> - <refpurpose>Liefert den mnoGoSearch Fehlercode zurück.</refpurpose> + <refpurpose>Liefert den mnoGoSearch Fehlercode zurück.</refpurpose> </refnamediv> <refsect1> @@ -408,7 +420,8 @@ </funcsynopsis> <para> - <function>udm_errno</function> liefert den mnoGoSearch Fehlercode. Null wenn kein Fehler vorliegt.. + <function>udm_errno</function> liefert den mnoGoSearch Fehlercode. Null + wenn kein Fehler vorliegt.. </para> <para> @@ -417,7 +430,7 @@ </para> <para> - Enthält einen numerischen Fehlercode. + Enthält einen numerischen Fehlercode. </para> </refsect1> </refentry> @@ -425,7 +438,7 @@ <refentry id="function.udm-error"> <refnamediv> <refname>udm_error</refname> - <refpurpose>Liefert eine mnoGoSearch Fehlermeldung zurück.</refpurpose> + <refpurpose>Liefert eine mnoGoSearch Fehlermeldung zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -437,7 +450,7 @@ </funcsynopsis> <para> - <function>udm_error</function> gibt eine mnoGoSearch Fehlermeldung zurück, + <function>udm_error</function> gibt eine mnoGoSearch Fehlermeldung zurück, eine leere Zeichenkette, wenn kein Fehler vorlag. </para> @@ -447,7 +460,7 @@ </para> <para> - Liefert die Fehlermeldung des Agenten zurück. + Liefert die Fehlermeldung des Agenten zurück. </para> </refsect1> @@ -456,7 +469,7 @@ <refentry id="function.udm-find"> <refnamediv> <refname>udm_find</refname> - <refpurpose>Führe eine Suche durch.</refpurpose> + <refpurpose>Führe eine Suche durch.</refpurpose> </refnamediv> <refsect1> @@ -470,25 +483,25 @@ </funcsynopsis> <para> - <function>udm_find</function> gibt einen Ergebniszeiger bei Erfolg zurück, + <function>udm_find</function> gibt einen Ergebniszeiger bei Erfolg zurück, &false; bei einem Fehler. </para> <para> - Die eigentliche Suche. Das erste Argument - die Session, das nächste + Die eigentliche Suche. Das erste Argument - die Session, das nächste - die Suche selbst. Um etwas zu finden, einfach die zu suchenden - Begriffe in das Suchfeld eintippen und den Submit-Button drücken. - Zum Beispiel "mysql odbc". Die doppelten Anführungszeichen " sollten - nicht in einer Suche verwendet werden, sie werden hier nur aufgeführt, + Begriffe in das Suchfeld eintippen und den Submit-Button drücken. + Zum Beispiel "mysql odbc". Die doppelten Anführungszeichen " sollten + nicht in einer Suche verwendet werden, sie werden hier nur aufgeführt, um die Suchbegriffe vom anderen Text zu unterscheiden. mnoGoSearch wird alle Dokumente finden, die das Wort "mysql" und/oder "odbc" enthalten. Dokumente, die der Suche besser entsprechen als andere werden zuerst angezeigt. Wird der Suchmodus ALL verwendet, werden nur Dokumente gefunden, die alle gesuchten Wörter mindestens einmal enthalten. Wird der Suchmodus - ANY verwendet, werden alle Dokumente zurückgliefert, die eines der + ANY verwendet, werden alle Dokumente zurückgliefert, die eines der gesuchten Wörter enthalten. Wenn ausgefeiltere Suchen stattfinden sollen, muß die Suchsprache verwendet werden. In diesem Falle sollte der boolsche - Übereinstimmungsmodus gewählt werden. + Übereinstimmungsmodus gewählt werden. </para> <simpara> @@ -537,7 +550,8 @@ </funcsynopsis> <para> - <function>udm_free_agent</function> gibt &true; bei Erfolg zurück, &false; bei einem Fehler. + <function>udm_free_agent</function> gibt &true; bei Erfolg zurück, &false; + bei einem Fehler. </para> <para> <parameter>agent</parameter> - Zeiger auf einen Agenten, erhalten nach @@ -554,7 +568,8 @@ <refentry id="function.udm-free-ispell-data"> <refnamediv> <refname>udm_free_ispell_data</refname> - <refpurpose>Gibt den Speicher frei, der für ISpell alloziiert wurde.</refpurpose> + <refpurpose>Gibt den Speicher frei, der für ISpell alloziiert + wurde.</refpurpose> </refnamediv> <refsect1> @@ -601,7 +616,8 @@ </funcsynopsis> <para> - <function>udm_free_res</function> gibt &true; bei Erfolg, &false; bei einem Fehler zurück. + <function>udm_free_res</function> gibt &true; bei Erfolg, &false; bei einem + Fehler zurück. </para> <para> @@ -619,7 +635,8 @@ <refentry id="function.udm-get-doc-count"> <refnamediv> <refname>udm_get_doc_count</refname> - <refpurpose>Liefert die Anzahl aller Dokumente in der Datenbank zurück.</refpurpose> + <refpurpose>Liefert die Anzahl aller Dokumente in der Datenbank + zurück.</refpurpose> </refnamediv> <refsect1> @@ -632,7 +649,8 @@ </funcsynopsis> <para> - <function>udm_get_doc_count</function> gibt die Anzahl der Dokumente in der Datenbank zurück. + <function>udm_get_doc_count</function> gibt die Anzahl der Dokumente in der + Datenbank zurück. </para> <para> @@ -701,8 +719,8 @@ <simpara> UDM_FIELD_CATEGORY - Kategorie des Dokumentes. <function>udm_cat_path</function> sollte verwendet werden, um den vollen - Pfad vom der Wurzel des Kategorienbaumes zur aktuellen Kategorie zu erhalten. - (Dieser Parameter ist erst ab PHP Version 4.0.6 verfügbar). + Pfad vom der Wurzel des Kategorienbaumes zur aktuellen Kategorie zu + erhalten. (Dieser Parameter ist erst ab PHP Version 4.0.6 verfügbar). </simpara> </listitem> <listitem> @@ -722,7 +740,8 @@ </listitem> <listitem> <simpara> - UDM_FIELD_TEXT - Inhalt des Dokumentes (die ersten Zeilen des Dokumentes). + UDM_FIELD_TEXT - Inhalt des Dokumentes (die ersten Zeilen des + Dokumentes). </simpara> </listitem> <listitem> @@ -742,12 +761,14 @@ </listitem> <listitem> <simpara> - UDM_FIELD_MODIFIED - Datum der letzten Änderung des Dokumentes als Unix-Timestamp. + UDM_FIELD_MODIFIED - Datum der letzten Änderung des Dokumentes als + Unix-Timestamp. </simpara> </listitem> <listitem> <simpara> - UDM_FIELD_ORDER - Die Nummer des aktuellen Dokumentes in der Menge der gefundenen Dokumente. + UDM_FIELD_ORDER - Die Nummer des aktuellen Dokumentes in der Menge der + gefundenen Dokumente. </simpara> </listitem> <listitem> @@ -777,17 +798,18 @@ </funcsynopsis> <para> - <function>udm_get_res_param</function> gibt den Wert des Parameters bei Erfolg. - &false; bei einem Fehler zurüc. + <function>udm_get_res_param</function> gibt den Wert des Parameters bei + Erfolg. &false; bei einem Fehler zurüc. </para> <para> - <parameter>res</parameter> - ein Ergebniszeiger, erhalten nach einem Aufruf von - <function>udm_find</function>. + <parameter>res</parameter> - ein Ergebniszeiger, erhalten nach einem Aufruf + von <function>udm_find</function>. </para> <para> - <parameter>param</parameter> - Parameterbezeichner. Kann folgenden Werte annehmen: + <parameter>param</parameter> - Parameterbezeichner. Kann folgenden Werte + annehmen: </para> <itemizedlist> @@ -798,14 +820,15 @@ </listitem> <listitem> <simpara> - UDM_PARAM_FOUND - Anzahl der gefundenen Dokuemnte, die der Suche entsprechen. + UDM_PARAM_FOUND - Anzahl der gefundenen Dokuemnte, die der Suche + entsprechen. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_WORDINFO - Informationen über die gefundenen Wörter. Zum Beispiel - könnte eine Suche nach "a good book" die Werte "a: stopword, good:5637, book: 120" - ausgeben. + UDM_PARAM_WORDINFO - Informationen über die gefundenen Wörter. Zum + Beispiel könnte eine Suche nach "a good book" die Werte "a: stopword, + good:5637, book: 120" ausgeben. </simpara> </listitem> <listitem> @@ -815,12 +838,14 @@ </listitem> <listitem> <simpara> - UDM_PARAM_FIRST_DOC - Die Nummer des ersten auf der aktuellen Seite angezeigten Dokumentes. + UDM_PARAM_FIRST_DOC - Die Nummer des ersten auf der aktuellen Seite + angezeigten Dokumentes. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_LAST_DOC - Die Nummer des letzten auf der aktuellen Seiten angezeigten Dokumentes. + UDM_PARAM_LAST_DOC - Die Nummer des letzten auf der aktuellen Seiten + angezeigten Dokumentes. </simpara> </listitem> </itemizedlist> @@ -865,7 +890,8 @@ <para> Nachdem diese Funktion aufgerufen wurde, sollte nicht vergessen werden, mittels <function>udm_free_ispell_data</function> den durch ISpell belegten - Speicher wieder freizugeben, auch wenn UDM_ISPELL_TYPE_SERVER verwendet wird. + Speicher wieder freizugeben, auch wenn UDM_ISPELL_TYPE_SERVER verwendet + wird. </para> <para> @@ -878,23 +904,26 @@ <itemizedlist> <listitem> <simpara> - UDM_ISPELL_TYPE_DB - Gibt an, das die ISpell-Daten aus einer SQL-Datenbank - gelesen werden sollen. In diesem Fall werden <parameter>val1</parameter> und - <parameter>val2</parameter> ignoriert und sollten leer gelassen werden. - Der Parameter <parameter>flag</parameter> sollte <literal>1</literal> sein. + UDM_ISPELL_TYPE_DB - Gibt an, das die ISpell-Daten aus einer + SQL-Datenbank gelesen werden sollen. In diesem Fall werden + <parameter>val1</parameter> und <parameter>val2</parameter> ignoriert + und sollten leer gelassen werden. Der Parameter + <parameter>flag</parameter> sollte <literal>1</literal> sein. </simpara> <note> <para> Der Parameter <parameter>flag</parameter> gibt an, dass die ISpell-Daten - nach dem Laden sortiert werden sollen, dies ist für ein korrektes Arbeiten - von ISpell nötig. Werden die ISpell-Daten aus Dateien gelesen, kann es - vorkommen, daß mehrere Aufrufe von <function>udm_load_ispell_data</function> - vorkommen, was es wenig Effektiv macht, die Daten nach jedem Aufruf zu sortieren. - Der Datenbank-Modus lädt jedoch alle Daten auf einmal, in diesem Fall sollte - der Wert also <literal>1</literal> betragen. Sollte ein Fehler auftreten, - wird &false; zurückgegeben, Fehler und Fehlercode sind in diesem Fall über - <function>udm_error</function> und <function>udm_errno</function> verfügbar. + nach dem Laden sortiert werden sollen, dies ist für ein korrektes + Arbeiten von ISpell nötig. Werden die ISpell-Daten aus Dateien gelesen, + kann es vorkommen, daß mehrere Aufrufe von + <function>udm_load_ispell_data</function> + vorkommen, was es wenig Effektiv macht, die Daten nach jedem Aufruf zu + sortieren. Der Datenbank-Modus lädt jedoch alle Daten auf einmal, in + diesem Fall sollte der Wert also <literal>1</literal> betragen. Sollte + ein Fehler auftreten, wird &false; zurückgegeben, Fehler und Fehlercode + sind in diesem Fall über <function>udm_error</function> und + <function>udm_errno</function> verfügbar. </para> </note> @@ -913,14 +942,15 @@ UDM_ISPELL_TYPE_AFFIX - Gibt an, dass die ISpell-Daten aus einer Datei geladen werden sollen und initiiert das Laden der Anhangsdaten. In diesem Fall gibt der Parameter <parameter>val1</parameter> den zweibuchstabigen - Sprachcode an, für den die Anhänge geladen werden sollen, <parameter>val2</parameter> - gibt den Dateipfad an. Wird kein absoluter Pfad angeben, werden die Dateien - nicht in UDM_CONF_DIR, sondern in im zum aktuellen Pfad relativen gesucht. - Kann die Datei nicht geladen werden, gibt die Funktion &false; zurück, und eine - Fehlermeldung wird ausgegeben. Die Fehlercodes können nicht über - <function>udm_error</function> oder <function>udm_errno</function> ausgelesen - werden. Zur Erlärung des Parameters <parameter>flag</parameter> schauen Sie - bitte bei UDM_ISPELL_TYPE_DB nach. + Sprachcode an, für den die Anhänge geladen werden sollen, + <parameter>val2</parameter> gibt den Dateipfad an. Wird kein absoluter + Pfad angeben, werden die Dateien nicht in UDM_CONF_DIR, sondern in im zum + aktuellen Pfad relativen gesucht. Kann die Datei nicht geladen werden, + gibt die Funktion &false; zurück, und eine Fehlermeldung wird ausgegeben. + Die Fehlercodes können nicht über <function>udm_error</function> oder + <function>udm_errno</function> ausgelesen werden. Zur Erlärung des + Parameters <parameter>flag</parameter> schauen Sie bitte bei + UDM_ISPELL_TYPE_DB nach. </para> <simpara>Beispiel:</simpara> @@ -936,7 +966,8 @@ </informalexample> <note> <para> - <parameter>flag</parameter> hat nur beim letzten Aufruf den Wert<literal>1</literal>. + <parameter>flag</parameter> hat nur beim letzten Aufruf den Wert + <literal>1</literal>. </para> </note> </listitem> @@ -944,15 +975,17 @@ <para> UDM_ISPELL_TYPE_SPELL - Gibt an, dass die ISpell-Daten aus einer Datei gelesen werden sollen, und initiiert das Laden des ISpell-Wörterbuches. - In diesem Fall gibt der Parameter <parameter>val1</parameter> den zweibuchstabigen - Sprachcode an, für den die Anhänge geladen werden sollen, <parameter>val2</parameter> - gibt den Dateipfad an. Wird kein absoluter Pfad angeben, werden die Dateien - nicht in UDM_CONF_DIR, sondern in im zum aktuellen Pfad relativen gesucht. - Kann die Datei nicht geladen werden, gibt die Funktion &false; zurück, und eine - Fehlermeldung wird ausgegeben. Die Fehlercodes können nicht über - <function>udm_error</function> oder <function>udm_errno</function> ausgelesen - werden. Zur Erlärung des Parameters <parameter>flag</parameter> schauen Sie - bitte bei UDM_ISPELL_TYPE_DB nach. + In diesem Fall gibt der Parameter <parameter>val1</parameter> den + zweibuchstabigen Sprachcode an, für den die Anhänge geladen werden + sollen, <parameter>val2</parameter> gibt den Dateipfad an. Wird kein + absoluter Pfad angeben, werden die Dateien nicht in UDM_CONF_DIR, + sondern in im zum aktuellen Pfad relativen gesucht. Kann die Datei nicht + geladen werden, gibt die Funktion &false; zurück, und eine Fehlermeldung + wird ausgegeben. Die Fehlercodes können nicht über + <function>udm_error</function> oder <function>udm_errno</function> + ausgelesen werden. Zur Erklärung des Parameters + <parameter>flag</parameter> schauen Sie bitte bei + UDM_ISPELL_TYPE_DB nach. </para> <informalexample> <programlisting role="C"> @@ -975,22 +1008,25 @@ <para> UDM_ISPELL_TYPE_SERVER - schaltet den Spell-Server support ein. <parameter>val1</parameter> gibt den Host an, auf dem der Spell-Server - läuft.. <parameter>val2</parameter> ist noch ohne Funktion, wird in Zukunft - aber den Port des Spell-Servers angeben. <parameter>flag</parameter> wird - nicht benötigt, da die Daten bereits sortiert im Spell-Server vorliegen. + läuft.. <parameter>val2</parameter> ist noch ohne Funktion, wird in + Zukunft aber den Port des Spell-Servers angeben. + <parameter>flag</parameter> wird nicht benötigt, da die Daten bereits + sortiert im Spell-Server vorliegen. </para> <para> Der Spell-Server (Spelld) liest die Rechtschreibdaten aus einer - seperaten Konfigurationsdatei (Standardmäßig /usr/local/mnogosearch/etc/spelld.conf), - sortiert sie und speichert sie im Speicher. + seperaten Konfigurationsdatei (Standardmäßig + /usr/local/mnogosearch/etc/spelld.conf), sortiert sie und speichert sie + im Speicher. </para> <para> - Die Funktion <function>udm_load_ispell_data</function> in UDM_ISPELL_TYPE_SERVER - lädt eigentlich nicht die ISpell-Daten, sondern legt nur die Serveradresse fest. - Eigentlich wird dieser Server automatisch von <function>udm_find</function> - benutzt, wenn eine Suche durchgeführt wird. Sollte ein Fehler auftreten, - wird keine Fehlermeldung ausgegeben, eine ISpell-Konvertierung kann dann - jedoch natürlich auch nicht stattfinden. + Die Funktion <function>udm_load_ispell_data</function> in + UDM_ISPELL_TYPE_SERVER lädt eigentlich nicht die ISpell-Daten, sondern + legt nur die Serveradresse fest. Eigentlich wird dieser Server + automatisch von <function>udm_find</function> benutzt, wenn eine Suche + durchgeführt wird. Sollte ein Fehler auftreten, wird keine Fehlermeldung + ausgegeben, eine ISpell-Konvertierung kann dann jedoch natürlich auch + nicht stattfinden. </para> <note> @@ -1041,50 +1077,54 @@ <itemizedlist> <listitem> <simpara> - UDM_PARAM_PAGE_NUM - wird genutzt, um eine bestimmte Seite aus den Suchergebnissen - auszuwählen. Ergebnissseiten werden von 0 an gezählt. + UDM_PARAM_PAGE_NUM - wird genutzt, um eine bestimmte Seite aus den + Suchergebnissen auszuwählen. Ergebnissseiten werden von 0 an gezählt. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_PAGE_SIZE - Anzahl der Suchergebnisse, die pro Seite angezeigt werden. + UDM_PARAM_PAGE_SIZE - Anzahl der Suchergebnisse, die pro Seite angezeigt + werden. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_SEARCH_MODE - Suchmodus. Die folgenden Werte sind erlaubt: UDM_MODE_ALL - - Logische UND-Verknüpfung; UDM_MODE_ANY - Logische ODER-Verknüpfung; UDM_MODE_BOOL - - boolsche Suche. Siehe <function>udm_find</function> für weitere Details zur boolschen - Suche. + UDM_PARAM_SEARCH_MODE - Suchmodus. Die folgenden Werte sind erlaubt: + UDM_MODE_ALL - Logische UND-Verknüpfung; UDM_MODE_ANY - Logische + ODER-Verknüpfung; UDM_MODE_BOOL - boolsche Suche. Siehe + <function>udm_find</function> für weitere Details zur boolschen Suche. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_CACHE_MODE - Schaltet den Ergebnis-Cache an oder aus. Falls eingeschaltet - wird die Suchmaschine Suchergebnisse auf der Festplatte zwischenspeichern. Für - den Fall, dass später eine ähnliche Suche durchgeführt wird, werden die Ergebnisse - für ein schnelleres Ergebnis aus dem Cache gelesen. Werte: UDM_CACHE_ENABLED, UDM_CACHE_DISABLED. + UDM_PARAM_CACHE_MODE - Schaltet den Ergebnis-Cache an oder aus. Falls + eingeschaltet wird die Suchmaschine Suchergebnisse auf der Festplatte + zwischenspeichern. Für den Fall, dass später eine ähnliche Suche + durchgeführt wird, werden die Ergebnisse für ein schnelleres Ergebnis aus + dem Cache gelesen. Werte: UDM_CACHE_ENABLED, UDM_CACHE_DISABLED. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_TRACK_MODE - schaltet den Trackquery-Modus an oder aus. Seit Version - 3.1.12 von mnoGoSearch wird eine Verfolgung von Suchanfragen unterstützt. - Um die Track-Funktion nutzen zu können, müssen zusätzliche SQL-Tabellen angelegt werden. - Für MySQL liegen die Tabellenbeschreibungen in create/mysql/track.txt. - Wird eine Suche durchgeführt, werden die Suchwörter in diesen Tabellen zusammen - mit der Anzahl der gefundenen Dokumente und dem aktuellen Unix-Timestamp - gespeichert. Verfügbare Werte: UDM_TRACK_ENABLED, UDM_TRACK_DISABLED. + UDM_PARAM_TRACK_MODE - schaltet den Trackquery-Modus an oder aus. Seit + Version 3.1.12 von mnoGoSearch wird eine Verfolgung von Suchanfragen + unterstützt. Um die Track-Funktion nutzen zu können, müssen zusätzliche + SQL-Tabellen angelegt werden. Für MySQL liegen die Tabellenbeschreibungen + in create/mysql/track.txt. Wird eine Suche durchgeführt, werden die + Suchwörter in diesen Tabellen zusammen mit der Anzahl der gefundenen + Dokumente und dem aktuellen Unix-Timestamp gespeichert. Verfügbare Werte: + UDM_TRACK_ENABLED, UDM_TRACK_DISABLED. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_PHRASE_MODE - Gibt an, ob die Index-Datenbank eine Unterstützung - für "Phrases" erlaubt. (Muß vor der Indizierung in der indexer.conf eingeschaltet - werden. Mögliche Werte: UDM_PHRASE_ENABLED und UDM_PHRASE_DISABLED. Wird der - Phrase-Modus verwendet, ist es natürlich nach wie vor möglich, alle anderen - Suchmodi zu verwenden. Seit Version 3.1.11 wird auch der Cache-Modus zusammen - mit dem Phrase-Modus unterstützt. + UDM_PARAM_PHRASE_MODE - Gibt an, ob die Index-Datenbank eine + Unterstützung für "Phrases" erlaubt. (Muß vor der Indizierung in der + indexer.conf eingeschaltet werden. Mögliche Werte: UDM_PHRASE_ENABLED und + UDM_PHRASE_DISABLED. Wird der Phrase-Modus verwendet, ist es natürlich + nach wie vor möglich, alle anderen Suchmodi zu verwenden. Seit Version + 3.1.11 wird auch der Cache-Modus zusammen mit dem Phrase-Modus + unterstützt. </simpara> <simpara> Beispiele: @@ -1118,10 +1158,10 @@ <listitem> <simpara> UDM_PARAM_WEIGHT_FACTOR - Legt fest, wie bestimmte Teile eines Dokumentes - zur Sortierung gewertet werden. Zur Zeit werden Body, Title, Keywords, Description - und URL unterstützt. Um dieses Feature nutzen zu können, muß der Grad 2 - in den *Weight-Anweisungen in der indexer.conf verwendet werden. - Stellen wir uns vor, folgende Werte würden verwendet: + zur Sortierung gewertet werden. Zur Zeit werden Body, Title, Keywords, + Description und URL unterstützt. Um dieses Feature nutzen zu können, muß + der Grad 2 in den *Weight-Anweisungen in der indexer.conf verwendet + werden. Stellen wir uns vor, folgende Werte würden verwendet: </simpara> <literallayout> URLWeight 1 @@ -1132,12 +1172,13 @@ </literallayout> <simpara> - Solange der Indexer eine logische bit-ODER Operation verwendet, um das Gewicht - einzelner Wörter festzulegen, wenn ein Wort mehrere Male im selben Dokument vorkommt, - ist es möglich, zur Zeit der Suche festzustellen, welches Wort in welchem Teil des - Dokumentes vorkommt. Wörter, die nur im Body auftauchen, haben das Gewicht - 00000010 in binärer Notation. Wörter, die in allen Dokumententeilen vorkommen - haben das Gewicht 00011111. + Solange der Indexer eine logische bit-ODER Operation verwendet, um das + Gewicht einzelner Wörter festzulegen, wenn ein Wort mehrere Male im + selben Dokument vorkommt, ist es möglich, zur Zeit der Suche + festzustellen, welches Wort in welchem Teil des Dokumentes vorkommt. + Wörter, die nur im Body auftauchen, haben das Gewicht 00000010 in + binärer Notation. Wörter, die in allen Dokumententeilen vorkommen haben + das Gewicht 00011111. </simpara> <simpara> @@ -1176,16 +1217,17 @@ URL mit dem Faktor 1 </literallayout> <simpara> - Wenn die Variable UDM_PARAM_WEIGHT_FACTOR übergeben wird, wird das Originalgewicht - zur Sortierung verwendet. + Wenn die Variable UDM_PARAM_WEIGHT_FACTOR übergeben wird, wird das + Originalgewicht zur Sortierung verwendet. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_WORD_MATCH - Wortteilübereinstimmung. Dieser Parameter kann verwendet - werden, um festzulegen, welcher Wortteil mit dem gesuchten Wort übereinstimmen - muß. Dieses Feature funktioniert nur im "single" oder "multi"-Modus. Im Cachemode - und in den CRC-Modi ist eine Verwendung nicht möglich. Erlaubt Werte: + UDM_PARAM_WORD_MATCH - Wortteilübereinstimmung. Dieser Parameter kann + verwendet werden, um festzulegen, welcher Wortteil mit dem gesuchten Wort + übereinstimmen muß. Dieses Feature funktioniert nur im "single" oder + "multi"-Modus. Im Cachemode und in den CRC-Modi ist eine Verwendung nicht + möglich. Erlaubt Werte: </simpara> <simpara>UDM_MATCH_BEGIN - Der Wortanfang muss übereinstimmen;</simpara> <simpara>UDM_MATCH_END - Das Wortende muss übereinstimmen;</simpara> @@ -1194,30 +1236,33 @@ </listitem> <listitem> <simpara> - UDM_PARAM_MIN_WORD_LEN - Legt die mininmale Wortlänge fest. Jedes Wort, dass - kürzer als die angegebene Länge ist, wird als stopword aufgefasst. + UDM_PARAM_MIN_WORD_LEN - Legt die mininmale Wortlänge fest. Jedes Wort, + dass kürzer als die angegebene Länge ist, wird als stopword aufgefasst. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_ISPELL_PREFIXES - Mögliche Werte: UDM_PREFIXES_ENABLED und UDM_PREFIXES_DISABLED, - die explizit die Verwendung von ISpell-Prefixen an- oder abschalten. - Wird also zum Beispiel das Wort "tested" in einer Suchabfrage verwendet, - werden auch Wörter wie "test" oder "testing" gefunden. Nur Endungen werden - normalerweise Unterstützt. Prefixe verändern für gewöhnlich die Bedeutung - von Wörtern. So werden bei einer Suche nach "tested" z.B. auch Dokumente - gefunden, die das Wort "untested" enthalten. Um diese Funktion nutzen zu können, - müssen vorher mittels <function>udm_load_ispell_data</function> ISpell-Daten geladen werden. + UDM_PARAM_ISPELL_PREFIXES - Mögliche Werte: UDM_PREFIXES_ENABLED und + UDM_PREFIXES_DISABLED, die explizit die Verwendung von ISpell-Prefixen + an- oder abschalten. Wird also zum Beispiel das Wort "tested" in einer + Suchabfrage verwendet, werden auch Wörter wie "test" oder "testing" + gefunden. Nur Endungen werden normalerweise Unterstützt. Prefixe + verändern für gewöhnlich die Bedeutung von Wörtern. So werden bei einer + Suche nach "tested" z.B. auch Dokumente gefunden, die das Wort + "untested" enthalten. Um diese Funktion nutzen zu können, müssen vorher + mittels <function>udm_load_ispell_data</function> ISpell-Daten geladen + werden. </simpara> </listitem> <listitem> <simpara> UDM_PARAM_CROSS_WORDS - Aktiviert oder deaktiviert eine Unterstützung für - Crosswords. Mögliche Werte: UDM_CROSS_WORDS_ENABLED und UDM_CROSS_WORDS_DISABLED. + Crosswords. Mögliche Werte: UDM_CROSS_WORDS_ENABLED und + UDM_CROSS_WORDS_DISABLED. </simpara> <simpara> - Das Crosswords-Feature erlaubt es, Wörter zwischen <a href="xxx"> und </a> - dem Dokument zuzuordnen, zu dem dieser Link führt. + Das Crosswords-Feature erlaubt es, Wörter zwischen <a href="xxx"> + und </a> dem Dokument zuzuordnen, zu dem dieser Link führt. </simpara> <note> <simpara> @@ -1227,12 +1272,13 @@ </listitem> <listitem> <simpara> - UDM_PARAM_VARDIR - Gibt einen Pfad zu einem Verzeichnis an, in dem der Indexer - Daten speichert, wenn der integrierte Datenbank-Modus oder der Cachemodus - verwendet wird. Voreingestellt ist das <literal>/var</literal>-Verzeichnis - der <application>mnoGoSearch</application>-Installation verwendet. Es können - ausschliesslich Strings verwendet werden. Dieser Parameter ist erst ab - PHP 4.1.0 verfügbar. + UDM_PARAM_VARDIR - Gibt einen Pfad zu einem Verzeichnis an, in dem der + Indexer Daten speichert, wenn der integrierte Datenbank-Modus oder der + Cachemodus verwendet wird. Voreingestellt ist das + <literal>/var</literal>-Verzeichnis + der <application>mnoGoSearch</application>-Installation verwendet. Es + können ausschliesslich Strings verwendet werden. Dieser Parameter ist + erst ab PHP 4.1.0 verfügbar. </simpara> </listitem> </itemizedlist>
Index: phpdoc/de/functions/mnogosearch.xml diff -u phpdoc/de/functions/mnogosearch.xml:1.1 phpdoc/de/functions/mnogosearch.xml:1.2 --- phpdoc/de/functions/mnogosearch.xml:1.1 Sun Nov 11 13:57:35 2001 +++ phpdoc/de/functions/mnogosearch.xml Sun Nov 11 15:19:47 2001 @@ -1,15 +1,15 @@ <?xml encoding="iso-8859-1"?> -<!-- $Revision: 1.1 $ --> +<!-- $Revision: 1.2 $ --> <reference id="ref.mnogo"> <title>mnoGoSearch Funktionen</title> <titleabbrev>mnoGoSearch</titleabbrev> <partintro> <simpara> Diese Funktionen erlauben den Zugriff auf die mnoGoSearch - früher als UdmSearch bekannt) Suchmaschine. Um auf diese + früher als UdmSearch bekannt) Suchmaschine. Um auf diese Funktionen zugreifen zu können, muß php mittels der <link linkend="install.configure.with-mnogosearch"><option role="configure"> - --with-mnogosearch</option></link>-Option mit mnoGoSearch-Unterstützung + --with-mnogosearch</option></link>-Option mit mnoGoSearch-Unterstützung compiliert worden sein. Wird diese Option ohne Pfadangabe zu mnoGoSearch verwendet, wird mnoGoSearch in /usr/local/mnoGoSearch gesucht. Wurde mnoGoSearch unter einem anderen Pfad installiert, kann der Pfad mittels @@ -17,29 +17,31 @@ --with-mnogosearch=DIR</option></link> spezifiziert werden. </simpara> <para> - mnoGoSearch ist eine vollwertige Suchmaschine für den Intra- und Interneteinsatz, - vertrieben unter der GPL. mnoGoSearch hat einige einzigartige Funktionen, die es - für weite Einsatzbereiche tauglich machen. Es bietet Volltextindizierung von - HTML, PDF und Textdokumenten. mnoGoSearch besteht aus zwei Teilen: Der erste ist - der sogenannte indexer, der den Indizierungsmechanismus bereitstellt. Er spidered - HTTP, FTP und Newsserver oder lokale Dateisysteme, indiziert die gefundenen - Dokumente und speichert Meta-Daten über die Dokumente in einer SQL-Datenbank. + mnoGoSearch ist eine vollwertige Suchmaschine für den Intra- und + Interneteinsatz, vertrieben unter der GPL. mnoGoSearch hat einige + einzigartige Funktionen, die es für weite Einsatzbereiche tauglich machen. + Es bietet Volltextindizierung von HTML, PDF und Textdokumenten. mnoGoSearch + besteht aus zwei Teilen: Der erste ist der sogenannte indexer, der den + Indizierungsmechanismus bereitstellt. Er spidered HTTP, FTP und Newsserver + oder lokale Dateisysteme, indiziert die gefundenen Dokumente und speichert + Meta-Daten über die Dokumente in einer SQL-Datenbank. </para> <note> <para> php beinhaltet zwar einen eingebauten MySQL-Support, dieser ist jedoch nicht mit mnoGoSearch kompatibel, deshalb muß php gegen die selben generischen MySQL-Bibliotheken wie mnoGoSearch gelinkt werden, also z.B.: - <link linkend="install.configure.with-mnogosearch"><option role="configure"> + <link linkend="install.configure.with-mnogosearch"> + <option role="configure"> --with-mnogosearch --with-mysql=/usr</option></link>. </para> </note> <simpara> - Es wird mindestens Version 3.1.10 von mnoGoSearch vorausgesetzt, um die folgenden - Funktionen nutzen zu lönnen. + Es wird mindestens Version 3.1.10 von mnoGoSearch vorausgesetzt, um die + folgenden Funktionen nutzen zu können. </simpara> <simpara> - Weitere Informationen über mnoGoSearch können unter + Weitere Informationen über mnoGoSearch können unter <ulink url="&url.mnogo;">&url.mnogo;</ulink> abgerufen werden. </simpara> </partintro> @@ -47,7 +49,7 @@ <refentry id="function.udm-add-search-limit"> <refnamediv> <refname>udm_add_search_limit</refname> - <refpurpose>Verschiedene Beschränkungen bei der Suche anwenden</refpurpose> + <refpurpose>Verschiedene Beschränkungen bei der Suche anwenden</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -61,7 +63,7 @@ </funcsynopsis> <para> <function>udm_add_search_limit</function> gibt &true; bei Erfolg, - &false; bei einem Fehler zurück. Fügt Suchrestritktionen + &false; bei einem Fehler zurück. Fügt Suchrestritktionen hinzu. </para> <para> @@ -69,33 +71,35 @@ <function>udm_alloc_agent</function>. </para> <para> - <parameter>var</parameter> - Definiert den Parameter der die Einschränkung angibt. + <parameter>var</parameter> - Definiert den Parameter der die Einschränkung + angibt. </para> <para> <parameter>val</parameter> - Definiert den Wert des aktuellen Parameters. </para> <para> - Mögliche Werte für <parameter>var</parameter>: + Mögliche Werte für <parameter>var</parameter>: </para> <itemizedlist> <listitem> <simpara> UDM_LIMIT_URL - - definiert URL Limitationen, um die Suche auf Unterbereiche einzuschränken - SQL % und _ LIKE Wildcards werden unterstützt, % entspricht dabei einer - beliebigen Anzahl von Zeichen, wobei auch keine Zeichen eingeschlossen werden, - _ entspricht genau einem Zeichen. So entspricht also http://my.domain__/catalog - sowohl http://my.domain.ru/catalog als auch http://my.domain.ua/catalog. + definiert URL Limitationen, um die Suche auf Unterbereiche einzuschränken + SQL % und _ LIKE Wildcards werden unterstützt, % entspricht dabei einer + beliebigen Anzahl von Zeichen, wobei auch keine Zeichen eingeschlossen + werden, _ entspricht genau einem Zeichen. So entspricht also + http://my.domain__/catalog sowohl http://my.domain.ru/catalog als auch + http://my.domain.ua/catalog. </simpara> </listitem> <listitem> <simpara> UDM_LIMIT_TAG - - definiert TAG Limitationen. In der indexer-conf können bestimmeten + definiert TAG Limitationen. In der indexer-conf können bestimmeten Sites und Teilen von Sites sogenannte Tags zugewiesen werden. Auch bei - Tags werden % und _ unterstützt. Metasymbole erlauben die Suche - über Gruppen von Tags. So werden also die Tags ABCD und ABCE bei - einer Einschränkung auf ABC_ eingeschlossen. + Tags werden % und _ unterstützt. Metasymbole erlauben die Suche + über Gruppen von Tags. So werden also die Tags ABCD und ABCE bei + einer Einschränkung auf ABC_ eingeschlossen. </simpara> </listitem> <listitem> @@ -106,21 +110,21 @@ <listitem> <simpara> UDM_LIMIT_CAT - Definiert Dokumentenkategorielimitationen. Kategorien - sind den Tags ähnlich, jedoch im Gegensatz zu diesen verschachtelt. Eine - Kategorie kann also Unterkategorie einer anderen sein. Für jede Ebene - werden müssen zwei Zeichen verwendendet werden, entweder hexadezimale + sind den Tags ähnlich, jedoch im Gegensatz zu diesen verschachtelt. Eine + Kategorie kann also Unterkategorie einer anderen sein. Für jede Ebene + werden müssen zwei Zeichen verwendendet werden, entweder hexadezimale Zahlen von 0-F oder Zahlen zur Basis 36 von 0-Z. Eine Kategorie der - obersten Ebene, z.B. 'Auto' hätte die Zahl 01, die Unterkategorie 'Ford' - hätte ebenfalls die 01 als Zahl. Zusammen ergäbe das dann die 0101. Eine - weitere Kategorie 'VW' unterhalb der Kategorie 'Auto' hätte dann die Zahl - 0102 usw. Wenn 'VW' eine Unterkategorie 'Golf' hätte, wäre desren ID + obersten Ebene, z.B. 'Auto' hätte die Zahl 01, die Unterkategorie 'Ford' + hätte ebenfalls die 01 als Zahl. Zusammen ergäbe das dann die 0101. Eine + weitere Kategorie 'VW' unterhalb der Kategorie 'Auto' hätte dann die Zahl + 0102 usw. Wenn 'VW' eine Unterkategorie 'Golf' hätte, wäre desren ID 010201. </simpara> </listitem> <listitem> <simpara> - UDM_LIMIT_DATE - Definiert Einschränkungen in Bezug auf das Datum, wann - das Dokument zuletzt verändert wurde. + UDM_LIMIT_DATE - Definiert Einschränkungen in Bezug auf das Datum, wann + das Dokument zuletzt verändert wurde. </simpara> <simpara> Der Wert dieses Parameters ist das kleiner bzw. größer-Zeichen @@ -130,10 +134,10 @@ Udm_Add_Search_Limit($udm,UDM_LIMIT_DATE,"<908012006"); </simpara> <simpara> - Wenn das >-Zeichen benutzt wird, wird die Suche auf diejenigen Dokumente - eingeschränkt, deren Veränderungsdatum jünger als das eigegebene ist, - beim <-Zeichen erfolgt die Einschränkung dementsprechend auf Dokumente, - die Älter sind. + Wenn das >-Zeichen benutzt wird, wird die Suche auf diejenigen + Dokumente eingeschränkt, deren Veränderungsdatum jünger als das + eingegebene ist, beim <-Zeichen erfolgt die Einschränkung + dementsprechend auf Dokumente, die Älter sind. </simpara> </listitem> </itemizedlist> @@ -150,48 +154,51 @@ <funcprototype> <funcdef>int <function>udm_alloc_agent</function></funcdef> <paramdef>string <parameter>dbaddr</parameter></paramdef> - <paramdef>string<parameter><optional>dbmode</optional></parameter></paramdef> + <paramdef>string<parameter><optional>dbmode</optional></parameter> + </paramdef> </funcprototype> </funcsynopsis> <para><function>udm_alloc_agent</function> Gibt bei Erfolg einen eindeutigen Zeiger auf einen mnoGoSearch-Agenten - zurück, bei einem Fehler wird &false; zurücckgegeben. Diese Funktion + zurück, bei einem Fehler wird &false; zurückgegeben. Diese Funktion kreiert eine Sitzung mit Datenbankparametern. </para> <para> <parameter>dbaddr</parameter> - - Datenbankadresse im URL-Stil. Wird verwendet, um mit den Daten Datenbanktyp, - Datenbankhost, Datenbankname, Datenbankport, Datenbankuser und Datenbankpasswort - eine Verbindung zu einer SQL-Datenbank herzustellen. Das Format lautet: + Datenbankadresse im URL-Stil. Wird verwendet, um mit den Daten + Datenbanktyp, Datenbankhost, Datenbankname, Datenbankport, Datenbankuser + und Datenbankpasswort eine Verbindung zu einer SQL-Datenbank herzustellen. + Das Format lautet: DBAddr DBType:[//[DBUser[:DBPass]@]DBHost[:DBPort]]/DBName/. </para> <para> <parameter>dbmode</parameter> - - Mit dem Parameter dbmode wird der Modus spezifiziert, in dem die Daten in der - Datenbank vorliegen. Wird der Modus 'single' gewählt, werden alle Wörter in - der selben Tablelle gespeichert. Der Modus 'multi' speichert die Wörter - in verschiedenene Tabellen, abhängig von deren Länge. Weitere Modi sind der - CRC-Modus und der Multi-CRC-Modus, wobei der CRC-Modus schneller als der - Single- und der Multimodus sind, und der Multi-CRC-Modus die Technik des - CRC-Modus mit der Speicherstruktur des Multi-Modus verbindet. + Mit dem Parameter dbmode wird der Modus spezifiziert, in dem die Daten in + der Datenbank vorliegen. Wird der Modus 'single' gewählt, werden alle + Wörter in der selben Tablelle gespeichert. Der Modus 'multi' speichert die + Wörter in verschiedenene Tabellen, abhängig von deren Länge. Weitere Modi + sind der CRC-Modus und der Multi-CRC-Modus, wobei der CRC-Modus schneller + als der Single- und der Multimodus sind, und der Multi-CRC-Modus die + Technik des CRC-Modus mit der Speicherstruktur des Multi-Modus verbindet. Format: DBMode single/multi/crc/crc-multi </para> <note> <para> - <parameter>dbaddr</parameter> und <parameter>dbmode</parameter> müssen mit - den Werten übereinstimmen, die beim Indizieren verwendet wurden. + <parameter>dbaddr</parameter> und <parameter>dbmode</parameter> müssen mit + den Werten übereinstimmen, die beim Indizieren verwendet wurden. </para> </note> <note> <para> Eigentlich öffnet diese Funktion keine Verbindung zur Datenbank, folglich - werden auch keine User- und Passwortüberprüfungen durchgeführt. Die Verbindung - zur Datenbank wird von der Funktion <function>udm_find</function> übernommen, - hier findet dann auch eine Überprüfung der Logindaten statt. + werden auch keine User- und Passwortüberprüfungen durchgeführt. Die + Verbindung zur Datenbank wird von der Funktion + <function>udm_find</function> übernommen, hier findet dann auch eine + Überprüfung der Logindaten statt. </para> </note> </refsect1> @@ -200,7 +207,7 @@ <refentry id="function.udm-api-version"> <refnamediv> <refname>udm_api_version</refname> - <refpurpose>Gibt die Version der mnoGoSearch API zurück.</refpurpose> + <refpurpose>Gibt die Version der mnoGoSearch API zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -212,14 +219,15 @@ </funcsynopsis> <para> - <function>udm_api_version</function> gibt die mnoGoSearch API-Versionsnummer - zurück. Wird als z.B. die mnoGoSearch 3.1.10 API benutzt, gibt diese Funktion - <literal>30110</literal> zurück. + <function>udm_api_version</function> gibt die mnoGoSearch + API-Versionsnummer zurück. Wird als z.B. die mnoGoSearch 3.1.10 API + benutzt, gibt diese Funktion <literal>30110</literal> zurück. </para> - <para>Diese Funktion erlaubt es dem Benutzer zu erfahren, welche Funktionen der - mnoGoSearch-API verfügbar sind. - <function>udm_get_doc_count</function> diese Funktion ist erst ab mnoGoSearch 3.1.11 oder später verfügbar. </para> + <para>Diese Funktion erlaubt es dem Benutzer zu erfahren, welche Funktionen + der mnoGoSearch-API verfügbar sind. <function>udm_get_doc_count</function> + diese Funktion ist erst ab mnoGoSearch 3.1.11 oder später verfügbar. + </para> <simpara>Beispiel:</simpara> <informalexample> @@ -235,7 +243,7 @@ <refentry id="function.udm-cat-path"> <refnamediv> <refname>udm_cat_path</refname> - <refpurpose>Liefert den Pfad zur aktuellen Kategorie zurück.</refpurpose> + <refpurpose>Liefert den Pfad zur aktuellen Kategorie zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -247,8 +255,8 @@ </funcprototype> </funcsynopsis> <para> - <function>udm_cat_path</function> gibt einen Array zurück, der den Pfad - im Kategorienbaum von der Wurzel an bis zur aktuellen Kategorie enthält. + <function>udm_cat_path</function> gibt einen Array zurück, der den Pfad + im Kategorienbaum von der Wurzel an bis zur aktuellen Kategorie enthält. </para> <para> @@ -256,11 +264,12 @@ </para> <para> - <parameter>category</parameter> - aktuelle Kategorie - diejenige, zu der der Pfad herausgefunden werden soll. + <parameter>category</parameter> - aktuelle Kategorie - diejenige, zu der + der Pfad herausgefunden werden soll. </para> <para> - Gibt einen Array mit dem folgenden Format zurück: + Gibt einen Array mit dem folgenden Format zurück: </para> <para> @@ -269,8 +278,8 @@ Kategorienamen. </para> <para> - So könnte der Aufruf <literal>$array=udm_cat_path($agent, '02031D');</literal> - folgenden Array zurückliefern: + So könnte der Aufruf <literal>$array=udm_cat_path($agent, + '02031D');</literal> folgenden Array zurückliefern: </para> <literallayout> @@ -306,7 +315,8 @@ <refentry id="function.udm-cat-list"> <refnamediv> <refname>udm_cat_list</refname> - <refpurpose>Liefert alle Kategorien auf der selben Ebene wie der aktuellen zurück.</refpurpose> + <refpurpose>Liefert alle Kategorien auf der selben Ebene wie der aktuellen + zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -319,15 +329,17 @@ </funcsynopsis> <para> - <function>udm_cat_list</function> Gibt einen Array zurück, der alle Kategorien - auf dem selben Level im Kategorienbaum wie dei aktuelle Kategorie liegen. + <function>udm_cat_list</function> Gibt einen Array zurück, der alle + Kategorien auf dem selben Level im Kategorienbaum wie die aktuelle + Kategorie liegen. </para> <para> - Diese Funktion kann nützlich sein, um einen Kategorienbrowser zu entwickeln. + Diese Funktion kann nützlich sein, um einen Kategorienbrowser zu + entwickeln. </para> <para> - Gibt einen Array mit dem folgenden Format zurück: + Gibt einen Array mit dem folgenden Format zurück: </para> <para> @@ -386,8 +398,8 @@ </funcsynopsis> <para> - <function>udm_clear_search_limits</function> setzt definierte Sucheinschränkungen - zurück und gibt &true; zurück. + <function>udm_clear_search_limits</function> setzt definierte + Sucheinschränkungen zurück und gibt &true; zurück. </para> </refsect1> </refentry> @@ -395,7 +407,7 @@ <refentry id="function.udm-errno"> <refnamediv> <refname>udm_errno</refname> - <refpurpose>Liefert den mnoGoSearch Fehlercode zurück.</refpurpose> + <refpurpose>Liefert den mnoGoSearch Fehlercode zurück.</refpurpose> </refnamediv> <refsect1> @@ -408,7 +420,8 @@ </funcsynopsis> <para> - <function>udm_errno</function> liefert den mnoGoSearch Fehlercode. Null wenn kein Fehler vorliegt.. + <function>udm_errno</function> liefert den mnoGoSearch Fehlercode. Null + wenn kein Fehler vorliegt.. </para> <para> @@ -417,7 +430,7 @@ </para> <para> - Enthält einen numerischen Fehlercode. + Enthält einen numerischen Fehlercode. </para> </refsect1> </refentry> @@ -425,7 +438,7 @@ <refentry id="function.udm-error"> <refnamediv> <refname>udm_error</refname> - <refpurpose>Liefert eine mnoGoSearch Fehlermeldung zurück.</refpurpose> + <refpurpose>Liefert eine mnoGoSearch Fehlermeldung zurück.</refpurpose> </refnamediv> <refsect1> <title>Beschreibung</title> @@ -437,7 +450,7 @@ </funcsynopsis> <para> - <function>udm_error</function> gibt eine mnoGoSearch Fehlermeldung zurück, + <function>udm_error</function> gibt eine mnoGoSearch Fehlermeldung zurück, eine leere Zeichenkette, wenn kein Fehler vorlag. </para> @@ -447,7 +460,7 @@ </para> <para> - Liefert die Fehlermeldung des Agenten zurück. + Liefert die Fehlermeldung des Agenten zurück. </para> </refsect1> @@ -456,7 +469,7 @@ <refentry id="function.udm-find"> <refnamediv> <refname>udm_find</refname> - <refpurpose>Führe eine Suche durch.</refpurpose> + <refpurpose>Führe eine Suche durch.</refpurpose> </refnamediv> <refsect1> @@ -470,25 +483,25 @@ </funcsynopsis> <para> - <function>udm_find</function> gibt einen Ergebniszeiger bei Erfolg zurück, + <function>udm_find</function> gibt einen Ergebniszeiger bei Erfolg zurück, &false; bei einem Fehler. </para> <para> - Die eigentliche Suche. Das erste Argument - die Session, das nächste + Die eigentliche Suche. Das erste Argument - die Session, das nächste - die Suche selbst. Um etwas zu finden, einfach die zu suchenden - Begriffe in das Suchfeld eintippen und den Submit-Button drücken. - Zum Beispiel "mysql odbc". Die doppelten Anführungszeichen " sollten - nicht in einer Suche verwendet werden, sie werden hier nur aufgeführt, + Begriffe in das Suchfeld eintippen und den Submit-Button drücken. + Zum Beispiel "mysql odbc". Die doppelten Anführungszeichen " sollten + nicht in einer Suche verwendet werden, sie werden hier nur aufgeführt, um die Suchbegriffe vom anderen Text zu unterscheiden. mnoGoSearch wird alle Dokumente finden, die das Wort "mysql" und/oder "odbc" enthalten. Dokumente, die der Suche besser entsprechen als andere werden zuerst angezeigt. Wird der Suchmodus ALL verwendet, werden nur Dokumente gefunden, die alle gesuchten Wörter mindestens einmal enthalten. Wird der Suchmodus - ANY verwendet, werden alle Dokumente zurückgliefert, die eines der + ANY verwendet, werden alle Dokumente zurückgliefert, die eines der gesuchten Wörter enthalten. Wenn ausgefeiltere Suchen stattfinden sollen, muß die Suchsprache verwendet werden. In diesem Falle sollte der boolsche - Übereinstimmungsmodus gewählt werden. + Übereinstimmungsmodus gewählt werden. </para> <simpara> @@ -537,7 +550,8 @@ </funcsynopsis> <para> - <function>udm_free_agent</function> gibt &true; bei Erfolg zurück, &false; bei einem Fehler. + <function>udm_free_agent</function> gibt &true; bei Erfolg zurück, &false; + bei einem Fehler. </para> <para> <parameter>agent</parameter> - Zeiger auf einen Agenten, erhalten nach @@ -554,7 +568,8 @@ <refentry id="function.udm-free-ispell-data"> <refnamediv> <refname>udm_free_ispell_data</refname> - <refpurpose>Gibt den Speicher frei, der für ISpell alloziiert wurde.</refpurpose> + <refpurpose>Gibt den Speicher frei, der für ISpell alloziiert + wurde.</refpurpose> </refnamediv> <refsect1> @@ -601,7 +616,8 @@ </funcsynopsis> <para> - <function>udm_free_res</function> gibt &true; bei Erfolg, &false; bei einem Fehler zurück. + <function>udm_free_res</function> gibt &true; bei Erfolg, &false; bei einem + Fehler zurück. </para> <para> @@ -619,7 +635,8 @@ <refentry id="function.udm-get-doc-count"> <refnamediv> <refname>udm_get_doc_count</refname> - <refpurpose>Liefert die Anzahl aller Dokumente in der Datenbank zurück.</refpurpose> + <refpurpose>Liefert die Anzahl aller Dokumente in der Datenbank + zurück.</refpurpose> </refnamediv> <refsect1> @@ -632,7 +649,8 @@ </funcsynopsis> <para> - <function>udm_get_doc_count</function> gibt die Anzahl der Dokumente in der Datenbank zurück. + <function>udm_get_doc_count</function> gibt die Anzahl der Dokumente in der + Datenbank zurück. </para> <para> @@ -701,8 +719,8 @@ <simpara> UDM_FIELD_CATEGORY - Kategorie des Dokumentes. <function>udm_cat_path</function> sollte verwendet werden, um den vollen - Pfad vom der Wurzel des Kategorienbaumes zur aktuellen Kategorie zu erhalten. - (Dieser Parameter ist erst ab PHP Version 4.0.6 verfügbar). + Pfad vom der Wurzel des Kategorienbaumes zur aktuellen Kategorie zu + erhalten. (Dieser Parameter ist erst ab PHP Version 4.0.6 verfügbar). </simpara> </listitem> <listitem> @@ -722,7 +740,8 @@ </listitem> <listitem> <simpara> - UDM_FIELD_TEXT - Inhalt des Dokumentes (die ersten Zeilen des Dokumentes). + UDM_FIELD_TEXT - Inhalt des Dokumentes (die ersten Zeilen des + Dokumentes). </simpara> </listitem> <listitem> @@ -742,12 +761,14 @@ </listitem> <listitem> <simpara> - UDM_FIELD_MODIFIED - Datum der letzten Änderung des Dokumentes als Unix-Timestamp. + UDM_FIELD_MODIFIED - Datum der letzten Änderung des Dokumentes als + Unix-Timestamp. </simpara> </listitem> <listitem> <simpara> - UDM_FIELD_ORDER - Die Nummer des aktuellen Dokumentes in der Menge der gefundenen Dokumente. + UDM_FIELD_ORDER - Die Nummer des aktuellen Dokumentes in der Menge der + gefundenen Dokumente. </simpara> </listitem> <listitem> @@ -777,17 +798,18 @@ </funcsynopsis> <para> - <function>udm_get_res_param</function> gibt den Wert des Parameters bei Erfolg. - &false; bei einem Fehler zurüc. + <function>udm_get_res_param</function> gibt den Wert des Parameters bei + Erfolg. &false; bei einem Fehler zurüc. </para> <para> - <parameter>res</parameter> - ein Ergebniszeiger, erhalten nach einem Aufruf von - <function>udm_find</function>. + <parameter>res</parameter> - ein Ergebniszeiger, erhalten nach einem Aufruf + von <function>udm_find</function>. </para> <para> - <parameter>param</parameter> - Parameterbezeichner. Kann folgenden Werte annehmen: + <parameter>param</parameter> - Parameterbezeichner. Kann folgenden Werte + annehmen: </para> <itemizedlist> @@ -798,14 +820,15 @@ </listitem> <listitem> <simpara> - UDM_PARAM_FOUND - Anzahl der gefundenen Dokuemnte, die der Suche entsprechen. + UDM_PARAM_FOUND - Anzahl der gefundenen Dokuemnte, die der Suche + entsprechen. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_WORDINFO - Informationen über die gefundenen Wörter. Zum Beispiel - könnte eine Suche nach "a good book" die Werte "a: stopword, good:5637, book: 120" - ausgeben. + UDM_PARAM_WORDINFO - Informationen über die gefundenen Wörter. Zum + Beispiel könnte eine Suche nach "a good book" die Werte "a: stopword, + good:5637, book: 120" ausgeben. </simpara> </listitem> <listitem> @@ -815,12 +838,14 @@ </listitem> <listitem> <simpara> - UDM_PARAM_FIRST_DOC - Die Nummer des ersten auf der aktuellen Seite angezeigten Dokumentes. + UDM_PARAM_FIRST_DOC - Die Nummer des ersten auf der aktuellen Seite + angezeigten Dokumentes. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_LAST_DOC - Die Nummer des letzten auf der aktuellen Seiten angezeigten Dokumentes. + UDM_PARAM_LAST_DOC - Die Nummer des letzten auf der aktuellen Seiten + angezeigten Dokumentes. </simpara> </listitem> </itemizedlist> @@ -865,7 +890,8 @@ <para> Nachdem diese Funktion aufgerufen wurde, sollte nicht vergessen werden, mittels <function>udm_free_ispell_data</function> den durch ISpell belegten - Speicher wieder freizugeben, auch wenn UDM_ISPELL_TYPE_SERVER verwendet wird. + Speicher wieder freizugeben, auch wenn UDM_ISPELL_TYPE_SERVER verwendet + wird. </para> <para> @@ -878,23 +904,26 @@ <itemizedlist> <listitem> <simpara> - UDM_ISPELL_TYPE_DB - Gibt an, das die ISpell-Daten aus einer SQL-Datenbank - gelesen werden sollen. In diesem Fall werden <parameter>val1</parameter> und - <parameter>val2</parameter> ignoriert und sollten leer gelassen werden. - Der Parameter <parameter>flag</parameter> sollte <literal>1</literal> sein. + UDM_ISPELL_TYPE_DB - Gibt an, das die ISpell-Daten aus einer + SQL-Datenbank gelesen werden sollen. In diesem Fall werden + <parameter>val1</parameter> und <parameter>val2</parameter> ignoriert + und sollten leer gelassen werden. Der Parameter + <parameter>flag</parameter> sollte <literal>1</literal> sein. </simpara> <note> <para> Der Parameter <parameter>flag</parameter> gibt an, dass die ISpell-Daten - nach dem Laden sortiert werden sollen, dies ist für ein korrektes Arbeiten - von ISpell nötig. Werden die ISpell-Daten aus Dateien gelesen, kann es - vorkommen, daß mehrere Aufrufe von <function>udm_load_ispell_data</function> - vorkommen, was es wenig Effektiv macht, die Daten nach jedem Aufruf zu sortieren. - Der Datenbank-Modus lädt jedoch alle Daten auf einmal, in diesem Fall sollte - der Wert also <literal>1</literal> betragen. Sollte ein Fehler auftreten, - wird &false; zurückgegeben, Fehler und Fehlercode sind in diesem Fall über - <function>udm_error</function> und <function>udm_errno</function> verfügbar. + nach dem Laden sortiert werden sollen, dies ist für ein korrektes + Arbeiten von ISpell nötig. Werden die ISpell-Daten aus Dateien gelesen, + kann es vorkommen, daß mehrere Aufrufe von + <function>udm_load_ispell_data</function> + vorkommen, was es wenig Effektiv macht, die Daten nach jedem Aufruf zu + sortieren. Der Datenbank-Modus lädt jedoch alle Daten auf einmal, in + diesem Fall sollte der Wert also <literal>1</literal> betragen. Sollte + ein Fehler auftreten, wird &false; zurückgegeben, Fehler und Fehlercode + sind in diesem Fall über <function>udm_error</function> und + <function>udm_errno</function> verfügbar. </para> </note> @@ -913,14 +942,15 @@ UDM_ISPELL_TYPE_AFFIX - Gibt an, dass die ISpell-Daten aus einer Datei geladen werden sollen und initiiert das Laden der Anhangsdaten. In diesem Fall gibt der Parameter <parameter>val1</parameter> den zweibuchstabigen - Sprachcode an, für den die Anhänge geladen werden sollen, <parameter>val2</parameter> - gibt den Dateipfad an. Wird kein absoluter Pfad angeben, werden die Dateien - nicht in UDM_CONF_DIR, sondern in im zum aktuellen Pfad relativen gesucht. - Kann die Datei nicht geladen werden, gibt die Funktion &false; zurück, und eine - Fehlermeldung wird ausgegeben. Die Fehlercodes können nicht über - <function>udm_error</function> oder <function>udm_errno</function> ausgelesen - werden. Zur Erlärung des Parameters <parameter>flag</parameter> schauen Sie - bitte bei UDM_ISPELL_TYPE_DB nach. + Sprachcode an, für den die Anhänge geladen werden sollen, + <parameter>val2</parameter> gibt den Dateipfad an. Wird kein absoluter + Pfad angeben, werden die Dateien nicht in UDM_CONF_DIR, sondern in im zum + aktuellen Pfad relativen gesucht. Kann die Datei nicht geladen werden, + gibt die Funktion &false; zurück, und eine Fehlermeldung wird ausgegeben. + Die Fehlercodes können nicht über <function>udm_error</function> oder + <function>udm_errno</function> ausgelesen werden. Zur Erlärung des + Parameters <parameter>flag</parameter> schauen Sie bitte bei + UDM_ISPELL_TYPE_DB nach. </para> <simpara>Beispiel:</simpara> @@ -936,7 +966,8 @@ </informalexample> <note> <para> - <parameter>flag</parameter> hat nur beim letzten Aufruf den Wert<literal>1</literal>. + <parameter>flag</parameter> hat nur beim letzten Aufruf den Wert + <literal>1</literal>. </para> </note> </listitem> @@ -944,15 +975,17 @@ <para> UDM_ISPELL_TYPE_SPELL - Gibt an, dass die ISpell-Daten aus einer Datei gelesen werden sollen, und initiiert das Laden des ISpell-Wörterbuches. - In diesem Fall gibt der Parameter <parameter>val1</parameter> den zweibuchstabigen - Sprachcode an, für den die Anhänge geladen werden sollen, <parameter>val2</parameter> - gibt den Dateipfad an. Wird kein absoluter Pfad angeben, werden die Dateien - nicht in UDM_CONF_DIR, sondern in im zum aktuellen Pfad relativen gesucht. - Kann die Datei nicht geladen werden, gibt die Funktion &false; zurück, und eine - Fehlermeldung wird ausgegeben. Die Fehlercodes können nicht über - <function>udm_error</function> oder <function>udm_errno</function> ausgelesen - werden. Zur Erlärung des Parameters <parameter>flag</parameter> schauen Sie - bitte bei UDM_ISPELL_TYPE_DB nach. + In diesem Fall gibt der Parameter <parameter>val1</parameter> den + zweibuchstabigen Sprachcode an, für den die Anhänge geladen werden + sollen, <parameter>val2</parameter> gibt den Dateipfad an. Wird kein + absoluter Pfad angeben, werden die Dateien nicht in UDM_CONF_DIR, + sondern in im zum aktuellen Pfad relativen gesucht. Kann die Datei nicht + geladen werden, gibt die Funktion &false; zurück, und eine Fehlermeldung + wird ausgegeben. Die Fehlercodes können nicht über + <function>udm_error</function> oder <function>udm_errno</function> + ausgelesen werden. Zur Erklärung des Parameters + <parameter>flag</parameter> schauen Sie bitte bei + UDM_ISPELL_TYPE_DB nach. </para> <informalexample> <programlisting role="C"> @@ -975,22 +1008,25 @@ <para> UDM_ISPELL_TYPE_SERVER - schaltet den Spell-Server support ein. <parameter>val1</parameter> gibt den Host an, auf dem der Spell-Server - läuft.. <parameter>val2</parameter> ist noch ohne Funktion, wird in Zukunft - aber den Port des Spell-Servers angeben. <parameter>flag</parameter> wird - nicht benötigt, da die Daten bereits sortiert im Spell-Server vorliegen. + läuft.. <parameter>val2</parameter> ist noch ohne Funktion, wird in + Zukunft aber den Port des Spell-Servers angeben. + <parameter>flag</parameter> wird nicht benötigt, da die Daten bereits + sortiert im Spell-Server vorliegen. </para> <para> Der Spell-Server (Spelld) liest die Rechtschreibdaten aus einer - seperaten Konfigurationsdatei (Standardmäßig /usr/local/mnogosearch/etc/spelld.conf), - sortiert sie und speichert sie im Speicher. + seperaten Konfigurationsdatei (Standardmäßig + /usr/local/mnogosearch/etc/spelld.conf), sortiert sie und speichert sie + im Speicher. </para> <para> - Die Funktion <function>udm_load_ispell_data</function> in UDM_ISPELL_TYPE_SERVER - lädt eigentlich nicht die ISpell-Daten, sondern legt nur die Serveradresse fest. - Eigentlich wird dieser Server automatisch von <function>udm_find</function> - benutzt, wenn eine Suche durchgeführt wird. Sollte ein Fehler auftreten, - wird keine Fehlermeldung ausgegeben, eine ISpell-Konvertierung kann dann - jedoch natürlich auch nicht stattfinden. + Die Funktion <function>udm_load_ispell_data</function> in + UDM_ISPELL_TYPE_SERVER lädt eigentlich nicht die ISpell-Daten, sondern + legt nur die Serveradresse fest. Eigentlich wird dieser Server + automatisch von <function>udm_find</function> benutzt, wenn eine Suche + durchgeführt wird. Sollte ein Fehler auftreten, wird keine Fehlermeldung + ausgegeben, eine ISpell-Konvertierung kann dann jedoch natürlich auch + nicht stattfinden. </para> <note> @@ -1041,50 +1077,54 @@ <itemizedlist> <listitem> <simpara> - UDM_PARAM_PAGE_NUM - wird genutzt, um eine bestimmte Seite aus den Suchergebnissen - auszuwählen. Ergebnissseiten werden von 0 an gezählt. + UDM_PARAM_PAGE_NUM - wird genutzt, um eine bestimmte Seite aus den + Suchergebnissen auszuwählen. Ergebnissseiten werden von 0 an gezählt. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_PAGE_SIZE - Anzahl der Suchergebnisse, die pro Seite angezeigt werden. + UDM_PARAM_PAGE_SIZE - Anzahl der Suchergebnisse, die pro Seite angezeigt + werden. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_SEARCH_MODE - Suchmodus. Die folgenden Werte sind erlaubt: UDM_MODE_ALL - - Logische UND-Verknüpfung; UDM_MODE_ANY - Logische ODER-Verknüpfung; UDM_MODE_BOOL - - boolsche Suche. Siehe <function>udm_find</function> für weitere Details zur boolschen - Suche. + UDM_PARAM_SEARCH_MODE - Suchmodus. Die folgenden Werte sind erlaubt: + UDM_MODE_ALL - Logische UND-Verknüpfung; UDM_MODE_ANY - Logische + ODER-Verknüpfung; UDM_MODE_BOOL - boolsche Suche. Siehe + <function>udm_find</function> für weitere Details zur boolschen Suche. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_CACHE_MODE - Schaltet den Ergebnis-Cache an oder aus. Falls eingeschaltet - wird die Suchmaschine Suchergebnisse auf der Festplatte zwischenspeichern. Für - den Fall, dass später eine ähnliche Suche durchgeführt wird, werden die Ergebnisse - für ein schnelleres Ergebnis aus dem Cache gelesen. Werte: UDM_CACHE_ENABLED, UDM_CACHE_DISABLED. + UDM_PARAM_CACHE_MODE - Schaltet den Ergebnis-Cache an oder aus. Falls + eingeschaltet wird die Suchmaschine Suchergebnisse auf der Festplatte + zwischenspeichern. Für den Fall, dass später eine ähnliche Suche + durchgeführt wird, werden die Ergebnisse für ein schnelleres Ergebnis aus + dem Cache gelesen. Werte: UDM_CACHE_ENABLED, UDM_CACHE_DISABLED. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_TRACK_MODE - schaltet den Trackquery-Modus an oder aus. Seit Version - 3.1.12 von mnoGoSearch wird eine Verfolgung von Suchanfragen unterstützt. - Um die Track-Funktion nutzen zu können, müssen zusätzliche SQL-Tabellen angelegt werden. - Für MySQL liegen die Tabellenbeschreibungen in create/mysql/track.txt. - Wird eine Suche durchgeführt, werden die Suchwörter in diesen Tabellen zusammen - mit der Anzahl der gefundenen Dokumente und dem aktuellen Unix-Timestamp - gespeichert. Verfügbare Werte: UDM_TRACK_ENABLED, UDM_TRACK_DISABLED. + UDM_PARAM_TRACK_MODE - schaltet den Trackquery-Modus an oder aus. Seit + Version 3.1.12 von mnoGoSearch wird eine Verfolgung von Suchanfragen + unterstützt. Um die Track-Funktion nutzen zu können, müssen zusätzliche + SQL-Tabellen angelegt werden. Für MySQL liegen die Tabellenbeschreibungen + in create/mysql/track.txt. Wird eine Suche durchgeführt, werden die + Suchwörter in diesen Tabellen zusammen mit der Anzahl der gefundenen + Dokumente und dem aktuellen Unix-Timestamp gespeichert. Verfügbare Werte: + UDM_TRACK_ENABLED, UDM_TRACK_DISABLED. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_PHRASE_MODE - Gibt an, ob die Index-Datenbank eine Unterstützung - für "Phrases" erlaubt. (Muß vor der Indizierung in der indexer.conf eingeschaltet - werden. Mögliche Werte: UDM_PHRASE_ENABLED und UDM_PHRASE_DISABLED. Wird der - Phrase-Modus verwendet, ist es natürlich nach wie vor möglich, alle anderen - Suchmodi zu verwenden. Seit Version 3.1.11 wird auch der Cache-Modus zusammen - mit dem Phrase-Modus unterstützt. + UDM_PARAM_PHRASE_MODE - Gibt an, ob die Index-Datenbank eine + Unterstützung für "Phrases" erlaubt. (Muß vor der Indizierung in der + indexer.conf eingeschaltet werden. Mögliche Werte: UDM_PHRASE_ENABLED und + UDM_PHRASE_DISABLED. Wird der Phrase-Modus verwendet, ist es natürlich + nach wie vor möglich, alle anderen Suchmodi zu verwenden. Seit Version + 3.1.11 wird auch der Cache-Modus zusammen mit dem Phrase-Modus + unterstützt. </simpara> <simpara> Beispiele: @@ -1118,10 +1158,10 @@ <listitem> <simpara> UDM_PARAM_WEIGHT_FACTOR - Legt fest, wie bestimmte Teile eines Dokumentes - zur Sortierung gewertet werden. Zur Zeit werden Body, Title, Keywords, Description - und URL unterstützt. Um dieses Feature nutzen zu können, muß der Grad 2 - in den *Weight-Anweisungen in der indexer.conf verwendet werden. - Stellen wir uns vor, folgende Werte würden verwendet: + zur Sortierung gewertet werden. Zur Zeit werden Body, Title, Keywords, + Description und URL unterstützt. Um dieses Feature nutzen zu können, muß + der Grad 2 in den *Weight-Anweisungen in der indexer.conf verwendet + werden. Stellen wir uns vor, folgende Werte würden verwendet: </simpara> <literallayout> URLWeight 1 @@ -1132,12 +1172,13 @@ </literallayout> <simpara> - Solange der Indexer eine logische bit-ODER Operation verwendet, um das Gewicht - einzelner Wörter festzulegen, wenn ein Wort mehrere Male im selben Dokument vorkommt, - ist es möglich, zur Zeit der Suche festzustellen, welches Wort in welchem Teil des - Dokumentes vorkommt. Wörter, die nur im Body auftauchen, haben das Gewicht - 00000010 in binärer Notation. Wörter, die in allen Dokumententeilen vorkommen - haben das Gewicht 00011111. + Solange der Indexer eine logische bit-ODER Operation verwendet, um das + Gewicht einzelner Wörter festzulegen, wenn ein Wort mehrere Male im + selben Dokument vorkommt, ist es möglich, zur Zeit der Suche + festzustellen, welches Wort in welchem Teil des Dokumentes vorkommt. + Wörter, die nur im Body auftauchen, haben das Gewicht 00000010 in + binärer Notation. Wörter, die in allen Dokumententeilen vorkommen haben + das Gewicht 00011111. </simpara> <simpara> @@ -1176,16 +1217,17 @@ URL mit dem Faktor 1 </literallayout> <simpara> - Wenn die Variable UDM_PARAM_WEIGHT_FACTOR übergeben wird, wird das Originalgewicht - zur Sortierung verwendet. + Wenn die Variable UDM_PARAM_WEIGHT_FACTOR übergeben wird, wird das + Originalgewicht zur Sortierung verwendet. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_WORD_MATCH - Wortteilübereinstimmung. Dieser Parameter kann verwendet - werden, um festzulegen, welcher Wortteil mit dem gesuchten Wort übereinstimmen - muß. Dieses Feature funktioniert nur im "single" oder "multi"-Modus. Im Cachemode - und in den CRC-Modi ist eine Verwendung nicht möglich. Erlaubt Werte: + UDM_PARAM_WORD_MATCH - Wortteilübereinstimmung. Dieser Parameter kann + verwendet werden, um festzulegen, welcher Wortteil mit dem gesuchten Wort + übereinstimmen muß. Dieses Feature funktioniert nur im "single" oder + "multi"-Modus. Im Cachemode und in den CRC-Modi ist eine Verwendung nicht + möglich. Erlaubt Werte: </simpara> <simpara>UDM_MATCH_BEGIN - Der Wortanfang muss übereinstimmen;</simpara> <simpara>UDM_MATCH_END - Das Wortende muss übereinstimmen;</simpara> @@ -1194,30 +1236,33 @@ </listitem> <listitem> <simpara> - UDM_PARAM_MIN_WORD_LEN - Legt die mininmale Wortlänge fest. Jedes Wort, dass - kürzer als die angegebene Länge ist, wird als stopword aufgefasst. + UDM_PARAM_MIN_WORD_LEN - Legt die mininmale Wortlänge fest. Jedes Wort, + dass kürzer als die angegebene Länge ist, wird als stopword aufgefasst. </simpara> </listitem> <listitem> <simpara> - UDM_PARAM_ISPELL_PREFIXES - Mögliche Werte: UDM_PREFIXES_ENABLED und UDM_PREFIXES_DISABLED, - die explizit die Verwendung von ISpell-Prefixen an- oder abschalten. - Wird also zum Beispiel das Wort "tested" in einer Suchabfrage verwendet, - werden auch Wörter wie "test" oder "testing" gefunden. Nur Endungen werden - normalerweise Unterstützt. Prefixe verändern für gewöhnlich die Bedeutung - von Wörtern. So werden bei einer Suche nach "tested" z.B. auch Dokumente - gefunden, die das Wort "untested" enthalten. Um diese Funktion nutzen zu können, - müssen vorher mittels <function>udm_load_ispell_data</function> ISpell-Daten geladen werden. + UDM_PARAM_ISPELL_PREFIXES - Mögliche Werte: UDM_PREFIXES_ENABLED und + UDM_PREFIXES_DISABLED, die explizit die Verwendung von ISpell-Prefixen + an- oder abschalten. Wird also zum Beispiel das Wort "tested" in einer + Suchabfrage verwendet, werden auch Wörter wie "test" oder "testing" + gefunden. Nur Endungen werden normalerweise Unterstützt. Prefixe + verändern für gewöhnlich die Bedeutung von Wörtern. So werden bei einer + Suche nach "tested" z.B. auch Dokumente gefunden, die das Wort + "untested" enthalten. Um diese Funktion nutzen zu können, müssen vorher + mittels <function>udm_load_ispell_data</function> ISpell-Daten geladen + werden. </simpara> </listitem> <listitem> <simpara> UDM_PARAM_CROSS_WORDS - Aktiviert oder deaktiviert eine Unterstützung für - Crosswords. Mögliche Werte: UDM_CROSS_WORDS_ENABLED und UDM_CROSS_WORDS_DISABLED. + Crosswords. Mögliche Werte: UDM_CROSS_WORDS_ENABLED und + UDM_CROSS_WORDS_DISABLED. </simpara> <simpara> - Das Crosswords-Feature erlaubt es, Wörter zwischen <a href="xxx"> und </a> - dem Dokument zuzuordnen, zu dem dieser Link führt. + Das Crosswords-Feature erlaubt es, Wörter zwischen <a href="xxx"> + und </a> dem Dokument zuzuordnen, zu dem dieser Link führt. </simpara> <note> <simpara> @@ -1227,12 +1272,13 @@ </listitem> <listitem> <simpara> - UDM_PARAM_VARDIR - Gibt einen Pfad zu einem Verzeichnis an, in dem der Indexer - Daten speichert, wenn der integrierte Datenbank-Modus oder der Cachemodus - verwendet wird. Voreingestellt ist das <literal>/var</literal>-Verzeichnis - der <application>mnoGoSearch</application>-Installation verwendet. Es können - ausschliesslich Strings verwendet werden. Dieser Parameter ist erst ab - PHP 4.1.0 verfügbar. + UDM_PARAM_VARDIR - Gibt einen Pfad zu einem Verzeichnis an, in dem der + Indexer Daten speichert, wenn der integrierte Datenbank-Modus oder der + Cachemodus verwendet wird. Voreingestellt ist das + <literal>/var</literal>-Verzeichnis + der <application>mnoGoSearch</application>-Installation verwendet. Es + können ausschliesslich Strings verwendet werden. Dieser Parameter ist + erst ab PHP 4.1.0 verfügbar. </simpara> </listitem> </itemizedlist>