OmegaT 2.3.0 - Guía de usuario

# Instalando y ejecutando OmegaT

## Usuarios de Windows

### Descarga el paquete

¿Tienes una implementación de Java compatible con Java 1.5 JRE de Oracle?

- Sí: descarga OmegaT_2.3.x_Windows_without_JRE.exe .

- No / No sé: descarga OmegaT_2.3.x_Windows.exe.

  Este paquete incluye el Java Runtime Environment de Oracle. Este JRE no interferirá con otras implementaciones de Java que puedas tener instaladas en tu sistema.

### Instalando OmegaT

Para instalar OmegaT, haz doble clic en el programa descargado y sigue las instrucciones

### Añadiendo OmegaT al menú Inicio o al escritorio

Durante la instalación, el mismo programa de instalación te pregunta si deseas crear una entrada en el menú Inicio , y si deseas crear un acceso directo en el escritorio y en la barra de Inicio rápido.

También puedes crear un acceso directo más tarde arrastrando OmegaT.exe al menú Inicio, al escritorio o al Inicio rápido para enlazarlos desde allí.

### Ejecutando OmegaT

Una vez instalado OmegaT, puedes hacer clic en OmegaT.jar para ejecutarlo directamente o lo puedes lanzar directamente desde la línea de ordenes.

La forma más sencilla de lanzar OmegaT, sin embargo, es ejecutando el programa OmegaT.exe . Las opciones para arrancar el programa en este caso, se pueden leer en el archivo OmegaT.l4j.ini , que reside en el mismo directorio que el archivo exe y que puedes editar para reflejar tu configuración. El siguiente ejemplo para el archivo INI reserva 1GB de memoria, establece el Francés como el idioma del usuario y Canadá como país:

`# OmegaT.exe configuración para ejecución
# Para usar un parámetro, quita la almohadilla '#' antes del '-'
# Memory -Xmx1024M
# Language -Duser.language=FR
# Country -Duser.country=CA`

### Actualizando OmegaT

Esta información aplica sólo a las versiones de OmegaT "tradicionales" para Windows. No aplican a las versiones Web Start, que se actualizan automáticamente, ni a las versiones de plataformas cruzadas instaladas en Windows.

Si ya tienes instalada una versión de OmegaT en tu PC y deseas actualizarla a una versión más reciente, tienes dos opciones:

- Instalar sobre la instalación existente. Para ello, sólo tienes que seleccionar el directorio de instalación igual que el de la instalación existente al instalar la nueva versión. La versión "antigua" de OmegaT se sobrescribirá, pero se mantendrán la misma configuración. Esto incluye las preferencias definidas dentro de OmegaT, los cambios que hayas realizado a tu archivo `OmegaT.l4J.ini`, y también el guión de inicio (.bat), si uno está utilizando.

Con este método, también puedes descargar la versión "Windows sin JRE", ya que la nueva instalación utilizará el JRE existente.

- Instalación en un nuevo directorio. Esto te permitirá mantener las dos versiones lado a lado, lo cual posiblemente es lo que deseas hacer, hasta que te sientas cómodo con la nueva versión. Este método también utiliza las preferencias y ajustes que hayas realizado desde OmegaT. En este caso, sin embargo:

  - Si haz realizado cambios en tu archivo `OmegaT.l4J.ini` y / o utilizas un archivo .bat, los debes copiar de nuevo.

  - Si la instalación de OmegaT existente es una versión "Windows con JRE", la nueva versión también debe ser una versión "Windows con JRE".

## Usuarios de Linux (Intel)

### Descarga el paquete adecuado

¿Tienes una implementación de Java compatible con Java 1.5 JRE de Oracle?

- Sí: descarga OmegaT_2.3.x_Without_JRE.zip .

- No / No sé: descarga OmegaT_2.3.x_Linux.tar.bz2.

  Este paquete incluye el Java Runtime Environment de Oracle. Este JRE no interferirá con otras implementaciones de Java que puedas tener instaladas en tu sistema.

### Instalando OmegaT

Desempaca/descomprime el archivo descargado. Esto creará un directorio omegat/ en el directorio de trabajo en el que se encuentran todos los archivos necesarios para ejecutar OmegaT. Para descomprimir el archivo .tar.gz :

$ tar xf archivo_descargado.tar.gz

### Añadiendo OmegaT a tus menús (KDE) o paneles (Gnome)

#### Usuarios de KDE 4

Puedes agregar OmegaT a tus menús de la siguiente manera:

- Presiona las teclas Alt+F2 para mostrar el KRunner. Escribe kmenuedit+enter para ejecutar la orden. Aparece el KMenuEditor. En KMenuEditor selecciona Archivo → Nuevo elemento.

- Entonces, después de seleccionar un menú adecuado, agrega un submenú/elemento con Archivo → Nuevo Submenú y Archivo → Nuevo elemento . Ingresa OmegaT como nombre del nuevo elemento.

- En el campo "Orden", utiliza el botón de navegación para encontrar tu guión de inicio OmegaT (el archivo con el nombre OmegaT en el directorio descomprimido) y selecciónalo.

- Haz clic en el botón con el icono (a la derecha de los campos Nombre/Descripción/Comentario)

- Otros iconos - Examina y navega al subdirectorio /images en el directorio OmegaT de la aplicación. Selecciona el icono OmegaT.png.

- Finalmente, guarda los cambios con Archivo → Guardar.

#### Usuarios de GNOME

Puedes agregar OmegaT a tus menús de la siguiente manera:

- Haz clic con el botón derecho en el panel - Añadir nuevo lanzador.

- Ingresa "OmegaT" en el campo "Nombre"; en el campo "Orden", usa el botón de navegación para localizar tu guión de inicio de OmegaT (el archivo llamado OmegaT en el directorio descomprimido). Selecciónalo y confirma con Aceptar.

- Haz clic en el botón icono, y luego presiona Examinar... y ve al subdirectorio /images en el directorio de la aplicación OmegaT. Seleccione el icono OmegaT.png . Posiblemente GNOME no muestre los archivos de icono en los formatos disponibles y en un principio parece esperar un archivo SVG, pero si seleccionas el directorio, los archivos deben aparecer y puedes seleccionar OmegaT.png.

### Ejecutando OmegaT

Puedes lanzar OmegaT desde la línea de ordenes con un guión que incluya opciones de inicio, o puedes hacer clic en OmegaT.jar para lanzarlo directamente. Los métodos difieren en función de la distribución. Asegúrate de que tus ajustes en PATH son correctos y que los archivos .jar están asociados correctamente con un lanzador de Java. Consulta "lanzando desde la línea de ordenes" para más información.

## Usuarios de Mac OS X

### Descargando el paquete

OmegaT 2.3 requiere Java 1.5 para ejecutarse. Usa "Actualiza Software..." en el menú Apple para actualizar tu versión de Java.

Descarga OmegaT_2.3.x_Mac.zip.

### Instalando OmegaT

Haz doble clic en OmegaT_2.3.x_Mac.zip para descomprimirlo. Esto crea un directorio llamado OmegaT . El directorio contiene dos archivos: index.html y OmegaT.app. Copia el directorio al directorio correspondiente (por ejemplo, Aplicaciones). Una vez hecho esto, puedes eliminar el archivo OmegaT_2.3.x_Mac.zip , ya no es necesario.

### Añadiendo OmegaT al Dock

Arrastra y suelta OmegaT.app en el Dock.

### Ejecutando OmegaT

Haz doble clic en OmegaT.app o haz clic en su ubicación en el Dock.

Para acceder a Info.plist , Haz clic en OmegaT.app y selecciona "Mostrar contenido del paquete", a continuación, abre el archivo haciendo clic derecho sobre él y selecciona el editor de texto de tu elección. También puedes "cd" directamente desde la línea de ordenes y abrir Info.plist en un editor de línea de ordenes como emacs o vi.

Puedes modificar las Propiedades así como la parte VMOptions .

Si deseas agregar valores a VMOptions , deja un espacio entre ellos. Por ejemplo, `-Xmx1024M -Duser.language=ja` lanzará OmegaT con 1024MB de memoria y con la interfaz de usuario en japonés.

Para iniciar varias instancias de OmegaT.app , haz doble clic en el archivo JavaApplicationStub ubicado en OmegaT.app/Contents/MacOS/ .

Usa el archivo OmegaT.jar que se encuentra en OmegaT.app/Contents/Resources/Java/ para lanzar OmegaT desde la línea de ordenes. Consulta "lanzando desde la línea de ordenes" para más información.

### Golosinas de Mac OS X

OmegaT.app se puede acceder desde los servicios de Mac OS X. De este modo se puedes seleccionar una palabra en cualquier parte y utilizar los servicios de OmegaT para ver esa palabra, por ejemplo, en Spotlight o en Google. También puedes utilizar AppleScript o Automator para crear servicios o guiones que automaticen acciones frecuentes

## Otros sistemas

Esta información se aplica a sistemas como Solaris SPARC/x86/x64, Linux x64/PowerPC, Windows x64

### Descarga el paquete adecuado

OmegaT está disponible junto con un JRE Java de Oracle para Linux (Intel x86) y Windows. Los usuarios de otras plataformas (Linux PowerPC, Linux x64, Solaris SPARC/x86/x64, Windows 64, etc.) deben tener un JRE de Java compatible corriendo en su sistema para ser capaces de utilizar OmegaT.

¿Tienes una implementación de Java compatible con Java 1.5 JRE de Oracle?

- Sí: descarga OmegaT_2.3.x_Windows_without_JRE. zip Este paquete se puede utilizar en cualquier plataforma donde esté instalado un JRE compatible con el JRE de Java 1.5.

- No sé: abre una terminal y escribe "java -version". Si devuelve una "orden no encontrada" o algo similar, lo más probable es que Java no está instalado en tu sistema

- No: consigue un JRE de Java para tu sistema (ve abajo) y descarga OmegaT_2.3.x_Without_JRE.zip .

  Oracle proporciona JRE para Solaris SPARC/x86 (Java 1.5) y para Linux x64, Solaris x64, Windows x64 (Java 1.5) en http://www.oracle.com/technetwork/java/archive-139210.html

  IBM proporciona JRE para Linux PowerPC en http://www.ibm.com/developerworks/java/jdk/linux/download.htm

  Sigue las instrucciones de instalación del paquete que necesitas.

### Instalando OmegaT

Para instalar OmegaT, simplemente descomprime el archivo OmegaT_2.3.x_Without_JRE.zip . Esto crea un directorio ./OmegaT_2.3.x_Without_JRE / en el directorio actual con todos los archivos necesarios para ejecutar OmegaT.

### Instalando convenientes accesos directos

Sigue las instrucciones de tu sistema para instalar atajos a OmegaT en lugares convenientes a tu elección.

### Ejecutando OmegaT

Una vez instalado OmegaT, lo puedes lanzar directamente desde la línea de ordenes, puedes crear un archivo que incluya los parámetros de lanzamiento de la línea de ordenes o puedes hacer clic en OmegaT.jar para ejecutarlo directamente. Los métodos difieren en función de la distribución. Asegúrate de que los ajustes de tu PATH son correctos y que los archivos .jar están correctamente asociados con un lanzador de Java. Consulta "lanzando desde la línea de ordenes" para más información.

## Usando Java Web Start

La tecnología Java Web Start (parte de Java 1.5 y superior) se puede utilizar para implementar aplicaciones de software independiente de Java con un solo clic en la red. Java Web Start se asegura utilizar la última versión de la aplicación, así como la versión correcta de Java Runtime Environment (JRE) utilizada. Para iniciar OmegaT por primera vez con Java Web Start, carga de la siguiente URL en tu navegador:

http://omegat.sourceforge.net/webstart/OmegaT.jnlp

Descarga el archivo OmegaT.jnlp y haz clic en él. Durante la instalación, dependiendo de tu sistema operativo, puedes recibir varias advertencias de seguridad. Los permisos que le des a esta versión (que pueden aparecer como "acceso sin restricciones al equipo") son idénticos a los permisos que das a la versión local, es decir, permites el acceso al disco duro del ordenador. Subsecuentes clics en OmegaT.jnlp comprobarán si hay actualizaciones, instalándolas, si las hay, y luego inician OmegaT. Tras la instalación inicial puedes, por supuesto, usar OmegaT.jnlp también cuando no estés conectado.

Privacidad : OmegaT Java Web Start no guarda ninguna información más allá del equipo en el que lo ejecutes. La aplicación se ejecuta solamente en tu máquina. Tus documentos y memorias de traducción permanecen en el equipo, y el proyecto OmegaT no tendrá acceso a tu trabajo o información.

Ten en cuenta que si necesitas o deseas utilizar cualquiera de los argumentos de la orden de lanzamiento (ve arriba), debes utilizar la instalación normal.

## Iniciando OmegaT desde la línea de ordenes

Normalmente, no es necesario iniciar OmegaT desde la línea de ordenes. Sin embargo, la alternativa de línea de ordenes te permite controlar y modificar el comportamiento del programa. Hay dos maneras de ejecutar OmegaT usando la línea de ordenes.

### Abriendo una ventana de la línea de ordenes

Una ventana de línea de ordenes también se conocida como una "ventana de terminal". En Windows se llama "ventana MS-DOS" y está disponible desde el menú Inicio, dentro de programas, a través del elemento "MS-DOS". La equivalente en Mac OS X es la aplicación Terminal ubicada en Aplicaciones → Utilidades.

Para lanzar OmegaT, normalmente debes escribir dos ordenes. La primera de ellas es:

`cd {directorio}`

donde {directorio} es el nombre del directorio con la ruta completa, en la que tu programa OmegaT - en concreto, el archivo OmegaT.jar - se encuentra. En la práctica, este comando será algo como esto:

En Windows

`cd C:\Archivos de programa\OmegaT`

En Mac OS X

``cd <ubicación de OmegaT.app>/OmegaT.app/Contents/Resources/Java/``

En Linux

`cd /usr/local/omegat`

Esta orden te lleva al directorio que contiene el archivo ejecutable de OmegaT. La segunda orden es la orden que en realidad lanza a OmegaT. En su forma más básica, esta orden es:

`java -jar OmegaT.jar`

Preste especial atención a las mayúsculas - ¡el programa no se iniciará, si introduces omegat en lugar de OmegaT !

Este método tiene una ventaja particular de iniciar parámetros adecuados para encontrar las causas de problemas: si se produce un error durante el uso del programa, mostrará un mensaje de error en la ventana de la terminal, el cual puede contener información útil sobre la causa del error.

El método anterior es poco práctico para lanzar un programa rutinariamente. Por esta razón, las dos ordenes descritas anteriormente están contenidas en un archivo (un "guión", también llamado ".bat" en sistemas Windows).

Cuando ejecutas ese archivo, las ordenes dentro de él se ejecutan automáticamente. En consecuencia, para realizar cambios en el orden de inicio, es suficiente hacer las modificaciones en el archivo.

### Argumentos de la orden de lanzamiento

La orden básica ya se ha mencionado anteriormente. Los cambios a esta orden implican la adición de "argumentos". Los argumentos se añaden después del "Java" inicial, y antes de "-jar OmegaT.jar" . Ten en cuenta que en Windows puedes cambiar el archivo OmegaT.l4j.ini para reflejar tus preferencias. En Mac OS X, puedes cambiar el Info.plist ubicado en OmegaT.app/Contents/ para hacer lo mismo.

A continuación se muestra una lista de posibles argumentos. Los usuarios avanzados pueden obtener más información acerca de los argumentos escribiendo man Java en la ventana de la terminal.

- Idioma de la interfaz de usuario

  -Duser.language=XX Normalmente, es decir, cuando lanzas OmegaT sin ningún tipo de argumento, el programa primero detecta el idioma del sistema operativo del usuario. Si está disponible una interfaz de usuario en ese idioma, OmegaT lo utiliza. Por lo tanto, si el sistema operativo del usuario está en Ruso y OmegaT ha sido traducido al Ruso, OmegaT muestra una interfaz de usuario Rusa, los menús Rusos, etc. Si el idioma del sistema del usuario no está disponible, OmegaT por omisión se presenta en Inglés. Este es el comportamiento estándar.

  El argumento "-Duser.language=XX" provoca que OmegaT utilice el idioma especificado en lugar del idioma del sistema operativo del usuario. "XX" en la orden representa el código de dos dígitos del idioma deseado. Para lanzar OmegaT con una interfaz en Francés (por ejemplo en un sistema operativo Ruso), la orden sería:

  `java -Duser.language=fr -jar OmegaT.jar`

- Configurando el país del usuario

  -Duser.country=XX Además del idioma, también puedes especificar el país, por ejemplo, CN o TW en el caso del idioma Chino. Para mostrar la guía de inicio rápido en el idioma deseado, es necesario especificar el idioma y país. Esto es necesario incluso si sólo hay una combinación disponible, como pt_BR en el caso del Portugués/Brasil.

- Suavizando el contorno del tipo de letra - (sólo Java 1.5)

  -Dswing.aatext=true Este argumento afecta el suavizado del contorno del tipo de letra, mejorando así su apariencia.

- Asignando memoria

  -XmxZZM Esta orden asigna más memoria a OmegaT. De manera predeterminada, se asignan 256 MB, por lo que no hay ninguna ventaja en asignar una cifra menor a esta. "ZZ" determina la cantidad de memoria asignada, en megabytes. La orden para lanzar OmegaT con 1024 MB (1 GB) de memoria asignada por lo tanto es:

  `java -Xmx1024M -jar OmegaT.jar`

- Direcciones IP del anfitrión sustituto

  -Dhttp.proxyHost=nnn.nnn.nnn.nnn la dirección IP del servidor sustituto, si tu sistema se utiliza como sustituto

- Número de puerto del servidor sustituto

  Dhttp.proxyPort=NNNN el número de puerto que tu sistema utiliza para acceder al servidor sustituto.

Puedes combinar los argumentos: para lanzar OmegaT con todos los ejemplos descritos anteriormente, la orden sería:

`java -Dswing.aatext=true -Duser.language=pt -Duser.country=BR -Xmx1024M -DDhttp.proxyHost=192.168.1.1 -Dhttp.proxyport = 3128 -jar -OmegaT.jar`

### OmegaT en el modo de línea de ordenes

El propósito de la modalidad de consola es usar OmegaT como una herramienta de traducción en un entorno de programación. Cuando lo inicias en modo consola, no se carga la interfaz gráfica de usuario (por lo tanto funciona en cualquier consola) y automáticamente se procesa el proyecto dado conforme a lo solicitado.

#### Requisitos previos

Para ejecutar OmegaT en el modo de línea de ordenes, debe estar presente un proyecto OmegaT válido. La ubicación no importa, puesto que de cualquier modo hay que añadirla a iniciar la línea de ordenes.

Si necesitas alterar la configuración, los archivos de configuración deben estar disponibles. Lo puedes lograr de dos maneras:

- Ejecuta OmegaT normalmente (con la interfaz gráfica de usuario) y especifica la configuración. Si inicias OmegaT en modo consola, se utilizará la misma configuración.

- Si no puedes ejecutar OmegaT normalmente (sin entorno gráfico disponible): copia los archivos de configuración de alguna otra instalación de OmegaT en otra máquina a un directorio específico. La ubicación no importa, ya que se puede añadir al iniciar la línea de ordenes. Los archivos importantes son `filters.conf` y `segmentation.conf` y los puedes encontrar en el directorio home del usuario (por ejemplo, `C:\Documents and Settings\%usuario%\OmegaT` bajo Windows, `%Usuario%/.Omegat/` en Linux)

#### Arrancando en modo consola

Para iniciar OmegaT en modo consola, algunos parámetros adicionales se le han pasado al inicio. El más importante es `<directorio-del-proyecto>`, y opcionalmente, `--config-dir=<directorio-de-configuración>.` Ejemplo:

`java -jar OmegaT.jar /ruta/al/proyecto \`

`--config-dir=/ruta/a/los/archivos-de-configuración/ \`

`--mode=console-translate|console-createpseudotranslatetmx|console-align`

`--source-pattern={regexp}`

Ten en cuenta que todos los parámetros comienzan con un carácter de guión '-' doble.

Explicación:

- `<directorio-del-proyecto>` dice a OmegaT dónde se encuentra el proyecto a traducir. Si se proporciona, OmegaT se inicia en modo consola y traducirá el proyecto.

- `--config-dir=<directorio-de-configuración>` dice a OmegaT en cual directorio están los archivos de configuración. Si no se da, OmegaT vuelve a los valores predeterminados del directorio (OmegaT en el hogar del usuario, o en su defecto, el directorio de trabajo actual). Ten en cuenta los dobles caracteres de guión '-'

- `--mode`=...- OmegaT se inicia en modo de consola para realizar automáticamente uno de los siguientes servicios

  - `--mode=console-translate`

    En este modo, OmegaT intentará traducir los archivos en /fuente/ con las memorias de traducción disponibles. Esto es útil para ejecutar OmegaT en un servidor con archivos TMX alimentados automáticamente a un proyecto.

  - `--mode=console-createpseudotranslatetmx`

    En este modo, OmegaT creará un TMX para todo el proyecto. Parámetros adicionales permiten al usuario decidir sobre los valores para las entradas de destino:

    --pseudotranslatetype=[equal|empty]

  - `--mode=console-align`

    En este modo, OmegaT alinea las propiedades de Java encontradas en el directorio `/fuente/` del proyecto a las propiedades de Java encuentra en la ubicación especificada. El TMX resultante se almacena en el directorio `/omegat/` bajo el nombre `align.tmx`.

    En este caso se requiere un parámetro adicional, especificando la ubicación de los datos destino:

    `--alignDir={ubicación de los archivos traducidos}`

    `alignDir` debe contener una traducción en el idioma destino del proyecto. (Por ejemplo, si el proyecto es EN→FR, alignDir debe contener un paquete terminando con _fr). El tmx resultante se almacena en el directorio `omegat` bajo el nombre `align.tmx`.

- `--source-pattern={regexp}`

  Cuando se ha utilizado el modo esta opción, debe especificar que los archivos se procesan automáticamente.. Si no se especifica el parámetro, todos los archivos serán procesados. He aquí algunos ejemplos típicos para limitar tu elección:

  - `.*\.html`

    Todos los archivos HTML se traducirán - no es que el punto habitualmente *.html tenga que escaparse (\.) según lo especificado por las reglas de las expresiones regulares

  - `prueba\.html`

    Únicamente el archivo prueba.html en la raíz del directorio fuente será traducido. Si hay otros archivos llamados prueba.html en otros directorios, serán omitidos.

  - `dir-10\\prueba\.html`

    Sólo el archivo prueba.html en el directorio dir-10 será procesado. Una vez más ten en cuenta que la barra invertida también se escapó.

#### Opción "quiet"

Es un parámetro adicional de línea de ordenes específica para el modo consola: `--quiet.` En modo silencioso, se registra menos información en pantalla. No se muestran los mensajes que generalmente se encuentran en la barra de estado.

Uso: `java -jar OmegaT.jar /ruta/al/proyecto --quiet`

## Construyendo OmegaT desde código fuente

Ten en cuenta que se necesita el programa ant ( http://ant.apache.org/bindownload.cgi ) para construir tu propia versión de OmegaT. Descomprime el archivo OmegaT_2.3.x_Source.zip y entra en el directorio OmegaT_2.3.x_Source o entra en el directorio ./OmegaT/ del SVN descargado. Por favor, asegúrate de que está presente un archivo build.xml en ese directorio. A continuación, en la línea de ordenes, escribe:

`$ ant jar release`

Esto creará una distribución completa de OmegaT en el directorio ./dist/, donde se encuentran todos los archivos necesarios para ejecutar OmegaT.