# Manual de KBiff

## Introducción.

### Características.

KBiff es una utilidad que avisa de que hay correo para el proyecto KDE. Tiene varias ventajas sobre muchos de sus competidores:

- Configuración GUI pura. No más parámetros en la línea de comandos que recordar (bien, una opción para hacer las cosas más sencillas para algunas personas) o extraños ficheros de configuración. Toda la configuración de KBiff se puede hacer desde cuadros de diálogos.

- Mantenimiento de la sesión. KBiff comienza con la misma configuración con la que lo dejaste.

- Se fija en el Panel. Puedes fijar KBiff en el panel de forma muy sencilla. Práctico cuando controlas varios buzones y no tienes sitio en ninguna otra parte.

- GIFs Animados. Puedes usar GIFs animados como tus iconos.

- Sonidos. KBiff tiene la opción de hacer sonar un fichero .wav cuando llega correo.

- POP3, IMAP4, Maildir, MBOX. KBiff soporta todos los formatos de buzón más importantes.

- Buzones Múltiples. KBiff puede monitorizar varios buzones de una sola vez.

- Otros. KBiff tiene un gran número de otras opciones.

Si tienes cualquier comentario o quieres pedir alguna otra característica, siéntete libre de enviarme un correo electrónico.

Kurt Granroth

<granroth@kde.org>

### Características planeadas.

Esas son algunas de las características que estoy planeando añadir o considerando si añadirlas. Sin ningún orden en particular:

- Ponerlo en algún "lazo" CORBA. Posiblemente implemente un modelo cliente/servidor también.

- ¿Monitorizar grupos de noticias NNTP? Estoy esperando hasta que alguien lo pida.

## Instalación.

### Cómo obtener KBiff.

La versión más reciente puede siempre encontrarse, tanto en formato binario como las fuentes en la página de KBiff. Está en http://www.granroth.org/kbiff KBiff es ahora parte del paquete de Redes de KDE. Como tal la última versión está siempre disponible en el CVS de KDE.

### Requisitos.

Para compilar KBiff de forma satisfactoria tú necesitas al menos la versión 1.0 de KDE. Todas las librerías requeridas pueden encontrarse en ftp://ftp.kde.org/pub/kde.

### Compilación e Instalación.

Compilar KBiff es muy sencillo. Se tiene que hacer lo siguiente:

    % ./configure
    % make
    % make install

¡Eso debería hacerlo! Si tienes algún problema, por favor coméntaselos al autor

## Usando KBiff

Casi todas las características de KBiff pueden configurarse desde el cuadro de configuración. El que existan algunos parámetros para la línea de comandos es más por conveniencia -- algunas opciones tienen más sentido en la línea de comandos.

### El "perfil".

KBiff gira en torno a algo llamado "perfil". Un "perfil" es simplemente un contenedor para uno o varios buzones de correo que KBiff monitorizará. Por ejemplo, siempre habrá un buzón por defecto llamado "Inbox" (o alguna otra cosa si lo renombras). Este perfil contendrá un buzón, a menudo como "/var/mail/nombredeusuario". Puede sin embargo, simplemente tener varios buzones. Cada caso de KBiff (que es, cada icono visible) corresponde a un perfil.

### Parámetros de la línea de comandos.

KBiff soporta tres parámetros en la línea de comandos. Son: profile, debug, y secure.

    -profile <nombre_del_perfil> Se salta el cuadro de configuración y
    			comienza KBiff directamente con el perfil dado.
    			Ej. 'kbiff -profile Inbox'
    -debug                  Pone el programa en modo de depurado. Sólo usar si
    			tienes problemas con KBiff
    -secure                 Deshabilita el cuadro de configuración. Útil cuando
    			quieras que se muestre KBiff pero no que otros lo modifiquen.

## El cuadro de configuración.

El cuadro de configuración maneja todos los puntos de configuración de KBiff. Como resultado no hay necesidad de usar parámetros en la línea de comandos en casi todos los casos.

### Nombre del perfil.

La parte de arriba del cuadro consiste en una lista desplegable y tres opciones. La lista desplegable consiste en los nombres de todos los "perfiles". Un perfil es un conjunto de configuraciones para un buzon bajo el mismo nombre. Los tres botones son Nuevo, Renombrar, y Borrar. Los botones funcionan sobre los perfiles, nada más. No tocan los ficheros del buzón. Cuando se arranca KBiff la primera vez, habrá un perfil creado de forma automática. Es el perfil Inbox que monitoriza el buzón del sistema.

### Etiquetas de preferencia.

Hay cuatro etiquetas de preferencia. Son opciones completas que se aplican al perfil actual. El perfil actual es el cual se está mostrando en ese momento en la lista desplegable. No hay configuraciones globales.

#### Preferencias Generales.

Las preferencias generales para cada perfil están contenidas en este apartado. Aquí hay cinco campos:

##### Revisar.

Esta opción controla cuanto tiempo tiene que esperar KBiff hasta que comprueba el buzón otra vez. El tiempo está en segundos. El valor por defecto es 60 segundos (un minuto).

Para elegir un tiempo distinto al valor por defecto, aquí, es una buena idea el analizar la frecuencia con que llega el correo. Por ejemplo, si tienes `fetchmail` corriendo cada cinco minutos, no tiene sentido fijar un tiempo menor que ese. Por otra parte si estas usando la opción POP3 y IMAP4 de KBiff, posiblemente debas usar un intervalo más grande. Fijar el valor por debajo de 60 dará resultados inesperados si tu conexión de red no es muy rápida.

##### Cliente de correo.

Este campo especifica el comando que deberá ejecutar KBiff cuando se pulse el botón izquierdo. Aunque típicamente es un cliente de correo, no tiene por qué. Puede se cualquier comando que pueda ser ejecutado en su propia ventana X. En otras palabras, poner `elm` en este campo no funcionará. Poner `konsole -e elm` sí lo hará. Por defecto pone `kmail -check`

##### Fijar en el panel.

Esto controla si KBiff comenzará fijo en el panel o no cuando el usuario salga del cuadro de configuración. Date cuenta de que aun es posible cambiar entre fijo y no fijo a parte de esta opción. Esto solo controla el estado inicial. Puede ser comprobado por defecto.

##### Habilitar mantenimiento de la sesión.

Esto controla el que el mantenimiento de sesión de KDE esté o no habilitado. Deberá deshabilitarse solo en raras ocasiones. El caso más común donde la sesión está deshabilitada es cuando el usuario ejecuta KDE desde la misma cuenta en máquinas diferentes al mismo tiempo. En este caso, posiblemente sea deseable el deshabilitar el mantenimiento de sesión y usar la opción de la línea de comandos `-profile` en su lugar.

En todos los otros casos, el mantenimiento de la sesión, probablemente se dejará habilitado.

##### Iconos.

KBiff usa tres iconos para representar los tres estados: No hay correo, Correo antiguo y Correo nuevo. Los iconos mistrados son iconos "grandes". Para selecionar iconos nuevos pulsar el los botones y aparecerá un cuadro de iconos. Date cuenta de que aunque KBiff soporta GIFs animados, no aparecerán animados aquí.

#### Preferencias en el correo nuevo.

Esta opción agrupa las opciones que controlan qué ocurre cuando llega correo nuevo.

##### Ejecutar comando.

Es una shell de comandos que será ejecutada cuando llegue correo nuevo. Un ejemplo típico de esto es hacer sonar newmail.au. Esto causará que suene el fichero newmail.au cada vez que llegue correo nuevo. Por defecto esto está deshabilitado.

##### Tocar sonido.

Especifica un sonido a tocar cuando llega nuevo correo. Esta versión solo tocará ficheros .wav. Simplemente especifica el trayecto hasta el fichero que quieres que suene. Por defecto, está deshabilitado.

##### Pitido del sistema.

Habilitando esto, se hará que KBiff pite cada vez que llegue correo nuevo. Esto es posiblemente el método menos intrusivo, aunque este activo, de avisar al usuario de que ha llegado nuevo correo. Por defecto está habilitado.

##### Avisar.

Habilitando esto se hará que KBiff abra una ventana cuando llegue nuevo correo. El mensaje de "aviso" mostrará ambas cosas el buzón y el número de mensajes nuevos. Esta opción no se recomienda en buzones que reciban mucho correo.

#### Preferencias del Buzón.

Esto agrupa las opciones que controlan el buzón físico.

Todas las opciones en este cuadro son POR buzón. Así que si tienes tres buzones en este perfil, cada buzón tendrá sus propias configuraciones en este cuadro. De todas formas todas las configuraciónes en los otros cuadros afectan a todos los perfiles. Esto significa que si tú tienes la opción de Avisar en el cuadro de Correo Nuevo, entonces KBiff avisará cuando haya llegado correo nuevo a todos los buzones de este perfil.

##### Lista de buzones.

La lista de la izquierda del cuadro contiene la lista de buzones de correo que el perfil actual monitorizará. En la mayoría d los casos solo habrá uno (el buzón "por defecto"). Así que puedes tener tantos buzones por perfil como quieras.

Hay dos botones debajo de la lista de buzones. El botón con el buzón creará un nuevo buzón. Si quieres renombrar el buzón, deberás borrar el viejo y crear uno nuevo con idénticas propiedades.

##### Protocolo.

Determina el protocolo del buzón seleccionado. Hay cuatro (y medio) protocolos - mbox (estilo Unix), maildir (Qmail), POP3, e IMAP4. El protocolo 'fichero' puede usarse para monitorizar cualquier fichero local porque utiliza solo la última leída - última modificación para determinar el estado.

##### Buzón.

Este campo no estará activo con el protocolo POP3. En todos los otros casos, pon el trayecto hasta el buzón aquí. En el caso de mbox, esto será un fichero, con maildir, será un directorio. Es una carpeta con IMAP4.

##### Servidor.

Solo está activo con los protocolos IMAP4 y POP3.

##### Usuario.

Solo está activo con los protocolos IMAP4 y POP3.

##### Contraseña.

Solo está activo con los protocolos IMAP4 y POP3.

##### Guardar contraseña.

Guardará la contraseña entre sesiones.

¡KBiff no encripta la contraseña cuando se guarda! La revolverá un poco, pero cualquiera con el código fuente (o un poco de paciencia) podria decodificarlo en un instante. Si estás en una red insegura, es del todo recomendable que la opción de guardar contraseña este deshabilitada.

##### Avanzado.

Esto abrirá un menú que contiene características avanzadas.

###### URL del Buzón

KBiff maneja los buzones internamente como una URL. Si sabes que estás haciendo puedes modificar directamente la URL aquí. Modificar esto se desaconseja a no ser que te sea familiar el código.

###### Puerto.

Configura esto al número del puerto donde tengas tu servidor. Por defecto, estará 110 para POP3 y 143 para IMAP4.

###### PREAUTENTIFICACIÓN.

Si no sabesq ue significa esto, posiblemente no lo necesites. Básicamente, comprobará el correo IMAP sin entrar.

###### Mantener vivo.

Cuando se habilita en POP3 o IMAP4, esto mantendrá "viva" la conexión. Esto es, KBiff entrará una vez y se mantendrá conectado. Esto no se recomienda si tu servidor POP3 o IMAP4 usa bloqueos. Si hay bloqueos (cerrojos) y KBiff no sale entonces tu cliente de correo no será capaz de acceder a tu cuenta.

#### Acerca de.

Esta etiqueta tiene información acerca de KBiff.

##### Acerca de KBiff.

Esto contiene información sobre qué versión de KBiff se está usando. También tiene información para contactar con el autor.

Date cuenta de que la dirección de correo es un hiperenlace. Pulsando sobre él se supone que se abrirá el cliente de correo para enviar un mensaje al autor. Desafortunadamente, no hay forma de hacer esto de forma automática si KBiff estña presente. Hay aquí algún código para ello. Para enviar un mensaje usando este hiperenlace, KBiff busca la variable de entorno `MAILER`. Si la encuentra, usará el contenido de la variable como el programa de correo a usar.

Por ejemplo, si `MAILER` está fijada como: `% setenv MAILER "konsole -e mutt"` Entonces KBiff usará `konsole -e mutt` como programa de correo por defecto.

## Menú desplegable.

El menu desplegable se activa cuando se pulsa el botón derecho del ratón sobre el area del icono del KBiff.

### (No)Fijar.

Esto fija y libera KBiff del panel. Esta opción solo funcionará en gestores de ventana compatibles con KDE como KWM. El valor por defecto se determina en el menu de configuración.

### Configuración.

Esto activará el menú de configuración. Mira la sección del Menú de configuración para más detalles.

### Ayuda.

Esto activa la ayuda en línea (esto).

### Comprobar si hay correo.

Esto fuerza a KBiff a comprobar si hay correo justo ahora, sin tener en cuenta el tiempo de espera. Esto comprobará todos los buzones de un perfil.

### Leer correo.

Esto forzará a KBiff a actuar como si todos los buzones del perfil actual fueran "viejos". Esto tiene más sentido cuando tienes correo nuevo en un servidor remoto (pop3 o imap4) y no te apetece bajarlos en ese momento.

### Parar/Empezar.

Esto hará parar o empezar KBiff.

## Preguntas, Respuestas, y Pistas.

### ¿Hay otras utilidades "biff" para KDE".

Si. Hay por lo menos dos que yo conozco. Cada "biff" tiene sus puntos fuertes. KOrn fue el original. Su mayor fortaleza es la habilidad de monitorizar múltiples buzones de una sola vez y mostrar de forma efectiva el nimero de mensajes de cada uno. Si tienes muchos buzones y no te importan los iconos, KOrn es posiblemente una mejor elección que KBiff. El otro "biff" KNewMail. KNewMail intenta emular la utilidad de Windows NewMail. Comprueba correo POP3 y muestra la línea del título de cada mensaje.

### ¿Qué diferencia hay entre "perfil" y "buzón" otra vez?

Un "perfil" es un conjunto de uno o más buzones que KBiff monitorizará de una sola vez. Y un ejemplo de perfil es "Inbox". Un "buzón" es una entidad física que puede ser monitorizada por KBiff. Un ejemplo de buzón es "/usr/var/nombre_de_usuario".

### ¿Cómo uso mis propios pixmaps?

Respuesta corta: seleccionalos usando el cuadro de configuración. Respuesta más larga: KBiff busca los iconos en el trayecto estandar de KDE para los iconos. Actualmente es

    kdedir()/share/apps/kbiff/toolbar
    kdedir()/share/toolbar
    kdedir()/share/icons
    kdedir()/share/apps/kbiff/pics
    $HOME/.kde/share/apps/kbiff/toolbar
    $HOME/.kde/share/toolbar
    $HOME/.kde/share/icons
    $HOME/.kde/share/apps/kbiff/pics

Donde "kdedir()" es a menudo "/opt/kde" y $HOME es tu directorio habitual. Si pones tus propios iconos en cualquiera de esos directorios (se recomienda el último de los listados), entonces KBiff no deberá tener problemas para encontrarlos y usarlos.

Si planeas fijar KBiff en el panel, deberás tener una versión de 22x22 (o menor) de tu icono. El nombre del icono pequeño deberá ser el mismo que el del más grande precedido de "mini-". Asi que si quieres usar el icono "oldmail.zpm" por defecto para el correo antiguo pero usar tu propio "mycoolpixmap.xpm" icono más pequeño para cuando esté fijo, debes renombrar tu icono a ""mini-oldmail.xpm". Si no haces esto, KBiff usará la versión grande incluso en el panel.

Date cuenta de que KBiff determina su tamaño por el icono antiguo. Asi que si tu antiguo icono es 100x100, pero todos los demás son 32x32... vamos, que KBiff parecerá muy raro cada vez que llegue correo nuevo.

### ¿Cómo uso elm (o mutt o PINE) con KBiff?

Has probado a poner "elm" en la opción de Cliente de correo ¿verdad? ¡Ups! 'elm', 'mutt' y 'PINE' todos necesitan un terminal para ejecutar y KBiff no proporciona uno. El autor usa lo siguiente como Cliente de correo: `konsole -vt_geometry 80x35 -caption Mail -no_scrollbar -e mutt &`

Si usas un cliente de correo gráfico como KMail o Netscape, entonces simplemente necesitas poner el nombre en la opción. No se necesita terminal.

### ¿Por qué KBiff no puede tocar mi fichero newmail.au?

KBiff usa la clase KAudio para tocar sonidos cuando llega correo nuevo. Actualmente esa clase solo soporta ficheros .wav. Si quieres tocar un fichero .au cuando llegue correo, prueba a obtener el paquete SOX y poner "'play newmail.au' (o solo cat newmail.au > /dev/audio') en la opción de comandos a ejecutar.

### ¿Por qué KBiff funciona sin mantenimiento de sesión?

Si. El mantenimiento de sesión está habilitado por defecto, pero se puede deshabilitar en el menú de configuración. Todavia puedes tener KBiff en el arranque de KDE poniendo KBiff en la carpeta de Inicio con la opción '-profile'.

### ¡Pulsando en tu dirección de correo en Sobre no pasa nada!

Sería bueno pasar la URL 'mailto:granroth@kde.org' a kfm para procesar esto... desafortunadamente, esto no está implementado aun. Codifiqué algo de soporte de todas formas. Simplemente fija como variable de entorno MAILER al mailer que uses y el enlace debe funcionar.

    e.g.
    % setenv MAILER konsole -e mutt

Date cuenta de que esto tiene el lado agradable de que 'mailto' enlaza en kfm y usará también tu cliente de correo.

### Cuando uso KBiff para monitorizar mi buzón, las otras utilidades 'biff' dejan de funcionar ¿qué pasa?

Esto es resultado del código para contar nuevos mensajes en KBiff. Para que KBiff sepa cuantos mensajes nuevos hay en un buzón mbox, debe de abrirlo para leerlo. Cuando eso ocurre, la mayoría de las otras utiliaddes 'biff' (incluyendo la que lleva la shell) asumirán que tú has leído el buzón y lo clasificarán como correo antiguo (o "leído")

Hay tres soluciones para esto:

1. No usar KBiff.

2. Usar el protocolo 'fichero' en vez del protocolo 'mbox' (date cuenta de que no sabrás cuantos mensajes nuevos te han llegado)

3. Convertir todos tus buzones 'mbox' a 'maildir'.

### ¿Cómo usar el correo de Netscape con KBiff?

Has probado 'netscape -mail' ¿verdad? Entonces has descubierto que eso hace que Netscape se queje debido al fichero cerradura si ya está corriendo ¿cierto? Bien, aquí hay mucho del usuario de KBiff Steven Boger (sboger@marcus-online.net) Crea un script como este: `#!/bin/sh`

    if [ -L "$HOME/.netscape/lock" ];
    then
    netscape -remote
     'xfeDoCommand(openInbox)'
    else
    netscape -mail &
    fi

## Licencia

### Sobre la traducción.

Esta traducción se distribuye bajo los términos de la Licencia Pública General - GPL - GNU.

Jaime Robles - `ea4abw@amsat.org`