From d244be12f60ae850c3ed1908f604c594598ef53d Mon Sep 17 00:00:00 2001
From: Frederic Culot <calcurse@culot.org>
Date: Sat, 9 Sep 2006 20:29:19 +0000
Subject: Spanish manual provided by Jose Lopez. Many thanks to him
---
doc/manual_es.html | 748 +++++++++++++++++++++++++++++++++++++++++++++++++++++
1 file changed, 748 insertions(+)
create mode 100755 doc/manual_es.html
(limited to 'doc/manual_es.html')
diff --git a/doc/manual_es.html b/doc/manual_es.html
new file mode 100755
index 0000000..79a38bb
--- /dev/null
+++ b/doc/manual_es.html
@@ -0,0 +1,748 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<!--
+/*
+ * $calcurse: manual_es.html,v 1.1 2006/09/09 20:29:19 culot Exp $
+ *
+ * Calcurse - text-based organizer
+ * Copyright (c) 2004-2006 Frederic Culot
+ *
+ * This program is free software; you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program; if not, write to the Free Software
+ * Foundation, Inc., 59 Temple Place - Suite 330,
+ * Boston, MA 02111-1307, USA.
+ *
+ * Send your feedback or comments to : calcurse@culot.org
+ * Calcurse home page : http://culot.org/calcurse
+ *
+ */
+-->
+
+<html>
+<head>
+<title>CALCURSE documentaci�n</title>
+<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
+</head>
+<body bgcolor="white" text="black" link="blue" vlink="navy">
+
+<h1><code>CALCURSE - organizador basado en modo texto</code></h1>
+<p>
+<p><hr><p>
+
+<h1>Tabla de Contenidos</h1>
+<ul>
+<li><a href="#intro">Introducci�n</a>
+<li><a href="#overview">Descripci�n</a>
+<ul>
+<li><a href="#overview_history">Historia</a>
+<li><a href="#overview_features">Caracter�sticas importantes</a>
+</ul>
+<li><a href="#install">Instalaci�n</a>
+<ul>
+<li><a href="#install_requirements">Requerimientos</a>
+<ul><li><a href="#install_requirements_ncurses">librer�a <code>ncurses</code></a>
+<li><a href="#install_requirements_gettext">librer�a <code>gettext</code></a>
+</ul>
+<li><a href="#install_process">Proceso de instalaci�n</a>
+</ul>
+<li><a href="#basics"><code>calcurse</code> b�sicos</a>
+<ul>
+<li><a href="#basics_invocation">Invocaci�n</a>
+<ul>
+<li><a href="#basics_invocation_commandline">Argumentos de la linea de comandos</a>
+<li><a href="#basics_invocation_variable">Variable de entorno para i18n</a>
+</ul>
+<li><a href="#basics_interface">Interfaz de usuario</a>
+<ul>
+<li><a href="#basics_interface_noninteractive">Modo no-interactivo</a>
+<li><a href="#basics_interface_interactive">Modo interactivo</a>
+</ul>
+<li><a href="#basics_files">Archivos de <code>calcurse</code></a>
+<li><a href="#basics_help">Ayuda en linea</a>
+</ul>
+<li><a href="#options">Opciones</a>
+<ul>
+<li><a href="#options_general">Opciones generales</a>
+<li><a href="#options_colors">Color (temas)</a>
+<li><a href="#options_layout">Configuraci�n de la disposici�n</a>
+</ul>
+<li><a href="#known_bugs">Bugs conocidos</a>
+<li><a href="#bugs">Informar de bugs y comentarios</a>
+<li><a href="#contribute">�Como contribuir?</a>
+<ul>
+<li><a href="#contribute_documentation">Traduciendo la documentaci�n</a>
+<li><a href="#contribute_i18n"><code>calcurse</code> i18n</a>
+<ul>
+<li><a href="#contribute_i18n_overview">Descripci�n</a>
+<li><a href="#contribute_i18n_translator">Tareas del traductor</a>
+<li><a href="#contribute_i18n_po-files">Archivos-po</a>
+</ul>
+</ul>
+<li><a href="#links">Enlaces</a>
+<ul>
+<li><a href="#links_homepage">Pagina web de <code>calcurse</code></a>
+<li><a href="#links_list">Lista de anuncios de <code>calcurse</code></a>
+</ul>
+<li><a href="#thanks">Gracias a ...</a>
+</ul>
+<p><hr><p>
+
+
+<a name="intro"></a><h1>Introducci�n</a></h1>
+<p>
+ <code>calcurse</code> es un organizador personal que te
+ ayuda a mantener un seguimiento de tus eventos y tareas diarias.
+ Contiene un calendario, una lista de tareas pendientes (ToDo) y mantiene
+ tus citas de forma ordenada. La interfaz de usuario es
+ configurable y puedes elegir entre diferentes esquemas de
+ color y disposiciones. Todos los comandos est�n documentados a
+ trav�s de un sistema de ayuda en linea.
+
+
+<a name="overview"></a><h1>Descripci�n</h1>
+<a name="overview_history"></a><h2>Historia</h2>
+<p>
+ Comenc� a pensar en este proyecto cuando estaba acabando mi doctorado
+ en Astrof�sica... Empezaba a ser un poco complicado el organizarme
+ y realmente necesitaba una buena herramienta que me ayudase
+ en esa dif�cil tarea ;-)<br>
+ Me gustan los programas que utilizan las interfaces de
+ usuario en modo texto porque son simples, r�pidos y
+ eficientes, por eso pens� en programar un calendario simple en
+ ese tipo de interfaz. Por otra parte, esperaba aprender el
+ lenguaje <code>C</code> que hab�a utilizado solo a ratos
+ durante mi �poca de estudiante. Por eso pens� que pod�a ser un
+ buen proyecto para empezar a estar organizado y � aprender algunas
+ cosas sobre <code>C</code> ! Por desgracia acabe mi doctorado antes de
+ acabar <code>calcurse</code>, pero de todas formas aun quer�a
+ trabajar en el y esperaba que pudiese ser de ayuda a otra gente.
+ Y aqu� esta...<br><br>
+ Pero �por que 'calcurse'? Bien, es simplemente una concatenaci�n
+ de CALendar y nCURSEs, el nombre de la librer�a utilizada para
+ construir la interfaz de usuario.
+
+
+
+
+<a name="overview_features"></a><h2>Caracter�sticas importantes</h2>
+<p>
+ <code>Calcurse</code> es multi-plataforma e intenta ser ligero,
+ r�pido y fiable. Esta hecho para ser usado en consola o terminal,
+ tanto en local como en una maquina remota a trav�s de ssh o una
+ conexi�n similar.<br>
+ <code>Calcurse</code> puede funcionar de dos modos diferentes :
+ modo interactivo o no-interactivo. El primero permite a un usuario
+ ver su organizador en casi cualquier maquina gracias a la interfaz
+ basada en modo texto. El segundo modo permite crear recordatorios
+ de una forma muy f�cil, �nicamente a�adiendo <code>calcurse</code>,
+ con los argumentos apropiados en la linea de comando, en el crontab
+ o mediante un sell init script.<br>
+ Por otra parte, <code>calcurse</code> fue creado pensando en el usuario
+ final y trata de ser lo mas amigable posible. Esto significa un
+ completo sistema de ayuda en linea, conjuntamente con tener todas
+ las posibles acciones visualizadas en todo momento en la barra de
+ estado. La interfaz de usuario tambi�n es configurable y uno puede
+ elegir entre combinaciones de colores y disposiciones.
+
+
+
+<a name="install"></a><h1>Instalaci�n</h1>
+<a name="install_requirements"></a><h2>Requerimientos</h2>
+<a name="install_requirements_ncurses"></a><h3>librer�a <code>ncurses</code></h3>
+<p>
+ <code>Calcurse</code> requiere solo un compilador <code>C</code>, como
+ <code>cc</code> o <code>gcc</code>, y la librer�a <code>ncurses</code>.
+ Ser�a muy sorprendente no tener una librer�a <code>ncurses</code>
+ valida ya instalada en tu ordenador, pero si no la tienes, puedes
+ encontrarla en la siguiente direcci�n :<br>
+ <pre>
+ http://ftp.gnu.org/pub/gnu/ncurses/
+ </pre>
+
+<a name="install_requirements_gettext"></a><h3>librer�a <code>gettext</code></h3>
+<p>
+ <code>calcurse</code> soporta internacionalizaci�n
+ ( de aqu� en adelante <em>i18n</em>) con las
+ utilidades <code>gettext</code>.
+ Esto significa que <code>calcurse</code> puede producir
+ mensajes en diferentes lenguas si esta compilado con el soporte
+ para lengua nativa (p.e. <em>NLS</em>). Por otra parte,
+ <em>NLS</em> es opcional, si tu no quieres tener soporte
+ para esta caracter�stica, basta con que utilices la opci�n <code>--disable-nls</code>
+ en el comando <code>configure</code> (ver la secci�n <a
+ href="#install_process">Proceso de instalaci�n</a>). <br>
+ Para comprobar si las utilidades <code>gettext</code> est�n
+ instaladas en tu sistema, puedes buscar el archivo cabecera
+ <code>libintl.h</code>, por ejemplo :
+ <pre>
+ locate libintl.h
+ </pre>
+ Si este archivo cabecera no se encuentra, entonces puedes obtener
+ las fuentes de <code>gettext</code> en la siguiente direcci�n :<br>
+ <pre>
+ http://ftp.gnu.org/pub/gnu/gettext/
+ </pre>
+ <u>Nota:</u> Incluso si <code>libintl.h</code> se encuentra en tu
+ sistema, puede ser necesario especificar su localizaci�n durante el <a
+ href="#install_process">proceso de instalaci�n</a>, utilizando la opci�n
+ <code>--with-libintl-prefix</code> en el comando
+ <code>configure</code>. De hecho, el comando <code>configure</code>
+ puede fallar al tratar de localizar esta librer�a si esta instalada en
+ un lugar infrecuente.
+
+
+<a name="install_process"></a><h2>Proceso de instalaci�n</h2>
+<p>
+ Primero necesitas descomprimir ( gunzip y untar) el archivo fuente:
+ <pre>
+ tar zxvf calcurse-1.5.tar.gz
+ </pre>
+ Una vez has resuelto los requisitos y has extra�do el archivo,
+ el proceso de instalaci�n es muy simple y sigue los tres pasos habituales:
+ <OL>
+ <li><code>./configure</code>
+ <li><code>make</code>
+ <li><code>make install</code> (puede requerir privilegios de administrador)
+ </OL>
+ Utiliza <code>./configure --help</code> para obtener una lista de posibles
+ opciones.
+
+
+<a name="basics"></a><h1><code>calcurse</code> b�sicos</h1>
+<a name="basics_invocation"></a><h2>Invocaci�n (arranque del programa)</h2>
+<a name="basics_invocation_commandline"></a><h3>Argumentos de la linea de comando</h3>
+<p>
+ <code>calcurse</code> acepta las siguientes opciones en la
+ linea de comando:
+
+ <dl compact>
+ <dt><code>-a</code>
+ <dd>
+ Imprime las citas y eventos para el d�a actual y sale.<br>
+ <u>Nota:</u> el calendario desde donde leer�n
+ puede ser especificado usando la opci�n '-c' .<br>
+ <br>
+ <dt><code>-c</code>
+ <dd>
+ Especifica el archivo de calendario a usar.<br>
+ El calendario por defecto es <code>~/.calcurse/apts</code>
+ (ver la secci�n <a href="#basics_files">Archivos de <code>calcurse</code></a>).<br>
+ <br>
+ <dt><code>-d</code>
+ <dd>
+ Imprime las citas y eventos para la fecha dada o para el numero dado de d�as
+ pr�ximos, dependiendo del formato del argumento.
+ Soporta dos posible formatos :
+ <ul>
+ <li>una fecha en la siguiente forma 'mm/dd/aaaa' (d�a/mes/a�o).
+ <li>un numero 'n'.
+ </ul>
+ En el primer caso, devolver� la lista de citas y eventos para la fecha especificada
+ mientras que en el segundo caso devolver� la lista de citas y eventos
+ para los 'n' pr�ximos d�as.<br>
+ Por ejemplo, tecleando <code>calcurse -d 3</code>
+ mostrara tus citas y eventos para hoy, ma�ana y pasado ma�ana.<br>
+ <u>Nota:</u>al igual que para la opci�n '-a' , el calendario desde donde se
+ leer�n puede ser especificado usando la opci�n '-c' .<br>
+ <br>
+ <dt><code>-h</code>
+ <dd>
+ Imprime un breve texto de ayuda describiendo las opciones soportadas en la
+ linea de comando y sale.<br>
+ <br>
+ <dt><code>-t</code>
+ <dd>
+ Imprime la lista de tareas pendientes ('ToDo') y sale.<br>
+ <br>
+ <dt><code>-v</code>
+ <dd>
+ Muestra la versi�n de <code>calcurse</code> y sale.
+ </DL>
+
+<a name="basics_invocation_variable"></a><h3>Variable de entorno para i18n</h3>
+<p>
+ <code>calcurse</code> puede ser compilado son soporte para lenguaje
+ nativo (ver <a href="#install_requirements_gettext">librer�a <code>gettext</code>
+ </a>). As�, si quieres ver los mensajes en tu lengua nativa, primero comprueba
+ que esta disponible mirando en el fichero <code>po/LINGUAS</code>.
+ Este fichero indica la lista de lenguas disponibles mostrando el c�digo de dos
+ letras correspondiente (por ejemplo, <em>fr</em> ser�a para franc�s).
+ Si no encuentras tu lengua, tu ayuda seria muy apreciada si pudieses traducir
+ <code>calcurse</code> (ver la secci�n <a href="#contribute">�Como puedo ayudar?</a>.<br>
+ Si tu lengua esta disponible, arranca <code>calcurse</code> con el siguiente comando:
+ <pre>
+ LC_ALL=fr_FR calcurse
+ </pre>
+ donde <em>fr_FR</em> es el nombre locale en este ejemplo, pero puede ser remplazado
+ por el locale correspondiente a la lengua deseada.
+
+<a name="basics_interface"></a><h2>Interfaz de usuario</h2>
+<a name="basics_interface_noninteractive"></a><h3>Modo no-interactivo</h3>
+<p>
+ Cuando es llamado por lo menos con uno de los siguientes argumentos:<br>
+ <code>-a</code>, <code>-d</code>, <code>-t</code>,
+ <code>-h</code>, <code>-v</code><br>
+ <code>calcurse</code> arranca en modo no-interactivo.
+ Esto significa que se mostrara la informaci�n deseada, y
+ despu�s de esto, <code>calcurse</code> simplemente se cierra y eres
+ de nuevo devuelto al prompt del shell.<br>
+ De esta forma, uno puede a�adir una linea como <code>'calcurse -ta'</code>
+ en el archivo de inicializaci�n de su entorno gr�fico (X o consola) para ver,
+ cuando entras en el sistema; la lista de tareas, citas y eventos programadas para el d�a actual.
+
+
+
+<a name="basics_interface_interactive"></a><h3>Modo interactivo</h3>
+<p>
+ Cuando es llamado sin ning�n argumento o solo con la opci�n
+ <code>-c</code>, <code>calcurse</code> arranca en modo interactivo.
+ En este modo, se muestra una interfaz conteniendo tres
+ paneles diferentes por los cuales puedes navegar usando la tecla
+ 'TAB' (tabulador), mas una barra de estado (ver la figura de abajo).
+ <pre>
+
+ panel de citas y eventos ---. .--- panel de calendario
+ | |
+ v v
+ +------------------------------------++----------------------------+
+ | Citas y eventos || Calendario |
+ |------------------------------------||----------------------------|
+ | Abril 6, 2006 || Abril 2006 |
+ | ||Lun Mar Mie Jue Vie Sab Dom |
+ | || 1 2 |
+ | || 3 4 5 6 7 8 9 |
+ | || 10 11 12 13 14 15 16 |
+ | || 17 18 19 20 21 22 23 |
+ | || 24 25 26 27 28 29 30 |
+ | || |
+ | |+----------------------------+
+ | |+----------------------------+
+ | || Tareas Pendientes |
+ | ||----------------------------| panel de tareas pendientes
+ | || | |
+ | || | |
+ | || |<--.
+ | || |
+ | || |
+ | || |
+ +------------------------------------++----------------------------+
+ | ? Ayuda R Redibujar H/L -/+1 Dia G Ir a C Config |
+ | Q Salir S Guardar J/K -/+1 Semana Tab Cabiar vista |<-.
+ +------------------------------------------------------------------+ |
+ |
+ barra de estado
+
+ </pre>
+ El primer panel representa un calendario que permite iluminar un
+ d�a en particular, el segundo contiene la lista de citas y eventos
+ pertenecientes a ese d�a, y el ultimo contiene una lista
+ de tareas pendientes (ToDo) pero que no est�n asignadas a ning�n d�a especifico.
+ En la parte inferior de la pantalla hay una barra de estado, que
+ indica las posibles acciones y sus correspondientes atajos de teclado.
+
+
+<a name="basics_files"></a><h2>Archivos de <code>calcurse</code></h2>
+<p>
+ La siguiente estructura se crea en tu directorio <code>$HOME</code>
+ la primera vez que se ejecuta <code>calcurse</code> :
+ <pre>
+ $HOME/.calcurse/
+ |___conf
+ |___apts
+ |___todo
+ </pre>
+ El archivo <em>conf</em> contiene la configuraci�n del usuario.<br>
+ El archivo <em>apts</em> contiene todos los eventos y citas del usuario.<br>
+ El archivo <em>todo</em> contiene la lista de tareas pendientes.
+
+
+<a name="basics_help"></a><h2>Ayuda en linea</h2>
+<p>
+ En cualquier momento, puedes consultar el sistema de ayuda integrado
+ presionando la tecla '?'. Una vez en la pantalla de ayuda,
+ puedes acceder a la informaci�n acerca de un comando especifico presionando
+ la tecla correspondiente a ese comando.
+
+<a name="options"></a><h1>Opciones</h1>
+<p>
+ Todos los par�metros de <code>calcurse</code> se peden configurar desde
+ el men� de Configuraci�n disponible pulsando 'C'. Entonces aparecer� un
+ submenu con tres posibilidades :
+ pulsando 'C' de nuevo, te lleva a la configuraci�n del esquema de colores.
+ Pulsando 'L' te permite elegir la disposici�n de la pantalla principal
+ de <code>calcurse</code> (en otras palabras, donde colocar los tres diferentes
+ paneles en pantalla), y finalmente puedes elegir entre diferentes opciones
+ generales pulsando 'G'.
+
+<a name="options_general"></a><h2>Opciones generales</h2>
+<p>
+ Estas opciones controlan el comportamiento general en la forma
+ que se describe a continuaci�n:
+ <ul>
+ <li><code>auto_guardar</code> (por defecto: <em>si</em>)<br>
+ Esta opci�n permite salvar autom�ticamente los datos del usuario
+ (si esta fijada en <em>si</em>) cuando se sale del programa.<br>
+ <em>Aviso:</em> Los datos no ser�n guardados autom�ticamente si
+ <code>auto_guardar</code> esta fijada en <em>no</em>. Esto significa que
+ el usuario debe pulsar 'S' (guardar) para guardar sus modificaciones
+ antes de salir.<br>
+ <br>
+ <li><code>confirmar_salir</code> (por defecto: <em>si</em>)<br>
+ Si se fija en <em>si</em>, se requerir� confirmaci�n antes de salir,
+ de otra forma cuando se pulse 'Q' causara que <code>calcurse</code>
+ se cierre sin esperar confirmaci�n del usuario.<br>
+ <br>
+ <li><code>confirmar_borrar</code> (por defecto: <em>si</em>)<br>
+ Si se fija esta opci�n en <em>si</em>, cuando se pulse 'D' para
+ borrar una anotaci�n (bien sea un <em>ToDo
+ (tarea pendiente)</em>, <em>cita</em>,
+ o <em>evento</em>), se requerir� confirmaci�n del usuario antes de borrar
+ de la lista la anotaci�n seleccionada.
+ De otra forma, no ser� necesaria confirmaci�n antes de borrar la anotaci�n.<br>
+ <br>
+ <li><code>saltar_dialogos_sistema</code> (por defecto: <em>no</em>)<br>
+ Fijando esta opci�n en <em>si</em> causar� la omisi�n de los di�logos
+ del sistema relativos al guardado y carga de los datos.
+ Esto puede ser �til para acelerar los procesos de entrada y salida al programa.<br>
+ <br>
+ <li><code>saltar_barra_progreso</code> (por defecto: <em>no</em>)<br>
+ Si se fija en <em>si</em>, ocasionara la desaparici�n de la barra de progreso
+ que normalmente se muestra cuando se salvan datos a un archivo.
+ Si esta fijada en <em>no</em>, se mostrar� esta barra, conjuntamente con
+ el nombre del archivo que se esta guardando
+ (ver secci�n <a href="#basics_files">Archivos de <code>calcurse</code></a>).<br>
+ <br>
+ <li><code>empezar_semana_en_lunes</code> (por defecto: <em>si</em>)<br>
+ Uno puede elegir entre el Lunes o el Domingo como primer d�a de la semana.
+ Si la opci�n <em>empezar_semana_en_lunes</em> esta fijada en
+ <em>si</em>, el Lunes ser� el primer d�a de la semana en la vista del calendario.
+ Por el contrario, si esta opci�n esta fijada en <em>no</em>, entonces el Domingo
+ ser� el primer d�a de la semana.
+ </ul>
+
+
+<a name="options_colors"></a><h2>Color (temas)</h2>
+<p>
+ El tema de color de <code>calcurse</code> es configurable
+ y puede elegirse tecleando el numero correspondiente al tema deseado.
+ Este color puede entonces ser aplicado a los bordes del panel,
+ a los t�tulos, a los atajos de teclado, y a las informaciones generales
+ mostradas en el interior de la barra de estado. Tambi�n esta disponible
+ un tema en blanco y negro para los terminales que no soportan colores.<br>
+ <u>Notas:</u>
+ <ul>
+ <li> Dependiendo de tu tipo de terminal y del valor de la variable de
+ entorno <code>$TERM</code>, color puede no estar soportado.
+ En ese caso, si intentas cambiar los colores aparecer� un mensaje de error
+ puesto que tu terminal no soporta esta caracter�stica.<br>
+ <br>
+ <li> Si sabes que tu terminal soporta colores pero no puedes conseguir
+ que <code>calcurse</code> los muestre, intenta fijar tu variable <code>$TERM</code>
+ a otro valor. (como por ejemplo <em>xterm-xfree86</em>).
+ </ul>
+
+
+<a name="options_layout"></a><h2>Configuraci�n de la disposici�n</h2>
+<p>
+ La disposici�n corresponde a la posici�n de los paneles
+ dentro de la pantalla de <code>calcurse</code>. La disposici�n por defecto
+ hace que el calendario se muestre en la esquina superior derecha
+ del terminal, el panel de 'ToDo' (tareas pendientes) en la esquina inferior
+ derecha, mientras que el panel de citas se muestra en la parte izquierda
+ de la pantalla (ver la figura de la secci�n <a href="#basics_interface_interactive">Modo interactivo</a>
+ como ejemplo de la disposici�n por defecto).<br>
+ Eligiendo otra disposici�n en la pantalla de configuraci�n, el usuario puede
+ modificar la apariencia de <code>calcurse</code> que mejor se adapte a sus
+ necesidades colocando los diferentes paneles donde los necesite.
+
+
+<a name="known_bugs"></a><h1>Bugs conocidos</h1>
+<p>
+ Aparece una incorrecta iluminaci�n de las anotaciones cuando se usa el tema
+ calcurse blanco y negro conjuntamente con la variable <code>$TERM</code>
+ fijada a <em>xterm-color</em>.
+ Para solucionar este bug, y tal como fue anunciado por Thomas E. Dickey
+ (que mantiene <code>xterm</code>), <em>xterm-xfree86</em>
+ puede ser usado en vez de <em>xterm-color</em> para fijar la variable <code>$TERM</code><br>
+ <blockquote>
+ "The xterm-color value for $TERM is a bad choice for XFree86 xterm
+ because it is commonly used for a terminfo entry which happens to
+ not support bce. Use the xterm-xfree86 entry which is distributed
+ with XFree86 xterm (or the similar one distributed with ncurses)."
+ </blockquote>
+
+<a name="bugs"></a><h1>Informar de bugs y comentarios</h1>
+<p>
+ Por favor env�a los informes de bugs y tus comentarios a :
+ <pre>
+ calcurse@culot.org
+ </pre>
+ o al autor:
+ <pre>
+ frederic@culot.org
+ </pre>
+
+<a name="contribute"></a><h1>�Como contribuir?</h1>
+<p>
+ Si te gustar�a contribuir al proyecto, puedes enviar tus comentarios
+ acerca de lo que te gusta o no te gusta, y si hay alguna
+ funcionalidad que echas de menos en <code>calcurse</code>.
+ Por ahora, las posibles contribuciones est�n limitadas a la traducci�n
+ de la documentaci�n y mensajes de error de <code>calcurse</code>. <br>
+ <br>
+ <u>Nota:</u> Cualquier ayuda para la internacionalizaci�n de <code>calcurse</code>
+ ser� muy bienvenida, pero antes de contribuir env�a en email a :
+ <code>calcurse-i18n@culot.org</code> para saber si alguien ha empezado ya
+ el proceso de traducci�n a tu lengua.
+
+<a name="contribute_documentation"></a><h2>Traduciendo la documentaci�n</h2>
+<p>
+ El directorio <em>doc/</em> del paquete fuente ya contiene versiones traducidas
+ del manual de <code>calcurse</code>. Aunque si el manual no esta aun disponible
+ en tu lengua nativa, ser�a de gran ayuda si tu pudieses traducirlo.<br>
+ Para hacerlo, �nicamente copia uno de los archivos de los manuales existentes
+ de <code>manual_XX.html</code>, donde <em>XX</em> identifica tu lengua. Entonces
+ traduce este nuevo archivo creado y env�a un email al autor (ver <a href="#bugs">Informar
+ de bugs y comentarios</a>), para que pueda ser incluido en la nueva edici�n de <code>calcurse</code>.
+
+<a name="contribute_i18n"></a><h2><code>calcurse</code> i18n</h2>
+<p>
+ Como ya se ha mencionado, las utilidades de <code>gettext</code> son usadas
+ por <code>calcurse</code> para producir mensajes en diferentes lenguas.
+ Esta secci�n proporciona informaci�n acerca de como traducir estos mensajes
+ a tu lengua nativa. Por otra parte este 'como' es deliberadamente incompleto,
+ centrado espec�ficamente en trabajar con <code>gettext</code> para <code>calcurse</code>.
+ Para una informaci�n mas completa deber�s dirigirte al manual de <code>GNU gettext</code> en:
+ <pre>
+ http://www.gnu.org/software/gettext/manual/
+ </pre>
+ B�sicamente, hay tres tipos de personas diferentes que est�n involucradas en la cadena de traducci�n:
+ programadores, coordinadores de lenguaje y traductores.
+ Despu�s de una r�pida descripci�n de como funcionan las cosas, las tareas del
+ traductor se describen a continuaci�n.
+
+
+<a name="contribute_i18n_overview"></a><h3>Descripci�n</h3>
+<p>
+ Para que se muestren mensajes en la lengua nativa del usuario, se requieren
+ dos pasos: <em>internacionalizaci�n</em>
+ (i18n) y <em>localizaci�n</em> (l10n). i18n se refiere a como hacer que
+ <code>calcurse</code> soporte m�ltiples lenguas. Esto es realizado por
+ programadores, quienes seleccionan los textos traducibles y
+ proporcionan una manera de que se muestren traducidos en el arranque. l10n se
+ refiere a como hacer que el <code>calcurse</code> internacionalizado se adapte a la
+ lengua especifica del usuario, p.e. traduciendo las sentencias previamente
+ marcadas por los desarrolladores y seleccionando el entorno correcto
+ para que <code>calcurse</code> utilice el resultado de esta traducci�n.<br> <br>
+
+ Entonces, las sentencias traducibles son primero marcadas por los programadores dentro
+ de el c�digo fuente de los archivos en c�digo <code>C</code>, y despu�s recogidas en un archivo
+ plantilla (<em>calcurse.pot</em> - la extensi�n <em>pot</em> significa
+ <em>portable object template</em>). El contenido de
+ esta plantilla es entonces combinado con los ficheros de traducci�n
+ para cada lengua (<em>fr.po</em> para franc�s por ejemplo -
+ donde <em>po</em> significa <em>portable object</em>, lo cual quiere decir
+ que puede ser le�do y editado por humanos). Un equipo de traducci�n dado,
+ coger�a este archivo, traducir�a estas sentencias y se las mandar�a de nuevo
+ a los desarrolladores. En el momento de la compilaci�n, una versi�n binaria
+ de esta archivo (por razones de eficacia) producir�
+ (<em>fr.mo</em> - donde <em>mo</em> significa <em>machine
+ object</em>, lo que quiere decir que puede ser le�do por programas), y entonces
+ instalado. Ahora <code>calcurse</code> utilizara este archivo en el arranque,
+ traduciendo las sentencias acorde con la configuraci�n del locale del usuario.
+
+
+<a name="contribute_i18n_translator"></a><h3>Tareas del traductor</h3>
+<p>
+ Supongamos que alguien quiere iniciar la traducci�n de una nueva lengua.
+ Estos son los pasos a seguir:
+ <ul>
+ <li>Primero, localiza cual es el nombre del locale. Por ejemplo, para franc�s
+ es 'fr_FR', o simplemente 'fr'. Este es el valor que el usuario deber� poner
+ es su variable de entorno <code>LC_ALL</code> para que el software sea traducido
+ (ver <a href="#basics_invocation_variable">Variable de entorno para i18n</a>).<br>
+ <br>
+ <li>Entonces, entra en el directorio <em>po/</em> y crea un nuevo archivo-po
+ desde el archivo plantilla usando el siguiente comando:
+ <pre>
+ 'msginit -i calcurse.pot -o fr.po -l fr --no-translator'
+ </pre>
+ Si no tienes instalado <code>msginit</code> en tu sistema,
+ simplemente copia el archivo <em>calcurse.pot</em> a
+ <em>fr.po</em> y edita la cabecera a mano.<br>
+ Ahora, teniendo el archivo <em>fr.po</em>, estas preparado para empezar.
+ </ul>
+
+
+<a name="contribute_i18n_po-files"></a><h3>Archivos-po</h3>
+<p>
+ El formato de los archivos-po es muy simple. De hecho, los archivos-po
+ est�n formados de cuatro cosas:
+ <ol>
+ <li><em>lineas de localizaci�n:</em> te dicen donde est�n las sentencias
+ (nombre del archivo y numero de linea), en caso de que necesites un poco
+ mas de contexto.
+ <li><em>limeas msgid:</em> las sentencias a traducir.
+ <li><em>lineas msgstr:</em> las sentencias traducidas.
+ <li><em>lineas con prefijo '#':</em> comentarios (algunos con un significado
+ especial, como veremos m�s abajo).
+ </ol>
+ B�sicamente, todo lo que tienes que hacer es llenar las lineas <em>msgstr</em>
+ con la traducci�n de la linea <em>msgid</em> de encima.
+ <p>
+ <u>Algunas notas:</u>
+ <ul>
+ <li><em>Sentencias Fuzzy</em><br>
+ Encontraras sentencias marcadas con un comentario <code>"#, fuzzy"</code>.
+ <code>calcurse</code> no utilizara las traducciones de ese tipo de sentencias
+ hasta que tu elimines este comentario. Si una sentencia es fuzzy
+ significa que ya ha sido traducida pero que desde entonces ha sido
+ cambiada en el c�digo fuente del programa, o que es una nueva sentencia para la cual
+ <code>gettext</code> ha hecho una traducci�n 'forzosa' basada en otras sentencias
+ del archivo. Esto quiere decir que tu debes revisar la traducci�n.
+ Algunas veces, la sentencia original ha cambiado solo porque se ha arreglado
+ una tipograf�a. En ese caso, tu no tienes que cambiar nada. Pero a veces, la
+ traducci�n puede no ser muy precisa y necesitara ser modificada.
+ Una vez que has acabado y estas satisfecho con la traducci�n, tan solo elimina
+ el comentario <code>"#, fuzzy"</code> y la traducci�n podr� ser usada de nuevo
+ en <code>calcurse</code>.<br>
+ <br>
+ <li><em>Sentencias c-format y sentencias especiales</em><br>
+ Algunas sentencias tienen el siguiente comentario: <code>"#,
+ c-format"</code>. Esto te esta diciendo que partes de la sentencia a traducir
+ tienen un significado especial para el programa, puede ser que la sentencia
+ contenga alguna variable, como por ejemplo % , si ves algo como esto <code>"%s"</code>,
+ eso quiere decir que el programa remplazara esta variable por algun valor o por otra
+ sentencia. En ese caso, puedes traducir el resto de la sentencia pero sin modificar las
+ variables que pueda contener. Tambi�n hay sentencias que contienen \ , como por ejemplo
+ <code>\n</code> o <code>\t</code>, lo primero significa un final de linea y
+ lo otro una tabulaci�n, asi pues, puedes traducir la sentencia pero con cuidado de no
+ modificar estos simbolos.<br>
+ <br>
+ <li><em>Las traducciones pueden ser excesivamente largas</em><br>
+ Si las lineas son demasiado largas, pueden ser partidas de la siguiente forma:
+ <pre>
+ msgid ""
+ "alguna linea muy larga"
+ "otra linea"
+ </pre>
+ <li><em>Cabecera del archivo-po</em><br>
+ Al principio del archivo-po, la primera sentencia forma una cabecera,
+ donde hay varios tipos de informaci�n. Lo mas importante es el 'charset'. Suele parecerse
+ a esto:
+ <pre>
+ "Content-Type: text/plain; charset=utf-8\n"
+ </pre>
+ Debes cumplimentar tambi�n el campo 'Last-Translator' (�ltimo traductor), para que
+ los potenciales contribuidores puedan contactar contigo si ellos quieren colaborar
+ en el equipo de traducci�n, o hacer alg�n tipo de correcci�n sobre las traducciones.
+ Puedes poner solo tu nombre/nick o a�adir tu direcci�n de email, por ejemplo:
+ <pre>
+ "Last-Translator: Frederic Culot <frederic@culot.org>\n"
+ </pre>
+ <li><em>Comentarios</em><br>
+ A�adir comentarios (lineas que comiencen con el car�cter '#') puede ser una buena manera
+ de evitar problemas o dificultades a los correctores u otros miembros de tu equipo.<br>
+ <br>
+ <li><em>Tama�o de las sentencias</em><br>
+ <code>calcurse</code> es un programa basado en curses/consola, as� que puede ser muy dependiente
+ del tama�o del terminal donde se ejecute (numero de columnas). Piensa en ello cuando lo traduzcas.
+ A menudo una sentencia puede colocarse en una sola linea (la longitud standard es de 80 caracteres).
+ No traduzcas a lo loco, intenta ver donde se mostrara la sentencia y adapta a ello tu traducci�n.<br>
+ <br>
+ <li><em>Algunas herramientas �tiles</em><br>
+ El formato de los archivos-po es muy simple, y puede ser editado con casi cualquier editor, pero
+ si lo prefieres, hay unas pocas herramientas especializadas que pueden resultarte
+ interesantes para traducir:
+ <ul>
+ <li><code>poEdit</code> (<a
+ href="http://www.poedit.org/" target="_blank">
+ http://www.poedit.org/</a>)
+ <li><code>KBabel</code> (<a
+ href="http://i18n.kde.org/tools/kbabel/" target="_blank">
+ http://i18n.kde.org/tools/kbabel/</a>)
+ <li><code>GTranslator</code> (<a
+ href="http://gtranslator.sourceforge.net/" target="_blank">
+ http://gtranslator.sourceforge.net/</a>)
+ <li><code>Emacs</code> en modo po
+ <li><code>Vim</code> en modo po
+ </ul>
+ <br>
+ <li><em>Y finalmente</em><br>
+ Espero que te hayas divertido contribuyendo a un mundo mas internacionalizado :) Si tienes alguna
+ pregunta no dudes en contactar conmigo en <em>frederic@culot.org</em>.
+ </ul>
+
+
+<a name="links"></a><h1>Enlaces</h1>
+
+<p>
+ Esta secci�n contiene enlaces y referencias que pueden ser de tu inter�s.
+
+
+<a name="links_homepage"></a><h2>Pagina web de <code>calcurse</code></h2>
+<p>
+ La pagina web de <code>calcurse</code> es:
+ <pre>
+ http://culot.org/calcurse
+ </pre>
+
+<a name="links_list"></a><h2>Lista de anuncios de <code>calcurse</code></h2>
+<p>
+ Si estas interesado en el proyecto y quieres ser avisado
+ cuando salga una nueva versi�n, puedes suscribirte a la
+ lista de anuncios de <code>calcurse</code>. Si lo haces, recibir�s
+ un email tan pronto como una nueva funcionalidad se a�ada a
+ <code>calcurse</code>.<br>
+ Para suscribirte a la lista, env�a un email a :
+ <code>calcurse-announce@culot.org</code> poniendo "subscribe"
+ en el asunto.
+
+
+<a name="thanks"></a><h1>Gracias a ...</a></h1>
+<p>
+ Es la hora de dar las gracias a personas sin las que este programa
+ � no existir�a ! Por eso esta es una lista de las personas que contribuyeron
+ y a las que me gustar�a dar las gracias :
+ <ul>
+ <li>Alex por sus patches, ayuda y notas con la programaci�n <code>C</code>
+ <li>Gwen por probarlo y las discusiones sobre como mejorar <code>calcurse</code>
+ <li>Kevin and Ryan por hacer el paquete para <code>calcurse</code> para Debian
+ <li>Steffen por hacer el paquete <code>calcurse</code> para Archlinux
+ <li>Alexandre por hacer el paquete <code>calcurse</code> para Mac OsX
+ <li>Joel por su script del calendario que inspiro la vista de calendario de <code>calcurse</code>
+ <li>Michael Schulz por la traducci�n al alem�n de <code>calcurse</code> y su manual
+ <li>Neil Williams por la traducci�n al ingles
+ <li>Jose Lopez por la traduccion al Espa�ol de <code>calcurse</code> y su manual
+ <li>a la gente que ha escrito softwares que me gustan y que me inspiraron, especialmente :
+ <ul>
+ <li><code>vim</code> por las teclas de desplazamiento
+ <li><code>orpheus</code> y <code>abook</code> por la documentaci�n
+ <li><code>pine</code> and <code>aptitude</code>
+ por la interfaz de usuario
+ </ul>
+ </ul>
+ <br>
+ Y por �ltimo, muchas muchas gracias a todos los usuarios de <code>calcurse</code>
+ que me han enviado sus comentarios.
+
+<hr>
+<small><em>
+Copyright (c) 2004-2006 Frédéric Culot<br>
+Traducido al Espa�ol por Jose Lopez
+<code><testinground.at.gmail.dot.com></code><br>
+Calcurse version 1.5 - Last change: August 24, 2006
+<em></small>
+
+
+</body>
+</html>
--
cgit v1.2.3-70-g09d2