cvs: phpdoc-de /reference/pspell/functions pspell-new-personal.xml
| From: | Martin Samesch | Date: | Fri, 23 Aug 2002 16:48:20 +0000 |
| Subject: | cvs: phpdoc-de /reference/pspell/functions pspell-new-personal.xml | ||
| Groups: | php.doc.de | ||
| Request: | Send a blank email to doc-de+get-132@lists.php.net to get a copy of this message | ||
samesch Fri Aug 23 12:48:20 2002 EDT
Added files:
/phpdoc-de/reference/pspell/functions pspell-new-personal.xml
Log:
added; in sync with EN-Rev. 1.2
Index: phpdoc-de/reference/pspell/functions/pspell-new-personal.xml
+++ phpdoc-de/reference/pspell/functions/pspell-new-personal.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: samesch Status: ready -->
<!-- splitted from ./en/functions/pspell.xml, last change in rev 1.6 -->
<refentry id="function.pspell-new-personal">
<refnamediv>
<refname>pspell_new_personal</refname>
<refpurpose>
Lädt ein neues Wörterbuch mit persönlicher Wortliste
</refpurpose>
</refnamediv>
<refsect1>
<title>Beschreibung</title>
<methodsynopsis>
<type>int</type><methodname>pspell_new_personal</methodname>
<methodparam><type>string</type><parameter>persönliche_wortliste</parameter></methodparam>
<methodparam><type>string</type><parameter>Sprache</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>
Schreibweise
</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>
Jargon
</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>
Codierung
</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>
Modus
</parameter></methodparam>
</methodsynopsis>
<simpara>
<function>pspell_new_personal</function> öffnet ein neues
Wörterbuch mit einer persönlichen Wortliste und gibt die Kennung
des Wörterbuch-Links für die Verwendung in anderen
pspell-Funktionen zurück. Die Wortliste kann bei Bedarf mit
<function>pspell_save_wordlist</function> geändert und
gespeichert werden. Die Ersetzen-Paare werden jedoch nicht
gespeichert. Um diese zu speichern, müssen Sie mittels
<function>pspell_config_create</function> eine Konfiguration
erzeugen, die persönliche Wortliste mit
<function>pspell_config_personal</function> setzen, die Datei für
die Ersetzen-Paare mit <function>pspell_config_repl</function>
setzen und mit <function>pspell_new_config</function> ein neues
Wörterbuch öffnen.
</simpara>
<para>
<parameter>persönliche_wortliste</parameter> bestimmt die Datei,
in der Wörter, die zur persönlichen Wortliste hinzu gefügt
wurden, gespeichert werden. Dieser Parameter sollte als absoluter
Dateiname mit '/' beginnend angegeben werden, weil er andernfalls
relativ zu $HOME wäre, was auf den meisten Systemen '/root' ist
und es vermutlich nicht das ist, was sie wollen.
</para>
<para>
<parameter>Sprache</parameter> ist der Sprachencode, der aus dem
zweibuchstabigen ISO 639-Sprachencode und, nach einem Binde- oder
Unterstrich, einem optionalen zweibuchstabigen ISO
3166-Ländercode besteht.
</para>
<para>
<parameter>Schreibweise</parameter> ist die angeforderte
Schreibweise für Sprachen mit mehr als einer Schreibweise, wie
zum Beispiel Englisch. Bekannte Werte sind 'american', 'british'
und 'canadian'.
</para>
<para>
<parameter>Jargon</parameter> enthält zusätzliche Informationen,
um zwischen zwei Wortlisten mit der selben Sprache und den selben
Parametern für die Schreibweise zu unterscheiden.
</para>
<para>
<parameter>Codierung</parameter> ist die Codierung, in der die
Wörter voraussichtlich sind. Gültige Werte sind 'utf-8',
'iso8859-*', 'koi8-r', 'viscii', 'cp1252',
'machine unsigned 16'
und 'machine unsigned 32'. Dieser Parameter ist weit gehend
ungetestet, weshalb Sie bei dessen Verwendung vorsichtig sein
sollten.
</para>
<para>
<parameter>Modus</parameter> ist der Modus, in dem die
Rechtschreibprüfung arbeitet. Es stehen mehrere Modi zur
Verfügung:
<itemizedlist>
<listitem>
<simpara>
<constant>PSPELL_FAST</constant> - Schneller Modus (geringste
Anzahl Vorschläge)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PSPELL_NORMAL</constant> - Normaler Modus (mehr
Vorschläge)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PSPELL_BAD_SPELLERS</constant> - Langsamer Modus
(viele Vorschläge)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PSPELL_RUN_TOGETHER</constant> - Betrachtet
zusammengesetzte Wörter als erlaubte Verbindungen. Das heißt,
dieSpinne wäre dann eine erlaubte Verbindung, obwohl ein
Leerzeichen zwischen den beiden Wörtern sein müsste. Eine
Änderung dieser Einstellung wirkt sich nur auf das Ergebnis
aus, das von <function>pspell_check</function> zurückgegeben
wird; <function>pspell_suggest</function> liefert weiterhin
Änderungsvorschläge.
</simpara>
</listitem>
</itemizedlist>
<parameter>Modus</parameter> ist eine Bitmask, die sich aus
verschiedenden der oben aufgelisteten Konstanten zusammensetzt.
<constant>PSPELL_FAST</constant>,
<constant>PSPELL_NORMAL</constant> und
<constant>PSPELL_BAD_SPELLERS</constant> schließen sich
allerdings gegenseitig aus, weshalb Sie nur eine davon auswählen
sollten.
</para>
<para>
Schauen Sie sich für weitere Informationen und Beispiele das
pspell-Handbuch (auf englisch) auf der Website
<ulink url="&url.pspell;">&url.pspell;</ulink> an.
</para>
<para>
<example>
<title><function>pspell_new_personal</function></title>
<programlisting role="php">
<![CDATA[
$pspell_link = pspell_new_personal ("/var/dictionaries/custom.pws",
"de", "", "", "", PSPELL_FAST|PSPELL_RUN_TOGETHER));
]]>
</programlisting>
</example>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->