manual/es/plugins.xml

   1 <?xml version="1.0" encoding="utf-8"?>
   2 <section id="ch_plugins">
   3 <title>Extendiendo &SC;</title>
   4
   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="http://www.claws-mail.org/plugins.php"
  30         >http://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="http://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="http://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         >http://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         >http://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>GData</term>
 167         <listitem>
 168           <para>
 169         Proporciona un interface para los servicios de Google usando la
 170         biblioteca gdata. La única funcionalidad implmementada actualmente
 171         es incluir los contactos de Google en la función de auto-completar
 172         direcciones con el tabulador.
 173           </para>
 174         </listitem>
 175       </varlistentry>
 176       <varlistentry>
 177         <term>Libravatar</term>
 178         <listitem>
 179           <para>
 180         Permite mostrar las imágenes de avatares asociadas a los perfiles de
 181         usuario de libravatar.org o los dominios de los usuarios que esten
 182         configurados para proporcionar avatares.
 183         Más información: <ulink
 184         url="http://www.claws-mail.org/plugin.php?plugin=libravatar"
 185         >www.claws-mail.org/plugin.php?plugin=libravatar</ulink>.
 186           </para>
 187         </listitem>
 188       </varlistentry>
 189       <varlistentry>
 190         <term>Archivador de correo</term>
 191         <listitem>
 192           <para>
 193         Permite archivar carpetas y subcarpetas en varios formatos diferentes.
 194           </para>
 195         </listitem>
 196       </varlistentry>
 197       <varlistentry>
 198         <term>mailMBOX</term>
 199         <listitem>
 200           <para>
 201         Gestiona buzones en formato Mbox.
 202           </para>
 203         </listitem>
 204       </varlistentry>
 205       <varlistentry>
 206         <term>NewMail</term>
 207         <listitem>
 208           <para>
 209         Escribe un resumen de las cabeceras de los mensajes en un fichero
 210         de traza (por defecto <filename>~/Mail/NewLog</filename>) cuando
 211         llega correo nuevo y <emphasis>después</emphasis> de ordenarlo.
 212           </para>
 213         </listitem>
 214       </varlistentry>
 215       <varlistentry>
 216         <term>Notificación</term>
 217         <listitem>
 218           <para>
 219         Proporciona varios métodos para notificar al usuario sobre el
 220         correo nuevo y no leído.
 221         Más información: <ulink
 222         url="http://www.claws-mail.org/plugin.php?plugin=notification"
 223         >www.claws-mail.org/plugin.php?plugin=notification</ulink>.
 224           </para>
 225         </listitem>
 226       </varlistentry>
 227       <varlistentry>
 228         <term>Visor PDF</term>
 229         <listitem>
 230           <para>
 231         Permite visualizar los adjuntos de tipo PDF y PostScript utilizando
 232         la biblioteca Poppler y el programa externo GhostScript.
 233         Más información: <ulink
 234         url="http://www.claws-mail.org/plugin.php?plugin=pdf_viewer"
 235         >www.claws-mail.org/plugin.php?plugin=pdf_viewer</ulink>.
 236           </para>
 237         </listitem>
 238       </varlistentry>
 239       <varlistentry>
 240         <term>Perl</term>
 241         <listitem>
 242           <para>
 243         Para ampliar las posibilidades de filtrado de &SC;. Proporciona un
 244         interfaz Perl al mecanismo de filtrado de &SC;, permitiendo el uso de
 245         toda la potencia de Perl en los filtros de correo.
 246           </para>
 247         </listitem>
 248       </varlistentry>
 249       <varlistentry>
 250         <term>PGP/Core, PGP/Inline y PGP/MIME</term>
 251         <listitem>
 252           <para>
 253         Gestiona mensajes firmados y/o cifrados con PGP. Se pueden descifrar
 254         correos y verificar firmas, así como firmar y cifrar sus propios
 255         correos. Utiliza GnuPG/GPGME, <ulink
 256         url="ftp://ftp.gnupg.org/gcrypt/gpgme/"
 257         >ftp://ftp.gnupg.org/gcrypt/gpgme/</ulink>.
 258         Más información: <ulink
 259         url="http://www.claws-mail.org/plugin.php?plugin=gpg"
 260         >www.claws-mail.org/plugin.php?plugin=gpg</ulink>.
 261           </para>
 262         </listitem>
 263       </varlistentry>
 264       <varlistentry>
 265         <term>Python</term>
 266         <listitem>
 267           <para>
 268         Este módulo permite integrarse con Python.
 269         Más información: <ulink
 270         url="http://www.claws-mail.org/plugin.php?plugin=python"
 271         >www.claws-mail.org/plugin.php?plugin=python</ulink>.
 272           </para>
 273         </listitem>
 274       </varlistentry>
 275       <varlistentry>
 276         <term>RSSyl</term>
 277         <listitem>
 278           <para>
 279         Le permite leer sus canales de noticias (<emphasis>feeds</emphasis>)
 280         en &SC;. Actualmente están soportados los canales RSS 1.0 y 2.0, así
 281         como los Atom.
 282         Más información: <ulink
 283         url="http://www.claws-mail.org/plugin.php?plugin=rssyl"
 284         >www.claws-mail.org/plugin.php?plugin=rssyl</ulink>.
 285           </para>
 286         </listitem>
 287       </varlistentry>
 288       <varlistentry>
 289         <term>S/MIME</term>
 290         <listitem>
 291           <para>
 292         Gestiona correos firmados y/o cifrados S/MIME. Se pueden descifrar
 293         correos y verificar firmas digitales, así como firmar y cifrar sus
 294         propios correos. Utiliza GnuPG/GPGME y GpgSM, disponibles en <ulink
 295         url="ftp://ftp.gnupg.org/gcrypt/gpgme/"
 296         >ftp://ftp.gnupg.org/gcrypt/gpgme/</ulink>.
 297           </para>
 298         </listitem>
 299       </varlistentry>
 300       <varlistentry>
 301         <term>SpamAssassin</term>
 302         <listitem>
 303           <para>
 304         El módulo SpamAssassin proporciona dos grandes funcionalidades:
 305           </para><para>
 306         La capacidad de escanear con SpamAssassin el correo entrante de
 307         cualquier cuenta POP, IMAP o local. Opcionalmente puede borrar los
 308         mensajes identificados como spam o guardarlos en una carpeta al efecto.
 309         El escaneo de correo se puede desactivar, lo cual es útil si el
 310         correo ya es escaneado en su servidor.
 311           </para><para>
 312         La posibilidad para que los usuarios enseñen a SpamAssassin a
 313         distinguir el spam de los correos deseados. Se puede entrenar a
 314         SpamAssassin marcando los mensajes como spam o no usando el menú
 315         contextual de la lista de mensajes, o usando un botón para ello en
 316         la barra de herramientas de la ventana principal o de mensaje (vea
 317         <quote>Configuración/Preferencias/Barras de herramientas</quote>.
 318         Los mensajes marcados como spam se pueden
 319         guardar opcionalmente en una carpeta destinada a ello.
 320           </para><para>
 321         Las preferencias del módulo se encuentran en
 322         <quote>Configuración/Preferencias/Módulos/SpamAssassin</quote>.
 323           </para><para>
 324         SpamAssassin está disponible en <ulink
 325         url="http://spamassassin.apache.org/"
 326         >http://spamassassin.apache.org/</ulink>. Es necesaria la versión
 327         3.1.x o superior para utilizar la funcionalidad de aprendizaje en
 328         modo TCP.
 329           </para>
 330         </listitem>
 331       </varlistentry>
 332       <varlistentry>
 333         <term>SpamReport</term>
 334         <listitem>
 335           <para>
 336         Este módulo permite informar sobre correo basura en varios sitios.
 337         Actualmente están soportados los sitios <ulink
 338         url="http://spam-signal.fr">spam-signal.fr</ulink> y <ulink
 339         url="http://spamcop.net">spamcop.net</ulink>, y el sistema de
 340         nominación de correo basura de las <ulink url="http://lists.debian.org"
 341         >listas de Debian (lists.debian.org)</ulink>.
 342           </para>
 343         </listitem>
 344       </varlistentry>
 345       <varlistentry>
 346         <term>Intérprete TNEF</term>
 347         <listitem>
 348           <para>
 349         Este módulo permite leer los adjuntos de tipo <literal
 350         >application/ms-tnef</literal>.
 351         Más información: <ulink
 352         url="http://www.claws-mail.org/plugin.php?plugin=tnef_parser"
 353         >www.claws-mail.org/plugin.php?plugin=tnef_parser</ulink>.
 354           </para>
 355         </listitem>
 356       </varlistentry>
 357       <varlistentry>
 358         <term>vCalendar</term>
 359         <listitem>
 360           <para>
 361         Permite la gestión de mensajes vCalendar al estilo de Evolution u
 362         Outlook, y también suscripciones Webcal.
 363         Más información: <ulink
 364         url="http://www.claws-mail.org/plugin.php?plugin=vcalendar"
 365         >www.claws-mail.org/plugin.php?plugin=vcalendar</ulink>.
 366           </para>
 367         </listitem>
 368       </varlistentry>
 369     </variablelist>
 370     <para>
 371         Si usted es un desarrollador, escribir un módulo para extender las
 372         capacidades de &SC; será probablemente la mejor solución y la más
 373         fácil. Nosotros proporcionaremos hospedaje para su código y
 374         estaremos encantados de responder a sus preguntas en la lista de
 375         correo o en el canal de IRC, <literal>#claws</literal> en
 376         Freenode.
 377     </para>
 378   </section>
 379
 380   <section id="plugins_network">
 381     <title>Acceso a la red desde los módulos</title>
 382     <para>
 383         Algunos de los módulos externos, por ejemplo RSSyl, vCalendar, Fancy
 384         o Libravatar, necesitan acceso a Internet para llevar a cabo sus
 385         funciones (recuperar canales en el caso de RSSyl o vCalendar, y
 386         obtener imágenes en el caso de Fancy o Libravatar). Estos módulos usan
 387         para ello la librería Curl. Por tanto, si su acceso a Internet está
 388         restringido por un proxy necesitará decirle a libCurl que lo use.
 389         Esto se consigue estableciendo la variable de entorno
 390         <literal>http_proxy</literal>. Por ejemplo, <literal
 391         >http_proxy=http://usuario:contra@miproxy.ejemplo.com:8080</literal>
 392         le dirá a libCurl que conecte al puerto 8080 de la máquina
 393         miproxy.ejemplo.com con el  usuario <quote>usuario</quote> y
 394         contraseña <quote>contra</quote> para conectarse a Internet.
 395     </para><para>
 396         Puede establecer esta variable antes de iniciar &SC;, usando por
 397         por ejemplo la orden
 398         <command>http_proxy=http://usuario:contra@miproxy.ejemplo.com:8080
 399         claws-mail</command>, o establecerla en su fichero
 400         <filename>~/.bashrc</filename> (o el equivalente de su shell) añadiendo
 401         la línea<footnote><para>Otros shells pueden tener diferentes sintaxis,
 402         compruebe la página del manual de su shell.</para></footnote>:
 403         <command>export
 404         http_proxy=http://usuario:contra@miproxy.ejemplo.com:8080</command>
 405         (tendrá que reconectar para que se tenga en cuenta).
 406     </para>
 407   </section>
 408
 409   <section id="plugin_path_config">
 410     <title>Configuración de la ruta de los módulos</title>
 411     <para>
 412     Cuando se carga un módulo se guarda la ruta completa al mismo en el
 413     fichero de configuración <filename>~/.claws-mail/clawsrc</filename>.
 414     </para><para>
 415     Puesto que la mayoría de usuarios sólo utilizan una copia de &SC; y
 416     siempre usan el mismo método de instalación, esto no es un problema.
 417     </para><para>
 418     Por el contrario, si se tienen múltiples copias de &SC; instaladas y
 419     desea compartir la misma configuración entre ellas esto puede no
 420     funcionar, especialmente si se utilizan diferentes versiones de &SC;.
 421     </para><para>
 422     La copia instalada en segundo lugar intentará cargar los módulos
 423     instalados por la primera y, si las versiones difieren, los módulos
 424     serán rechazados.
 425     </para><para>
 426     Para evitar este problema se puede editar manualmente la sección de
 427     los módulos en el fichero <filename>clawsrc</filename>, sustituyendo
 428     la ruta completa por el nombre del fichero únicamente en aquellos que
 429     desee cargar de manera relativa a la copia de &SC; en ejecución.
 430     </para><para>
 431     De esta manera cada copia de &SC; intentará cargar esos módulos de su
 432     propio directorio de módulos en lugar de una ubicación concreta.
 433     </para>
 434   </section>
 435
 436 </section>
 437