Remove inclusion of sys/socket.h from nntp-thread.c
[claws.git] / manual / es / plugins.xml
blob9a7cb2d13d28405d1769c5956a91336fc2100143
1 <?xml version="1.0" encoding="utf-8"?>
2 <section id="ch_plugins">
3 <title>Extendiendo &SC;</title>
5   <section id="plugins_default">
6     <title>Módulos</title>
7     <para>
8         Las capacidades de &SC; se amplian usando módulos, cuya lista
9         aparece debajo.
10     </para><para>
11         Los módulos se instalan en <filename class="directory"
12         >$PREFIX/lib/claws-mail/plugins/</filename> y 
13         tienen el sufijo <quote>.so</quote>. Para cargar un módulo vaya
14         al menú <quote>Configuración/Módulos</quote> y pulse el botón
15         <quote>Cargar módulo</quote>. Seleccione el módulo que desee cargar y
16         pulse el botón <quote>Aceptar</quote>.
17     </para><para>
18         Si no encuentra el módulo que busca es posible que la distribución de
19         su sistema operativo lo proporcione en algún paquete distinto. En ese 
20         caso busque el módulo con su gestor de paquetes.
21     </para><para>
22         Algunos módulos proporcionan la misma funcionalidad que otros (por
23         ejemplo, los tres módulos anti-correo basura). En tal caso tendrá que
24         elejir cual de ellos cargar, ya que &SC; no cargará más de uno del
25         mismo tipo a la vez.
26     </para>
27     <para>
28         Existe una lista de todos los módulos disponibles en <ulink
29         url="https://www.claws-mail.org/plugins.php"
30         >www.claws-mail.org/plugins.php</ulink>.
31     </para>
32     <variablelist>
33       <varlistentry>
34         <term>Nofificador ACPI</term>
35         <listitem>
36           <para>
37         Permite la notificación del correo nuevo a través de los LEDs que se
38         encuentran en ciertos modelos de portátil de marcas como Acer, Asus,
39         Fujitsu o IBM.
40         Más información: <ulink
41         url="https://www.claws-mail.org/plugin.php?plugin=acpinotifier"
42         >www.claws-mail.org/plugin.php?plugin=acpinotifier</ulink>.
43           </para>
44         </listitem>
45       </varlistentry>
46       <varlistentry>
47         <term>Guardián de direcciones</term>
48         <listitem>
49           <para>
50         Guarda todas las direcciones de destinatarios desconocidos (
51         <quote>Para</quote>, <quote>Cc</quote> y/o <quote>Bcc</quote>)
52         en una carpeta de la agenda de direcciones designada al efecto.
53           </para>
54         </listitem>
55       </varlistentry>
56       <varlistentry>
57         <term>Aviso de adjuntos</term>
58         <listitem>
59           <para>
60         Le recuerda la posibilidad de que se haya olvidado adjuntos.
61         Comprueba expresiones comunes que se usan cuando se adjuntan
62         ficheros y le avisa si no se añadió ningún adjunto al correo
63         que se está enviando.
64         Más información: <ulink
65         url="https://www.claws-mail.org/plugin.php?plugin=attachwarner"
66         >www.claws-mail.org/plugin.php?plugin=attachwarner</ulink>.
67           </para>
68         </listitem>
69       </varlistentry>
70       <varlistentry>
71         <term>Eliminador de adjuntos</term>
72         <listitem>
73           <para>
74         Permite eliminar los ficheros adjuntos de los mensajes.
75           </para>
76         </listitem>
77       </varlistentry>
78       <varlistentry>
79         <term>Bogofilter</term>
80         <listitem>
81           <para>
82         El módulo Bogofilter viene con dos características principales:
83           </para><para>
84         La habilidad para escanear el correo entrante recibido de cuentas
85         IMAP, POP3 o locales usando Bogofilter. Puede, opcionalmente, borrar
86         el correo identificado como basura o guardarlo en una carpeta 
87         designada al efecto. El escaneado se puede desactivar.
88           </para><para>
89         La posibilidad de que el usuario enseñe a Bogofilter a distinguir entre
90         el correo basura o el aceptable. Puede entrenar a Bogofilter marcando 
91         los mensajes como correo basura o como buenos en el menú contextual de
92         la lista de mensajes, o a través del botón correspondiente en la 
93         venana principal o de mensaje (vea
94         <quote>Configuración/Preferencias/Barras de herramientas</quote>. 
95         Los mensajes marcados como basura se pueden
96         guardar en una carpeta designada al efecto también de manera opcional.
97           </para><para>
98         Las preferencias del módulo se pueden encontrar en
99         <quote>Configuración/Preferencias/Módulos/Bogofilter</quote>.
100           </para><para>
101         La ventaja de Bogofilter sobre SpamAssassin es su velocidad.
102           </para><para>
103         Bogofilter necesita entrenamiento antes de poder filtrar mensajes.
104         Para entrenarlo es necesario marcar algún correo basura como tal y
105         algún correo legítimo como bueno.
106           </para><para>
107         Bogofilter está disponible en <ulink 
108         url="http://bogofilter.sourceforge.net/"
109         >bogofilter.sourceforge.net/</ulink>.
110           </para>
111         </listitem>
112       </varlistentry>
113       <varlistentry>
114         <term>BSFilter</term>
115         <listitem>
116           <para>
117         BSFilter es un módulo muy similar al Bogofilter pero utiliza
118         para realizar su tarea el filtro bayesiano de correo basura
119         bsfilter (<ulink url="http://bsfilter.org/index-e.html"
120         >bsfilter.org/index-e.html</ulink>).
121           </para><para>
122         Al igual que con Bogofilter, hay que entrenarlo con mensajes
123         basura y mensajes legítimos para que pueda comenzar a reconocer
124         el correo basura.
125           </para><para>
126         Las preferencias se encuentran en
127         <quote>Configuración/Preferencias/Módulos/BSFilter</quote>.
128           </para>
129         </listitem>
130       </varlistentry>
131       <varlistentry>
132         <term>Clamd</term>
133         <listitem>
134           <para>
135         Permite escanear todos los mensajes recibidos de cuentas locales,
136         POP o IMAP usando el demonio clam, parte del software antivirus
137         Clam AV (<ulink url="http://www.clamav.net/"
138         >www.clamav.net/</ulink>).
139           </para>
140         </listitem>
141       </varlistentry>
142       <varlistentry>
143         <term>Visor HTML Fancy</term>
144         <listitem>
145           <para>
146         Permite mostrar mensajes HTML usando la versión basada en GTK
147         de la librería WebKit. Por omisión no se carga ningún contenido
148         remoto.
149           </para><para>
150         Las preferencias se encuentran en
151         <quote>Configuración/Preferencias/Módulos/Visor HTML Fancy</quote>.
152           </para>
153         </listitem>
154       </varlistentry>
155       <varlistentry>
156         <term>Fetchinfo</term>
157         <listitem>
158           <para>
159         Inserta cabeceras que contienen cierta información sobre la descarga,
160         como el UIDL, el nombre de la cuenta de &SC;, el servidor POP, el
161         identificador de usuario y la hora de descarga.
162           </para>
163         </listitem>
164       </varlistentry>
165       <varlistentry>
166         <term>Aviso de palabras clave</term>
167         <listitem>
168           <para>
169         Muestra un aviso al enviar o poner en la cola un mensaje y el texto
170         del mismo contiene alguna referencia a una o más palabras clave.
171           </para>
172         </listitem>
173       </varlistentry>
174       <varlistentry>
175         <term>Libravatar</term>
176         <listitem>
177           <para>
178         Permite mostrar las imágenes de avatares asociadas a los perfiles de
179         usuario de libravatar.org o los dominios de los usuarios que esten
180         configurados para proporcionar avatares.
181         Más información: <ulink
182         url="https://www.claws-mail.org/plugin.php?plugin=libravatar"
183         >www.claws-mail.org/plugin.php?plugin=libravatar</ulink>.
184           </para>
185         </listitem>
186       </varlistentry>
187       <varlistentry>
188         <term>Archivador de correo</term>
189         <listitem>
190           <para>
191         Permite archivar carpetas y subcarpetas en varios formatos diferentes.
192           </para>
193         </listitem>
194       </varlistentry>
195       <varlistentry>
196         <term>mailMBOX</term>
197         <listitem>
198           <para>
199         Gestiona buzones en formato Mbox.
200           </para>
201         </listitem>
202       </varlistentry>
203       <varlistentry>
204         <term>NewMail</term>
205         <listitem>
206           <para>
207         Escribe un resumen de las cabeceras de los mensajes en un fichero
208         de traza (por defecto <filename>~/Mail/NewLog</filename>) cuando
209         llega correo nuevo y <emphasis>después</emphasis> de ordenarlo.
210           </para>
211         </listitem>
212       </varlistentry>
213       <varlistentry>
214         <term>Notificación</term>
215         <listitem>
216           <para>
217         Proporciona varios métodos para notificar al usuario sobre el
218         correo nuevo y no leído.
219         Más información: <ulink
220         url="https://www.claws-mail.org/plugin.php?plugin=notification"
221         >www.claws-mail.org/plugin.php?plugin=notification</ulink>.
222           </para>
223         </listitem>
224       </varlistentry>
225       <varlistentry>
226         <term>Visor PDF</term>
227         <listitem>
228           <para>
229         Permite visualizar los adjuntos de tipo PDF y PostScript utilizando
230         la biblioteca Poppler y el programa externo GhostScript.
231         Más información: <ulink
232         url="https://www.claws-mail.org/plugin.php?plugin=pdf_viewer"
233         >www.claws-mail.org/plugin.php?plugin=pdf_viewer</ulink>.
234           </para>
235         </listitem>
236       </varlistentry>
237       <varlistentry>
238         <term>Perl</term>
239         <listitem>
240           <para>
241         Para ampliar las posibilidades de filtrado de &SC;. Proporciona un
242         interfaz Perl al mecanismo de filtrado de &SC;, permitiendo el uso de
243         toda la potencia de Perl en los filtros de correo.
244           </para>
245         </listitem>
246       </varlistentry>
247       <varlistentry>
248         <term>PGP/Core, PGP/Inline y PGP/MIME</term>
249         <listitem>
250           <para>
251         Gestiona mensajes firmados y/o cifrados con PGP. Se pueden descifrar
252         correos y verificar firmas, así como firmar y cifrar sus propios
253         correos. Utiliza GnuPG/GPGME, <ulink
254         url="https://www.gnupg.org/software/gpgme/"
255         >www.gnupg.org/software/gpgme/</ulink>.
256         Más información: <ulink
257         url="https://www.claws-mail.org/plugin.php?plugin=gpg"
258         >www.claws-mail.org/plugin.php?plugin=gpg</ulink>.
259           </para>
260         </listitem>
261       </varlistentry>
262       <varlistentry>
263         <term>Python</term>
264         <listitem>
265           <para>
266         Este módulo permite integrarse con Python.
267         Más información: <ulink 
268         url="https://www.claws-mail.org/plugin.php?plugin=python"
269         >www.claws-mail.org/plugin.php?plugin=python</ulink>.
270           </para>
271         </listitem>
272       </varlistentry>
273       <varlistentry>
274         <term>RSSyl</term>
275         <listitem>
276           <para>
277         Le permite leer sus canales de noticias (<emphasis>feeds</emphasis>)
278         en &SC;. Actualmente están soportados los canales RSS 1.0 y 2.0, así
279         como los Atom.
280         Más información: <ulink 
281         url="https://www.claws-mail.org/plugin.php?plugin=rssyl"
282         >www.claws-mail.org/plugin.php?plugin=rssyl</ulink>.
283           </para>
284         </listitem>
285       </varlistentry>
286       <varlistentry>
287         <term>S/MIME</term>
288         <listitem>
289           <para>
290         Gestiona correos firmados y/o cifrados S/MIME. Se pueden descifrar
291         correos y verificar firmas digitales, así como firmar y cifrar sus
292         propios correos. Utiliza GnuPG/GPGME y GpgSM, disponibles en <ulink
293         url="https://www.gnupg.org/software/gpgme/"
294         >www.gnupg.org/software/gpgme/</ulink>.
295           </para>
296         </listitem>
297       </varlistentry>
298       <varlistentry>
299         <term>SpamAssassin</term>
300         <listitem>
301           <para>
302         El módulo SpamAssassin proporciona dos grandes funcionalidades:
303           </para><para>
304         La capacidad de escanear con SpamAssassin el correo entrante de
305         cualquier cuenta POP, IMAP o local. Opcionalmente puede borrar los
306         mensajes identificados como spam o guardarlos en una carpeta al efecto.
307         El escaneo de correo se puede desactivar, lo cual es útil si el
308         correo ya es escaneado en su servidor.
309           </para><para>
310         La posibilidad para que los usuarios enseñen a SpamAssassin a
311         distinguir el spam de los correos deseados. Se puede entrenar a
312         SpamAssassin marcando los mensajes como spam o no usando el menú
313         contextual de la lista de mensajes, o usando un botón para ello en
314         la barra de herramientas de la ventana principal o de mensaje (vea
315         <quote>Configuración/Preferencias/Barras de herramientas</quote>.
316         Los mensajes marcados como spam se pueden
317         guardar opcionalmente en una carpeta destinada a ello.
318           </para><para>
319         Las preferencias del módulo se encuentran en
320         <quote>Configuración/Preferencias/Módulos/SpamAssassin</quote>.
321           </para><para>
322         SpamAssassin está disponible en <ulink
323         url="http://spamassassin.apache.org/"
324         >spamassassin.apache.org/</ulink>. Es necesaria la versión
325         3.1.x o superior para utilizar la funcionalidad de aprendizaje en
326         modo TCP.
327           </para>
328         </listitem>
329       </varlistentry>
330       <varlistentry>
331         <term>SpamReport</term>
332         <listitem>
333           <para>
334         Este módulo permite informar sobre correo basura en varios sitios.
335         Actualmente están soportados los sitios <ulink 
336         url="http://spam-signal.fr">spam-signal.fr</ulink> y <ulink 
337         url="http://spamcop.net">spamcop.net</ulink>, y el sistema de
338         nominación de correo basura de las <ulink url="http://lists.debian.org"
339         >listas de Debian (lists.debian.org)</ulink>.
340           </para>
341         </listitem>
342       </varlistentry>
343       <varlistentry>
344         <term>Intérprete TNEF</term>
345         <listitem>
346           <para>
347         Este módulo permite leer los adjuntos de tipo <literal
348         >application/ms-tnef</literal>.
349         Más información: <ulink 
350         url="https://www.claws-mail.org/plugin.php?plugin=tnef_parser"
351         >www.claws-mail.org/plugin.php?plugin=tnef_parser</ulink>.
352           </para>
353         </listitem>
354       </varlistentry>
355       <varlistentry>
356         <term>vCalendar</term>
357         <listitem>
358           <para>
359         Permite la gestión de mensajes vCalendar al estilo de Evolution u
360         Outlook, y también suscripciones Webcal.
361         Más información: <ulink 
362         url="https://www.claws-mail.org/plugin.php?plugin=vcalendar"
363         >www.claws-mail.org/plugin.php?plugin=vcalendar</ulink>.
364           </para>
365         </listitem>
366       </varlistentry>
367     </variablelist>
368     <para>
369         Si usted es un desarrollador, escribir un módulo para extender las
370         capacidades de &SC; será probablemente la mejor solución y la más 
371         fácil. Nosotros proporcionaremos hospedaje para su código y
372         estaremos encantados de responder a sus preguntas en la lista de
373         correo o en el canal de IRC, <literal>#claws</literal> en
374         <ulink url="https://libera.chat">Libera.chat</ulink>.
375     </para>
376   </section>
378   <section id="plugins_network">
379     <title>Acceso a la red desde los módulos</title>
380     <para>
381         Algunos de los módulos externos, por ejemplo RSSyl, vCalendar, Fancy
382         o Libravatar, necesitan acceso a Internet para llevar a cabo sus
383         funciones (recuperar canales en el caso de RSSyl o vCalendar, y
384         obtener imágenes en el caso de Fancy o Libravatar). Estos módulos usan
385         para ello la librería Curl. Por tanto, si su acceso a Internet está
386         restringido por un proxy necesitará decirle a libCurl que lo use.
387         Esto se consigue estableciendo la variable de entorno
388         <literal>http_proxy</literal>. Por ejemplo, <literal
389         >http_proxy=http://usuario:contra@miproxy.ejemplo.com:8080</literal>
390         le dirá a libCurl que conecte al puerto 8080 de la máquina
391         miproxy.ejemplo.com con el  usuario <quote>usuario</quote> y
392         contraseña <quote>contra</quote> para conectarse a Internet.
393     </para><para>
394         Puede establecer esta variable antes de iniciar &SC;, usando por
395         por ejemplo la orden
396         <command>http_proxy=http://usuario:contra@miproxy.ejemplo.com:8080 
397         claws-mail</command>, o establecerla en su fichero 
398         <filename>~/.bashrc</filename> (o el equivalente de su shell) añadiendo
399         la línea<footnote><para>Otros shells pueden tener diferentes sintaxis,
400         compruebe la página del manual de su shell.</para></footnote>:
401         <command>export
402         http_proxy=http://usuario:contra@miproxy.ejemplo.com:8080</command>
403         (tendrá que reconectar para que se tenga en cuenta).
404     </para>
405   </section>
407   <section id="plugin_path_config">
408     <title>Configuración de la ruta de los módulos</title>
409     <para>
410     Cuando se carga un módulo se guarda la ruta completa al mismo en el
411     fichero de configuración <filename>~/.claws-mail/clawsrc</filename>.
412     </para><para>
413     Puesto que la mayoría de usuarios sólo utilizan una copia de &SC; y
414     siempre usan el mismo método de instalación, esto no es un problema.
415     </para><para>
416     Por el contrario, si se tienen múltiples copias de &SC; instaladas y
417     desea compartir la misma configuración entre ellas esto puede no
418     funcionar, especialmente si se utilizan diferentes versiones de &SC;.
419     </para><para>
420     La copia instalada en segundo lugar intentará cargar los módulos
421     instalados por la primera y, si las versiones difieren, los módulos
422     serán rechazados.
423     </para><para>
424     Para evitar este problema se puede editar manualmente la sección de
425     los módulos en el fichero <filename>clawsrc</filename>, sustituyendo
426     la ruta completa por el nombre del fichero únicamente en aquellos que
427     desee cargar de manera relativa a la copia de &SC; en ejecución.
428     </para><para>
429     De esta manera cada copia de &SC; intentará cargar esos módulos de su
430     propio directorio de módulos en lugar de una ubicación concreta.
431     </para>
432   </section>
434 </section>