Chapter 1. Installazione e avvio di OmegaT

Si possiede un'implementazione Java compatibile con Java 8 JRE di Oracle?

Per installare OmegaT, fare doppio-clic sul programma scaricato.

All'inizio dell'installazione è possibile selezionare la lingua da utilizzare durante l'installazione. Nella finestra successiva è possibile indicare che la quale lingua selezionata dovrà essere utilizzata in OmegaT. Attivando la casella corrispondente, il file OmegaT.l4J.ini verrà modificato per utilizzare la lingua selezionata (per i dettagli, si veda la sezione seguente). Successivamente, una volta accettato il contratto di licenza, il programma chiederà se si vuole creare un gruppo nel menu Start , e un collegamento nel desktop e nella barra di avvio rapido: è possibile creare queste scorciatoie anche in seguito, trascinando l'icona OmegaT.exe nel desktop o nel menu Start. L'ultimo riquadro permette di dare uno sguardo al file leggimi e a quello delle modifiche relativo alla versione installata.

Una volta installato, è possibile avviare OmegaT sia facendo clic direttamente su OmegaT.jar , sia da riga di comando.

Il metodo più semplice per avviare OmegaT è, comunque, eseguire il programma OmegaT.exe. In questo caso, le opzioni per l'avvio del programma saranno lette dal file OmegaT.l4J.ini, che si trova nella stessa cartella del file eseguibile e che può essere modificato affinché rispecchi le proprie impostazioni. L'esempio di file INI che segue riserva 1 GB di memoria, richiede il francese come lingua dell'utente e il Canada come nazione:

# OmegaT.exe runtime configuration
# To use a parameter, remove the '#' before the '-'
# Memory
-Xmx1024M
# Language
-Duser.language=FR
# Country
-Duser.country=CA

Nota: se OmegaT risultasse lento durante le sessioni di desktop remoto in Windows, sarà possibile usare questa opzione:

-Dsun.java2d.noddraw=false

Queste informazioni si riferiscono solo alle versioni "tradizionali" di OmegaT per Windows. Non sono applicabili alle versioni con Web Start, che vengono aggiornate in automatico, né a quelle multi-piattaforma installate su Windows.

Se nel proprio computer è presente una versione di OmegaT e si ha intenzione di aggiornarla, esistono due possibilità:

Con questo metodo è possibile scaricare anche la versione "Windows without JRE", dato che la nuova installazione utilizzerà il JRE esistente.

Si possiede un'implementazione Java compatibile con Java 8 JRE di Oracle?

Decomprimere (untar) il file scaricato. L'operazione creerà una cartella omegat/ nella cartella prescelta, in cui saranno presenti tutti i file necessari per l'avvio di OmegaT. Per decomprimere il file .tar.gz:

$ tar xf file_scaricato.tar.gz

È possibile avviare OmegaT dalla riga di comando con uno script che includa le opzioni di avvio, oppure lo si può avviare direttamente facendo clic su OmegaT.jar. I metodi variano in base alla distribuzione. Assicurarsi che le impostazioni del proprio PERCORSO siano corrette e i file .jar correttamente associati a un avviatore Java. Per ulteriori informazioni consultare la sezione "Avvio da riga di comando" più sotto.

OmegaT contiene Java JRE 1.8

Scaricare OmegaT_4.n.n_Mac.zip.

Fare doppio clic su OmegaT_4.n.n_Mac.zip per decomprimere il file. Viene creata la cartella OmegaT. La cartella contiene due file: index.html e OmegaT.app. Copiare la cartella nella cartella prescelta (es., Applicazioni). Una volta fatto, è possibile eliminare il file OmegaT_4.n.n_Mac.zip, poiché non più necessario.

Trascinare e rilasciare OmegaT.app sulla Dock.

Fare doppio clic su OmegaT.app o sulla sua posizione nella Dock.

È possibile cambiare il comportamento di OmegaT modificando sia la sezione Properties, sia il file Configuration.properties contenuti nel pacchetto.

Per aprire Configuration.properties, fare clic col pulsante destro su OmegaT.app e selezionare "Show Package Contents", poi aprirlo in Contents/Resources facendovi sopra clic col pulsante destro e selezionando il proprio editor di testo preferito. È possibile anche arrivare direttamente alla cartella dalla riga di comando (con cd) e aprire Configuration.properties in un editor a riga di comando come emacs o vi.

Le opzioni vengono cambiate modificando Configuration.properties. Per ottenere delle opzioni predefinite, abilitare un parametro rimuovendo il carattere # all'inizio della riga. Per esempio, user.language=ja (senza #) avvierà OmegaT con l'interfaccia giapponese.

Per cambiare la quantità di memoria disponibile, modificare il file OmegaT.app/Contents/Info.plist e decommentare la riga <!-- <string>-Xmx6g</string> --> rimuovendo <!-- e -->. OmegaT sarà avviato con 6 GB di memoria; cambiare 6g con la quantità prescelta.

Per avviare più istanze di OmegaT.app, fare doppio clic sul file OmegaT che si trova in OmegaT.app/Contents/MacOS/.

Usare il file OmegaT.jar che si trova in OmegaT.app/Contents/MacOS/Java/ per avviare OmegaT dalla riga di comando. Per ulteriori informazioni consultare la sezione "Avvio da riga di comando" più sotto.

OmegaT.app può utilizzare i servizi di macOS. È dunque possibile selezionare una parola in qualsiasi punto di OmegaT e utilizzare i Servizi per controllarla, per esempio in Spotlight o in Google. È pure possibile usare AppleScript o Automator per creare Servizi o script di automazione delle azioni frequenti.

OmegaT è disponibile con Oracle Java JRE per le piattaforme Linux (Intel x86) e Windows. Per essere in grado di usare OmegaT, gli utenti di piattaforme differenti (Linux PowerPC, Linux x64, Solaris SPARC/x86/x64, Windows x64, e via discorrendo) devono avere installato un JRE Java compatibile e funzionante sul proprio sistema.

Si possiede un'implementazione Java compatibile con Java 8 JRE di Oracle?

Per installare OmegaT, decomprimere il file OmegaT_4.n.n_Without_JRE.zip. L'operazione crea una sotto-cartella ./OmegaT_4.n.n_Without_JRE/ nella cartella prescelta, con tutti i file necessari per l'avvio di OmegaT.

Seguire le istruzioni del proprio sistema per installare i collegamenti di OmegaT nelle posizioni prescelte.

Una volta installato OmegaT, è possibile avviarlo dalla riga di comando, creare uno script che includa i parametri per la riga oppure fare clic su OmegaT.jar per avviarlo in modo diretto. I metodi variano in base alla distribuzione. Assicurarsi che le impostazioni del proprio PERCORSO siano corrette e i file .jar correttamente associati a un avviatore Java. Per ulteriori informazioni consultare la sezione "Avvio da riga di comando" più sotto.

Una finestra a riga di comando viene anche chiamata "finestra di terminale". In Windows è chiamata "finestra MS-DOS" ed è disponibile all'interno dei Programmi nel menu Start, tramite la voce "MS-DOS". L'equivalente macOS è l'applicazione Terminale, che si trova in Applicazioni/Utilità.

Per avviare OmegaT, si devono, in genere, digitare due comandi. Il primo di questi è:

cd cartella

dove cartella è il nome della cartella, nel suo percorso completo, in cui risiede il programma OmegaT (in particolare il file OmegaT.jar). Nella pratica, questo comando assomiglierà ai seguenti:

In Windows

cd C:\Program Files\OmegaT

In macOS

cd <posizione OmegaT.app>/OmegaT.app/Contents/Resources/Java/

In Linux

cd /usr/local/omegat

Il comando fa in modo che ci si sposti nella cartella contenente il file eseguibile di OmegaT. Il secondo comando è quello che avvia OmegaT. Nella sua forma base è:

java -jar OmegaT.jar

È importante prestare attenzione alle maiuscole: nei sistemi operativi diversi da Windows, il programma non si avvierà se si digita omegat anziché OmegaT!

Questo metodo presenta il particolare vantaggio di essere adatto per ricercare le cause di problemi: se si verifica un errore durante l'uso del programma, verrà restituito un messaggio, contenente possibili informazioni utili relative alla causa dell'errore, nella finestra di terminale.

Il metodo summenzionato è, in qualche modo, un sistema impraticabile per l'avvio quotidiano di un programma. Per questo motivo, i due comandi sopra esposti sono contenuti in un file (uno "script" viene anche chiamato "file .bat" nei sistemi Windows).

Quando viene eseguito questo file, vengono automaticamente eseguiti anche i comandi al suo interno. Per eseguire modifiche ai comandi di avvio, dunque, basta modificare il file.

Il comando di base è stato già citato prima. Le modifiche a questo comando implicano l'aggiunta di "argomenti". Gli argomenti sono aggiunti dopo la parte java iniziale e prima di -jar OmegaT.jar. Si noti che in Windows è possibile cambiare il file OmegaT.l4J.ini per farlo coincidere con proprie preferenze. In altre piattaforme è possibile modificare il file Configuration.properties in Mac, o l'avviatore OmegaT in Linux in modo che esegua le stesse operazioni.

Sotto viene fornito un elenco di argomenti possibili. Gli utenti avanzati possono ottenere ulteriori informazioni sugli argomenti digitando man java nella finestra di terminale.

Gli argomenti possono essere combinati. Per avviare OmegaT con tutti gli esempi descritti sopra, il comando deve essere:

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

Lo scopo della modalità console è usare OmegaT come strumento di traduzione in un ambiente di scripting. Quando è avviato in modalità console, non viene caricata alcuna interfaccia grafica (dunque funzionerà in qualsiasi console) e il progetto dato viene elaborato automaticamente come richiesto.

java -jar OmegaT.jar /percorso/al/progetto \
    --config-dir=/percorso/al/file-di-configurazione/ \
    --config-file=/percorso/al/file-di-configurazione/ \
    --mode=console-translate|console-createpseudotranslatetmx|console-align \
    --source-pattern=regexp