Trauducción de ayudas

Este documento describe los pasos a seguir para traducir las ayudas de las aplicaciones y utilidades de [http://www.gnome.org GNOME].

En todas las aplicaciones, apliques y utilidades del entorno GNOME se incluye un manual con la idea de facilitar su aprendizaje a los usuarios. Una vez traducidos los mensajes del interfaz, de los menús y de los diálogos, que suponen el primer contacto de los usuarios con la aplicación, nuestro objetivo es traducir la documentación que se adjunta con ella. Esta guía tiene por objetivo ayudar a los traductores a realizar esta labor de forma sencilla, empezando por aclarar los distintos ficheros que se deben traducir y terminado con la forma de entregar los trabajos en el repositorio SVN.

Con el fin de que la guía sea lo más practica posible, se usará las ayudas del aplique whereami y su traducción al castellano (código es) como ejemplo.

Ficheros de un manual

El original en inglés de la ayuda de whereami se encuentra en el directorio: gnome-applets/whereami/docs/C y se compone de los siguientes ficheros:

/C/whereami_applet.sgml
/C/whereami.sgml
/C/topic.dat
/C/whereami_applet-C.omf
/C/figures
/C/figures/whereami_applet.png

El resultado de la traducción deberá residir en el directorio: gnome-applets/whereami/docs/es manteniendo la misma estructura:

/es/whereami_applet.sgml
/es/whereami.sgml
/es/topic.dat
/es/whereami_applet-es.omf
/es/figures
/es/figures/whereami_applet.png
/es/authors.sgml
/es/license.sgml
/es/licencia-es.sgml
/es/licencia-nota-es.sgml

Observarás que hay tres ficheros adicionales en la traducción. Más adelante explicaremos el motivo.

El grueso de la traducción lo componen los ficheros de tipo sgml, debiéndose traducir también algunas frases en el resto de ficheros. Por último es necesario realizar las capturas en castellano de las figuras que se incluyen en el directorio figures.

Veremos en la sección dedicada a las entregas que, de cara a realizar una entrega en el repositorio, hay que prestar también atención a algunos ficheros adicionales.

En los paquetes de traducción que preparamos en Gnome-es, incluimos el árbol con el original en inglés y, en caso de existir una versión previa de la traducción, los ficheros correspondientes a la traducción anterior. Todo ello comprimido en un paquete de tipo tar.

Traducción de cada fichero

A continuación se describe cómo y qué traducir en cada fichero.

harem_applet.sgml

Este fichero es una especie de cabecera, y cuando existe (a veces está incluido todo en un único sgml), contiene información sobre el tipo de DTD usada por el documento, sobre la licencia y los derechos de autor.

<!DOCTYPE Article PUBLIC "-//GNOME//DTD DocBook PNG Variant V1.1//EN"[ <!ENTITY whereami.sgml SYSTEM "whereami.sgml">
]>
<article id="index"> 
 <artheader>
- <title>Where Am I? Applet</title> <copyright>
  - <year>2000</year> <holder>Telsa Gwynne</holder>
  </copyright>
  
  
  <legalnotice id="legalnotice">
  - <para>
    - Permission is granted to copy, distribute and/or modify this
      document under the terms of the <citetitle>GNU Free Documentation

...

of the GNOME Documentation Project, the names have been printed in caps or initial caps.

</para>

</legalnotice>
<releaseinfo>
- This is version 1.0 of the Where Am I? applet manual.
</releaseinfo>

</artheader>

&whereami.sgml;
</article>

En este fichero deberemos incluir una serie de nuevas definiciones en la cabecera DTD:

<!ENTITY name "¿Dónde estoy?"> <!ENTITY aplication "whereami">
<!ENTITY authors SYSTEM "authors.sgml"> <!ENTITY license SYSTEM "license.sgml">
<!ENTITY licencia-nota-es SYSTEM "licencia-nota-es.sgml"> <!ENTITY license-es SYSTEM "licencia-es.sgml">
<!ENTITY programer "John Kodis"> <!ENTITY programer-email "<email>kodis@jagunet.com</email>">
<!ENTITY writer "Telsa Gwynne"> <!ENTITY writer-email "<email>hobbit@aloss.ukuu.org.uk</email>">
<!ENTITY traductor "Manuel de Vega Barreiro"> <!ENTITY traductor-email "<email>mbarreiro@red.madritel.es</email>">