# El manual de &kalarm;

David
Jarvie

    &David.Jarvie.mail;

David
Jarvie

    &David.Jarvie.mail;

Desarrollador
Juan Manuel
García Molina

    juanma@superiodico.net

Traductor
Javier
Viñal Gutiérrez

    fjvinal@gmail.com

Traductor
2001
2002
2003
2004
2005
2006
2007
2008
2009
&David.Jarvie;
&FDLNotice;
2009-11-28
2.04.00

&kalarm; es un gestor de mensajes de alarma, ordenes y planificador de correo para &kde;.

KDE
kdepim
kalarm
alarma
recordatorio
planificador

## Introducción

&kalarm; le permite planificar la visualización de mensajes personales de alarma, la reproducción de archivos de sonido, la ejecución de órdenes y el envío de correos electrónicos.

En su modo gráfico predeterminado, &kalarm; muestra la lista de alarmas pendientes, mostrando sus horas y detalles. Puede crear alarmas nuevas o puede seleccionar las alarmas existentes para modificarlas o borrarlas. Opcionalmente, también puede ver las alarmas cumplidas.

Al configurar una alarma, puede elegir si debe repetirse, y si la alarma debería cancelarse si no puede dispararse en el momento planificado. Para alarmas de visualización, puede teclear en un mensaje de texto, indicar un archivo de texto o de imagen para mostrar, o indicar una orden cuya salida se visualizará. También puede seleccionar el color del mensaje de alarma, si se debe reproducir un sonido o leer el mensaje.

Las alarmas también se pueden planificar desde la línea de órdenes o vía llamadas D-bus desde programas.

Cuando un mensaje de alarma vence, se muestra en cada escritorio de &kde; para asegurarse de que no se le pasa. La ventana del mensaje muestra la hora a la que se ha planificado la alarma. Normalmente tiene una opción para pedir que la alarma se repita más tarde. Un ejemplo de un mensaje de alarma:

Captura de pantalla de la ventana del mensaje de &kalarm;
Mensaje de alarma

Cuando la alarma especifica la ejecución de una orden o un correo para enviar, &kalarm; no visualiza nada.

&kalarm; generalmente muestra un icono en la bandeja del sistema, aunque puede ocultarse si se desea.

## Usando &kalarm;

Cuando se ejecuta sin parámetros en la línea de órdenes, &kalarm; comienza en modo gráfico y muestra la lista actual de alarmas pendientes.

Todos los cuadros de valores de &kalarm; tienen la posibilidad de una aceleración. Para hacer que el valor se incremente en pasos más grandes, mantenga pulsada la tecla &Shift; mientras pulsa sobre los botones de la flecha.

### Tipos de alarma

Las funciones básicas disponibles desde los diferentes tipos de alarma que proporciona KAlarm son:

- Mostrar las alarmas como un mensaje de texto que usted teclea, o el contenido de un archivo de texto o imagen, o la salida textual de una orden que se ejecuta cuando la alarma se dispara. Además de mostrar cualquiera de estos elementos, puede reproducir archivos de audio, que su texto sea leído, o emitir un simple pitido. También se pueden especificar ordenes para que sean ejecutadas antes y después de que se muestre el mensaje de alarma.

- Las alarmas de órdenes ejecutan bien una orden o un guión de shell que usted puede teclear. Nada se visualiza salvo que ocurra un error.

- Las alarmas de correo envían un correo. Nada se muestra salvo que ocurra un error.

- Las alarmas de audio reproducen un archivo de audio. No se muestra nada salvo que ocurra un error.

#### Manejo de errores

Si ocurre un error cuando una alarma se dispara, se mostrará un mensaje de error (salvo que haya especificado previamente no mostrar mensajes de error para ese tipo de mensaje de nuevo).

Si ocurrió un error de ejecución la última vez que se disparó una alarma de orden, se muestra una exclamación blanca sobre rojo en la columna de mensajes. Los detalles del error se visualizan en una ayuda si sitúa el cursor sobre esa línea en la lista de alarmas. Se muestran las mismas indicaciones de error para las alarmas de visualización si sucede un error de ejecución en una orden de pre- o post-alarma especificada en el diálogo de acciones especiales, excepto que el color del fondo de la columna no se cambia a rojo.

### Lista de alarmas

La ventana principal de &kalarm; muestra la lista actual de alarmas pendientes, mostrando sus horas, intervalos de repetición, colores y textos de mensaje, nombres de archivos para mostrar o reproducir, órdenes para ejecutar o asuntos de correos. (Para una alarma que se repite la hora que se muestra es la del próximo disparo. Para una alarma con un recordatorio, la hora que se muestra es la de la propia alarma, no la del recordatorio). Un icono a la izquierda de cada texto de alarma/archivo/orden/asunto de correo indica el tipo de alarma.

Capturas de pantalla de la ventana principal de &kalarm;
Ventana principal

Para una alarma que se repite, la lista muestra su próxima hora de ocurrencia y su intervalo básico de repetición (&eg; 1 día para una repetición diaria, 3 semanas para una repetición que sucede los lunes y los miércoles cada tres semanas, Inicio de sesión para una alarma que se repite en cada ingreso al sistema).

Si ocurre un error de ejecución la última vez que una alarma de orden se dispara, o la última vez que una orden de pre- o post-alarma de una alarma de visualización se ejecuta, se muestra una indicación de error en el color de la columna, como se describe mas arriba en Manejo de errores.

#### Cambiando la apariencia de la lista de alarmas

Las alarmas se pueden ordenar por fecha/hora, intervalo de repetición, color, tipo o texto pulsando sobre la barra de título de la columna adecuada. Para invertir el orden, vuelva a pulsar sobre la barra de título.

De forma opcional, puede mostrar el tiempo que falta para que cumpla cada alarma, junto con, o en lugar de, la hora planificada de la alarma. Para mostrar u ocultar la columna de hora de la alarma, seleccione Ver Mostrar horas de alarmas. Para mostrar u ocultar la columna de hora de la alarma, seleccione Ver Mostrar hora para las alarmas. Siempre se muestra al menos una columna.

Si usted utiliza varios calendarios de alarma, puede colorear los códigos de alarma de acuerdo al calendario al que pertenecen, seleccionando un color de fondo distinto para cada calendario.

#### Alarmas archivadas

De forma predefinida, &kalarm; archiva las alarmas durante un periodo de tiempo una vez que se han cumplido o se han eliminado (pero tenga en cuenta que las alarmas que elimina se archivan únicamente si se han producido al menos una vez). Puede controlar si &kalarm; debe almacenar o no las alarmas cumplidas, y durante cuánto tiempo, en el Diálogo de configuración.

Las alarmas archivadas se pueden mostrar en la lista de alarmas seleccionando Ver Mostrar alarmas archivadas. Para volver a ocultarlas, seleccione Ver Ocultar alarmas archivadas.

#### Buscando en la lista de alarmas

Puede buscar a través de la lista de alarmas para encontrar las que contengan un texto en concreto. Para ello, seleccione Editar Buscar. En el diálogo de búsqueda, seleccione los tipos de alarma en los que quiera buscar. Para seguir buscando más alarmas que cumplan los criterios, use Editar Buscar siguiente o Editar Buscar anterior .

La búsquedas se realizan como sigue:

- Alarmas de mensajes de texto: se busca el mensaje de texto.

- Alarmas de visualización: se busca el &URL; o ruta del archivo.

- Alarmas de orden: se busca en la línea de órdenes o de guiones de órdenes.

- Alarmas de correo: además del asunto y del cuerpo del correo, se busca en los destinatarios y en los URL de los adjuntos.

- Alarmas de audio: se busca la &URL; o ruta del archivo.

Sólo se pueden seleccionar para la búsqueda las alarmas de la lista. Por tanto, si quiere buscar en las alarmas archivadas, primero debe mostrarlas como está descrito en la sección anterior.

### Crear y manipular alarmas

#### Crear una alarma nueva

Para crear una alarma nueva, haga una de las siguientes acciones, y después seleccione el tipo de alarma de la lista que aparece. Con ellas se muestra el Diálogo de edición de alarma con el que puede configurar la alarma.

- Seleccione Archivo Nuevo.

- Pulse Derecho sobre el icono de la bandeja del sistema y elija Nueva alarma en el menú de contexto.

- Pulse con el botón derecho sobre la lista de alarmas y elija Nuevo en el menú de contexto.

También puede crear alarmas nuevas preconfiguradas desde varios sitios:

- Para basar su alarma nueva en una plantilla de alarma, siga las instrucciones de la sección Plantillas de alarma.

- Para basar su alarma nueva en una existente, resalte la alarma existente en la lista y seleccione Archivo Copiar. Esto abre el diálogo de edición de alarmas ya relleno con una copia de todos los detalles de la alarma seleccionada.

- Para crear una alarma nueva que muestre un mensaje de correo existente, arrastre el correo desde &kmail; a la ventana principal de &kalarm; o al icono de la bandeja del sistema. Se abre el Diálogo de edición de alarmas con el texto completo del correo electrónico (incluyendo remitente, destinatario, &etc;) como texto de la alarma.

- Para crear una alarma de correo nueva para enviar una copia de un mensaje de correo existente, arrastre el correo desde &kmail; a la ventana principal de &kalarm; o al icono de la bandeja del sistema. Luego, seleccione la opción Correo electrónico. El Diálogo de edición de alarma está inicializado con el mensaje de correo completo, salvo el destinatario.

- Para crear una alarma nueva que muestre un resumen o una tarea pendiente existente, arrastre la tarea pendiente desde &korganizer; u otra aplicación a la ventana principal de &kalarm; o al icono de la bandeja del sistema. Se abre el Diálogo de edición de alarmas con el contenido de la tarea pendiente y el texto de la alarma.

- Al arrastrar cualquier trozo de texto sobre la ventana principal de &kalarm; o sobre el icono de la bandeja del sistema, se abre el Diálogo de edición de alarmas y se define el texto de la alarma.

- Para crear una alarma que muestre archivos, arrastre una &URL; de archivo de texto o imagen a la ventana principal de &kalarm; o al icono de la bandeja del sistema. Esto abre el diálogo de edición de alarmas y pone allí el nombre del archivo.

- Para crear una alarma de audio, arrastre una &URL; de archivo de audio a la ventana principal de &kalarm; o al icono de la bandeja del sistema. Esto abre el diálogo de edición de alarmas y pone allí el nombre del archivo.

- Puede crear automáticamente alarmas para gente que esté en &kaddressbook; tal y como se describe en Importar cumpleaños desde &kaddressbook;.

#### Modificando una alarma existente

Para modificar una alarma pendiente que exista (las alarmas que hayan expirado no se pueden recuperar), haga una de las siguientes cosas:

- Doble clic sobre su entrada en la lista de alarmas.

- Selecciónelo pulsando sobre su entrada en la lista de alarmas. Luego elija Editar Editar.

- Pulse con el botón derecho sobre su entrada en la lista de alarmas y elija Editar desde el menú contextual.

Esto muestra el Diálogo de edición de alarmas.

#### Eliminando/reactivando una alarma

Para borrar alarmas existentes, seleccione una o mas pulsando sobre sus entradas en la lista de alarmas. Después haga algo de lo siguiente:

- Elija Editar Borrar.

- Pulse con el botón Derecho sobre las entradas seleccionadas y elija Eliminar en el menú de contexto.

- Para borrarlas sin petición de confirmación, teclee &Shift;-Borrar.

Cuando usted elimina una alarma activa, se archiva, supuesto que se haya disparado al menos una vez antes de ser eliminada y supuesto que se archivan todas las alarmas cumplidas (use el Diálogo configuración para controlar si se deben archivar las alarmas y durante cuánto tiempo se almacenan). Cuando elimine una alarma archivada o una alarma activa que no se haya disparado aún, se elimina permanentemente.

Puede reactivar una alarma eliminada en la lista de alarmas archivadas, suponiendo que aún no haya expirado. Para ello, primero tiene que mostrar las alarmas archivadas, tal y como se describe en Alarmas archivadas. Luego:

- Seleccione una o más de las alarmas archivadas pulsando en sus entradas de la lista de alarmas. Luego elija Acciones Reactivar .

- Pulse con el botón derecho sobre las entradas archivadas que desee en la lista de alarmas archivadas y elija Reactivar en el menú de contexto.

#### Activando/desactivando una alarma

Vea Activando y desactivando las alarmas para saber cómo activar y desactivar alarmas, bien individualmente o en conjunto.

#### Confirmar una alarma

Vea Ventana de mensaje de alarma para saber cómo aceptar alarmas.

#### Plantillas de alarma

Si quiere configurar con frecuencia alarmas similares, puede crear una plantilla de alarma para evitar tener que introducir cada vez todos los detalles desde cero. Una plantilla puede tener todos los detalles que puede tener una alarma, aparte de la fecha de comienzo.

Como ejemplo, puede querer configurar una alarma regularmente para que le recuerde un programa de televisión cuya emisión varía de semana en semana. La plantilla debería tener todos los detalles de la alarma (mensaje de texto, si reproducir un sonido, &etc;) salvo la hora y la fecha. Ahora, para crear la alarma, todo lo que tiene que hacer es abrir Diálogo de edición de alarmas con esa plantilla en el y luego indicar la hora y la fecha.

Para crear una alarma basada en una plantilla, abra el Diálogo de edición de alarma, con las opciones predefinidas de los detalles de la plantilla:

- Seleccione el elemento Archivo Nuevo desde plantilla del menú y luego elija la plantilla que desee.

- Pulse con el botón derecho sobre el icono de la bandeja del sistema y elija Nueva alarma desde plantilla en el menú contextual. Luego seleccione la plantilla que desee.

- Abra el Diálogo de edición de alarma de la forma habitual y pulse en el botón Cargar plantilla... para seleccionar una plantilla con algunas opciones predefinidas para el diálogo.

##### Configurando plantillas

Puede crear, modificar o eliminar plantillas usando el diálogo de plantillas de alarma, o puede crear una plantilla de alarma nueva basada en una alarma existente.

Para crear un plantilla de alarma nueva, haga una de las siguientes acciones:

- Muestra el diálogo de las plantillas de alarma seleccionando el elemento Archivo Plantillas... del menú, y pulse sobre Nuevo y elija el tipo de alarma de la lista que aparece. Esto muestra un diálogo de edición con una plantilla vacía.

- Muestre el diálogo de plantillas de alarma seleccionando el elemento Archivo Plantillas... del menú, seleccione una plantilla de la lista y pulse sobre Copiar. Esto abre el diálogo de edición ya relleno con una copia de los detalles de la plantilla existente.

- Resalte una alarma de la lista y seleccione Archivo Crear plantilla... . Se abrirá el cuadro de diálogo de edición de plantillas ya relleno con una copia de los detalles de la alarma seleccionada.

Para modificar una plantilla existente, muestre el diálogo de plantillas de alarma seleccionando el elemento Archivo Plantillas... del menú y pulse sobre Editar. Se mostrará el diálogo de edición de plantillas que se describe más abajo.

Para eliminar las plantillas existentes, muestre el diálogo de plantillas de alarma seleccionando el elemento Archivo Plantillas... del menú, seleccione una o más plantillas y pulse sobre Eliminar. Se solicitará confirmación para evitar los borrados accidentales.

##### Diálogo de edición de plantillas

El diálogo de edición de plantillas es similar al diálogo de edición de alarmas descrito en elDiálogo de edición de alarmas. Son diferentes los siguientes controles:

- Indique el nombre de la plantilla en Nombre de la plantilla. Es el nombre de la plantilla que se muestra en las listas de selección de plantillas, así que es mejor elegir un nombre que le recuerde su función. El nombre de la plantilla debe ser único.

- En el grupo de opciones Hora, seleccione una de:

  - Hora predefinida si no quiere indicar ninguna hora de activación. Las alarmas que se basan en esta plantilla usarán inicialmente la hora de activación normal predefinida para las alarmas nuevas.

  - Marque Hora para indicar una hora a la que la alarma se deba producir.

  - Marque Sólo fecha para indicar que la alarma sólo debe tener fecha, no hora.

  - Marque Tiempo desde ahora para introducir cuánto tiempo (en horas y minutos) después de crear la alarma se debe producir.

- En el grupo de opciones Reglas de repetición, en la pestaña Repetición, no necesita seleccionar ni día ni mes para la repetición semanal ni anual, respectivamente.

#### Alarmas de calendario

Si sólo utiliza un equipo y trabaja de forma independiente, no importa el lugar en el que &kalarm; almacena sus alarmas. Pero si necesita acceder a las alarmas en más de un equipo, o en más de una ubicación de su equipo local, puede definir alarmas de calendario para decirle a &kalarm; que utilice otros calendarios de alarmas adicionales para, o en lugar de, las predefinidas.

Puede ver y manipular calendarios mediante la lista de calendarios, que se puede mostrar junto con la lista de alarmas de la ventana principal de &kalarm;. Se muestran combinadas las alarmas de todos los calendarios en la lista de alarmas. Cuando guarde una alarma nueva, puede definir una opción de configuración para determinar si se debe guardar automáticamente en el calendario predefinido o si se le debe pedir que elija un calendario. Cuando edite una alarma existente, se guarda automáticamente en el recurso original de la alarma.

Captura de pantalla de la ventana principal de &kalarm; mostrando la lista de calendario
Ventana principal mostrando la lista de calendario

##### Tipos de calendario y opciones

Los calendarios de alarmas están categorizados por tipo de alarma y por tipo de almacenamiento. Se pueden desactivar, definir como de sólo lectura o convertir en el calendario predefinido para su tipo de alarma.

Tipo de alarma

  Los tres tipos de entidades de alarma – alarmas activas, alarmas archivadas y plantillas de alarmas – se almacenan en calendarios de alarmas aparte. &kalarm; tiene tres tipos de calendario predefinidos estándar, uno para cada tipo (para más detalles, puede dirigirse a Preguntas y respuestas), que puede cambiar a su gusto.

Tipo de almacenamiento

  &kalarm; gestiona tres tipos de almacenamiento de calendarios de alarmas:

  - Archivo local: Las alarmas se almacenan en un archivo local en formato iCalendar. &kalarm; utiliza calendarios de archivos locales de forma predefinida (tiene más detalles en Preguntas y respuestas). Archivos locales, además de los archivos en el equipo local, pueden incluir calendarios de alarmas en la red local, así como sus ubicaciones se pueden representar por una ruta que comience con `/`.

  - Directorio local: Las alarmas se almacenan en una carpeta local, cada alarma se almacena en un archivo iCalendar distinto de la carpeta. El método de almacenamiento tiene la ventaja de que en caso de corrupción de un archivo, sólo pierde una alarma, no el calendario completo.

  - Archivo remoto: Las alarmas se almacenan en un solo archivo remoto, en formato iCalendar. Este método de almacenamiento le permite acceder remotamente a los datos de la alarma, sin importar dónde está, o permitiendo que otras personas puedan ver los calendarios de las alarmas. Cuando se usan archivos remotos, &kalarm; funciona con una caché local de los datos.

    Si un calendario remoto de alarmas lo comparten varios usuarios, los cambios que realiza una persona pueden no estar disponible automáticamente para otros usuarios, o puede haber un retardo antes de que el otro usuario pueda verlo. Por eso, si alguien hace un cambio que luego sobreescribe otro usuario sin que esa persona sepa lo que está pasando. La razón técnica de esto es que un cambio que haga una persona A sólo está disponible para la persona B después de que la persona A haya guardado primero una copia en la caché del archivo remoto, y la copia de la caché de la persona B la haya recargado. Cuando y si el calendario se guarda y se recarga depende de los parámetros de configuración del calendario que cada usuario haya definido para ese calendario de alarmas.

    Entre las formas de evitar este problema están el ajuste de los parámetros de guardar y recargar de configuración del calendario o la adopción de una política para que los usuarios que no sean los propietarios del calendario sólo lo puedan abrir en modo de sólo lectura.

Estado activado/desactivado

  Desactivar un calendario tiene el mismo efecto que eliminarlo, salvo que aparece en la lista de calendarios para reactivarlo de forma sencilla. Cuando se desactiva, se ignoran sus alarmas y no aparecen en la lista de alarmas ni en la lista de plantillas. Cuando se reactivan, las alarmas se vuelven a mostrar una vez más, y si es un recurso activo de alarmas, se activa.

Estado de sólo lectura

  Los calendarios de alarmas de sólo lectura no se pueden modificar ni añadir. No puede editar sus alarmas ni guardar alarmas nuevas. Tampoco puede retrasar las alarmas, porque se necesitaría actualizar la alarma con el tiempo nuevo. Cuando se produce la alarma, no se elimina del recurso y se archiva hasta que usted o algún otro usuario acceda al recurso en modo de lectura-escritura.

  Puede definir el estado de sólo lectura de un calendario en el diálogo de configuración del calendario. Sin embargo, algunos calendarios no se pueden escribir, por varios motivos:

  - Si un calendario se ha creado con otra aplicación, no sería seguro permitir que &kalarm; lo actualizase, porque alguna diferencia en el formato de datos podría convertirlo en inutilizable para la aplicación original.

  - Si el calendario lo creó con una versión posterior de &kalarm;, se pueden perder datos actualizándolo desde una versión antigua de &kalarm;.

  - Si el calendario lo creó con una versión anterior de &kalarm;, se pueden perder datos o pueden ser inutilizables para las versiones anteriores de &kalarm; si su versión de &kalarm; los utiliza. Se le debe pedir que convierta el formato para que se pueda escribir en el archivo, admitiendo los potenciales problemas de compatibilidad si tiene que acceder desde una versión anterior de &kalarm;.

  - Si no tiene permiso para escribir el archivo o la carpeta de calendarios.

  Si necesita permiso de escritura para los datos de la alarma en un calendario que no puede escribir, puede copiar sus alarmas importándolas en un calendario en el que tenga permiso de escritura, usando la opción Importar... del menú contextual del calendarios (más información en Importar alarmas de calendarios externos).

Estado del calendario predefinido

  Opcionalmente, se puede definir el calendario predefinido para cada tipo de alarma. Las alarmas nuevas se guardan automáticamente en el calendario predefinido para el tipo de alarma predefinido, a no ser que haya seleccionado la opción de preguntar por cada alarma y por cada plantilla nueva en el diálogo Preferencias.

##### Usando calendarios

Puede ver y manipular los recursos mediante la lista de calendarios, que se pueden mostrar u ocultar mediante Ver Mostrar calendarios . Al usar la lista de calendarios, seleccione primero la lista de los tipos de alarmas usando la lista desplegable que hay encima de la lista. Luego, pulse sobre uno de los botones que hay bajo la lista o pulse con el botón Derecho sobre el calendario apropiado de la lista y elija un elemento del menú contextual. Las acciones disponibles son:

Añadir...

  Añade a la lista un calendario del tipo seleccionado. Se le pide que elija un tipo de almacenamiento, luego se muestra el diálogo de configuración del calendario y sus características. Si no hay ningún recurso de alarma en la ubicación especificada, se crea uno nuevo.

Eliminar

  Elimina de la lista el calendario seleccionado. El propio calendario permanece intacto. Simplemente se elimina de la lista, y se puede volver a disponer en la lista si se desea.

Editar...

  Edita el calendario seleccionado. Muestra el diálogo de configuración para el calendario seleccionado.

Recargar

  Vuelve a cargar el calendario seleccionado. El calendario se vuelve a leer de la ubicación en la que está almacenado, asegurándose de que no hay discrepancia entre las alarmas que muestra &kalarm; y el estado actual del calendario. Si el calendario se comparte con otros usuarios, los últimos cambios que se hayan realizado pueden no estar a la vista en &kalarm;.

  Si vuelve a cargar un calendario remoto, se pierden los cambios que haya hecho a las alarmas desde la última vez que guardó el calendario. Se vuelven a producir las alarmas que hayan caducado desde la última vez que se guardaron.

Guardar

  Guarda los cambios que se han realizado al calendario seleccionado. El calendario se actualiza con los cambios de la alarma que hayan ocurrido desde la última vez que se guardó o se volvió a cargar. Sólo es útil para los calendarios remotos, porque los calendarios locales se guardan automáticamente cada vez que se hace algún cambio. Puede configurar cuándo y con qué frecuencia se debe guardar automáticamente, usando el diálogo de configuración (mediante la opción Editar... del menú contextual).

  Si guarda un calendario remoto que comparte con otros usuarios, se perderán los cambios que se hayan hecho desde la última vez que recargó el calendario (de forma automática o manual).

Importar...

  Importa las alarmas de un archivo de calendario externo en el calendario seleccionado. Se describe en Importar alarmas de calendarios externos. Esta opción no está disponible para los recursos de sólo lectura.

Exportar...

  Exporta las alarmas del calendario seleccionado en un archivo de calendario externo. Se describe en Exportar alarmas a calendarios externos. Esta opción no está disponible para los calendarios desactivados.

Mostrar detalles

  Muestra los detalles del calendario seleccionado. Muestra la ubicación del calendario, el tipo de almacenamiento y la información del estado.

Usar como predefinido

  Hace que el calendario seleccionado sea el calendario predefinido para el tipo de calendario seleccionado. Esta opción no está disponible ni en los calendarios desactivados o los de sólo lectura.

Establecer el color...

  Selecciona un color de fondo para destacar estas alarmas de calendario en la lista de alarmas. Esto le permite ver de un vistazo las alarmas que pertenecen a un calendario en concreto.

Limpiar el color

  Limpiar el color destacado para este calendario en la lista de alarmas.

#### Importar alarmas de calendarios externos

Puede importar alarmas de otros archivos de calendario en &kalarm;. La función de importación busca en el archivo de calendario seleccionado eventos que contengan alarmas, y copiarlos (con los id. únicos nuevos) en el calendario de &kalarm;. Los eventos sin alarmas y otros tipos de entradas de calendario se ignoran. Hay dos modos de importar alarmas:

- Use Archivo Importar alarmas... para importar las alarmas de todos los tipos (alarmas activas, alarmas activadas y plantillas de alarmas) en el calendario.

  Si ha configurado alarmas de calendario, las alarmas de cada tipo se añadirán al calendario predefinido adecuado, o si ha elegido la opción para que se le pida esta información para las alarmas y para las plantillas nuevas en el Diálogo configuración se le preguntará que calendario usar.

- Pulse con el botón Derecho sobre un calendario en la lista de calendarios, y elija Importar... desde el menú de contexto. Esto importa alarmas del tipo seleccionado actualmente en ese calendario. Por ejemplo, si el tipo de calendario seleccionado es de plantillas de alarmas, se importarán plantillas de alarmas (y no alarmas activas o archivadas).

Si importa alarmas de archivos de calendario creados con una aplicación distinta de &kalarm;, las alarmas las cambia el proceso de importación, incluso las horas de los eventos pueden cambiar. Depende de las convenciones de almacenamiento de datos que utilicen las otras aplicaciones, y no se pueden evitar si estas convenciones son diferentes a las que espera &kalarm;. Compruebe siempre si hay cambios no esperados en las alarmas importadas, y ajústelas si fuese necesario.

#### Exportar alarmas a calendarios externos

Usted puede exportar alarmas de &kalarm; a otros archivos de calendarios, bien las alarmas seleccionadas actualmente en la lista de alarmas, o todas las alarmas de un calendario de alarmas. Los métodos para hacerlo se muestran mas abajo. Cualquiera que sea el método que se utilice, usted puede bien crear un nuevo archivo de calendario o añadir las alarmas exportadas a uno existente. para añadir las alarmas, marque Añadir a archivo existente en el diálogo de selección de archivos: de otro modo, se sobreescribe cualquier archivo que ya exista.

- Para exportar las alarmas seleccionadas actualmente en la lista de alarmas, pulse el botón Derecho sobre la selección y elija Exportar... del menú de contexto, o utilice Archivo Exportar las alarmas seleccionadas... en el menú principal.

- Para exportar las alarmas desde un calendario pulse con el botón, Derecho sobre un calendario en la lista de calendarios, y elija Exportar... del menú de contexto.

#### Importar cumpleaños desde &kaddressbook;

Puede configurar alarmas para cumpleaños guardados en &kaddressbook;, usando Archivo Importar cumpleaños.... Esto muestra un diálogo que le permita seleccionar para qué cumpleaños crear alarmas.

- En el grupo de opciones Texto de alarma, puede configurar el texto para mostrar en los mensajes de alarma de los cumpleaños. El texto del mensaje se crea combinando el texto de Prefijo seguido del nombre de la persona y del texto de Sufijo. No se añaden espacios, por tanto recuerde incluir los espacios necesarios en Prefijo y Sufijo.

  Si cambia el texto de la alarma, la lista de selección del cumpleaños se volverá a evaluar.

- En la lista Seleccionar cumpleaños, seleccione los cumpleaños para el que quiera crear las alarmas. Tenga en cuenta que las listas muestran sólo aquellas variables de &kaddressbook; que contengan un cumpleaños y que no contengan ya una alarma de cumpleaños en el formato definido actualmente en el grupo de opciones Texto de alarma.

- Los restantes controles son los mismos para las alarmas de Texto del Diálogo de edición de alarmas.

Si ha configurado calendarios de alarma, las alarmas de cada tipo se añadirán al calendario predefinido adecuado, o se le pedirá el recurso específico si ha elegido la opción para que se le pida esta información para las alarmas y para las plantillas nuevas en el Diálogo configuración.

#### Deshacer / rehacer

Puede deshacer y rehacer los cambios más recientes que haya hecho durante la sesión actual de &kalarm;. La mayor parte de las acciones se pueden deshacer, incluyendo la creación, edición y borrado de alarmas y de plantillas de alarmas, y la reactivación de alarmas. Para evitar que se usen demasiados recursos en el histórico de deshacer, el número de cambios que se almacenan está limitado a los últimos 12.

Para deshacer el último cambio, seleccione Editar Deshacer. Para rehacer el último cambio que se ha deshecho, seleccione Editar Rehacer .

Para deshacer un cambio que no sea el último, pulse en el botón Deshacer de la barra de herramientas y mantenga pulsado el botón del ratón. Se muestra una lista de acciones en la que puede elegir el que quiera deshacer. Si no ve la acción que está buscando, recuerde que puede tener que deshacer antes cambios más recientes, de los que depende el cambio deseado. Por ejemplo, si edita una alarma y la elimina, no puede deshacer la edición hasta que no deshaga el borrado.

Puede rehacer un cambio distinto del último de modo similar, usando el botón Rehacer de la barra de herramientas.

### El diálogo de edición de alarma

El diálogo de edición de alarmas le permite ver y editar una alarma, Cuando utilice &kalarm; por primera vez, se muestra una forma simplificada del diálogo, con sólo un pequeño número de opciones visible. Par ver todas las opciones, pulse el botón Mas opciones, para revertir al diálogo simplificado pulse el botón Menos opciones. &kalarm; siempre recuerda su última elección cada vez que se vuelve a mostrar el diálogo de edición de alarmas.

Captura de pantalla del diálogo simplificado de edición de alarmas
Diálogo de edición simplificado para alarmas de visualización

Diálogo de edición simplificado para alarmas de visualización

Captura de pantalla del diálogo de edición de alarmas mostrando todas las opciones
Diálogo para una alarma de visualización mostrando todas las opciones

Diálogo de edición de alarmas para una alarma de visualización mostrando todas las opciones

#### Acción de la alarma

Los controles en el cuadro Acción,varían en función del tipo de alarma que se esté editando.

##### Mostrar alarmas

Mostrar alarmas muestra una ventana cuando la alarma se dispara. Seleccione el método utilizado para generar el contenido de la ventana de alarma, usando el cuadro combinado de la parte de arriba:

- Mensaje de texto para introducir el texto del mensaje de alarma (que puede incluir saltos de línea) en el cuadro de edición de texto.

- Contenido del archivo para introducir la ruta o &URL; de un archivo de texto cuyos contenidos se vayan a mostrar en el mensaje de alarma. Use el botón que está junto al cuadro de texto para mostrar un diálogo de selección de archivo. La opción Hablar no está disponible par este tipo de alarma.

- Salida de la orden para especificar que el mensaje de texto de la alarma se generará por una orden que se ejecuta al dispararse la alarma. Vea Alarmas de órdenes mas bajo para los detalles sobre como introducir la orden o guión de órdenes a ejecutar.

Los controles disponibles para mostrar alarmas son:

- La opción Sonido le permite seleccionar si debe sonar una alarma audible cuando se muestra el mensaje de la alarma. Elija:

  - Ninguno para mostrar la alarma de forma silenciosa.

  - Bip para que suene un «bip».

  - Hablar para que se pronuncie el mensaje de la alarma a medida que se muestre. Esta opción sólo está disponible si tiene instalado y configurado KTTSD (del paquete kdeaccessibility), así como un sintetizador de voz compatible, &eg; Festival.

  - Archivo de sonido para reproducir un archivo de audio. Use el botón de la derecha para mostrar el diálogo de archivo de sonido, que le permite seleccionar un archivo para que se reproduzca y definir el volumen y las opciones de repetición. Si pasa el ratón por encima del botón, un consejo mostrará el archivo de audio que está seleccionado en ese momento.

    En el diálogo de archivo de sonido:

    - Indique la ruta o el &URL; del archivo de sonido, o use el botón que hay junto a la casilla de edición para ver un diálogo de selección de archivo. Usted puede escuchar el archivo seleccionado pulsando el botón reproducir a la izquierda del campo de edición. Ese botón entonces cambia su función para permitirle parar la reproducción cuando haya oído bastante.

    - Marque Repetir para repetir continuamente el archivo de audio mientras se esté mostrando la alarma. (La ventana del mensaje de alarma tiene un botón para detener la reproducción del sonido por si necesitara el silencio pero quisiera mostrar la alarma).

    - Marque Volumen y ajuste el desplazador si quiere ajustar el volumen al que se reproduce el archivo de audio.

    - Si lo desea, puede graduar el volumen. Atenuación significa que se comience a reproducir el archivo de audio con un volumen y que se vaya cambiando gradualmente hasta el volumen final, a lo largo de un intervalo de tiempo especificado. El volumen final es el que se introdujo en Volumen arriba. Para activar la atenuación, marque Atenuar y luego introduzca el período en segundos en el campo Tiempo de atenuación, y ajuste con el deslizador el Volumen inicial.

    Puede usar el botón Probar para comprobar los niveles del sonido seleccionado.

- Use el botón Tipo de letra y color... para seleccionar un tipo de letra y colores de primer plano y fondo para el mensaje de alarma. En el diálogo Seleccionar tipo de letra y color, marque Usar tipo de letra predeterminado para mostrar el mensaje con el tipo de letra configurado a la hora en la que se muestra el mensaje. Para elegir un tipo de letra específico para el mensajes desmarque Usar tipo de letra predeterminado(El tipo de letra predeterminado y los colores se pueden configurar en el Diálogo preferencias).

  Los colores seleccionados se muestran en el campo de entrada de texto del mensaje de alarma.

- Use el botón Acciones especiales... para indicar qué órdenes de la shell se deben ejecutar antes o después de mostrar la alarma. En el diálogo Acciones especiales de alarma:

  - En el campo Acción previa a la alarma, introduzca una orden de la shell para que se ejecute antes de que se muestre la alarma. Tenga en cuenta que &kalarm; esperará hasta que se complete la orden antes de mostrar la alarma.

    Una acción de pre-alarma sólo se ejecuta una vez cuando se muestra inicialmente el mensaje de alarma, incluyendo cuando un mensaje de recordatorio es reemplazado por el mensaje de alarma actual. No se ejecuta en cualquiera de las siguientes circunstancias:

    - Cuando se muestra un mensaje de recordatorio.

    - Cuando el mensaje es vuelto a mostrar tras retrasar la alarma.

    - Cuando el mensaje se mostró cuando usted cerró la sesión y se restaura cuando vuelve a acceder.

    - Cuando una alarma de repetición se dispara pero el mensaje de alarma (o un mensaje de alarma diferida) de una ocurrencia previa de la alarma es todavía visible; en otras palabras; cuando la ocurrencia previa de la alarma todavía no ha sido reconocida.

  - El el campo Acción post-alarma, introduzca una orden de shell a ejecutar cuando se acepta la alarma (bien pulsando Cerrar o usando el botón cerrar en la barra de la ventana). No se ejecuta en cualquiera de las siguientes circunstancias:

    - Cuando se cierra un mensaje de recordatorio.

    - Cuando usted retrasa la alarma, excepto cuando la alarma retrasada es finalmente aceptada.

    - Cuando se cierra un mensaje de alarma debido al cierre de sesión.

  Vea mas abajo Alarmas de órdenes para más detalles sobre cómo se ejecutan las órdenes de shell.

##### Alarmas de órdenes

Las alarmas de orden ejecutan una orden sin mostrar ningún mensaje de alarma.

Esta opción no está disponible si &kde; está corriendo en modo kiosco.

Los controles disponibles para alarmas de órdenes son:

- La casilla de verificación Introduzca un guión le permite elegir si se debe introducir una orden de la shell o un guión.

  Si esta opción no está marcada, puede introducir una orden de la shell para que se ejecute. La orden se pasa a través de la shell predefinida (definida por la variable de entorno `SHELL`), y puede incluir cualquier opción, parámetros, órdenes con tuberías, &etc; que se pueda incluir en una sola línea de orden.

  Si esta opción está marcada, puede introducir el texto de un guión para que se ejecute. Recuerde incluir una primera línea del tipo `#!/bin/bash` para asegurar que se invoca el intérprete de órdenes adecuado.

- Use el grupo Salida de la orden para indicar qué quiere que se haga con cualquier salida del terminal que produzca la orden cuando se procese.

  - Marque Ejecutar en una ventana del terminal para hacer que se ejecute la orden en la ventana del terminal. Puede elegir qué tipo de ventana del terminal se debe usar en el Diálogo de configuración.

  - Marque Registrar en archivo para guardar la salida de la orden en un archivo. La salida, que tendrá por prefijo una cabecera en la que se muestra la hora a la que se planificó la ejecución de la orden, se añadirá al contenido del archivo. Indique el nombre del archivo en la casilla de edición, o use el botón que hay junto a la casilla de edición para mostrar un diálogo de selección de archivos.

  - Marque Descartar para deshacerse de la salida de la orden.

##### Alarmas de correo

Las alarmas de correo envían un correo sin mostrar ningún mensaje de alarma.

Cumplimente las direcciones de los destinatarios, la línea del asunto y el cuerpo del mensaje en los tres campos de edición. Use el botón que está junto al cuadro de edición de la dirección para mostrar la libreta de direcciones de &kde;, desde la que puede seleccionar los destinatarios del correo. Se pueden añadir adjuntos usando el botón Añadir.... Tenga en cuenta que los archivos adjuntos deben existir cuando se produzca la alarma; no se almacena ninguna copia de los archivos cuando se configura la alarma. Para borrar un adjunto, resáltelo en la lista desplegable y haga pulse sobre el botón Borrar.

Defina las siguientes opciones:

- La lista desplegable De le permite seleccionar qué identidad de &kmail; se debe usar como dirección de correo electrónico para enviar el correo. Esta opción sólo aparece si en el campo De de la dirección de correo en el Diálogo configuración está marcado Usar las identidades de &kmail;. En caso contrario, su dirección de correo estará predefinida en el Diálogo configuración, haciendo que esta opción inaplicable.

- Marque Copia del correo a sí mismo para mandarse a sí mismo una copia oculta del correo cuando se lance la alarma. La dirección del correo que recibirá la copia se puede configurar en el Diálogo configuración. La predeterminada es la que tiene configurada en preferencias del sistema de &kde;.

##### Alarmas de audio

Las Alarma de audio reproducen un archivo de audio sin mostrar mensajes de alarma.

Defina las siguientes opciones:

- Introduzca la ruta del archivo de sonido, o utilice el botón junta a la caja de edición para mostrar un diálogo de selección de archivo.

- Compruebe Repetir para repetir continuamente al archivo de audio hasta que se seleccione la opción Parar reproducción. Para parar la reproducción del archivo seleccione la opción de menú Acciones Parar reproducción, o pulse con el botón Derecho en la bandeja del sistema y elija Detener reproducción del menúde contexto. Si lo desea usted puede crear un acceso rápido de teclado global para esta acción.

- Marque Volumen y ajuste el desplazador si quiere ajustar el volumen al que se reproduce el archivo de audio.

- Si lo desea, puede graduar el volumen. Atenuación significa que se comience a reproducir el archivo de audio con un volumen y que se vaya cambiando gradualmente hasta el volumen final, a lo largo de un intervalo de tiempo especificado. El volumen final es el que se introdujo en Volumen arriba. Para activar la atenuación, marque Atenuar y luego introduzca el período en segundos en el campo Tiempo de atenuación, y ajuste con el deslizador el Volumen inicial.

#### Posponer

Si la alarma se repite y se retrasó la última vez que fue mostrada, el grupo de opciones Alarma retrasada muestra la hora a la que se retrasó la alarma. Cambiar... muestra un diálogo que le permite cambiar la hora de la alarma retrasada o cancelarla.

#### Hora

En el grupo de opciones Hora, seleccione una de

- En fecha/hora para introducir la fecha y hora en la que se debe producir la alarma. Marque A cualquier hora si quiere especificar sólo una fecha para la alarma: en este caso, la alarma se mostrará en la primera ocasión que se tenga de hacerlo tras la hora de comienzo del día planificado de la alarma. (Configurar &kalarm; describe cómo configurar la hora de comienzo del día).

  Para una alarma que no se repite, la fecha/hora de la alarma que tiene que introducir debe pertenecer al futuro, o si es de sólo fecha, debe ser el día de la fecha o posterior. Para una alarma que se repite, no hay tales restricciones, porque la fecha/hora de comienzo se ajustará automáticamente a la primera repetición que ocurra tras la hora del momento.

- Tiempo desde ahora para introducir cuánto tiempo (en horas y minutos) desde este momento debe transcurrir para mostrar la alarma planificada.

Si lo desea, elija una zona horaria a aplicar a la alarma. esta zona horaria se utiliza Para todas las fechas y horas relacionadas con esta alarma, incluyendo repetición y y fechas y horas excepcionales. Normalmente, usted debería dejar los controles de zona horaria sin cambiar salvo que tenga una buena razón para cambiarlos.

Los controles de zona horaria se muestran sólo cuando la zona horaria seleccionada es distinta de la zona horaria predeterminada en Diálogo de configuración, o si pulsa sobre el botón Zona horaria....

- En el cuadro combinado, elija la zona horaria que se usará para esta alarma. Cuando se cree una nueva alarma, esta es inicialmente ajustada a la zona horaria seleccionada en Diálogo de configuración, que será la zona horaria de su equipo salvo que la haya cambiado.

- Marque Ignorar zona horaria si quiere utilizar la hora local de su equipo (en cualquier equipo en el que &kalarm; se encuentre ejecutando en ese momento) ignorando zonas horarias.

  Se recomienda no seleccionar esta opción si la alarma tiene una repetición especificada en horas y minutos; si lo hace, la alarma puede ocurrir en horas no esperadas después de que cambie el horario de verano.

#### Recordatorio

Para mostrar una alarma, marque Recordatorio si quiere mostrar un recordatorio antes de la alarma principal y de cada una de sus repeticiones (si las hubiera). Introduzca la anterioridad usando los controles de edición junto a la casilla de verificación.

Los recordatorios no se muestran para sub-repeticiones dentro de una repetición. Los recordatorios sólo se muestran antes de cada ocurrencia principal de la alarma.

Si la alarma se repite, marque Recordatorio sólo para la primera repetición si sólo quiere un recordatorio antes de la primera repetición de la alarma. Si no está marcado, el período del recordatorio está limitado a ser menor que el intervalo de repetición.

#### Cancelación

Las opciones de cancelación tardía determinan cómo se trata la alarma después del tiempo planificado:

- La casilla de verificación Cancelar si es tarde determina qué ocurre si no se puede producir la alarma en su hora planificada.

  Marque esta casilla para cancelar la alarma si no se puede producir en el período de tiempo indicado después de la hora adecuada. El período se selecciona usando los controles que aparecen cuando marca esta casilla. Por ejemplo, si introduce un período de tiempo de 1 hora, la alarma se producirá en la primera oportunidad que haya una hora después del vencimiento, pero no se puede producir en la hora en la que se haya cancelado la activación.

  La tardanza en las alarmas de sólo fecha, &ie; las que tienen seleccionada la opción Cualquier hora, se calcula desde la hora de comienzo del día de la fecha para la que se planificó la alarma.

  Deje sin marcar esta casilla para que la alarma se produzca en la primera ocasión desde la hora planificada, sin importar cuánto tiempo ha transcurrido.

  Una alarma sólo se puede lanzar mientras esté en sesión, y tanto X como &kalarm; estén ejecutándose.

- Marque Cerrar la ventana automáticamente tras esta hora si quiere que la ventana de alarma se cierre automáticamente si aún se está mostrando cuando es la hora de cancelación tardía de la alarma.

#### Repetición

Especifique si o como debe repetirse la alarma usando la pestaña Repetición.

Las características básicas de repetición de la alarma se muestran para su comodidad en la pestaña repetición. El intervalo de la repetición se muestra en primer lugar, seguido del intervalo de sub-repetición, que se configura usando el botón Sub-repetición.

En el grupo de opciones Reglas de repetición, fije el tipo de repetición o el período de la forma siguiente:

- Para lanzar la alarma sólo una vez, elija Sin repetición.

- Seleccione Al ingresar para lanzar la alarma cuando ingrese hasta la hora de finalización planificada. Tras la hora de finalización planificada, la alarma se mostrará una última vez. (Tenga en cuenta que una alarma que se repite al ingresar también se lanza cada vez que active las alarmas o reinicie &kalarm;).

- Para hacer que la alarma se repita en intervalos regulares, elija uno de los tipos de períodos temporales y luego introduzca en el cuadro Repetir cada cuántos períodos de tiempo deben transcurrir entre las repeticiones. Por ejemplo, para repetir cada 14 días puede seleccionar Diario e introducir un valor de 14 o seleccionar Semanal e introducir un valor de 2. Según el tipo de período de tiempo seleccionado, puede tener más opciones:

  - Para una repetición diaria, marque cada día de la semana en el que desee que se produzca la alarma.

  - Para una repetición mensual, puede seleccionar si se produce en una fecha fija o en una posición (&eg; el segundo martes).

  - Para una repetición anual, puede seleccionar una fecha fija del año o una posición del mes (&eg; el último sábado de mayo). Marque cada mes del año en el que quiera que se produzca la alarma.

    Si configura repeticiones anuales para el 29 de febrero, especifique cómo se deben gestionar estas repeticiones en los años que no sean bisiestos seleccionando la opción apropiada enAlarma del 29 de Febrero en años no bisiestos:

    - Ninguna: la alarma sucederá el 29 de febrero en los años bisiestos, pero se suprimirá en los años no bisiestos.

    - 28 de febrero: la alarma sucederá el 29 de febrero en los años bisiestos, y el 28 de febrero en los años no bisiestos.

    - 1 de marzo: la alarma sucederá el 29 de febrero en los años bisiestos y el 1 de marzo en los años no bisiestos.

  Para indicar que una alarma diaria suceda únicamente en ciertos días de la semana, use una repetición semanal y marque cada día en cuestión.

En el grupo de opciones Fin de la repetición, fije la hora de fin de la repetición de la siguiente forma:

- Seleccione Sin fin para seguir repitiendo indefinidamente.

- Seleccione Acabar tras para especificar el número total de ocurrencias de la alarma.

- Seleccione Acabar en para especificar la fecha/hora hasta la que se debe repetir la alarma. Tenga en cuenta que esto utiliza la misma zona horaria que la hora de inicio de la alarma.

  La fecha/hora de finalización determina cuando será la última ocurrencia principal, pero no limita las sub-repeticiones. Si están configuradas sub-repeticiones, estas se dispararán normalmente después de la última ocurrencia principal, independientemente de la fecha/hora de finalización.

El cuadro de grupo Excepciones le permite excluir ciertas fechas/horas de la repetición que ha configurado. Des cuenta que esos controles no se muestran en el formulario simplificado del diálogo de edición de alarmas: para verlos, pulse sobre Mas opciones.

- La lista de excepciones (&ie; las fechas y horas excluidas) se muestra a la izquierda. Para añadir una excepción nueva, indique una fecha en la derecha y pulse Añadir. Para cambiar una excepción, resáltela en la lista, introduzca la fecha nueva en la derecha y pulse Cambiar. Para eliminar una excepción, resáltela en la lista y pulse Eliminar.

- Usted puede restringir que una alarma no ocurra en vacaciones marcando Excluir vacaciones. Esto no cambia el modo en que se planifica la alarma; simplemente la suprime cuando se dispara en vacaciones. Usted puede seleccionar su región o país de vacaciones en Diálogo de configuración.

- Usted puede restringir una alarma para que ocurra sólo durante el horario de trabajo marcando Sólo durante horas de trabajo. Esto no cambia el modo en que se planifica la alarma; simplemente suprime la alarma cuando se dispara fuera del horario de trabajo. Los días y horas de trabajo se configuran en el Diálogo de configuración.

##### Sub-repetición

Usted puede usar el botón Sub-repetición para configurar una repetición dentro de una repetición. En este caso, cada vez a la que deba suceder la alarma como se especifica en la ocurrencia principal, en lugar de dispararse sólo una vez, se dispara repetidamente, según indicara en las especificaciones de la sub-repetición. Por ejemplo, para configurar una alarma que se repite cada hora desde el mediodía hasta las 6 de la tarde en los jueves, debería u configurar una repetición semanal, los jueves a las 12:00 y utilizar el diálogo de sub-repetición para indicar un intervalo de 1 hora y además un contador de 6 o una duración de 6 horas.

En el diálogo de sub-repetición que se muestra cuando usted pulsa el botón Sub-repetición, marque Repetir cada para definir una repetición, o desmárquelo para eliminar la repetición. Si está marcada Repetir cada, configure la repetición de la forma siguiente:

- Indique los intervalos de tiempo que hay entre las repeticiones de los controles que hay junto a Repetir cada. Seleccione las unidades de tiempo que desee (&eg; días), y luego introduzca el número de unidades.

- Indique o bien el número de repeticiones o bien su duración:

  - Seleccione Número de veces para indicar cuántas veces se debe disparar la alarma después la ocurrencia principal. Por ejemplo, para hacer que la alarma ocurra 4 veces para cada ocurrencia principal, &ie; 3 veces mas, debería poner aquí un 3.

  - Seleccione Duración para indicar el período total de tiempo en el que se debe producir la alarma. Tiene que ser un múltiplo exacto del intervalo de repetición. Se redondeará automáticamente hacia abajo cuando pulse sobre Aceptar.

Para evitar la superposición de sub-repeticiones para la misma alarma, la duración de una sub-repetición esta restringida para ser menos que el intervalo mas largo entre las ocurrencias principales. Cada vez que la alarma se repite tal como se especifica en la ocurrencia principal, cualquier sub-repetición todavía activa iniciada por la ocurrencia previa se cancela automáticamente.

#### Otros controles

Para mostrar las alarmas, la casilla de verificación Confirmar asentimiento le permite especificar si se le ha de pedir confirmación cuando cierre la ventana de mensaje de alarma. Esto se puede usar como salvaguarda en caso de reconocimiento accidental de alarmas.

Seleccione Mostrar en &korganizer; para añadir la alarma al calendario activo de &korganizer;, donde aparecerá como un evento sin ninguna alarma. Esta opción le permite seguir la pista de las alarmas de &korganizer; cuando esté haciendo uso de las funciones de &kalarm;.

Si modifica o elimina la alarma posteriormente en &kalarm;, el evento de &korganizer; se modificará o se eliminará también. Pero si cambia el evento en &korganizer;, la alarma de &kalarm; no se verá afectada.

Pulse el botón Cargar plantilla para seleccionar una plantilla con la que programar el diálogo, como se describe en Crear y manipular alarmas.

Pulse el botón Probar para comprobar la alarma y verificar si funciona correctamente. La alarma se ejecutará como si se hubiera planificado de la forma habitual.

Pulse el botón Aceptar cuando todos los detalles sean correctos, para añadir la alarma a la lista de alarmas planificadas. Tenga en cuenta que cuando edite una alarma que exista, el botón Aceptar está desactivado si no ha habido cambios.

### Ventana del mensaje de alarma

Cuando un mensaje de alarma cumple, se muestra en cada escritorio de &kde; y no puede ser cubierta por ventanas normales, para asegurarse de que la ve. La ventana del mensaje muestra la hora para la que se planificó la alarma, porque puede ver cuándo surgió si estaba lejos del equipo a esa hora. Si la hora de planificación de la alarma está en hora hora diferente de la configuración de su equipo local, demostrará también su propia zona horaria.(Para mensajes de recordatorios, sin embargo, la fecha/hora mostrada es aquella prevista para la alarma principal o su repetición, no la hora del mensaje del recordatorio, y el título de la ventana es Recordatorio),

Las ventanas del mensaje de alarma permanecen visibles hasta que se asienten, a no ser que se haya marcado Cerrar automáticamente tras la hora de cancelación tardía en el diálogo «Editar alarma». En el caso de una alarma que se repite, si permanece alguna ventana de mensaje no asentida de una repetición previa de la alarma, la ventana existente se muestra cuando se repita la alarma. Esto evita tener varias copias del mismo mensaje, cosa que pudiera no desear, o ser incapaz de asentir a un mensaje cuando aparezca.

La ventana del mensaje de alarma proporciona las siguientes opciones, que se pueden aplicar a las alarmas que se muestran:

- Asentir la alarma pulsando sobre el botón Cerrar. Esto cerrará la ventana (tras solicitar confirmación si seleccionó Confirmar asentimiento).

- Edite la alarma pulsando el botón Editar.... Esto muestra el Diálogo de edición de alarmas.

- Mostrar las opciones para retrasar la alarma pulsando sobre el botón Retrasar.... Luego elija Retrasar a fecha/hora para introducir la fecha y hora a la que se debe volver a mostrar el mensaje, o seleccione Retrasar un intervalo de tiempo para introducir el retraso a partir de ese momento (en horas y minutos) con el que se debe volver a mostrar el mensaje. Luego pulse sobre Retrasar para retrasar el mensaje de alarma para cerrar la ventana.

  La hora a la que se retrase la alarma debe ser anterior a la próxima ocurrencia o recordatorio planificados. Por este motivo, el botón Retrasar... de la ventana de mensaje de alarma y el botón Aceptar del diálogo de retraso se desactivan un minuto antes de que se produzca la próxima ocurrencia o recordatorio.

  El botón Retrasar... no está disponible para alarmas que se muestran al iniciar sesión porque se ha seleccionado la opción Repetir al ingresar.

- Detenga la reproducción del archivo de sonido de la alarma que muestra el símbolo dejar de reproducir.

- Si el mensaje de alarma se creó arrastrando el correo desde &kmail;, puede acceder directamente al correo en &kmail; pulsando en el botón que muestra el icono de &kmail;. Con ello, conseguirá seleccionar y resaltar el correo en la lista de carpetas de &kmail;.

  Si se regeneran los índices de &kmail;, se pierde el enlace al correo en &kmail;.

- El botón que muestra el icono &kalarm; proporciona una forma correcta de activar &kalarm;.

Usted puede elegir en Diálogo de configuración cual de los dos modos diferentes deben usarse para mostrar ventanas con mensajes de alarma:

- Como una ventana normal. En este modo, el foco del teclado se toma de la ventana de mensajes de alarma cuando aparece, para que se desvíen sus pulsaciones de teclado allí en lugar de a su aplicación original.

- Como una ventana no modal. En este modo, el foco del teclado no se ve afectado cuando aparece la ventana del mensaje, de tal forma que no interferirá en su tecleo. Sin embargo, en este modo la ventana no tiene barra de título ni marco, con lo que no puede moverla ni cambiarla de tamaño.

Cuando se muestra una alarma sobre una aplicación a pantalla completa, se muestra como una ventana no modal con independencia de su configuración. Esto es debido a una limitación del sistema de ventanas.

#### Posicionado de las ventanas de mensajes

Usted puede elegir en Diálogo de configuración cual de los dos esquemas deberían utilizarse para posicionar las ventanas de mensajes de alarma:

- Las ventanas se visualizan tan lejos como sea posible de la posición actual del cursor. Esto minimiza la interrupción de su flujo de trabajo y minimiza la posibilidad de aceptar accidentalmente la alarma.

- Las ventanas se visualizan en el centro de la pantalla. Para reducir el riesgo de aceptar la alarma accidentalmente, los botones de la ventana están desactivados inicialmente, activándose sólo tras un retraso configurable.

Si usted tiene varias ventanas de mensaje de alarma, o mensajes de error, puede expandir las ventanas sobre la pantalla para hacerlas visibles, o agruparlas todas juntas de nuevo en la esquina superior izquierda de la pantalla, por medio de la opción de menú Ver Expandir ventanas . Si lo desea, puede configurar una tecla de atajo global para esta acción.

### Operación de la bandeja del sistema

&kalarm; puede estar corriendo por omisión como icono en la bandeja del sistema. Este icono proporciona tanto control como indicación de estado de la monitorización de alarmas. Un icono normal de &kalarm; indica qué las alarmas están siendo monitorizadas, mientras que un icono gris indica que no lo están. Si algunas alarmas individuales están desactivadas, se superpone al icono una pequeña cruz.

Si pasa el cursor del ratón sobre el icono de la bandeja del sistema, se mostrará en forma de consejo un resumen de los primeros mensajes de alarma que vencen en las próximas 24 horas. Puede desactivar esta característica, o configurar el número de alarmas que va a mostrar y su formato en el Diálogo configuración.

Pulse con el botón Izquierdo sobre el icono de la bandeja del sistema para mostrar u ocultar la ventana principal de &kalarm;.

Pulse con el botón derecho sobre el icono de la bandeja del sistema para mostrar su menú de contexto:

Activar las alarmas

  Activa o desactiva la monitorización de las alarmas.

  Vea Activando y desactivando alarmas para más detalles.

Nueva alarma

  Después de que seleccione el tipo de alarma de la lista que aparece, abre el diálogo de edición de alarmas para crear una nueva alarma.

Alarma nueva desde plantilla

  Muestra la lista de plantillas de alarmas en un menú. Cuando elige una, se muestra el diálogo de edición de alarmas, con opciones predeterminadas con detalles de esa plantilla.

Parar reproducción

  Detiene la reproducción del archivo de audio reproducido en este momento.

Brotar ventanas

  Hace brotar en la pantalla una ventana de alarma y mensaje de error, o los agrupa juntos de nuevo.

Configurar &kalarm;...

  Muestra el diálogo de configuración de &kalarm;.

  El diálogo de configuración se describe en Configurar &kalarm;. Incluye opciones referentes al icono de &kalarm; en la bandeja del sistema.

Restaurar / Minimizar

  Restaura o minimiza la ventana principal de &kalarm;.

Salir

  Cierra el icono de la bandeja del sistema y las ventanas principales de &kalarm;.

  Cierra &kalarm; si no se muestra ninguna ventana de mensaje de alarma.

#### Mostrando &kalarm; en la bandeja del sistema

Usted debe estar ejecutando el escritorio &kde; u otro gestor de ventanas adecuado para poder visualizar &kalarm; en la bandeja del sistema.

Para mostrar &kalarm; en la bandeja del sistema, seleccione Ver Mostrar en la bandeja del sistema .

Para quitar &kalarm; de la bandeja del sistema, des-seleccione Ver Mostrar en la bandeja del sistema .

Para elegir si &kalarm; debe mostrarse o no al inicio en la bandeja del sistema, utilice la pestaña Ver en el diálogo de configuración.

### Refrescando alarmas

Si en el evento indeseado en el que una alarmas no se disparó cuando debería haberlo hecho, puede refrescar la lista de alarmas y lanzar cualquier alarma perdida seleccionando Acciones Refrescar alarmas . Esto causa que &kalarm; recargue todos los calendarios de alarma.

Usted puede recargar un calendario individual y refrescar sus alarmas en la lista de alarmas pulsando con el botón Derecho sobre el calendario en la lista de calendarios y seleccionando la opción de menú Recargar. Vea Calendarios de alarmas para mas detalles.

### Activando y desactivando alarmas

Las alarmas se pueden activar y desactivar en conjunto o individualmente:

- La monitorización de alarmas se aplica a las alarmas en conjunto. Mientras se desactiva la monitorización de alarmas, no se dispara ninguna alarma. Cuando la monitorización de alarmas está activada (la situación habitual), todas las alarmas que no estén desactivadas individualmente se dispararán a las horas adecuadas.

  Cuando se reactiva la monitorización de alarmas, las alarmas que se hayan disparado mientras estaba desactivada se disparan ahora (salvo que cualquier opción de cancelación posterior lo anule). En otras palabras, desactivar la monitorización de alarmas tiene el mismo efecto que detener &kalarm; las alarmas – se retrasan hasta que se re-active.

- Las alarmas se pueden activar y desactivar individualmente, independientemente del estado de la monitorización de las alarmas. Así, el estado de activación y desactivación de las alarmas individuales permanece sin cambios aunque se desactive y reactive la monitorización de alarmas. A diferencia de la monitorización de alarmas que puede desactivarse potencialmente debido a que &kalarm; no se esté ejecutando. las alarmas individuales soló pueden desactivarse si utiliza las opciones de menú para hacerlo.

  Cuando una alarma se reactiva individualmente, no se dispara si se produjo cuando estaba desactivada. En otras palabras, desactivar una alarma individual cancela todas sus ocurrencias hasta que se reactiva.

  El estado activado/desactivado de una alarma individual se indica según el color de la lista de alarmas (el color se puede configurar en la pestaña Ver del diálogo de configuración).

Para que se dispare una alarma, tiene que estar activada individualmente, y también tiene que estar activa la monitorización de alarmas.

#### Activando la monitorización de alarmas

Para que suceda la monitorización de una alarma, se debe estar ejecutando &kalarm;. Una vez que usted ejecute &kalarm; este se iniciará automáticamente cada vez que inicie sesión salvo que lo desactive mas tarde en la pestaña General del diálogo de configuración.

Si la monitorización de la alarma está desactivada actualmente, haga una de las siguientes cosas para activar las alarmas:

- Seleccione Acciones Activar alarmas.

- Pulse con el botón derecho sobre el icono de la bandeja del sistema y elija Activar alarmas del menú de contexto.

#### Desactivando la monitorización de alarmas

Usted puede desactivar temporalmente la monitorización de alarmas, que evita que &kalarm; vuelva a mostrar más alarmas hasta que vuelva a activar las alarmas, o – asumir que &kalarm; se configure para que comience al ingresar – hasta la próxima vez que inicie sesión.

- De-seleccione Acciones Activar alarmas.

- Pulse con el botón Derecho en el icono de la bandeja del sistema y desmarque Activar alarmas desde el menú de contexto.

- Para &kalarm; como se describe en Saliendo de &kalarm;.

Las alarmas pueden desactivarse permanentemente evitando que &kalarm; se arranque en el inicio de sesión usando la pestaña General del diálogo de configuración.

#### Activando y desactivando las alarmas individuales

Para activar las alarmas individuales que están desactivadas en ese momento, haga una de las siguientes acciones:

- Seleccione una o mas alarmas pulsando sobre sus entradas en la lista de alarmas. Luego elija Acciones Activar .

- Pulse con el botón derecho sobre las entradas que desee en la lista de alarmas y elija Activar en el menú de contexto.

Para desactivar las alarmas individuales que estén activadas en ese momento, haga una de las siguientes acciones:

- Seleccione una o mas alarmas pulsando sobre sus entradas en la lista de alarmas. Luego elija Acciones Activar .

- Pulse con el botón derecho sobre las entradas que desee en la lista de alarmas y elija Activar en el menú de contexto.

### Saliendo de &kalarm;

Salir de &kalarm; seleccionando Archivo Salir, o Salir en el menú de contexto del icono de la bandeja del sistema. Alternativamente, si el icono de la bandeja del sistema no está visible, ciñere la ventana de &kalarm;.

## Configurando &kalarm;

Para configurar el funcionamiento de &kalarm; para que se ajuste a su sistema y preferencias personales, seleccione Preferencias Configurar &kalarm;.... Esto muestra el diálogo de configuración.

### General

La sección General le permite controlar algunos aspectos relativos al comportamiento de &kalarm;:

- Iniciar automáticamente al ingresar: &kalarm; se iniciará automáticamente al ingresar en su sesión de &kde;, asegurando que &kalarm; se ejecute siempre hasta que lo quite manualmente.

  Esta opción siempre debería estar marcada, a no ser que pretenda dejar de usar &kalarm;.

  Esta opción se vuelve a seleccionar automáticamente si se ejecuta &kalarm;. Por tanto, si ha desmarcado esta opción y quiere seguir evitando que &kalarm; se lance al inicio, tiene que volver a desmarcar esta opción cada vez que haga funcionar &kalarm;.

- Avisar antes de salir: Cuando las alarmas están desactivadas mientras &kalarm; no esté corriendo, al marcar esta opción se le pide confirmación si intenta terminar &kalarm; usando la opción Salir del icono de la bandeja del sistema. Esto evita la desactivación adicional de las alarmas. Por seguridad, esta opción se activa automáticamente por omisión si cambia el modo de ejecución.

- Confirmar borrados de alarma: Especifique si se debe pedir confirmación cada vez que borre una alarma.

- Intervalo de retraso predefinido: Introduzca el intervalo de tiempo predeterminado, en horas y minutos para mostrar inicialmente cuando se visualiza el diálogo de alarma retrasada. Tenga en cuenta que si se ha retrasado previamente una alarma, el intervalo que se muestra inicialmente en el diálogo de alarma retrasada será igual al intervalo retrasado utilizado la última vez que se retrasó la alarma.

- Terminal para alarmas de órdenes: Aquí puede seleccionar qué tipo de ventana del terminal de debe usar para las alarmas de órdenes que se vayan a ejecutar en una ventana del terminal. Algunas de las aplicaciones de terminal más utilizadas ya están preconfiguradas, &eg; xterm, &konsole;, aunque sólo se mostrarán las que estén instaladas en su sistema. Puede ver las opciones reales de la orden que se usa para cada aplicación si muestra la ayuda contextual para este botón de radio.

  Si quiere usar otra aplicación, o quiere usar una de las que se listan, pero con unas opciones diferentes para la orden, puede seleccionar Otro, e indicar la orden que tiene que invocar la ventana del terminal. De forma predefinida, la cadena con la orden para lanzar la alarma se debe añadir a lo que indique. También puede querer especificar dónde se debe insertar la cadena de la orden de la alarma, usando los siguientes códigos:

  %c

    La cadena con la orden de la alarma que se debe sustituir.

  %w

    La cadena de la orden de la alarma que se debe sustituir a la que se le añade `sleep`.

  %C

    Un archivo de órdenes temporal, que contiene la cadena de la orden de alarma que se creará, y la orden que se debe ejecutar el archivo que se sustituirá.

  %W

    Un archivo de órdenes temporal, que contiene la cadena con la orden de la alarma, y que se creará con `sleep` añadido, y la línea de órdenes que se ejecutará con el archivo que se va a sustituir.

  Cuando se produzca la alarma de órdenes, la cadena con la orden se pondrá entre comillas antes de que se inserte en la línea de órdenes de la ventana del terminal.

### Fecha y hora

La sección Fecha y hora le permite elegir opciones relacionadas con la fecha y hora:

- Zona horaria: Seleccione su zona horarias. &kalarm; utiliza esta zona horaria siempre, excepto cuando la anule para alarmas individuales.

- Región de vacaciones: Elija que país o región de vacaciones utilizar. Esto afecta a las alarmas de repetición para las que esté activa la opción de excluir vacaciones.

- Comienzo del día par las alarmas de sólo fecha: Fija la hora de comienzo del día para disparar alarmas de sólo fecha, &ie; aquéllas para las que se haya seleccionado la opción A cualquier hora. En la fecha de vencimiento, tales alarmas se mostrarán en la primera ocasión durante las 24 horas siguientes a partir de la hora de comienzo del día.

- Cuadro de grupo Horario de trabajo: Estas opciones le permiten definir su horario de trabajo, lo que es necesario cuando se selecciona la opción Sólo en horas de trabajo para una repetición en el diálogo Diálogo de edición de alarmas.

  - Comprobar cada día que sea un día de trabajo.

  - Hora de entrada diaria: introduzca la hora a la que comienza a trabajar cada día.

  - Hora de salida diaria: introduzca la hora a la que termina de trabajar cada día.

- Duración del evento de KOrganizer: Introduzca la duración del evento a establecer en KOrganizer para alarmas que se copian a KOrganizer. La duración predeterminada es cero.

### Almacenamiento

La sección Almacenamiento le permite elegir opciones para guardar y archivar alarmas:

- Nuevas alarmas & plantillas: Especifique en que calendario almacenar las nuevas alarmas y plantillas cuando se usen múltiples calendarios de alarmas:

  - Guardar en calendario predeterminado: las nuevas alarmas y plantillas de alarmas se añaden automáticamente al calendario de alarmas predeterminado sin pedir confirmación.

  - Preguntar en que calendario almacenarlas: Cuando cree una nueva alarma o plantilla de alarma y hay mas de un calendario de alarmas escribible, se le pedirá elegir en que calendario guardarlas. Tenga en cuenta que cuando las alarmas se guardan al expirar, siempre se guardan en el calendario predeterminado sin preguntar.

- Cuadro de grupoAlarmas archivadas: Estas opciones controlan el almacenamiento de las alarmas archivadas en el calendario predeterminado de alarmas archivadas.

  - Mantener las alarmas tras expirar: Marque esta opción para archivar las alarmas expiradas y borradas. Quite la marca para no guardar el registro de las alarmas que dejan de estar activas. Tenga en cuenta que las alarmas eliminadas sólo se almacenan si se han disparado previamente. Si elimina una alarma antes de que se dispare, se descarta.

  - Descartar las alarmas archivadas tras: Define el número de días para almacenar las alarmas expiradas y eliminadas en el archivo, después de lo cual se eliminan permanentemente.

  - Borrar las alarmas archivadas: Este botón descarta todas las alarmas archivadas del calendario de alarmas archivadas predeterminado. (Otros calendarios de alarmas archivadas se mantienen sin cambios en caso de que se compartan con mas gente). Esto no tiene efecto sobre las alarmas que expiren o sean borradas con posterioridad; seguirán estando archivadas según las opciones seleccionadas.

### Correo

La sección Correo le permite elegir opciones para el envío y el direccionamiento de las alarmas de correo:

- Cliente de correo: Especifique el cliente de correo para ser utilizado al enviar las alarmas:

  - KMail: Cuando se produce una alarma de correo, el mensaje se envía usando &kmail; (que se inicia primero si es necesario) de la forma siguiente:

    - Si la versión de &kmail; es la 1.7 o posterior, el correo se envía automáticamente.

    - Si tiene una versión anterior de &kmail;, el correo se añade a la `bandeja de salida` de &kmail; para una transmisión posterior.

  - Sendmail: Cuando se dispara una alarma de correo, el correo se envía automáticamente usando &Sendmail;. Esta opción sólo funcionará si su sistema está configurado para usar &Sendmail; o un agente de transporte de correo compatible con &Sendmail;, como postfix o qmail.

- Copiar los correos enviados a la carpeta de correos enviados de &kmail;: Seleccione esta opción si, cada vez que se produce una alarma de correo electrónico, quiere que se almacene una copia del correo que se transmite en la carpeta de correo enviado `sent-items` de &kmail;.

  Esta opción no está disponible si &kmail; está seleccionado como cliente de correo electrónico, ya que es algo que &kmail; hace automáticamente.

- Notificar cuando los correos remotos entren en cola: Seleccione esta opción para mostrar una notificación cada vez que una alarma ponga en la cola de correo un mensaje para enviar a un sistema remoto. Esto puede ser útil si, por ejemplo, tiene una conexión por módem o si el correo electrónico se pone en la cola de la carpeta de salida (`outbox`) de &kmail;, de forma que se tendrá que asegurar que hace lo necesario para transmitir efectivamente el correo.

- Seleccione la dirección de correo electrónico que se vaya a usar como remitente en las alarmas de correo electrónico:

  - Seleccione De para introducir una dirección de correo electrónico.

  - Seleccione Usar la dirección de preferencias del sistema para usar la dirección de correo que está configurada en las preferencias del sistema de &kde;.

  - Seleccione Usar las identidades de &kmail; para poder seleccionar durante la configuración una alarma de correo electrónico de las identidades de &kmail;. Se usará la identidad predefinida de &kmail; para las alarmas que ya estuvieran configuradas entes de que seleccionara esta opción.

- Seleccione la dirección de correo electrónico que se deba usar para enviarse copias ocultas de las alarmas de correo electrónico cuando esté seleccionada la opción Copia del correo electrónico a sí mismo:

  - Seleccione Bcc para indicar una dirección de correo electrónico. Si se van a enviar copias ocultas a la cuenta del equipo en el que funciona &kalarm;, simplemente tiene que indicar aquí el nombre de usuario de ingreso.

  - Seleccione Usar la dirección de preferencias del sistema para usar la dirección de correo que está configurada en las preferencias del sistema de &kde;.

### Ver

La sección Ver le permite controlar algunos aspectos de la apariencia de &kalarm;. En la pestaña General:

- Mostrar en la bandeja del sistema: Cuando está seleccionado, se muestra el icono en la bandeja del sistema cuando &kalarm; esté funcionando. En este modo, cerrar el icono de la bandeja del sistema cierra todas las ventanas principales de &kalarm;, y si no hay ninguna ventana de mensajes visible, sale de la aplicación.

- Cuadro de grupo Consejo de la bandeja del sistema: Estas opciones controlan qué información se muestra en el consejo que aparece cuando se pasa el cursor sobre el icono de &kalarm; en la bandeja del sistema.

  - Mostrar las alarmas de las próximas 24 horas: Al estar seleccionado se muestra un resumen de las primeras alarmas que vencen en las próximas 24 horas.

  - Máximo número de alarmas que mostrar: Desmarque esta opción para mostrar todas las alarmas de las próximas 24 horas. Selecciónela para fijar el máximo número de alarmas que se deban mostrar.

  - Mostrar la hora de la alarma: Seleccione esta opción para mostrar la hora a la que está planificada cada alarma.

  - Mostrar tiempo hasta la alarma: Seleccione esta opción para mostrar el tiempo restante para que ocurra la siguiente alarma planificada. Este tiempo se muestra en horas y minutos.

    - Prefijo: Especifica un símbolo o texto que se mostrará delante del tiempo restante para la alarma, para distinguirlo de la hora a la que está planificada la alarma.

- El cuadro de grupo Lista de alarmas le permite seleccionar los colores que se usan en la lista de alarmas de la ventana principal de &kalarm;, para mostrar alarmas desactivadas y archivadas.

La pestaña Ventanas de alarma contiene opciones para controlar el aspecto de las ventanas de mensajes de alarma.

- Colocar las ventanas alejadas del cursor: Seleccione esta opción para visualizar las ventanas de mensajes de alarma tan lejos como se pueda de la posición actual del ratón. Esto minimiza la posibilidad de aceptar accidentalmente una alarma pulsando accidentalmente en un botón justo cuando aparece la ventana.

- Centrar ventanas, retrasar la activación de los botones de la ventana: Seleccione esta opción para mostrar las ventanas de mensajes de alarma en el centro de la pantalla. Para reducir la posibilidad de aceptar accidentalmente la alarma, los botones están desactivados inicialmente. El retraso en segundos antes de que se activen se especifica en Retraso en la activación de los botones (segundos).

- Las ventanas de mensaje tienen una barra de título y retienen el foco del teclado: Esta opción controla si las ventanas de los mensajes de alarma son modales o no, &ie; si retienen el foco del teclado cuando aparecen. Vea la sección Ventana de mensaje de alarma para más detalles.

### Editar

La sección Editar le permite elegir los valores predefinidos para las opciones del Diálogo de edición de alarma:

- La pestaña General contiene opciones que se aplican a todos los tipos de alarmas.

  - Define los estados predefinidos para las casillas de verificaciónMostrar en KOrganizer y Cancelar si tarde.

  - Fijar el tipo de repetición predeterminado.

  - Selecciona el tratamiento predeterminado para repetición en años no bisiestos para repeticiones planificadas para el 29 de Febrero.

- La pestaña Tipos de alarma contiene las opciones aplicables a tipos específicos de alarma.

  - Para mostrar alarmas:

    - Define el estado predefinido de las casillas de verificación Cerrar automáticamente la ventana tras esta hora y Confirmar asentimiento.

    - Fijar las unidades predeterminadas del periodo.

    - Define las opciones especiales de visualización de la alarma.

    - Define las opciones de sonido predefinidas. Tenga en cuenta que se debe indicar un archivo de sonido predefinido aunque el tipo de sonido no sea Archivo de sonido.

  - Para alarmas de órdenes:

    - Define los estados predefinidos para las casillas de verificación Introducir un guión y Ejecutar en una ventana del terminal.

  - Para alarmas de correo electrónico:

    - Defina el estado predefinido de la casilla de verificación Copia del correo electrónico a sí mismo.

- La sección Tipo de letra & color le permite elegir la apariencia predeterminada de los mensajes de alarma. Seleccione el tipo de letra predeterminado y los colores de primer plano y fondo.

## Operación de la línea de órdenes

Cuando se suministran los parámetros de la línea de órdenes, &kalarm; no muestra la lista de las alarmas planificadas tal y como se describen en el Usar &kalarm; arriba. Las opciones de la línea de órdenes específicas de &kalarm; se pueden usar para realizar las siguientes operaciones:

- planificar una alarma nueva

- controlar el modo de visualización de &kalarm;

- obtener ayuda

Las opciones de la línea de órdenes adicionales se proporcionan principalmente para permitir que otros programas se comuniquen con &kalarm;. Se describen en el capítulo Guía del desarrollador de &kalarm;.

La línea de órdenes sólo puede contener opciones aplicables a una operación de &kalarm;. Si quiere realizar múltiples operaciones, debe invocar a &kalarm; muchas veces con una sola serie de opciones cada vez.

### Planificar una alarma nueva

Se usan las siguientes opciones para planificar una alarma nueva:

Opción | Descripción
--- | ---
`-a`, `--ack-confirm` | Pedir confirmación cuando el mensaje de alarma se reconoce.
`-A`, `--attach URL` | Especificar la ruta o &URL; de un archivo que se va a añadir al correo electrónico. Esta opción se puede repetir tantas veces como sea necesario. Se debe especificar `--mail` con esta opción.
`--auto-close` | Cierra automáticamente la ventana de alarma después del período de `--late-cancel`. Con esta opción se tiene que indicar `--late-cancel`.
`-b`, `--beep` | Hace un «bip» audible cuando se muestra el mensaje. Ni `--speak` ni `--play` ni `--play-repeat` se pueden indicar con esta opción.
`--bcc` | Con copia oculta del correo a sí mismo. `--mail` se debe especificar con esta opción.
`-c`, `--color`, `--colour color` | Fija el color de fondo del mensaje para el nombre del color de &Qt; especificado o el código hexadecimal 0xRRGGBB.
`-C`, `--colorfg`, `--colourfg color` | Fija el color de fondo del mensaje para el nombre del color de &Qt; especificado o el código hexadecimal 0xRRGGBB.
`-d`, `--disable` | Desactivar la alarma. No se producirá la alarma hasta que no se haya activado manualmente.

`-e`, `--exec lineadeórdenes`

Especifique una orden de shell para ejecutar. Si lo especificó, esta opción debe ser la última opción de &kalarm; en la línea de órdenes de &kalarm;. Todos los parámetros y opciones siguientes se interpretan como parte de la línea de órdenes a ejecutar `--file` y `--mail` se pueden especificar con esta opción.`--ack-confirm`, `--beep` y `--color` se ignoran con esta opción.

`-E`, `--exec-display línea de orden`

Especifique un comando de la shell para ejecutar. Si lo especificó, esta opción debe ser la última opción de &kalarm; en la línea de comando de &kalarm;. Todos los parámetros y opciones siguientes se interpretan como parte de la línea de comando a ejecutar `--file` y `--mail` se pueden especificar con esta opción.`--ack-confirm`, `--beep` y `--color` se ignoran con esta opción.

`-f`, `--file URL` | Especifique la ruta o &URL; de un archivo de texto cuyo contenido va a formar el mensaje de alarma. `--exec`, `--exec-display` y `--mail` no pueden especificarse, y mensaje no debe estar presente esta opción.
`-F`, `--from-id ID` | Usa la identidad de &kmail; especificada como remitente del correo electrónico. Junto con esta opción se debe indicar `--mail`.

`-i`, `--interval periodo`

Fije los intervalos entre las repeticiones de la alarma. Las horas y minutos se especifican en en el formato nHnM, en las que n es un número, &eg; 3H30M. Otros períodos de tiempo se especifican con el formato nX, donde n es un número y X es una de las siguientes letras: Y(años), M (meses), W (semanas), D (días). Si también se indica la opción `--recurrence`, no se permite ni Y (años) ni M (meses). Obligatorio si se indica `--repeat` o `--until`.

`-k`, `--korganizer` | Muestra la alarma como un evento en el calendario activo de &korganizer;.
`-l`, `--late-cancel periodo` | Cancela la alarma si no se puede producir en el periodo indicado tras la hora adecuada. El período periodo se indica en el mismo formato que se describió para `--reminder`. El valor predeterminado del periodo es de 1 minuto.
`-L`, `--login` | Activa la alarma cada vez que ingrese. Ni `--interval` ni `--repeat` ni `--until` se pueden especificar con esta opción.
`-m`, `--mail dirección` | Envía un correo a las direcciones especificadas. Esta opción se puede repetir tantas veces como sea necesario. `--exec`, `--exec-display` y `--file` no pueden especificarse con esta opción. `--ack-confirm`, `--beep`, `--color` y `--colorfg` se ignoran con esta opción.
`-p`, `--plat URL` | Especifique la ruta o &URL; de un archivo de audio para reproducirlo cuando se muestre el mensaje de alarma. Ni `--play-repeat` ni `--beep` ni `--speak` se pueden indicar con esta opción.
`-P`, `--play-repeat URL` | Indique la ruta o &URL; de un archivo de audio para que se reproduzca repetidamente, bien hasta que se utiliza Parar reproducción o mientras se muestre el mensaje de alarma. Ni `--play` ni `--beep` ni `--speak` se pueden indicar con esta opción.
`--recurrence spec` | Fija la alarma para que se repita. Especifique la repetición usando la sintaxis de iCalendar (definidos en RFC2445), &eg; FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO. No se puede especificar `--until` con esta opción.

`-r`, `--repeat contador`

Define el número de veces que se debe producir la alarma, o, si se ha indicado con `--recurrence`, el número de veces que se debe producir la alarma cada vez que la activa `--recurrence` (&ie; una repetición dentro de una repetición). Si no está presente `--recurrence`, indique -1 para repetir la alarma indefinidamente. Se debe especificar `--interval`, y no se debe indicar `--until` con esta opción.

`-R`, `--reminder periodo`

Muestra un recordatorio de alarma la cantidad de tiempo dada antes de la alarma principal y cada una de sus repeticiones (si es que las hay). Se especifican horas y minutos con el formato nHnM, donde n es un número , &eg; 3H30M. Se especifican otros períodos de tiempo con el formatonX, donde n es un número y X es una de las siguientes letras: W (semanas), D (días). Esta opción no se puede especificar ni con `--exec` ni con `--mail` ni con `--reminder`.

`--reminder-once periodo` | Produce un recordatorio de alarma una vez, con el tiempo indicado antes de la primera repetición de la alarma. No se mostrará ningún otro recordatorio antes de las siguientes repeticiones (si las hubiera). Esta opción se puede indicar con `--exec`, `--mail` o `--reminder`.
`-s`, `--speak` | Lee el mensaje que se muestra. Esta opción necesita que esté instalado y configurado KTTSD, además de un sintetizador de habla. Ni `--beep` ni `--play` ni `--play-repeat` se pueden indicar con esta opción.
`-S`, `--subject asunto` | La línea del asunto del correo electrónico. `--mail` se debe especificar con esta opción.

`-t`, `--time fecha/hora`

Disparar la alarma en la fecha o la fecha/hora especificada. Especifique una fecha sin una hora en formato yyyy-mm-dd [TZ]; especifique una fecha y hora como [[[yyyy-]mm-]dd-]hh:mm [TZ] (cuando se omiten, los campos de fecha son por omisión los valores de hoy)). Si no se especifica zona horaria, se asume la hora local del sistema. Si está presente un especificador de zona horaria TZ, debe ser el nombre de una zona horaria del sistema (&eg; `Europe/London`), `UTC` representando la zona horaria UTC, o `Clock` para usar la zona local del equipo e ignorar zonas horarias.

`-v`, `--volume porcentaje` | Define el volumen del audio para reproducir el archivo de sonido. Esta opción sólo se puede usar si está especificada la opción `--play` o `--play-repeat`.

`-u`, `--until fecha/hora`

Repite la alarma hasta la fecha o fecha y hora especificada. Especifique una fecha sin hora con el mismo formato que en `--time`. tenga en cuenta que si se especifica`--time`, la zona horaria se tomará de este valor y no se incluirá zona horaria en el valor de la opción `--until`. `--interval` debe especificarse, y `--repeat` y `--recurrence` no pueden especificarse con esta opción.

mensaje | Texto del mensaje para mostrar, o si `--mail` está especificado, el cuerpo del mensaje del correo.

Se debe especificar un mensaje de texto o `--file`, `--exec`, `--exec-display`, `--play` or `--play-repeat`. Salvo en los casos citados anteriormente, todas las opciones son optativas.

Dos ejemplos más sobre qué muestra un mensaje de múltiples líneas con un fondo rojo a las 10 p.m. el día 27 de este mes:

    % kalarm -c rojo -t 27-22:00 "Recuerde\nPARAR"
    % kalarm -c 0xFF0000 -t 27-22:00 "Recuerde\nSTOP"

### Otras opciones

Se usan las siguientes opciones para mostrar el Diálogo de edición de alarmas, o para controlar el modo de visualización de &kalarm;.

Opción | Descripción
--- | ---
`--edit idEvento` | Muestra el diálogo de edición de alarma para editar la alarma con el id. de evento indicado.
`--edit-new-audio` | Muestra el diálogo de edición de alarma, para editar una alarma de audio nueva.
`--edit-new-command` | Muestra el diálogo de edición de alarma, para editar una alarma de orden nueva.
`--edit-new-display` | Muestra el diálogo de edición de alarma, para editar una alarma de visualización nueva.
`--edit-new-email` | Muestra el diálogo de edición de alarma, para editar una alarma de correo nueva.
`--edit-new-preset nombrePlantilla` | Muestra el diálogo de edición de alarma, con las opciones predefinidas de la plantilla de alarma con el nombre indicado, para editar una alarma nueva.
`--tray` | Muestra &kalarm; como un icono de la bandeja del sistema.

### Opciones de ayuda

Las siguientes opciones de ayuda son iguales en todos los programas de &kde;:

Opción | Descripción
--- | ---
`--help` | Muestra un pequeño texto de ayuda con las opciones.
`--help-qt` | Muestra numerosas opciones específicas de &Qt;.
`--help-kde` | Muestra numerosas opciones genéricas de &kde;.
`--help-all` | Muestra todas las opciones.
`--author` | Muestra los nombres y las direcciones de correo de los autores de &kalarm;.
`-v`, `--version` | Muestra las versiones actuales de las bibliotecas &Qt;, &kde; y &kalarm;.
`--license` | Muestra la información de la licencia.

## Guía del desarrollador de &kalarm;

&kalarm; proporciona un interfaz para permitir que otras aplicaciones soliciten las siguientes funciones:

- planificar una alarma nueva

- cancela una alarma ya planificada

- lanza una alarma ya planificada

- muestra el diálogo de edición de alarma

Cada una de las funciones anteriores se implementan tanto como llamadas D-Bus como con la línea de órdenes. Las llamadas a D-Bus se deberían usar preferentemente si &kalarm; ya se está ejecutando.

### Interfaz D-Bus

Las llamadas a D-Bus descritas en este documento están todas implementadas en la ruta del objeto D-Bus de &kalarm; `/kalarm`. La interfaz está definida en los archivos `org.kde.kalarm.kalarm.xml` y `kalarmiface.h`.

cancelEvent

#### cancelEvent

cancela una alarma ya planificada.

    void cancelEvent(const QString& idEvento)

##### Parámetros

`eventID`

  Indica el identificador único del evento que se va a cancelar.

##### Descripción

`cancelEvent()` es una llamada D-Bus para cancelar la alarma especificada. &kalarm; borra la alarma del archivo de calendario sin mostrarla ni ejecutarla.

triggerEvent

#### triggerEvent

lanza una alarma ya planificada.

    void triggerEvent(const QString& idEvento)

##### Parámetros

`eventID`

  Indica el id. único del evento que se va a disparar.

##### Descripción

`triggerEvent()` es una llamada D-Bus para provocar la visualización o ejecución inmediata de la alarma especificada (sin importar a qué hora esté planificada). &kalarm; recupera la alarma del calendario y luego la muestra o ejecuta.

Si la alarma se ha cumplido, &kalarm; borra todas las ocurrencias planificadas de la alarma hasta la hora actual, y si no hay repeticiones de la alarma pendientes, la alarma se borra del calendario. Si la alarma aún no ha cumplido, sus ocurrencias planificadas se dejarán sin cambios.

scheduleMessage

#### scheduleMessage

planifica un nuevo mensaje de alarma.

    bool scheduleMessage(const QString& message,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const QString& audioURL,
                         int reminderMins,
                         const QString& recurrence,
                         int subRepeatInterval,
                         int subRepeatCount)

    bool scheduleMessage(const QString& message,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const QString& audioURL,
                         int reminderMins,
                         int recurType,
                         int recurInterval,
                         int recurCount)

    bool scheduleMessage(const QString& message,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         const QString& bgColor,
                         const QString& fgColor,
                         const QString& font,
                         const QString& audioURL,
                         int reminderMins,
                         int recurType,
                         int recurInterval,
                         const QString& endDateTime)

##### Parámetros

`mensaje`

  Especifica el texto del mensaje a planificar, o si `flags` tiene activado el bit `DISPLAY_COMMAND`, especifica la línea de órdenes a ejecutar para generar el mensaje de texto.

`startDateTime`

  Especifica la fecha planificada, o la fecha y la hora, en la que se deba mostrar el mensaje. Para una alarma de sólo fecha, la cadena debería tener el formato AAAA-MM-DD [TZ] (tal y como lo devuelve el método `QDate::toString(Qt::ISODate)`). Para una alarma con fecha y hora, la cadena debería tener el formato AAAA-MM-DDTHH:MM[:SS] [TZ] (tal y como lo devuelve el método `QDateTime::toString(Qt::ISODate)`) o HH:MM[:SS] [Reloj](tal y como lo devuelve el método `QTime::toString(Qt::ISODate)`). Si no se indica ninguna fecha, se usa la fecha del día actual. Tenga en cuenta que el valor de los segundos se ignora.

  Si no se especifica zona horaria, se asume la hora local del sistema. Si está presente una zona horaria TZ, debe ser el nombre de una zona horaria del sistema (&eg; `Europe/London`), `UTC` representando la zona horaria UTC o `Clock` para usar la hora local del equipo e ignorar las zonas horarias.

`cancelarSiTarde`

  Provoca que se cancele la alarma si no se puede producir en el número de minutos indicado posteriores a la hora planificada para la alarma. Si el valor es 0, la alarma no se cancelará, independientemente del retraso con el que se produzca.

`banderas`

  Especifica la O lógica de las banderas de la alarma deseada. Los bits de la alarma son los que se definen en la clase `KAlarmIface` en `kalarmiface.h`. Tenga en cuenta que no todos los bits de la bandera se pueden aplicar a los mensajes de la alarma.

`bgColor`

  Especifica el color de fondo para cuando se muestre el mensaje. La cadena puede tener el formato #RRGGBB (tal y como devuelve el método `QColor::name()`), donde RR, GG y BB son valores hexadecimales de dos dígitos para el rojo, el verde y el azul. Además, la cadena puede ser de cualquiera de los formatos que acepte `QColor::setNamedColor()`, como un nombre de la base de datos de colores de las X (&eg; red o steelblue). Defina la cadena como nula para indicar que se use el color de fondo predefinido actual.

`fgColor`

  Especifica el color de primer plano para mostrar el mensaje. El formato de la cadena es el mismo que el de `colorFondo`, o, de forma alternativa, definir la cadena como nula para indicar el color de primer plano predefinido actual.

`tipo de letra`

  Especifica el tipo de letra para mostrar el mensaje. El formato de la cadena es la salida de `QFont::toString()`. Defina la cadena como nula para que se use el tipo de letra predefinido actual para el mensaje en el momento en el que se muestre.

`audioURL`

  Especifica un archivo de audio que se va a reproducir cuando se muestre el mensaje. Defina el valor como nulo si no quiere que se reproduzca ningún archivo de audio.

`reminderMins`

  Especifica el número de minutos antes de la alarma principal y de cada una de sus repeticiones (si es que las hay) que se debe mostrar un recordatorio de la alarma. Especifique 0 si no quiere recordatorio.

`repetición`

  Especifica una repetición regular para la alarma, usando la sintaxis de iCalendar tal y como está definida en RFC2445. Por ejemplo, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaría 4 repeticiones a intervalos de 3 meses el último lunes del mes. Para una alarma sin repetición, especifique una cadena vacía.

`recurType`

  Especifica el tipo de repetición para la alarma. Los valores admisibles son MINUTELY (cada minuto), DAILY (cada día), WEEKLY (cada semana), MONTHLY (cada mes), YEARLY (cada año). Se definen en la clase `KAlarmIface` en `kalarmiface.h`. Las repeticiones mensuales son del tipo día del mes, y las anuales son del tipo fecha del año, tomando en ambos casos la fecha del parámetro `startDateTime`.

`recurInterval`

  Especifica el número de períodos (minutos/días/semanas/meses/años tal y como se especifica en `recurType`) entre repeticiones de la alarma.

`recurCount`

  Especifica el número de veces que se debe repetir la alarma. Especifique -1 para repetir la alarma indefinidamente.

`endDateTime`

  Especifica la fecha de finalización, o la fecha y la hora, para repeticiones de la alarma. Si `startDateTime` incluye una hora, este parámetro también debe incluir una hora. Si `startDateTime` sólo contiene una fecha, el parámetro también debe contener sólo una fecha. No debe contener un especificador de zona; para el valor de este parámetro se usa la misma zona horaria que para `startDateTime`.

`subRepeatInterval`

  Especifica el número de minutos entre las repeticiones individuales de la alarma. Especifique 0 para que no haya sub-repetición. Se ignora si no se especifica repetición.

`subRepeatCount`

  Especifica el número de sub-repeticiones de la alarma, incluyendo la ocurrencia inicial.

##### Descripción

`scheduleMessage()` es una llamada D-Bus para planificar que se muestre el mensaje de alarma planificado en la fecha y hora indicada. Hay tres formas. Las forma más general permite que se especifique una repetición arbitraria – úsela también para alarmas que no se repitan. Las otras formas proporcionan acceso a un juego restringido de tipos de repeticiones de la alarma, una especificando un contador de repeticiones y otra una hora de finalización.

Si la hora planificada (incluyendo cualquier repetición), ya ha pasado,&kalarm; muestra el mensaje inmediatamente (a no ser que el valor `cancelarSiTarde` indique que es demasiado tarde para mostrar la alarma, en cuyo caso &kalarm; ignora la solicitud). Si la hora planificada (o una repetición) ocurre en el futuro, &kalarm; añade el mensaje de alarma al archivo de calendario para mostrarlo más tarde.

scheduleFile

#### scheduleFile

planifica una alarma nueva que muestra los contenidos de un archivo de texto o de imagen.

    bool scheduleFile(const QString& URL,
                      const QString& startDateTime,
                      int lateCancel,
                      unsigned flags,
                      const QString& bgColor,
                      const QString& audioURL,
                      int reminderMins,
                      const QString& recurrence,
                      int subRepeatInterval,
                      int subRepeatCount)

    bool scheduleFile(const QString& URL,
                      const QString& startDateTime,
                      int lateCancel,
                      unsigned flags,
                      const QString& bgColor,
                      const QString& audioURL,
                      int reminderMins,
                      int recurType,
                      int recurInterval,
                      int recurCount)

    bool scheduleFile(const QString& URL,
                      const QString& startDateTime,
                      int lateCancel,
                      unsigned flags,
                      const QString& bgColor,
                      const QString& audioURL,
                      int reminderMins,
                      int recurType,
                      int recurInterval,
                      const QString& endDateTime)

##### Parámetros

`URL`

  Especifica el archivo de texto o de imagen cuyo contenido se va a mostrar en el mensaje planificado.

`startDateTime`

  Especifica la fecha planificada, o la fecha y la hora, en la que se deba mostrar el mensaje. Para una alarma de sólo fecha, la cadena debería tener el formato AAAA-MM-DD [TZ] (tal y como lo devuelve el método `QDate::toString(Qt::ISODate)`). Para una alarma con fecha y hora, la cadena debería tener el formato AAAA-MM-DDTHH:MM[:SS] [TZ] (tal y como lo devuelve el método `QDateTime::toString(Qt::ISODate)`) o HH:MM[:SS] [Reloj](tal y como lo devuelve el método `QTime::toString(Qt::ISODate)`). Si no se indica ninguna fecha, se usa la fecha del día actual. Tenga en cuenta que el valor de los segundos se ignora.

  Si no se especifica zona horaria, se asume la hora local del sistema. Si está presente una zona horaria TZ, debe ser el nombre de una zona horaria del sistema (&eg; `Europe/London`), `UTC` representando la zona horaria UTC o `Clock` para usar la hora local del equipo e ignorar las zonas horarias.

`cancelarSiTarde`

  Provoca que se cancele la alarma si no se puede producir en el número de minutos indicado posteriores a la hora planificada para la alarma. Si el valor es 0, la alarma no se cancelará, independientemente del retraso con el que se produzca.

`banderas`

  Especifica la O lógica de las banderas de alarma deseadas. Los bits de la bandera son los que se definen en la clase `KAlarmIface` en `kalarmiface.h`. Tenga en cuenta que no todos los bits de la bandera se aplican a las alarmas de archivos.

`bgColor`

  Especifica el color de fondo para cuando se muestre el archivo. La cadena puede tener el formato #RRGGBB (tal y como devuelve el método `QColor::name()`), donde RR, GG y BB son valores hexadecimales de dos dígitos para el rojo, el verde y el azul. Además, la cadena puede ser de cualquiera de los otros formatos que acepta `QColor::setNamedColor()`, como un nombre de la base de datos de colores de las X (&eg; red o steelblue). Defina la cadena como nula para indicar que se use el color de fondo predefinido actual.

`audioURL`

  Especifica un archivo de audio que se va a reproducir cuando se muestre el mensaje. Defina el valor como nulo si no quiere que se reproduzca ningún archivo de audio.

`reminderMins`

  Especifica el número de minutos antes de la alarma principal y de cada una de sus repeticiones (si es que las hay) que se debe mostrar un recordatorio de la alarma. Especifique 0 si no quiere recordatorio.

`repetición`

  Especifica una repetición regular para la alarma, usando la sintaxis de iCalendar tal y como está definida en RFC2445. Por ejemplo, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaría 4 repeticiones a intervalos de 3 meses el último lunes del mes. Para una alarma sin repetición, especifique una cadena vacía.

`recurType`

  Especifica el tipo de repetición para la alarma. Los valores admisibles son MINUTELY (cada minuto), DAILY (cada día), WEEKLY (cada semana), MONTHLY (cada mes), YEARLY (cada año). Se definen en la clase `KAlarmIface` en `kalarmiface.h`. Las repeticiones mensuales son del tipo día del mes, y las anuales son del tipo fecha del año, tomando en ambos casos la fecha del parámetro `startDateTime`.

`recurInterval`

  Especifica el número de períodos (minutos/días/semanas/meses/años tal y como se especifica en `recurType`) entre repeticiones de la alarma.

`recurCount`

  Especifica el número de veces que se debe repetir la alarma. Especifique -1 para repetir la alarma indefinidamente.

`endDateTime`

  Especifica la fecha de finalización, o la fecha y la hora, para repeticiones de la alarma. Si `startDateTime` incluye una hora, este parámetro también debe incluir una hora. Si `startDateTime` sólo contiene una fecha, el parámetro también debe contener sólo una fecha. No debe contener un especificador de zona; para el valor de este parámetro se usa la misma zona horaria que para `startDateTime`.

`subRepeatInterval`

  Especifica el número de minutos entre las repeticiones individuales de la alarma. Especifique 0 para que no haya sub-repetición. Se ignora si no se especifica repetición.

`subRepeatCount`

  Especifica el número de sub-repeticiones de la alarma, incluyendo la ocurrencia inicial.

##### Descripción

`scheduleFile()` es una llamada D-Bus para planificar la el archivo de texto o imagen a la fecha y hora especificada. Aparte de especificar una ruta de archivo o &URL; y de omitir el color de primer plano y el tipo de letra, su uso es idéntico a `scheduleMessage` - vea la descripción de esa función para más detalles.

scheduleCommand

#### scheduleCommand

planifica una alarma nueva que ejecuta una orden de la shell.

    bool scheduleCommand(const QString& commandLine,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         const QString& recurrence,
                         int subRepeatInterval,
                         int subRepeatCount)

    bool scheduleCommand(const QString& commandLine,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         int recurType,
                         int recurInterval,
                         int recurCount)

    bool scheduleCommand(const QString& commandLine,
                         const QString& startDateTime,
                         int lateCancel,
                         unsigned flags,
                         int recurType,
                         int recurInterval,
                         const QString& endDateTime)

##### Parámetros

`commandLine`

  Indica la orden cuya ejecución se va a planificar. El parámetro `banderas` indica si ese parámetro contiene un línea de órdenes de la shell o un guión con órdenes.

`startDateTime`

  Especifica la fecha planificada, o la fecha y la hora, en la que se deba mostrar el mensaje. Para una alarma de sólo fecha, la cadena debería tener el formato AAAA-MM-DD [TZ] (tal y como lo devuelve el método `QDate::toString(Qt::ISODate)`). Para una alarma con fecha y hora, la cadena debería tener el formato AAAA-MM-DDTHH:MM[:SS] [TZ] (tal y como lo devuelve el método `QDateTime::toString(Qt::ISODate)`) o HH:MM[:SS] [Reloj](tal y como lo devuelve el método `QTime::toString(Qt::ISODate)`). Si no se indica ninguna fecha, se usa la fecha del día actual. Tenga en cuenta que el valor de los segundos se ignora.

  Si no se especifica zona horaria, se asume la hora local del sistema. Si está presente una zona horaria TZ, debe ser el nombre de una zona horaria del sistema (&eg; `Europe/London`), `UTC` representando la zona horaria UTC o `Clock` para usar la hora local del equipo e ignorar las zonas horarias.

`cancelarSiTarde`

  Provoca que se cancele la alarma si no se puede producir en el número de minutos indicado posteriores a la hora planificada para la alarma. Si el valor es 0, la alarma no se cancelará, independientemente del retraso con el que se produzca.

`banderas`

  Especifica la O lógica de las banderas de alarma deseadas. Los bits de la bandera son los que se definen en la clase `KAlarmIface` en `kalarmiface.h`. Tenga en cuenta que no todos los bits de la bandera se pueden aplicar a las alarmas de órdenes.

`repetición`

  Especifica una repetición regular para la alarma, usando la sintaxis de iCalendar tal y como está definida en RFC2445. Por ejemplo, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaría 4 repeticiones a intervalos de 3 meses el último lunes del mes. Para una alarma sin repetición, especifique una cadena vacía.

`recurType`

  Especifica el tipo de repetición para la alarma. Los valores admisibles son MINUTELY (cada minuto), DAILY (cada día), WEEKLY (cada semana), MONTHLY (cada mes), YEARLY (cada año). Se definen en la clase `KAlarmIface` en `kalarmiface.h`. Las repeticiones mensuales son del tipo día del mes, y las anuales son del tipo fecha del año, tomando en ambos casos la fecha del parámetro `startDateTime`.

`recurInterval`

  Especifica el número de períodos (minutos/días/semanas/meses/años tal y como se especifica en `recurType`) entre repeticiones de la alarma.

`recurCount`

  Especifica el número de veces que se debe repetir la alarma. Especifique -1 para repetir la alarma indefinidamente.

`endDateTime`

  Especifica la fecha de finalización, o la fecha y la hora, para repeticiones de la alarma. Si `startDateTime` incluye una hora, este parámetro también debe incluir una hora. Si `startDateTime` sólo contiene una fecha, el parámetro también debe contener sólo una fecha. No debe contener un especificador de zona; para el valor de este parámetro se usa la misma zona horaria que para `startDateTime`.

`subRepeatInterval`

  Especifica el número de minutos entre las repeticiones individuales de la alarma. Especifique 0 para que no haya sub-repetición. Se ignora si no se especifica repetición.

`subRepeatCount`

  Especifica el número de sub-repeticiones de la alarma, incluyendo la ocurrencia inicial.

##### Descripción

`scheduleCommand()` es una llamada a D-Bus; para planificar la ejecución de la línea de órdenes de la shell o de un guión de órdenes para su ejecución en la fecha y hora indicada. Además de indicar una orden y de omitir el color del mensaje, tipo de letra y los parámetros del archivo de audio, su uso es idéntico a `scheduleMessage`. Puede ver la descripción de esa función para más detalles.

scheduleEmail

#### scheduleEmail

planifica una alarma nueva que manda un correo electrónico.

    bool scheduleEmail(const QString& fromID,
                       const QString& addresses,
                       const QString& subject,
                       const QString& message,
                       const QString& attachments,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       const QString& recurrence,
                       int subRepeatInterval,
                       int subRepeatCount)

    bool scheduleEmail(const QString& fromID,
                       const QString& addresses,
                       const QString& subject,
                       const QString& message,
                       const QString& attachments,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       int recurType,
                       int recurInterval,
                       int recurCount)

    bool scheduleEmail(const QString& fromID,
                       const QString& addresses,
                       const QString& subject,
                       const QString& message,
                       const QString& attachments,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       int recurType,
                       int recurInterval,
                       const QString& endTime)

##### Parámetros

`fromID`

  La identidad que va a usar &kmail; como remitente del correo electrónico. Si se deja vacío, la dirección de correo electrónico del remitente será la que esté configurada en las Preferencias de correo electrónico de &kalarm;.

`addresses`

  Una lista de direcciones de correo electrónico de destino, separadas por comas.

`subject`

  Especifica la línea del asunto del correo.

`mensaje`

  Especifica el cuerpo del mensaje del correo.

`attachments`

  Una lista de rutas o &URL;s de archivos para enviar como adjuntos de correo, separadas por comas.

`startDateTime`

  Especifica la fecha planificada, o la fecha y la hora, en la que se deba mostrar el mensaje. Para una alarma de sólo fecha, la cadena debería tener el formato AAAA-MM-DD [TZ] (tal y como lo devuelve el método `QDate::toString(Qt::ISODate)`). Para una alarma con fecha y hora, la cadena debería tener el formato AAAA-MM-DDTHH:MM[:SS] [TZ] (tal y como lo devuelve el método `QDateTime::toString(Qt::ISODate)`) o HH:MM[:SS] [Reloj](tal y como lo devuelve el método `QTime::toString(Qt::ISODate)`). Si no se indica ninguna fecha, se usa la fecha del día actual. Tenga en cuenta que el valor de los segundos se ignora.

  Si no se especifica zona horaria, se asume la hora local del sistema. Si está presente una zona horaria TZ, debe ser el nombre de una zona horaria del sistema (&eg; `Europe/London`), `UTC` representando la zona horaria UTC o `Clock` para usar la hora local del equipo e ignorar las zonas horarias.

`cancelarSiTarde`

  Provoca que se cancele la alarma si no se puede producir en el número de minutos indicado posteriores a la hora planificada para la alarma. Si el valor es 0, la alarma no se cancelará, independientemente del retraso con el que se produzca.

`banderas`

  Especifica la O lógica de las banderas de alarma deseadas. Los bits de la bandera son los que se definen en la clase `KAlarmIface` en `kalarmiface.h`. Tenga en cuenta que no todos los bits de la bandera se aplican a las alarmas de correo electrónico.

`repetición`

  Especifica una repetición regular para la alarma, usando la sintaxis de iCalendar tal y como está definida en RFC2445. Por ejemplo, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaría 4 repeticiones a intervalos de 3 meses el último lunes del mes. Para una alarma sin repetición, especifique una cadena vacía.

`recurType`

  Especifica el tipo de repetición para la alarma. Los valores admisibles son MINUTELY (cada minuto), DAILY (cada día), WEEKLY (cada semana), MONTHLY (cada mes), YEARLY (cada año). Se definen en la clase `KAlarmIface` en `kalarmiface.h`. Las repeticiones mensuales son del tipo día del mes, y las anuales son del tipo fecha del año, tomando en ambos casos la fecha del parámetro `startDateTime`.

`recurInterval`

  Especifica el número de períodos (minutos/días/semanas/meses/años tal y como se especifica en `recurType`) entre repeticiones de la alarma.

`recurCount`

  Especifica el número de veces que se debe repetir la alarma. Especifique -1 para repetir la alarma indefinidamente.

`endDateTime`

  Especifica la fecha de finalización, o la fecha y la hora, para repeticiones de la alarma. Si `startDateTime` incluye una hora, este parámetro también debe incluir una hora. Si `startDateTime` sólo contiene una fecha, el parámetro también debe contener sólo una fecha. No debe contener un especificador de zona; para el valor de este parámetro se usa la misma zona horaria que para `startDateTime`.

`subRepeatInterval`

  Especifica el número de minutos entre las repeticiones individuales de la alarma. Especifique 0 para que no haya sub-repetición. Se ignora si no se especifica repetición.

`subRepeatCount`

  Especifica el número de sub-repeticiones de la alarma, incluyendo la ocurrencia inicial.

##### Descripción

`scheduleEmail()` es una llamada D-bus para planificar el envío del correo a una fecha y hora especificada. Además de especificar la cabecera del correo y su contenido y omitir los parámetros de color, el tipo de letra del mensaje y el archivo de audio, su uso es idéntico a `scheduleMessage` - vea la descripción de esa función para más detalles.

scheduleAudio

#### scheduleAudio

planifica una alarma nueva que ejecuta una orden de la shell.

    bool scheduleAudio(const QString& audioURL,
                       int volumePercent,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       const QString& recurrence,
                       int subRepeatInterval,
                       int subRepeatCount)

    bool scheduleAudio(const QString& audioURL,
                       int volumePercent,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       int recurType,
                       int recurInterval,
                       int recurCount)

    bool scheduleAudio(const QString& audioURL,
                       int volumePercent,
                       const QString& startDateTime,
                       int lateCancel,
                       unsigned flags,
                       int recurType,
                       int recurInterval,
                       const QString& endDateTime)

##### Parámetros

`audioURL`

  Indica el archivo de audio que se va a reproducir.

`volumePercent`

  Especifica el nivel de volumen a utilizar, como un porcentaje sobre el volumen total. Especifique -1 para utilizar el volumen predeterminado.

`startDateTime`

  Especifica la fecha planificada, o la fecha y la hora, en la que se deba mostrar el mensaje. Para una alarma de sólo fecha, la cadena debería tener el formato AAAA-MM-DD [TZ] (tal y como lo devuelve el método `QDate::toString(Qt::ISODate)`). Para una alarma con fecha y hora, la cadena debería tener el formato AAAA-MM-DDTHH:MM[:SS] [TZ] (tal y como lo devuelve el método `QDateTime::toString(Qt::ISODate)`) o HH:MM[:SS] [Reloj](tal y como lo devuelve el método `QTime::toString(Qt::ISODate)`). Si no se indica ninguna fecha, se usa la fecha del día actual. Tenga en cuenta que el valor de los segundos se ignora.

  Si no se especifica zona horaria, se asume la hora local del sistema. Si está presente una zona horaria TZ, debe ser el nombre de una zona horaria del sistema (&eg; `Europe/London`), `UTC` representando la zona horaria UTC o `Clock` para usar la hora local del equipo e ignorar las zonas horarias.

`cancelarSiTarde`

  Provoca que se cancele la alarma si no se puede producir en el número de minutos indicado posteriores a la hora planificada para la alarma. Si el valor es 0, la alarma no se cancelará, independientemente del retraso con el que se produzca.

`banderas`

  Especifica la O lógica de las banderas de alarma deseadas. Los bits de la bandera son los que se definen en la clase `KAlarmIface` en `kalarmiface.h`. Tenga en cuenta que no todos los bits de la bandera se pueden aplicar a las alarmas de órdenes.

`repetición`

  Especifica una repetición regular para la alarma, usando la sintaxis de iCalendar tal y como está definida en RFC2445. Por ejemplo, FREQ=MONTHLY;COUNT=4;INTERVAL=3;BYDAY=-1MO especificaría 4 repeticiones a intervalos de 3 meses el último lunes del mes. Para una alarma sin repetición, especifique una cadena vacía.

`recurType`

  Especifica el tipo de repetición para la alarma. Los valores admisibles son MINUTELY (cada minuto), DAILY (cada día), WEEKLY (cada semana), MONTHLY (cada mes), YEARLY (cada año). Se definen en la clase `KAlarmIface` en `kalarmiface.h`. Las repeticiones mensuales son del tipo día del mes, y las anuales son del tipo fecha del año, tomando en ambos casos la fecha del parámetro `startDateTime`.

`recurInterval`

  Especifica el número de períodos (minutos/días/semanas/meses/años tal y como se especifica en `recurType`) entre repeticiones de la alarma.

`recurCount`

  Especifica el número de veces que se debe repetir la alarma. Especifique -1 para repetir la alarma indefinidamente.

`endDateTime`

  Especifica la fecha de finalización, o la fecha y la hora, para repeticiones de la alarma. Si `startDateTime` incluye una hora, este parámetro también debe incluir una hora. Si `startDateTime` sólo contiene una fecha, el parámetro también debe contener sólo una fecha. No debe contener un especificador de zona; para el valor de este parámetro se usa la misma zona horaria que para `startDateTime`.

`subRepeatInterval`

  Especifica el número de minutos entre las repeticiones individuales de la alarma. Especifique 0 para que no haya sub-repetición. Se ignora si no se especifica repetición.

`subRepeatCount`

  Especifica el número de sub-repeticiones de la alarma, incluyendo la ocurrencia inicial.

##### Descripción

`scheduleAudio()` es una llamada a D-Bus para programar el archivo de audio que se va a reproducir al a fecha y hora especificada. Aparte de especificar un volumen y omitir los parámetros de color y tipo de letra del mensaje, su uso es idéntico a `scheduleMessage` - vea la descripción de esa función para detalles adicionales.

edit

#### edit

Muestra el diálogo de edición de alarma para editar una alarma.

    bool edit(const QString& eventID)

##### Parámetros

`eventID`

  Indica el id. único del evento que se va a editar.

##### Valor devuelto

false si la alarma indicada no se puede encontrar o es de sólo lectura. En los demás casos, devuelve true.

##### Descripción

`edit()` es una llamada D-Bus para mostrar el diálogo de edición de alarma para editar la alarma indicada.

editNew

#### editNew

Muestra el diálogo de edición de alarma para editar una alarma nueva.

    bool editNew(int type)

    bool editNew(const QString& templateName)

##### Parámetros

`type`

  Especifica el tipo de alarma. Los valores permitidos son DISPLAY, COMMAND, EMAIL, AUDIO. Están definidos en la clase `KAlarmIface` in `kalarmiface.h`.

`templateName`

  Indica el nombre de una plantilla de alarma que se debe tomar como base para la nueva alarma.

##### Valor devuelto

false si `type` contiene un valor no válido, o si no se puede encontrar una plantilla de nombre `templateName`; true en otro caso.

##### Descripción

`editNew()` es una llamada D-Bus para mostrar el Diálogo de edición de alarma para editar una alarma nueva. Si se especifica como parámetro un tipo de alarma, se visualiza un diálogo en blanco. Alternativamente, si se especifica como parámetro un nombre de plantilla de alarma, el diálogo se inicializa con los valores de la plantilla.

### Interfaz de la línea de órdenes

Las opciones de la línea de órdenes se proporcionan para hacer posible que otros programas lancen &kalarm;, si es que no está corriendo ya, para lanzar o cancelar las alarmas planificadas, o para planificar alarmas nuevas. La razón para usar estas opciones de la línea de órdenes para este propósito es que si &kalarm; se iniciara sin ningún parámetro en la línea de órdenes y luego enviaba peticiones D-Bus, se iniciaría en modo gráfico predeterminado, lo que no es muy deseable para peticiones internas del programa.

Los programas deberían comprobar primero si &kalarm; ya está corriendo; si es así, deberían intentar usar llamadas D-Bus; para solicitar estas operaciones.

Las opciones de la línea de órdenes que se usan para planificar una alarma nueva se describen en el capítulo Operación en línea de órdenes. Las opciones para lanzar y cancelar alarmas planificadas son las siguientes:

Los usuarios normales también deberían usar si quieren estas opciones de la línea de órdenes (asumiendo que puedan proporcionar la información necesaria de los parámetros).

Opción | Descripción
--- | ---
`--cancelEvent eventID` | Cancelar la alarma con el id de evento especificado. `--triggerEvent` no puede especificarse con esta opción.
`--triggerEvent eventID` | Lanza la alarma con el identificador de evento indicado. La acción realizada es la misma que en la llamada D-Bus triggerEvent(). No se puede especificar un `--cancelEvent` con esta opción.

Ejemplos:

    % kalarm --triggerEvent &kalarm;-387486299.702
    % kalarm --cancelEvent &kalarm;-388886299.793

## Preguntas y respuestas

&reporting.bugs; &updating.documentation;

¿Qué archivos de configuración usa &kalarm;?

El archivo `$KDEHOME/share/config/kalarmrc` mantiene sus preferencias de &kalarm;.

El archivo `$KDEHOME/share/config/kresources/alarms/stdrc` mantiene su configuración del calendario de alarmas.

($`KDEHOME` suele ser `~/.kde` o similar.)

¿Dónde almacena &kalarm; las alarmas?

Los nombres de los archivos de calendario que crea &kalarm; la primera vez que se ejecuta son los siguientes (pero pueden ser anulados por las entradas en la sección `General` del archivo de preferencias de &kalarm;):

- `$KDEHOME/share/apps/kalarm/calendar.ics` almacena las alarmas activas (se puede sobreescribir en la entrada `Calendario`).

- `$KDEHOME/share/apps/kalarm/expired.ics` mantiene alarmas archivadas (anulable por la entrada `ExpiredCalendar`).

- `$KDEHOME/share/apps/kalarm/template.ics` contiene plantillas de alarma (anulable por la entrada `TemplateCalendar`).

Usted puede encontrar que archivos de calendario se encuentran en uso viendo los detalles de cada calendario en la lista de calendarios de alarma. Los nombres de archivo se almacenan leen el archivo de configuración del calendario de alarmas.

Los detalles de las alarmas que se están mostrando actualmente se guardan en el archivo de calendario `$KDEHOME/share/apps/kalarm/displaying.ics`.

¿En qué formato se guardan las alarmas?

Los archivos de calendario en los que &kalarm; se almacena son archivos de texto cuyo formato está definido en el documento RFC2445 - Internet Calendaring and Scheduling Core Object Specification (iCalendar). Este es el formato estándar utilizado por todas las aplicaciones de kdepim. &kalarm; emplea ciertas propiedades no estándar, en cumplimiento con RFC2445. en el componente VEVENT: `X-KDE-KALARM-FLAGS`, `X-KDE-KALARM-NEXTRECUR`, `X-KDE-KALARM-REPEAT`, `X-KDE-KALARM-ARCHIVE`, `X-KDE-KALARM-LOG`, y en el componente VALARM `X-KDE-KALARM-TYPE`, `X-KDE-KALARM-NEXTREPEAT`, `X-KDE-KALARM-FONTCOLOR`, `X-KDE-KALARM-VOLUME`, `X-KDE-KALARM-SPEAK`, `X-KDE-KALARM-EMAILID`.

¿Qué es el programa kalarmautostart?

kalarmautostart es un pequeño programa de ayuda cuya función es auto arrancar &kalarm; en el inicio de sesión.

&kalarm; se restaura generalmente por el gestor de sesiones al iniciar sesión (para volver a mostrar sus ventanas en el mismo estado en que se dejaron al cerrar sesión). Pero si no se estaba ejecutando cuando usted cerró sesión, no lo iniciará el gestor de sesiones y por lo tanto necesita ser arrancado. Este problema es tal que cuando una aplicación se arranca tanto por el gestor de sesiones como auto iniciada, no hay garantía de lo que ocurrirá primero. Si el auto arranque se produce primero, evitará que el gestor de sesiones pueda restaurar el estado de la aplicación.

Para evitar este problema kalarmautostart se arranca al inicio de sesión en lugar de &kalarm;.. Todo lo que hace es esperar un rato (para asegurarse de que el gestor de sesiones tiene tiempo de hacer su trabajo) antes de iniciar &kalarm; momento en el que termina.

## Créditos y licencia

&kalarm;

Copyright del programa 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 &David.Jarvie; &David.Jarvie.mail;

Copyright de la documentación 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009 &David.Jarvie; &David.Jarvie.mail;

Traductores: Juan Manuel García Molina juanma@superiodico.net y Javier Viñal fjvinal@gmail.com.

&underFDL; &underGPL;

Gracias al autor de la aplicación KAlarm de &kde; 1, Stefan Nikolaus stefan.nikolaus@stuco.uni-oldenburg.de, que accedió amablemente a permitir el uso del nombre &kalarm; para esta aplicación de &kde; 2 en adelante.

## Instalación

### Cómo obtener &kalarm;

&install.intro.documentation;

&kalarm; está disponible para &kde; 2 y como un paquete individual para &kde; 3 en http://www.astrojar.org.uk/linux/kalarm.html

### Requisitos

&kalarm; precisa que las bibliotecas estándar de &kde; estén instaladas (lospaquetes `kdelibs` y `kdepimlibs`), mas el paquete `kdebase/runtime`. Para compilar desde los fuentes, también necesitará los paquetes de desarrollo importantes y el paquete de desarrollo de &Qt;.

Los siguientes paquetes opcionales aumentan las prestaciones de &kalarm; si están instalados:

- KTTSD (del paquete kdeaccessibility): si está instalado y configurado, junto con un paquete de síntesis de voz compatible, permite que &kalarm; lea los mensajes de alarma cuando se muestren.

&kalarm; usa sobre 12 Mb de memoria para ejecutarse, pero esto puede variar según su plataforma y configuración.

Puede encontrar una lista de cambios en el archivo `ChangeLog`, o en http://www.astrojar.org.uk/kalarm.

### Compilación e instalación

Si no puede obtener un paquete binario precompilado adecuado, tendrá que compilar &kalarm; desde los archivos fuente. Obtenga el archivo del paquete fuente `kdepim-x.x.tar.bz2` o `kalarm-x.x.tar.bz2` (o similar), según quiera instalar el &package; o simplemente &kalarm;. Desempaquételo en un directorio nuevo usando una orden parecida a ``tar` `xvfj paquete.tar.bz2``, y vaya a la carpeta que se ha creado.

&install.compile.documentation;

Si tiene más de una versión de &kde; instalada (por ejemplo, &kde; 2 y &kde; 3), puede ser posible que instale &kalarm; en la carpeta equivocada de &kde;. Si fuera necesario, puede pasar la carpeta de &kde; como parámetro a ``./configure``. Por ejemplo, si su &kde; está instalado en `/opt/kde2`:

``./configure` --prefix=/opt/kde2`

Si instala &kalarm; en una carpeta diferente a la carpeta en la que está instalado &kde;, no funcionará correctamente a no ser que indique esta ubicación a &kde;. Para hacerlo, debe anteceder la variable de entorno `KDEDIRS` con la ubicación de &kalarm; cada vez que inicie &kde;.

Por ejemplo, si &kde; está instalado en `/opt/kde`, `KDEDIRS` suele estar definido como `/etc/opt/kde:/opt/kde`. Si instala &kalarm; en `/usr/local`, tendría que definir `KDEDIRS` como `/usr/local:/etc/opt/kde:/opt/kde` antes de iniciar &kde;.

Las versiones independientes de &kalarm; tienen una opción de configuración especial, que permite seleccionar qué idiomas de la documentación se van a instalar, indicando el código del idioma o una lista de códigos de idiomas como parámetro a `./configure`. De forma predefinida, se instala la documentación en todos los idiomas disponibles. En el paquete se incluye una lista de los idiomas de la documentación, así como sus códigos, en el archivo `DOC-LANGUAGES`. Por ejemplo, para instalar la documentación sólo en castellano y en inglés británico:

``./configure` --enable-doc-language="es en_GB"`

Tenga en cuenta que esta opción no tiene efecto sobre el interfaz de usuario en el que se han instalado las traducciones.

### Configuración

No se necesita una configuración especial para configurar &kalarm; para que funcione con el escritorio &kde;. Una vez que haya lanzado &kalarm; por vez primera, comenzará cada vez que inicie sesión, para monitorizar las alarmas planificadas.

Para lanzar &kalarm; en un escritorio que no sea &kde;, el principal requisito es asegurar que &kalarm; se ejecuta automáticamente cuando inicia sesión. Puede consultar instrucciones más detalladas en el archivo `INSTALL` que se distribuye con &kalarm;.

&documentation.index;