-
Notifications
You must be signed in to change notification settings - Fork 54
/
pspell-new-personal.xml
184 lines (179 loc) · 6.57 KB
/
pspell-new-personal.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: seros Status: ready -->
<refentry xml:id="function.pspell-new-personal" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>pspell_new_personal</refname>
<refpurpose>Cargar un nuevo diccionario con una lista personal de palabras</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>int</type><methodname>pspell_new_personal</methodname>
<methodparam><type>string</type><parameter>personal</parameter></methodparam>
<methodparam><type>string</type><parameter>language</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>spelling</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>jargon</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>encoding</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>mode</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<simpara>
<function>pspell_new_personal</function> abre un nuevo diccionario con
una lista personal de palabras. Ésta puede ser modificada y guardada con
<function>pspell_save_wordlist</function>, si se desea. Sin embargo, los
pares de sustitución no se guardan. Para guardarlos se debería
crear una configuración usando <function>pspell_config_create</function>,
establecer el fichero de la lista personal de palabras con
<function>pspell_config_personal</function>,
establecer el fichero de pares de sustitución con
<function>pspell_config_repl</function>, y abrir un nuevo diccionario con
<function>pspell_new_config</function>.
</simpara>
<para>
Para más información y ejemplos, verifique el sitio web de pspell del manual
en línea:<link xlink:href="&url.pspell;">&url.pspell;</link>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<para>
<variablelist>
<varlistentry>
<term><parameter>personal</parameter></term>
<listitem>
<para>
El fichero donde se almacenarán las palabras añadidas a la lista personal.
Debería ser un nombre de fichero absoluto comenzado con '/', ya que de otro modo
será relativo a $HOME, el cual es "/root" para la mayoría de sistemas, y
probablemente no es lo que quiere.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>language</parameter></term>
<listitem>
<para>
El parámetro language es el código de lenguaje que consiste en el
código de lenguaje ISO 639 de dos letras y un código de país ISO
3166 de dos letras opcional después de un guión o guión de subrayado.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>spelling</parameter></term>
<listitem>
<para>
La ortografía solicitada para lenguajes con más de una ortografía, como el inglés.
Valores conocidos son 'american', 'british', y 'canadian'.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>jargon</parameter></term>
<listitem>
<para>
Información extra para distinguir dos listas de palabras diferentes que tienen
el mismo lenguaje y parámetros de ortografía.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>encoding</parameter></term>
<listitem>
<para>
La codificación que se espera que tengan esas palabras. Los valores válidos son
<literal>utf-8</literal>, <literal>iso8859-*</literal>,
<literal>koi8-r</literal>, <literal>viscii</literal>,
<literal>cp1252</literal>, <literal>machine unsigned 16</literal>,
<literal>machine unsigned 32</literal>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>mode</parameter></term>
<listitem>
<para>
El modo en el que trabajará el corrector ortográfico. Hay varios modos disponibles:
<itemizedlist>
<listitem>
<simpara>
<constant>PSPELL_FAST</constant> - Modo rápido (menor númeo de
sugerencias)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PSPELL_NORMAL</constant> - Modo normal (más sugerencias)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PSPELL_BAD_SPELLERS</constant> - Modo lento (un montón de
sugerencias)
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PSPELL_RUN_TOGETHER</constant> - Considerar palabras unidas
como compuestos legales. Es decir, "elgao" será un compuesto legal,
aunque debería haber un espacio entre las dos palabras. Cambiar esta
configuración solo afecta a los resultados devueltos por
<function>pspell_check</function>; <function>pspell_suggest</function>
seguirá devolviendo sugerencias.
</simpara>
</listitem>
</itemizedlist>
El modo es una máscara de bits construida a partir de diferentes constantes listadas después.
Sin embargo, <constant>PSPELL_FAST</constant>,
<constant>PSPELL_NORMAL</constant> y
<constant>PSPELL_BAD_SPELLERS</constant> son mutuamente exclusivas, por lo que
debería seleccionar únicamente una de ellas.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve el identificador de vínculo de diccionario para usarlo en otras funciones pspell.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title><function>pspell_new_personal</function></title>
<programlisting role="php">
<![CDATA[
<?php
$pspell_link = pspell_new_personal ("/var/dictionaries/custom.pws",
"en", "", "", "", 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:"~/.phpdoc/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
-->