<chapter id="translators">
<title>Guía para la traducción de &kturtle;</title>
<para>Como probablemente ya sabe, la posibilidad de tener las órdenes traducidas al idioma del programador, es una de las características 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 los cuales podrán ser autogenerados utilizando los scripts proporcionados por Rafael Beccar. Estos scripts pueden hallarse en <userinput>tdeedu/kturtle/scripts</userinput>, mientras que los archivos que necesitan traducción se encuentran en <userinput>tdeedu/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 scripts. </para>
 
<sect1 id="make_directory">
<title>Crear un directorio para guardar los archivos traducidos</title>
<para>Primero, deberá crear un directorio para guardar los archivos traducidos. Luego, cree un directorio llamado <filename class="directory">tde-i18n/<replaceable>código</replaceable>/data/tdeedu/kturtle/</filename> dentro de la estructura de su copia del CVS de KDE, donde <replaceable>código</replaceable> es el código de país (código <acronym>ISO</acronym> de 2 ó 4 letras). </para>
<para>Copie el archivo <filename>Makefile.am</filename> desde <filename class="directory">tdeedu/kturtle/data/</filename> a este directorio. Ábralo utilizando su editor de texto favorito, y reemplace todas las apariciones de «en_US» en el archivo, con el código de país anteriormente mencionado. Luego, guarde el archivo. </para>
</sect1>
<sect1 id="commands_trans">
<title>Traduciendo el archivo de órdenes &logo;</title>
<para>
<itemizedlist>
<listitem><para>Copie el archivo <filename>logokeywords.en_US.xml</filename> desde <filename class="directory">tdeedu/kturtle/data/</filename> al directorio que haya 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 ó 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. Traduzca también 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 abreviaturas de las órdenes.</para>
<para>Por ejemplo, traduzca «while» 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>, éstas deben permanecer en inglés. </para>
<para>Por último: es importante no alterar el orden en este archivo, de otro modo los scripts 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 cambie a <guilabel>utf8</guilabel> en el cuadro situado en la parte 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 con Anne-Marie Mahfouf <email>annemarie.mahfouf@free.fr</email> para obtener 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 script ideado por Rafael Beccar que podrá encontrar en <filename class="directory">tdeedu/kturtle/data/</filename>. En ese directorio encontrará un archivo README que le guiará en la utilización de los scripts. </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">tdeedu/kturtle/data/</filename> al directorio que creó anteriormente para guardar los archivos de datos traducidos, luego renómbrelo a <filename>logohighlightstyle.<replaceable>código</replaceable>.xml</filename> donde <replaceable>código</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 «en_US» por el código «ISO» 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> e <sgmltag class="endtag">item</sgmltag>). Estos cambios deben ser coherentes con el contenido del archivo <filename>logokeyword</filename>. Por ejemplo, traduzca «while» 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 cambie a <guilabel>utf8</guilabel> en el cuadro situado en la parte 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 con Anne-Marie Mahfouf <email>annemarie.mahfouf@free.fr</email> para obtener 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 scripts ideados por Rafael Beccar que se encuentran en <filename class="directory">tdeedu/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 scripts, 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">tde-i18n/<replaceable>code</replaceable>/data/tdeedu/kturtle/</filename> refleje la existencia de los nuevos archivos. Por ejemplo, para el holandés, el archivo <userinput>Makefile.am</userinput> debe 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 script de Perl de Rafael: <itemizedlist>
<listitem><para>Copiar los ejemplos en inglés desde<filename class="directory">tdeedu/kturtle/data/</filename> al directorio anteriormente creado 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 las órdenes (keywords) en los ejemplos utilizando el archivo <filename>logokeywords.xml</filename> como referencia. En consecuencia, el archivo de órdenes debe ser el que primero se traduzca, para posteriormente traducir los ejemplos.</para>
</listitem>
<listitem><para>Guarde su archivo como  <acronym>UTF-8</acronym> (en &kate;, utilice <guimenuitem> Guardar como...</guimenuitem> y cambie a <guilabel>utf8</guilabel>en el cuadro situado en la esquina superior derecha).</para>
</listitem>
<listitem><para>Suba su trabajo (añada un <filename>Makefile.am</filename>) o envíe el archivo traducido a Anne-Marie.</para>
</listitem>
<listitem><para>Si aún tuviera alguna duda contacte con Anne-Marie Mahfouf <email>annemarie.mahfouf@free.fr</email> para obtener 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>
