Documentation/Development/UsingOmegaT/es

OmegaT es una herramienta de traducción asistida por computadora (CAT, por sus siglas en inglés) de código abierto. Está escrita en Java, traducida a numerosos idiomas y existe una gran comunidad a su alrededor. Aquí describiremos únicamente los pasos necesarios para utilizar la herramienta con los archivos .odt. Léase la documentación de OmegaT para aprender a usarla en tu proceso de traducción.

Miloš Šrámek ha impartido una presentación sobre su flujo de trabajo (¡muchas gracias!) y esta página describe el proceso basado en los datos que él compartió.

Usar OmegaT
Descarga el software desde su sitio web oficial: http://www.omegat.org/. Incluso si utilizas Linux, los paquetes que provienen de los repositorios oficiales de las distribuciones muchas veces están desactualizados, por ello es mejor instalar la versión del sitio web del programa. Además, la versión de Java requerida puede no coincidir con la ofrecida por la distro, así que elige la descarga con instalador de Java.

Para instalarlo, sigue el procedimiento común de instalación de aplicaciones en Windows. Para Linux existe una secuencia de órdenes automática (script) que colocará el paquete en /opt e instalará Java a nivel de usuario en caso de que exista otra instalación de sistema; tan solo ejecuta  y listo.

Ahora, descarga la guía que quieras traducir en el formato .odt. Abre OmegaT y sigue estos pasos:
 * Crea un proyecto nuevo llamado «GuideTrans» por ejemplo. Esto creará un directorio nuevo dentro de tu carpeta personal.
 * En la ventana «Project creation» establece los idiomas de origen y de destino, deja la casilla «Segmentation» marcada.
 * Selecciona la ubicación de la guía que descargaste para el idioma de origen
 * Deja las demás rutas como están; la subcarpeta correspondiente se creará en la carpeta «GuideTrans».
 * Pulsa en «OK» y ya puedes empezar a traducir la guía.

Cuando finalices tu traducción, crea un documento .odt que se ubicará en la subcarpeta GuideTrans/target al seleccionar «Create translated files» bajo el menú «Project».

Recuerda que en la carpeta del proyecto («GuideTrans» en nuestro caso) existen varias subcarpetas a las que puedes acceder: «dictionary», «glossary», «source», «target» y «translation memory». También hay varios archivos con la extensión .tmx (archivos de memoria de traducción) en la carpeta «omegat». No dudes en consultar la documentación de OmegaT para sacar el máximo partido de esta útil herramienta.

Adición de archivo UI.po
La traducción de la interfaz de usuario y la ayuda de LibreOffice es mantenida por los equipos de l10n mediante Pootle. El formato de los archivos es .po. El problema que presentan los archivos .po es que están desperdigados en muchas carpetas. Pero, si utilizamos una herramienta llamada Translate Toolkit, podemos obtener un gran archivo .csv a partir de estos. Este .csv se puede añadir a OmegaT para que funcione como glosario. Este glosario será muy importante: al traducir con él podrás utilizar los términos exactos usados en los menús y los cuadros de diálogo, lo que asegurará la coherencia y aumentará la calidad de las guías.

Para configurar esto: [estos pasos son para Debian, si sabes hacerlo en Windows, agrega tus instrucciones :)]:

Aparecerán sugerencias de traducción en el área de glosario de OmegaT y en el menú contextual.
 * Descarga el archive UI.po desde aquí: https://translations.documentfoundation.org/XX/libo_ui/ donde XX es el código de tu idioma.
 * Descarga e instala Translate Toolkit: http://toolkit.translatehouse.org/index.html (hay un instalador para Windows). En Linux, si ya has instalado una versión anterior, se recomienda eliminarla antes de instalar la más reciente.
 * Crea una carpeta (podir en este ejemplo) y descomprime los archivos descargados
 * Usa la consola para convertir los archivos .po en .csv de podir a csvdir (ubicación para los .csv)
 * Ahora crearemos el gran archivo .csv
 * Entra en la carpeta csvdir y abre el archivo lo.csv con LibreOffice, elimina la primera columna que contiene comentarios y guarda el archivo como .csv de texto usando tabulaciones como separadores de columnas.
 * Copia el archivo en la carpeta GuideTrans/glossary.

Añadir un tercer archivo
El propósito de añadir un tercer archivo es que este funcione como memoria de traducción. Imagina que tienes una guía de una versión anterior ya traducida y quieres actualizarla a la versión en inglés más reciente pero basada en la traducción existente. Deberemos transformar el archivo .odt de la traducción existente en un archivo .tmx. Antes de la transformación, asegúrate de que el archivo no contiene formato directo para evitar la creación de etiquetas adicionales. Luego:


 * Crea un proyecto nuevo en OmegaT llamado Aux
 * Establece la visualización de segmentos de modo tal que solo se muestre el texto
 * Copia la guía traducida en la carpeta Aux/source
 * Ahora, mediante el ratón, copia todo el texto de ambos archivos y pégalo en un archivo nuevo.
 * Guarda el archivo nuevo como texto sencillo (.txt), comprueba el alineamiento de los segmentos con la herramienta http://sourceforge.net/projects/aligner/ y expórtalo como un archivo .tmx.

Manage a Team Project
This part explains how to use the Team Project functionality of OmegaT. The Team Project feature in OmegaT makes it possible for multiple translators to work on the same translation project, over the internet, using a synchronised project memory and a synchronised project glossary.

There are two parts in this guide. The first part will get you set up with the repository on GitHub to have the project synchronised. The second part is about how to set up the project on OmegaT. The team leader will set up the OmegaT part or ask Sophie on the Documentation project to set it for them, while the translators will only have to give the URL of the repository to OmegaT and translate as usual without taking care of anything else.

GitHub part
The first thing is to create a directory for your project on GitHub under the OmegaT repository. Well you need to be added to the OmegaT group too.


 * 1) To be added to the project
 * 2) * create an account on GitHub
 * 3) * ask Sophie to be added to the LO/OmegaT group
 * 4) Adding your language directory
 * you need to have svn installed on your computer
 * check out the repository using subversion to create a local repository:
 * enter OmegaT/trunk and create the xx directory where xx is your language code

https://www.dropbox.com/sh/xast59mptyxmj0u/AAC_jDmdALFrqUyShx1rzCOIa?dl=0
 * download and unzip lo-guides-lang-template.zip. This template has been prepared by Miloš and will create what is needed in your repository, which you can get from


 * change  for   in the LOGuides/omegat.project file, where XX is your language code


 * copy the LOGuides and LOGuides-graphic into the OmegaT/trunk/xx directory

(if you do not want the odg files with screenshots, either delete LOGuides-graphics or do not add it to svn. They may help, however, since besides screenshots there are also some drawings)
 * add your language (xx is your language code) repository to svn


 * you may try to open the project in OmegaT now (do not do that prior to 'svn add', since OmegaT will create a few files, which should not be stored in the repository)


 * commit your language project (xx is your language code) with all the content inside

OmegaT part

 * 1) Open the project from OmegaT, replace xx by your language code in the URL:
 * 2) * use Project -> Download team project
 * 3) * enter "https://github.com/LibreOffice/OmegaT/trunk/xx/LOGuides" in the Repository URL Box and hit tab - if OK, OmegaT will detect repository type and confirm that it is a subersion repository just below the field.
 * 4) * enter the name of the local work folder (or create it - do not use the original which you have used to check out by subversion)
 * 5) * Hit 'OK'. OmegaT in its lower left corner shows progress
 * 6) Start translating.

Any time you will save the project, it will be synchronized on GitHub, the glossary and the translation will be updated.

If there are other translators who want to work on the same project, they will need to create an account on GitHub. We will add them to the team and they will then have to follow the steps in the OmegaT part. They will never have to visit GitHub, everything will be handled by OmegaT.

The next steps are, as explained above:
 * create glossary with GUI translation using the .po files on Pootle
 * create tmx files from old translations to reuse them as a third file
 * have everything translated by "Google translate" to save a lot of typing