<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY lokalize "Lokalize">
<!ENTITY kaider "Lokalize">
<!ENTITY kappname "Lokalize">
<!ENTITY package "kdesdk">
<!ENTITY % addindex "IGNORE">
<!ENTITY % Spanish "INCLUDE">
]>
<book id="lokalize" lang="&language;">
<bookinfo>
<title
>Manual de &lokalize;</title>
<authorgroup>
<author
><firstname
>Nick</firstname
> <surname
>Shaforostoff</surname
> <affiliation
><address
><email
>shaforostoff@kde.ru</email
></address
></affiliation>
</author>
<othercredit role="translator"
><firstname
>Santiago</firstname
><surname
>Fernández Sancho</surname
><affiliation
><address
><email
>santi@kde-es.org</email
></address
></affiliation
><contrib
>Traductor</contrib
></othercredit
> <othercredit role="translator"
><firstname
>Cristina Yenyxe</firstname
><surname
>González García</surname
><affiliation
><address
><email
>the.blue.valkyrie@gmail.com</email
></address
></affiliation
><contrib
>Traductor</contrib
></othercredit
> 
</authorgroup>

<copyright>
<year
>2007-2009</year
><holder
>Nick Shaforostoff</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2009-05-09</date>
<releaseinfo
>1.0</releaseinfo>

<abstract>
<para
>&lokalize; es un sistema informático de ayuda a la traducción, centrado en la productividad y en asegurar la calidad. Posee los componentes usuales en estas herramientas: memoria de traducción, glosario, y unas capacidades únicas de fusionado (sincronización). Está orientado a la traducción de software, y también integra herramientas externas de conversión para la traducción de documentos de oficina. </para>
</abstract>

<keywordset>
<keyword
>&lokalize;</keyword>
<keyword
>localización</keyword>
<keyword
>l10n</keyword>
<keyword
>internacionalización</keyword>
<keyword
>i18n</keyword>
<keyword
>traducción</keyword>
<keyword
>globalización</keyword>
<keyword
>g11n</keyword>
<keyword
>XLIFF</keyword>
<keyword
>gettext</keyword>
<keyword
>OpenDocument</keyword>
<keyword
>KBabel</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introducción</title>

<para
>Cuando inicie &lokalize; por primera vez, verá una pestaña <guilabel
>Resumen del proyecto</guilabel
>. El flujo de trabajo de Lokalize le obliga a empezar creando o abriendo un proyecto. </para>
<para
>Si está trabajando en grupo, es posible que vaya a traducir un archivo OpenDocument. Para hacerlo, seleccione <menuchoice
><guimenu
>Proyecto</guimenu
><guimenuitem
>Crear nuevo proyecto</guimenuitem
></menuchoice
>. El asistente le preguntará sobre el documento fuente, lo convertirá a XLIFF, el formato interno de &lokalize;, y creará un proyecto para él. Cuando termine de traducir, seleccione <menuchoice
><guimenu
>Herramientas</guimenu
> <guimenuitem
>Fusionar en ODF</guimenuitem
></menuchoice
> para integrar su traducción en una copia del documento original. </para>

<para
>Si está traduciendo KDE ya tendrá un archivo de proyecto de &lokalize; en su carpeta de idiomas (normalmente llamada <filename
>index.lokalize</filename
>), o puede seleccionar <menuchoice
><guimenu
>Proyecto</guimenu
><guimenuitem
>Crear proyecto</guimenuitem
></menuchoice
> para que el asistente descargue los archivos de traducción para su idioma y cree el proyecto por usted. </para>

<para
>Los archivos de traducción se abren en pestañas separadas, con dos grandes editores de multi-línea y una <emphasis
>vista de herramientas</emphasis
>. Estas vistas se pueden apilar (como las pestañas), separar u ocultar. Los archivos de traducción están formados por muchos pares inglés-destino llamados <emphasis
>unidades</emphasis
>. Las <emphasis
>unidades</emphasis
> suelen corresponder a cadenas simples en la interfaz de usuario o a un párrafo de documentación. El propósito del primer editor multi-línea es mostrar la parte original del par, y el del segundo es mostrar la traducción. Puede moverse a través de las <emphasis
>unidades</emphasis
> con la vista de <guilabel
>Unidades de traducción</guilabel
> o las teclas <keycap
>Av Pág</keycap
> y <keycap
>Re Pág</keycap
>. </para>

<tip>
<para
>Se recomienda que utilice los atajos de teclado en lugar de los menús y las barras de herramientas para incrementar su productividad. Por ejemplo, utilice <keycombo
>&Ctrl;<keycap
>L</keycap
></keycombo
> para mover el foco a la entrada <guilabel
>Búsqueda rápida</guilabel
> para filtrar las unidades de la lista de <guilabel
>Unidades de traducción</guilabel
>. Cuando termine, pulse <keycap
>AvPág</keycap
> para moverse por la lista filtrada. </para>
</tip>

<para
>Un mensaje puede estar <emphasis
>traducido</emphasis
> o <emphasis
>sin traducir</emphasis
>. Un mensaje traducido puede estar <emphasis
>aprobado</emphasis
> o <emphasis
>sin aprobar</emphasis
> (a veces llamado <emphasis
>dudoso</emphasis
>). Si el mensaje no está aprobado, su traducción se renderiza en cursiva. &lokalize; le permite navegar fácilmente por el archivo de acuerdo al estado de su traducción. Vea el menú <guilabel
>Ir</guilabel
> para los atajos. Mientras navega, los mensajes sin traducir se tratan como no aprobados. También puede usar el filtro de la vista de herramientas <guilabel
>Unidades de traducción</guilabel
>. Pulsando <keycap
>AvPág</keycap
> avanzará a la siguiente unidad en la lista filtrada u ordenada de la vista. </para>

<para
>Si está trabajando con archivos de traducción en formato XLIFF (como en el caso de traducir OpenDocument), dispone de los estados avanzados (<emphasis
>nuevo</emphasis
>, <emphasis
>necesita revisión</emphasis
>, <emphasis
>aprobado</emphasis
>, &etc;). Puede seleccionarlos en el menú desplegable del botón <guilabel
>Aprobado</guilabel
> de la barra de herramientas. La clasificación del estado como <emphasis
>listo</emphasis
> o <emphasis
>no listo</emphasis
> depende de la <emphasis
>fase de trabajo</emphasis
> actual (<emphasis
>traducción</emphasis
>, <emphasis
>revisión</emphasis
>, <emphasis
>aprobación</emphasis
>). La fase por omisión depende del <emphasis
>rol</emphasis
> que ocupe en el proyecto (definido en las propiedades del proyecto). Cada unidad contiene información de registro sobre el último cambio de fase y, para cada fase, sobre su propietario. </para>

</chapter>

<chapter id="projects">
<title
>Proyectos</title>

<para
>Los proyectos son uno de los principales conceptos de &lokalize;, y se representan con un archivo que contiene las rutas, carpetas con las traducciones, plantillas, el archivo de glosario, guiones de automatización y una memoria de la traducción. Cuando &lokalize; abra un archivo sin un proyecto cargado, buscará un archivo de proyecto en las carpetas padre (hasta cuatro niveles por encima). También puede especificar el proyecto a través del modificador <userinput
>--project</userinput
> cuando inicie &lokalize; desde la línea de órdenes. </para>

<para
>Cada vez que seleccione un rol en un proyecto (<emphasis
>traducción</emphasis
>, <emphasis
>revisión</emphasis
>, <emphasis
>aprobación</emphasis
>), esto afectará a la fase de trabajo que &lokalize; seleccionará automáticamente cuando edite un archivo. </para>

<note>
<para
>La memoria de traducción (al contrario que los archivos de proyecto, glosario y guiones) no se comparte entre los miembros del equipo de traducción, ya que se crea y guarda en la carpeta personal del usuario, lo que significa que las memorias de traducción de todos los proyectos se guardan en la misma carpeta y se pueden utilizar cuando se abren otros proyectos. </para>
</note>

<sect1 id="project-view">
<title
>Resumen del proyecto</title>

<para
>El <guilabel
>Resumen del proyecto</guilabel
> muestra un árbol de archivos con estadísticas como el porcentaje de unidades completamente traducidas y el último traductor. También le permite abrir un archivo seleccionado en la pestaña actual o en una nueva ventana de &lokalize;. </para>

</sect1>

</chapter>

<chapter id="glossary">
<title
>Glosario</title>

<para
>¿Alguna vez ha estado cansado de teclear la misma secuencia de texto largo varias veces solo porque le cuesta más trabajo encontrarlo en la traducción para copiarlo y pegarlo? Ahora solo tendrá que encontrar la secuencia de palabras (frecuente) en la <guilabel
>Vista de glosario</guilabel
>, y se insertará punsando un acceso rápido. </para>

<para
>Por supuesto el glosario deberá poblarse primero con secuencias de palabras. &lokalize; incluye un editor de glosario manual que permite una búsqueda explícita sobre el glosario completo. </para>

<screenshot>
<screeninfo
>La vista de glosario en la esquina inferior derecha muestra las entradas de glosario adecuadas para la unidad actual</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="glossary.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>La vista de glosario en la esquina inferior derecha muestra las entradas de glosario adecuadas para la unidad actual</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</chapter>

<chapter id="tm">
<title
>Memoria de traducción</title>

<para
>La vista <guilabel
>Memoria de traducción</guilabel
> le permite arrastrar y soltar una carpeta con archivos de traducción en la vista, desde Dolphin por ejemplo, y en pocos minutos se le mostrarán de forma automática sugerencias de traducción en la entrada de mensajes. Para insertar las sugerencias de traducción en el archivo, pulse <keycombo
>&Ctrl;<keycap
>1</keycap
></keycombo
>, <keycombo
>&Ctrl;<keycap
>2</keycap
></keycombo
> y así sucesivamente, dependiendo del número de la sugerencia. </para>

<para
>Si pulsa <keycombo
><keycap
>F7</keycap
></keycombo
> se abrirá la pestaña <guilabel
>Memoria de traducción</guilabel
>, que permite consultar libremente la MT. Si pulsa sobre un resultado de la búsqueda se abrirá el correspondiente archivo en la entrada en cuestión. Si desea abrir rápidamente algún archivo del proyecto (y añadirlo a la MT), en lugar de seleccionarlo en el <guilabel
>Resumen del proyecto</guilabel
>, solo tiene que escribir su nombre en el campo <guilabel
>Máscara de archivo</guilabel
> acompañado por «*». </para>

<para
>El motor MT indexa todas las entradas, incluyendo las que aún no están listas y las no traducidas, lo que le permite reemplazar completamente la «Búsqueda en archivos», que requiere recorrer cada archivo del proyecto cada vez que realiza una búsqueda. </para>

<screenshot>
<screeninfo
>&lokalize; con los resultados de la búsqueda en la memoria de traducción para la unidad actual</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="tmview.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>&lokalize; con los resultados de la búsqueda en la memoria de traducción para la unidad actual</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</chapter>


<chapter id="sync">
<title
>Capacidades de sincronización de traducción</title>

<para
>El <guilabel
>Modo de sincronización</guilabel
> (anteriormente conocido como <guilabel
>Modo de fusión</guilabel
>) ahorra gran cantidad de tiempo a los editores, o cuando dos o más traductores están trabajando simultáneamente en el mismo archivo, o tiene que mantener traducciones de varias ramas de software. </para>

<para
>&lokalize; le permite navegar a través de las unidades que difieren, y muestra las diferencias palabra a palabra. Además, &lokalize; tiene dos vistas de sincronización: <guilabel
>Sincronización primaria</guilabel
> y <guilabel
>Sincronización secundaria</guilabel
>. Son idénticas, pero el antiguo se suele utilizar para fusionar las traducciones y la segunda para mantener las traducciones de sincronización para dos ramas de software. </para>

<para
>Después de que copie la traducción del archivo auxilizar(<emphasis
>sincronizándolo</emphasis
>), cualquier cambio que se haga posteriormente a esta unidad se replicará en el archivo auxiliar. </para>

<sect1 id="file-merge">
<title
>Fusión</title>
<para
>Uno de los usos del <guilabel
>Modo de sincronización</guilabel
> es revisar los cambios hechos por (nuevos) colaboradores, cuando no puede asegurarse de la calidad del trabajo hecho. </para>
<para
>Abra un archivo base, a continuación su versión cambiada en la vista de <guilabel
>Sincronización primaria</guilabel
>, seguida de <keycombo
>&Alt;<keycap
>Abajo</keycap
></keycombo
> o <keycombo
>&Alt; <keycap
>Arriba</keycap
></keycombo
> (recuerde que los accesos rápidos pueden modificarse de la misma forma que para las demás aplicaciones de &kde;) para navegar a través de las entradas que son diferentes. </para>
<screenshot>
<screeninfo
>&lokalize; utilizado para fusionar cambios en las traducciones</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="sync.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>&lokalize; utilizado para fusionar cambios en las traducciones</phrase>
    </textobject>
  </mediaobject>
</screenshot>

</sect1>

<sect1 id="file-sync">
<title
>Replicación</title>
<para
>El <guilabel
>Modo de sincronización</guilabel
> también puede utilizarse para hacer cambios de traducción en dos ramas simultáneamente. Especifique en la ruta de la <guilabel
>Carpeta de la rama</guilabel
> de las opciones de su proyecto la ruta que corresponda a la carpeta base de la rama, y la vista <guilabel
>Sincronización secundaria</guilabel
> abrirá automáticamente los archivos de la rama. De este modo, cada vez que haga cambios en los archivos de su rama principal, se replicarán automáticamente en la rama (por supuesto, si contiene la misma cadena en inglés). </para>
<para
>Por ejemplo, si trabaja en la traducción de KDE, puede descargar trunk de <filename class="directory"
>/home/xx/hacking/kde/trunk/l10n-kde4/SU_IDIOMA</filename
> y una rama de <filename class="directory"
>/home/xx/hacking/kde/branches/stable/l10n-kde4/SU_IDIOMA</filename
>. Cree un proyecto de &lokalize;: <filename
>/home/xx/hacking/kde/trunk/l10n-kde4/SU_IDIOMA/proyecto.lokalize</filename
> y establezca <filename class="directory"
>BranchDir=../../../branches/stable/l10n-kde4/SU_IDIOMA</filename
>, a continuación trabaje con este proyecto y envíe los cambios tanto de la carpeta de trunk como de la rama. </para>
</sect1>


<sect1 id="alt-trans">
<title
>Traducciones alternativas</title>

<para
>Cada unidad puede tener muchas <emphasis
>traducciones alternativas</emphasis
> asociadas. Tales traducciones pueden aparecer durante la actualización de un archivo, porque se haya modificado ligeramente la cadena original. En este caso, la antigua traducción con su (antigua) fuente se moverá a la lista de traducciones alternativas, así que no se perderán. </para>
<para
>Cuando esté traduciendo software, las herramientas gettext se usan normalmente para preparar los archivos a traducir. Cuando cambia el texto original, las herramientas gettext actualizan los archivos a traducir y marcan las entradas en las que ha cambiado el texto original como <emphasis
>dudosas</emphasis
> (o <emphasis
>no preparadas</emphasis
>, en otra terminología). Además, se almacena el texto original para que los traductores puedan ver qué cambios se han realizado exactamente. &lokalize; simplifica la vida del traductor resaltando las partes del texto original que han sido cambiadas en la vista <guilabel
>Traducciones alternativas</guilabel
>. </para>

<screenshot>
<screeninfo
>&lokalize; resalta las partes del texto original que se modificaron desde la última revisión de la traducción</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="original-diff.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>&lokalize; resalta las partes del texto original que se modificaron desde la última revisión de la traducción</phrase>
    </textobject>
  </mediaobject>
</screenshot>


</sect1>

</chapter>

<chapter id="scripting">
<title
>Creación de scripts en &lokalize;</title>

<para
>&lokalize; se puede extender mediante el uso de scripts en varios lenguajes interpretados, incluyendo Python y JavaScript. Los scripts suelen estar integrados en la interfaz de &lokalize; como acciones del menú (a las que puede asignar un acceso rápido de teclado). La ubicación y la entrada del menú para un script se define en su correspondiente archivo .rc. En cada proyecto abierto, &lokalize; explora la carpeta <filename
>CARPETADELPROYECTO/lokalize-scripts</filename
> en busca de archivos .rc y los añade a un archivo de <emphasis
>caché</emphasis
> llamado <filename
>CARPETADELPROYECTO/lokalize-scripts/scripts.rc</filename
> (por lo que normalmente no querrá añadirlo al sistema de control de versiones del proyecto). Los archivos RC también contienen rutas de scripts, que pueden ser relativas a la carpeta del archivo .rc o a una carpeta de scripts del sistema (se prueban las dos, y realmente <emphasis
>deben</emphasis
> ser relativas si desea compartir el archivo .rc con otras personas de su equipo). Así que, por ejemplo, puede especificar <filename
>../../scripts/lokalize/opensrc.py</filename
> para cargar un script de la <ulink url="http://websvn.kde.org/trunk/l10n-kde4/scripts/lokalize/"
>carpeta global de scripts de kde4-l10n</ulink
> (es decir, no específica de su idioma). </para>
<para
>Puede encontrar ejemplos de archivos «.rc» en la carpeta de instalación de &lokalize; (normalmente <filename
>/usr/share/kde4/apps/lokalize/scripts/</filename
>) y en <ulink url="http://websvn.kde.org/trunk/l10n-kde4/scripts/lokalize/"
>el repositorio de KDE</ulink
>. <ulink url="http://websvn.kde.org/trunk/l10n-kde4/ru/lokalize-scripts/"
>Aquí</ulink
> puede encontrar más ejemplos de scripts, incluyendo el <filename
>check-gui.js</filename
> en JavaScript, que se ejecuta automáticamente en cada guardado de archivos (mediante una opción especial en el archivo «.rc»). Si está familiarizado con Python o JavaScript, el código debería ser autoexplicativo. </para>
<para
>A continuación puede encontrar enlaces a las API de referencia. Todo aquello marcado como <emphasis
>Q_SCRIPTABLE</emphasis
> puede utilizarse en guiones. </para>

<itemizedlist>
<listitem>
<para
>Referencia de la API del objeto <ulink url="http://api.kde.org/4.x-api/kdesdk-apidocs/lokalize/html/classEditorTab.html"
>Editor</ulink
> </para>
</listitem>
<listitem>
<para
>Referencia de la API del objeto <ulink url="http://api.kde.org/4.x-api/kdesdk-apidocs/lokalize/html/classLokalizeMainWindow.html"
>Lokalize</ulink
> </para>
</listitem>
<listitem>
<para
>Referencia de la API del objeto <ulink url="http://api.kde.org/4.x-api/kdesdk-apidocs/lokalize/html/classProjectTab.html"
>Project</ulink
> </para>
</listitem>
</itemizedlist>


</chapter>

<chapter id="credits">
<title
>Créditos y licencia</title>

<para
>&lokalize; </para>

<para
>Derechos de autor del programa &copy; 2007, Nick Shaforostoff <email
>shaforostoff@kde.ru</email
> </para>

<para
>Algún código se ha tomado de &kbabel;, el predecesor de &lokalize;. </para>

<para
>Derechos de autor de la documentación &copy; 2007-2008 Nick Shaforostoff <email
>shaforostoff@kde.ru</email
> </para>

<para
>Autor: <itemizedlist
> <listitem
> <para
>Nick Shaforostoff <email
>shaforostoff AT kde.ru</email
> </para>
</listitem>
</itemizedlist>
</para>

<para
>Consulte la <ulink url="http://userbase.kde.org/lokalize"
> página principal de &lokalize;</ulink
> para obtener más detalles.</para>

<para
>Traducido por <email
>santi@kde-es.org</email
>.</para
> 
&underFDL; &underGPL; </chapter>

&documentation.index;
</book>
<!--
Local Variables:
mode: sgml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

// vim:ts=2:sw=2:tw=78:noet
-->
