diff options
Diffstat (limited to 'doc/manual_es.html')
| -rwxr-xr-x | doc/manual_es.html | 748 |
1 files changed, 748 insertions, 0 deletions
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> |