<chapter id="translators">
<title
>Guia para la traducción de &kturtle;</title>
<para
>Como usted probablemente ya sabe, la posibilidad de tener los comandos traducidos a la lengua del programador, es una de las característica distintiva del lenguaje de programación &logo;. De esta manera, se elimina una de las barreras que algunas personas encuentran para comprender los fundamentos de la programación. Cuando traduzca &kturtle; a un nuevo idioma, no solamente deberá traducir las cadenas y la documentación, sino que deberá trabajar también con algunos archivos adicionales. La mayor parte de estos archivos, podrán ser autogenerados utilizando los guiones provistos por Rafael Beccar. Estos guiones pueden hallarse en <userinput
>kdeedu/kturtle/scripts</userinput
>, mientras que los archivos que necesitan traducción se encuentran en <userinput
>kdeedu/kturtle/data</userinput
>. En ambos directorios encontrará también sendos archivos README que contienen instrucciones para la traducción de los archivos y el uso de los guiones. </para>
 
<sect1 id="make_directory">
<title
>Creando un directorio para guardar los archivos traducidos</title>
<para
>First, you need to create a directory to store the translated files. Create a directory called <filename class="directory"
>kde-i18n/<replaceable
>code</replaceable
>/data/kdeedu/kturtle/</filename
> in your KDE CVS directory, where <replaceable
>code</replaceable
> is your country code (the 2- or 4- letter <acronym
>ISO</acronym
> code). </para>
<para
>Copie el archivo <filename
>Makefile.am</filename
> desde <filename class="directory"
>kdeedu/kturtle/data/</filename
> a este directorio. Ábralo utilizando su editor de texto favorito, y reemplace todas las ocurrencias de <quote
>en_US</quote
> en el archivo, con el código de país mencionado arriba. Luego, guarde el archivo. </para>
</sect1>
<sect1 id="commands_trans">
<title
>Traduciendo el archivo de comandos &logo;</title>
<para>
<itemizedlist>
<listitem
><para
>Copie el archivo <filename
>logokeywords.en_US.xml</filename
> desde <filename class="directory"
>kdeedu/kturtle/data/</filename
> al directorio que usted ha creado recientemente. Luego, renombre el archivo a <filename
>logokeywords.<replaceable
>código</replaceable
>.xml</filename
> donde <replaceable
>código</replaceable
> es el código <acronym
>ISO</acronym
> de 2 o 4 letras. </para>
</listitem>
<listitem
><para
>Traduzca los contenidos de la etiqueta <sgmltag class="starttag"
>keyword</sgmltag
> (&ie; la información entre <sgmltag class="starttag"
>keyword</sgmltag
> y <sgmltag class="endtag"
>keyword</sgmltag
>) a su idioma siempre que sea posible. También traduzca los contenidos de la etiqueta <sgmltag class="starttag"
>alias</sgmltag
> (&ie; la información entre <sgmltag class="starttag"
>alias</sgmltag
> y <sgmltag class="endtag"
>alias</sgmltag
>): los alias se utilizan como abreviaciones de los comandos.</para>
<para
>Por ejemplo, traduzca <quote
>while</quote
> en <sgmltag class="starttag"
>keyword</sgmltag
>while<sgmltag class="endtag"
>keyword</sgmltag
> </para>
<para
>Por favor, no traduzca nada más, tampoco las palabras que se encuentran en etiquetas del tipo <sgmltag class="starttag"
>command name="english_word"</sgmltag
>, estas deben permanecer en inglés. </para>
<para
>Por último: es importante no alterar el orden en este archivo, de otro modo los guiones provistos por Rafael Beccar para la traducción automática de los archivos de datos podrían generar resultados inesperados. </para>
</listitem>
<listitem
><para
>Guarde su archivo como <acronym
>UTF-8</acronym
> (en kate;, use <guimenuitem
>Guardar como...</guimenuitem
> y cambiar a <guilabel
>utf8</guilabel
> en la caja sobre de arriba a la derecha ). </para>
</listitem>
<listitem
><para
>Suba su trabajo (modificando acordemente el archivo <filename
>Makefile.am</filename
>) o envíe el archivo traducido a Anne-Marie. </para>
</listitem>
<listitem
><para
>Si aún tuviera alguna duda contacte a  Anne-Marie Mahfouf <email
>annemarie.mahfouf@free.fr</email
> para más información.</para>
</listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="examples_syntax">
<title
>Como traducir el archivo de resaltado de sintaxis</title>
<para
>Traducir el archivo <filename
>logohighlightstyle.en_US.xml</filename
> es realmente muy simple si utiliza el guión ideado por Rafael Beccar que podrá encontrar en <filename class="directory"
>kdeedu/kturtle/data/</filename
>. En ese directorio encontrará un archivo README que le guiará en la utilización de los guiones. </para>
<para
>Para aquellos que por alguna razón no deseen utilizar el guión Perl mencionado en el párrafo anterior, se describe a continuación la antigua forma de traducir el archivo: <itemizedlist>
<listitem
><para
>Copie el archivo <filename
>logohighlightstyle.en_US.xml</filename
> en <filename class="directory"
>kdeedu/kturtle/data/</filename
> al directorio que creo anteriormente para guardar los archivos de datos traducidos, luego renombrelo a <filename
>logohighlightstyle.<replaceable
>codigo</replaceable
>.xml</filename
> donde <replaceable
>codigo</replaceable
> es su código de país (código <acronym
>ISO</acronym
> de 2- o 4- letras). </para>
</listitem>
<listitem
><para
>En la línea 4 dice <sgmltag class="starttag"
>language name="en_US"</sgmltag
>...: Aquí deberá cambiar <quote
>en_US</quote
> por el código <quote
>ISO</quote
> de cuatro letras correspondiente al idioma al que esté traduciendo. </para
></listitem>
<listitem
><para
>Traduzca el contenido de la etiqueta <sgmltag class="starttag"
>item</sgmltag
> (&ie; la información entre <sgmltag class="starttag"
>item</sgmltag
> and <sgmltag class="endtag"
>item</sgmltag
>). Estos cambios deben ser coherentes con el contenido del archivo <filename
>logokeyword</filename
>. Por ejemplo, traduzca <quote
>while</quote
> en: <sgmltag class="starttag"
>item</sgmltag
> while <sgmltag class="endtag"
>item</sgmltag
> y deje los espacios tal cual están (uno al principio y otro al final). Por favor, no traduzca nada más en este archivo. </para
></listitem>
<listitem
><para
>Guarde su archivo como <acronym
>UTF-8</acronym
> (en kate;, use <guimenuitem
>Guardar como...</guimenuitem
> y cambiar a <guilabel
>utf8</guilabel
> en la caja sobre de arriba a la derecha ). </para
></listitem>
<listitem
><para
>Suba su trabajo (modificando acordemente el archivo <filename
>Makefile.am</filename
>) o envíe el archivo traducido a Anne-Marie. </para
></listitem>
<listitem
><para
>Si aún tuviera alguna duda contacte a  Anne-Marie Mahfouf <email
>annemarie.mahfouf@free.fr</email
> para más información. </para
></listitem>
</itemizedlist>
</para>
</sect1>

<sect1 id="examples_trans">
<title
>Traduciendo los ejemplos</title>
<para
>Nuevamente, esta tarea se ha simplificado mucho gracias a los guiones ideados por Rafael Beccar que se encuentran en <filename class="directory"
>kdeedu/kturtle/data/</filename
>. Recuerde que encontrará información acerca del funcionamiento de los scripts en el archivo README de este directorio. Es importante que lea el README, ya que le indicará los pasos a seguir luego de la traducción automática de los ejemplos. </para>
<para
>Al terminar con todos los pasos que se indican en el archivo README que encontró en el directorio de guiones, todo debería estar casi listo. Por favor, no se olvide de verificar que todos los ejemplos traducidos funcionan correctamente. También verifique que el contenido del archivo <userinput
>Makefile.am</userinput
> en <filename class="directory"
>kde-i18n/<replaceable
>code</replaceable
>/data/kdeedu/kturtle/</filename
> refleje la existencia de los nuevos archivos. Por ejemplo, para el holandés, el archivo <userinput
>Makefile.am</userinput
> contener algo semejante a esto: <screen
>txt_DATA = advertentie.logo driehoeken.logo krullen.logo tafels.logo \
bloem.logo driehoek.logo logohighlightstyle.nl.xml pijl.logo vierkanten.logo \
kleuren.logo logokeywords.nl.xml randomnaam.logo vierkant.logo
txtdir = $(kde_datadir)/kturtle/examples/nl

xml_DATA = logohighlightstyle.nl.xml
xmldir = $(kde_datadir)/katepart/syntax

keywords_DATA = logokeywords.nl.xml
keywordsdir = $(kde_datadir)/kturtle/data
EXTRA_DIST = $(txt_DATA) $(xml_DATA) $(keywords_DATA)
</screen
> 
</para>
<para
>A continuación , describimos aquí el proceso de traducción SIN utilizar el guión de Rafael. Es decir, a la vieja usanza: <itemizedlist>
<listitem
><para
>Copiar los ejemplos en inglés desde<filename class="directory"
>kdeedu/kturtle/data/</filename
> al directorio anteriormente creado por usted para guardar los archivos de datos traducidos. Traduzca los nombres de archivo de ejemplos que se encuentran en su directorio: esto permitirá a los usuarios darse una idea de que es lo que harán estos ejemplos.</para>
</listitem>
<listitem
><para
>Traduzca los comandos (keywords) en los ejemplos utilizando el archivo <filename
>logokeywords.xml</filename
> como referencia. En consecuencia, el archivo de comandos debe ser traducido en una primera instancia, para posteriormente traducir los ejemplos.</para>
</listitem>
<listitem
><para
>Guarde su archivo como  <acronym
>UTF-8</acronym
> (in &kate;, utilice <guimenuitem
> Guardar como...</guimenuitem
> y cambie a <guilabel
>utf8</guilabel
>en la caja en la esquina superior derecha)</para>
</listitem>
<listitem
><para
>Suba su trabajo (modificando acordemente el archivo <filename
>Makefile.am</filename
>) o envíe el archivo traducido a Anne-Marie.</para>
</listitem>
<listitem
><para
>Si aún tuviera alguna duda contacte a  Anne-Marie Mahfouf <email
>annemarie.mahfouf@free.fr</email
> para más información.</para>
</listitem>
<listitem
><para
>Finalmente, si lo desea, puede agregar sus propios ejemplos en esta carpeta.</para>
</listitem>
</itemizedlist>
</para>
</sect1>

</chapter>
