Hoofdstuk 3. Installeren en uitvoeren van OmegaT

1. Windows-gebruikers
1.1. Downloaden van het pakket
1.2. Installeren van OmegaT
1.3. OmegaT uitvoeren
1.4. Upgraden van OmegaT
2. Linux (Intel)-gebruikers
2.1. Downloaden van het juiste pakket
2.2. Installeren van OmegaT
2.3. OmegaT toevoegen aan uw menu's (KDE) of panelen (Gnome)
2.4. OmegaT uitvoeren
3. Mac OS X-gebruikers
3.1. Downloaden van het pakket
3.2. Installeren van OmegaT
3.3. OmegaT toevoegen aan het dock
3.4. OmegaT uitvoeren
3.5. Mac OS X goede dingen
4. Andere systemen
4.1. Downloaden van het juiste pakket
4.2. Installeren van OmegaT
4.3. Installeren van handige sneltoetsen
4.4. OmegaT uitvoeren
5. Java Web Start gebruiken
6. OmegaT starten vanaf de opdrachtregel
6.1. Openen van een venster voor de opdrachtregel
6.2. Argumenten voor de startopdracht
6.3. OmegaT in de modus Opdrachtregel
7. OmegaT bouwen vanuit de bron

1. Windows-gebruikers

1.1. Downloaden van het pakket

Heeft u een Java-implementatie die compatibel is met Oracle's Java 1.6 JRE?

  • Ja: download OmegaT_3.n.n_Windows_without_JRE.exe.

  • Nee / Ik weet het niet: download OmegaT_3.n.n_Windows.exe.

    Dit pakket is gebundeld met Oracle's Java Runtime Environment. Deze JRE zal geen problemen veroorzaken met andere Java-implementaties die misschien al op uw systeem geïnstalleerd zijn.

1.2. Installeren van OmegaT

Dubbelklik op het programma dat u hebt gedownload om OmegaT te installeren.

Bij het begin van de installatie kunt u de taal selecteren die moet worden gebruikt gedurende de installatie. In het volgende venster kunt u aangeven dat de geselecteerde taal moet worden gebruikt in OmegaT. Als u het overeenkomende keuzevak selecteert, wordt het bestand OmegaT.l4J.ini aangepast om de geselecteerde taal te gebruiken (zie het volgende gedeelte voor details). Later, nadat u de licentieovereenkomst hebt geaccepteerd, zal het programma u vragen of u een map in het menu Start wilt maken en of u een snelkoppeling op het bureaublad en in het systeemvak wilt maken - u kunt deze snelkoppelingen later maken door OmegaT.exe naar het bureaublad of het menu Start te slepen om het van daaruit te koppelen. Het laatste frame biedt u de mogelijkheid om de bestanden readme en changes te bekijken voor de versie die u hebt geïnstalleerd.

1.3. OmegaT uitvoeren

Als OmegaT eenmaal is geïnstalleerd, kunt u klikken op OmegaT.jar om het direct te starten, of u kunt het direct vanaf de opdrachtregel starten.

De eenvoudigste manier om OmegaT te starten is echter om het programma OmegaT.exe uit te voeren. De opties voor het opstarten van het programma zullen in dit geval worden gelezen uit het OmegaT.l4J.ini-bestand, dat zich bevindt in dezelfde map als het exe-bestand en wat u kunt bewerken om uw instellingen weer te geven. Het volgende voorbeeld voor het INI-bestand reserveert 1GB aan geheugen, zal Frans als taal van de gebruiker instellen en Portugal als het land:

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

Advies: als OmegaT traag werkt in sessies van Remote Desktop onder Windows, zou u deze optie kunnen gebruiken:

-Dsun.java2d.noddraw=false

1.4. Upgraden van OmegaT

Deze informatie is alleen van toepassing op de "traditionele" Windows-versies van OmegaT. Het is niet van toepassing op de Web Start-versies, die automatisch worden geüpgraded, noch op de versies voor meerdere platformen die zijn geïnstalleerd op Windows.

Als u al een versie van OmegaT hebt geïnstalleerd op uw PC en wilt upgraden naar een meer recente versie, heeft u twee opties:

  • Installeren over de bestaande installatie heen. Selecteer eenvoudigweg dezelfde installatiemap als de bestaande installatie bij het installeren van de nieuw versie om dit te doen. De "oude" versie van OmegaT zal worden overschreven, maar alle instellingen ervan zullen worden behouden. Dit omvat ook de voorkeuren die zijn ingesteld binnen OmegaT, alle wijzigingen die u hebt gemaakt aan uw OmegaT.l4J.ini-bestand, en ook uw script om op te starten (.bat-bestand), als u er een gebruikt.

Met deze methode kunt u ook de versie "Windows without JRE" downloaden, omdat de nieuwe installatie uw bestaande JRE zal gebruiken.

  • Installeren in een nieuwe map. Hiermee zult u beide versies naast elkaar hebben staan, wat u zou kunnen doen totdat u zich op uw gemak voelt met de nieuwe versie. Deze methode zal ook de voorkeuren en instellingen gebruiken die u hebt gemaakt binnen OmegaT. In dit geval echter:

    • Als u wijzigingen hebt gemaakt in uw OmegaT.l4J.ini-bestand en/of een .bat-bestand gebruikt, moet u die kopiëren naar de nieuwe installatie.

    • Als uw bestaande installatie van OmegaT een "Windows with JRE"-versie is, moet de nieuwe versie ook een "Windows with JRE"-versie zijn.

2. Linux (Intel)-gebruikers

2.1. Downloaden van het juiste pakket

Heeft u een Java-implementatie die compatibel is met Oracle's Java 1.6 JRE?

  • Ja: download OmegaT_3.n.n_Windows_without_JRE.exe.

  • Nee / Ik weet het niet: download OmegaT_3.n.n_Linux.tar.bz2.

    Dit pakket is gebundeld met Oracle's Java Runtime Environment. Deze JRE zal geen problemen veroorzaken met andere Java-implementaties die misschien al op uw systeem geïnstalleerd zijn.

2.2. Installeren van OmegaT

Uitpakken/untarren van het gedownloade bestand. Dit zal een map omegat/ maken in de werkmap waarin u alle nodige bestanden vindt om OmegaT uit te voeren. Uitpakken van het .tar.gz bestand:

$ tar xf downloaded_file.tar.gz

2.3. OmegaT toevoegen aan uw menu's (KDE) of panelen (Gnome)

2.3.1. KDE 4-gebruikers

U kunt OmegaT als volgt aan uw menu's toevoegen:

  • Druk op Alt+F2 om KRunner weer te geven. Typ kmenuedit+enter om de opdracht uit te voeren. De KMenuEditor verschijnt. Selecteer in KMenuEditor Bestand -> Nieuw item.

  • Dan, na het selecteren van een passend menu, voeg een submenu/item toe met Bestand - Nieuw submenu en Bestand - Nieuw item. Voer OmegaT in als de naam van het nieuwe item.

  • Gebruik, in het veld "Commando", de navigatieknop om uw OmegaT startscript te vinden (het bestand genaamd OmegaT in de uitgepakte map) en selecteer dat.

  • Klik op de pictogramknop (rechts van de velden Naam/Beschrijving/Commentaar)

  • Andere pictogrammen - Bladeren en navigeer naar de submap /images in de OmegaT-toepassingsmap. Selecteer het pictogram OmegaT.png.

  • Sla tenslotte de wijzigingen op met Bestand - Opslaan.

2.3.2. Gnome-gebruikers

U kunt OmegaT als volgt aan uw menu's toevoegen:

  • Klik met rechts op het paneel - Nieuwe starter.

  • Voer "OmegaT" in in het veld "Naam"; gebruik, in het veld "Commando", de navigatieknop om uw startscript voor OmegaT te vinden (het bestand genaamd OmegaT in de uitgepakte map). Selecteer dat en bevestig met OK.

  • Klik op de pictogramknop, en druk dan op Bladeren... en navigeer naar de submap /images in de toepassingsmap OmegaT. Selecteer het pictogram OmegaT.png. GNOME kan weigeren om de pictogrambestanden weer te geven in de beschikbare indelingen en in het begin een SVGbestand verwachten, maar als de map wordt geselecteerd, zouden de bestanden moeten verschijnen en kan OmegaT.png worden geselecteerd.

2.4. OmegaT uitvoeren

U kunt OmegaT opstarten vanaf de opdrachtregel met een script dat de opties voor opstarten bevat of u kunt klikken op OmegaT.jar om het direct op te starten. Methoden verschillen, afhankelijk van de distributie. Zorg ervoor dat de instellingen van uw PATH juist zijn en dat .jar-bestanden juist zijn gekoppeld aan een Java-starter. Bekijk "Starten vanaf de opdrachtregel" hieronder voor meer informatie.

3. Mac OS X-gebruikers

3.1. Downloaden van het pakket

OmegaT bevat de Java JRE 1.8

Download OmegaT_3.n.n_Mac.zip.

3.2. Installeren van OmegaT

Dubbelklik op OmegaT_3.n.n_Mac.zip om het uit te pakken. Dit zal een map maken die OmegaT heet. De map bevat 2 bestanden: index.html en OmegaT.app. Kopieer de map naar een toepasselijke map (bijv. Toepassingen). Als u dit gedaan heeft kunt u het bestand OmegaT_3.n.n_Mac.zip verwijderen, het is niet langer nodig.

3.3. OmegaT toevoegen aan het dock

Sleep en zet OmegaT.app op het Dock neer.

3.4. OmegaT uitvoeren

Dubbelklik op OmegaT.app of klik op zijn locatie in het dock

U kunt het gedrag van OmegaT' aanpassen door de Eigenschappen als ook het bestand OmegaT.sh in het pakket te bewerken.

Klik met rechts op OmegaT.app en selecteer "Pakketinhoud weergeven" om toegang te krijgen tot OmegaT.sh, en open het bestand door er met rechts op te klikken en selecteer uw tekstverwerker van uw keuze. U kunt ook met "cd" daar rechtstreeks naartoe gaan vanaf de opdrachtregel en OmegaT.sh openen in een verwerker voor de opdrachtregel zoals emacs of vi.

Opties worden gewijzigd door OmegaT.sh aan te passen. Verwijder, voor vooraf gedefinieerde opties, de # vóór een parameter om het in te schakelen. Bijvoorbeeld: LANGUAGE="-Duser.language=ja" (zonder de #) zal OmegaT starten met de gebruikersinterface in het Japans.

Bewerk de startregel direct om de beschikbare hoeveelheid geheugen te wijzigen. Bijvoorbeeld: ${JAVA} -Xmx2048m ${MACOS} ${LANGUAGE} ${COUNTRY} ${PROXY_HOST} ${PROXY_PORT} ${GOOGLE_API_KEY} ${MS_CLIENT_ID} ${MS_CLIENT_SECRET} ${MY_MEMORY_EMAIL} ${TAAS_USER_KEY} -jar OmegaT.jar zal OmegaT starten met 2 gigabyte geheugen.

Als u meerdere instanties van OmegaT.app moet uitvoeren, gebruik dan in plaats daarvan het bestand OmegaT.sh dat zich bevind in OmegaT.app/ Contents/MacOS/.

Gebruik het bestand OmegaT.jar dat zich bevindt in OmegaT.app/Contents/MacOS/Java/ om OmegaT vanaf de opdrachtregel te starten. Bekijk "Starten vanaf de opdrachtregel" hieronder voor meer informatie.

3.5. Mac OS X goede dingen

OmegaT.app kan worden bereikt vanuit Mac OS X Services. U kunt dus ergens in OmegaT een woord selecteren en de Services gebruiken om het te controleren, bijvoorbeeld in Spotlight of in Google. U kunt ook AppleScript of Automator gebruiken om Services of scripts te maken die acties die veel voorkomen te automatiseren.

4. Andere systemen

Deze informatie is van toepassing op systemen zoals Solaris SPARC/x86/x64, Linux x64/PowerPC, Windows x64

4.1. Downloaden van het juiste pakket

OmegaT is beschikbaar, gebundeld met een Oracle Java JRE voor Linux (Intel x86)- en Windows-platformen. Gebruikers van andere platformen (Linux PowerPC, Linux x64, Solaris SPARC/x86/x64, Windows x64 etc) moeten een werkende compatibele Java JRE op hun systeem hebben om OmegaT te kunnen gebruiken.

Heeft u een Java-implementatie die compatibel is met Oracle's Java 1.6 JRE?

  • Ja: download OmegaT_3.n.n_Windows_without_JRE.zip. Dit pakket kan worden gebruikt op elk platform waar een Java 1.6 JRE compatibele JRE is geïnstalleerd.

  • Ik weet het niet: open een terminal en type "java -version". Als een "command not found" of soortgelijk bericht wordt teruggegeven, is het waarschijnlijk dat Java niet is geïnstalleerd op uw systeem.

  • Nee: Zorg voor een Java JRE voor uw systeem (zie hieronder) en download OmegaT_3.n.n_Without_JRE.zip.

    Oracle levert JRE's voor Solaris SPARC/x86 (Java 1.6) en voor Linux x64, Solaris x64, Windows x64 (Java 1.6) op http://www.oracle.com/technetwork/java/archive-139210.html.

    IBM levert JRE's voor Linux PowerPC op http://www.ibm.com/developerworks/java/jdk/linux/download.htm

    Volg de installatie-instructies voor het pakket dat u nodig hebt.

4.2. Installeren van OmegaT

Pak eenvoudigweg het bestand OmegaT_3.n.n_Without_JRE.zip uit om OmegaT te installeren. Dit maakt een map ./OmegaT_3.n.n_Without_JRE/ in de werkmap waarin u alle benodigde bestanden zult vinden om OmegaT uit te voeren.

4.3. Installeren van handige sneltoetsen

Volg de instructies voor uw systeem om sneltoetsen voor OmegaT op handige plaatsen te installeren.

4.4. OmegaT uitvoeren

Als OmegaT eenmaal is geïnstalleerd, kunt u het direct vanaf de opdrachtregel starten, u kunt een script maken dat de startparameters voor de opdrachtregel bevat of u kunt op OmegaT.jar klikken om het direct uit te voeren. Methoden verschillen, afhankelijk van de distributie. Zorg ervoor dat de instellingen van uw PATH juist zijn en dat .jar-bestanden juist zijn gekoppeld aan een Java-starter. Bekijk "Starten vanaf de opdrachtregel" hieronder voor meer informatie.

5. Java Web Start gebruiken

Java Web Start-technologie (onderdeel van Java 1.6 en hoger) kan worden gebruikt om met één enkele klik zelfstandige Java softwaretoepassingen uit te voeren over het netwerk. Java Web Start zorgt er voor dat de meest recente versie van de toepassing zal worden uitgevoerd, evenals de juiste versie van de Java Runtime Environment (JRE). Laad de volgende URL in uw browser om OmegaT voor de eerste keer te starten met Java Web Start:

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

Download het bestand OmegaT.jnlp en klik er dan op. Gedurende de installatie, afhankelijk van uw besturingssysteem, zou u verschillende beveiligingswaarschuwingen kunnen ontvangen. De rechten die u aan deze versie geeft (welke kunnen lijken op "onbeperkte toegang tot de computer") zijn identiek aan de rechten die u geeft voor de locale versie, d.i. zij geven toegang tot de harde schijf van de computer. Opvolgende klikken op OmegaT.jnlp zal leiden tot het controleren op upgrades, ze installeren als ze er zijn, en dan OmegaT starten. Na de initiële installatie kunt u natuurlijk OmegaT.jnlp ook gebruiken als u offline bent.

Privacy: OmegaT Java Web Start slaat geen informatie van u op buiten de computer waarop het wordt uitgevoerd. De toepassing wordt slechts uitgevoerd op uw machine. Uw documenten en vertaalgeheugens blijven op uw computer, en het OmegaTproject zal geen toegang hebben tot uw werk of informatie.

Merk op dat als u argumenten voor het opstarten wilt gebruiken (zie boven), u de normale installatie moet gebruiken.

6. OmegaT starten vanaf de opdrachtregel

Normaal gesproken is het niet nodig om OmegaT te starten vanaf de opdrachtregel. Het alternatief van de opdrachtregel stelt echter de gebruiker in staat om het gedrag van het programma te beheren en aan te passen. Er zijn twee manieren om OmegaT te starten met behulp van de opdrachtregel.

6.1. Openen van een venster voor de opdrachtregel

Een venster voor de opdrachtregel wordt ook wel een "terminalvenster" genoemd. Op Windows wordt het een "MS-DOSvenster" genoemd en is het beschikbaar via het menu Start, in Alle programma's → Bureau-accessoires, via het item "Opdrachtprompt". Het equivalent voor Mac OS X is de toepassing Terminal die zich bevind in Programma's → Hulpprogramma's.

U moet normaal gesproken twee opdrachten typen om OmegaT te starten. De eerste hiervan is:

cd {map}

waar {map} de naam is van de map, met het complete pad, waarin uw OmegaT-programma - specifiek het bestand OmegaT.jar - is geplaatst. In de praktijk zal deze opdracht er ongeveer zo uitzien:

Op Windows

cd C:\Program Files\OmegaT

Op Mac OS X

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

Op Linux

cd /usr/local/omegat

Deze opdracht wijzigt de map naar de map die het uitvoerbare OmegaT-bestand bevat. De tweede opdracht is de opdracht die OmegaT echt start. In zijn meest basale vorm is deze opdracht:

java -jar OmegaT.jar

Let op de hoofdletters - in andere besturingssystemen dan Windows zal het programma niet starten als u omegat invoert in plaats van OmegaT !

Deze methode heeft het bijzondere voordeel dat het geschikt is om oorzaken voor problemen op te sporen: als een fout optreedt gedurende het gebruiken van het programma wordt een foutbericht weergegeven in het terminalvenster dat bruikbare informatie kan bevatten over de oorzaak.

De bovenstaande methode is een niet zo praktische manier om een programma routinematig te starten. Om deze reden zijn de twee hierboven beschreven opdrachten opgenomen in een bestand (een "script", ook wel een ".bat-bestand" genoemd op Windows-systemen).

Als dit bestand wordt uitgevoerd worden de daarin opgenomen opdrachten automatisch uitgevoerd. Derhalve is het voldoende om dit bestand aan te passen om wijzigingen aan te brengen in de startopdracht.

6.2. Argumenten voor de startopdracht

De basisopdracht is hierboven al genoemd. Wijzigingen voor deze opdracht behelzen het daaraan toevoegen van "argumenten". Argumenten worden toegevoegd ná het initiële "java" en vóór het gedeelte "-jar OmegaT.jar". Onthoud dat u in Windows het bestand OmegaT.l4J.ini kunt wijzigen om uw voorkeuren weer te geven. Op andere platformen kunt u uw startprogramma aanpassen (bijv., OmegaT.sh op de Mac, OmegaT onder Linux) om hetzelfde te doen.

Een lijst van mogelijke argumenten wordt hieronder weergegeven. Gevorderde gebruikers kunnen meer informatie over de argumenten vinden door man java in het terminalvenster te typen.

  • Taal van de gebruikersinterface

    -Duser.language=XX Normaal gesproken, d.i. als OmegaT wordt gestart zonder enig argument, detecteert het programma eerst de taal van het besturingssysteem van de gebruiker. Als een gebruikersinterface in deze taal beschikbaar is gebruikt OmegaT die. Dus, als het besturingssysteem van de gebruiker Russisch is en OmegaT is vertaald in het Russisch, wordt OmegaT weergegeven met een Russische gebruikersinterface, Russische menu's, etc. Als de taal van het besturingssysteem van de gebruiker niet beschikbaar is gebruikt OmegaT standaard Engels. Dit is het standaard gedrag.

    Het argument "-Duser.language=XX" zorgt ervoor dat OmegaT de gespecificeerde taal gebruikt, in plaats van de taal van het besturingssysteem van de gebruiker. "XX" in de opdracht staat voor de code van twee letters van de gewenste taal. De opdracht, om OmegaT te starten met een Franse interface (bijvoorbeeld op een Russisch besturingssysteem), zou daarom zijn:

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

  • Land gebruiker

    -Duser.country=XX Naast de taal kunt u ook het land specificeren, bijvoorbeeld CN of TW in geval van de Chinese taal. U moet zowel de taal als het land specificeren om de gids Snel starten in de gewenste taal weer te geven. Dit is zelfs nodig als er slechts één combinatie beschikbaar is, zoals pt_BR in geval van Portugees / Braziliaans.

  • Toewijzen van geheugen

    -XmxZZM Deze opdracht wijst meer geheugen toe aan OmegaT. Standaard wordt 512 Mb toegewezen, dus er is geen voordeel te behalen door minder dan dit getal toe te wijzen. "ZZ" staat voor de toegewezen geheugenruimte in megabytes. De opdracht om OmegaT te starten met toewijzing van 1024 Mb (1 gigabyte) aan geheugen luidt dan ook:

    java -Xmx1024M -jar OmegaT.jar

  • Proxy host IP-adres

    -Dhttp.proxyHost=nnn.nnn.nnn.nnn Het IP-adres van uw proxyserver, als uw systeem een proxy gebruikt

  • Proxyhost poortnummer

    Dhttp.proxyPort=NNNN Het poortnummer dat uw systeem gebruikt om toegang te krijgen tot de proxyserver.

  • Google Translate V2

    -Dgoogle.api.key=A123456789B123456789C123456789D12345678 Indien u bent geabonneerd op de services van Google Translate, dient u hier uw eigen private Google API-sleutel in te voeren. Onthoud dat de sleutel 38 tekens lang is.

  • Microsoft Translator

    Zorg er voor dat u een gratis account voor Microsoft hebt. U heeft dat nodig om in te loggen op Windows Azure Marketplace en de service Translator te gebruiken. Onthoud dat tot en met 2M tekens per maand gratis is. De twee vereiste items zijn beschikbaar op uw pagina van het account onder Primary account key en Customer-ID:

    -Dmicrosoft.api.client_id=XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX

    -Dmicrosoft.api.client_secret=XXXX9xXxX9xXXxxXXX9xxX99xXXXX9xx9XXxXxXXXXX=

  • Yandex Translate

    Zorg er voor dat u een gratis account voor Yandex heeft. U heeft dat nodig om een API-sleutel voor Yandex Translate te verkrijgen en te gebruiken. API-sleutels kunnen worden aangevraagd met behulp van het API key request form, en worden bekeken op de pagina My Keys.

    -Dyandex.api.key=trnsl.1.1.XXXXXXXXXXXXXXXX.XXXXXXXXXXXXXXXX.XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX

Argumenten mogen worden gecombineerd: Voor het starten van OmegaT met alle hierboven genoemde voorbeelden zou de opdracht zijn:

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

6.3. OmegaT in de modus Opdrachtregel

Het doel van de console-modus is om OmegaT als vertaalgereedschap te gebruiken in een script-omgeving. Indien wordt begonnen in de console-modus, wordt geen GUI geladen (dus het zal werken op elke console) en het opgegeven project wordt automatisch verwerkt zoals verzocht.

6.3.1. Vooraf vereist

Een geldig OmegaT-project moet aanwezig zijn om OmegaT uit te kunnen voeren in de modus Opdrachtregel. De locatie maakt niet uit omdat het bij de start toch al moet worden ingevuld in de opdrachtregel.

Indien u gewijzigde instellingen nodig hebt, moeten de configuratiebestanden beschikbaar zijn. Dat kan op twee manieren worden bereikt:

  • Voer OmegaT normaal uit (met de GUI) en maak de instellingen. Indien u OmegaT in console-modus start, zal het dezelfde instellingen gebruiken.

  • Indien u OmegaT niet normaal kunt uitvoeren (geen grafische omgeving beschikbaar): kopieer de instellingen vanaf een andere installatie van OmegaT op een andere machine naar een bepaalde map. De locatie maakt niet uit, omdat u die toch in kunt vullen in de opdrachtregel bij het starten. De relevante bestanden zijn filters.conf en segmentation.conf en kunnen worden gevonden in de startmap van de gebruiker (bijv. C:\Documents and Settings\%User%\OmegaT onder Windows, %user%/.omegat/ onder Linux).

6.3.2. Beginnen in console-modus

Enkele extra parameters moeten bij het starten worden opgegeven om OmegaT in console-modus te starten. De meest belangrijke is <project-dir>, en optioneel --config-dir=<config-dir>. Voorbeeld:

java -jar OmegaT.jar /pad/naar/project \

--config-dir=/pad/naar/config-bestanden/ \

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

--source-pattern={reguliere uitdrukking}

Merk op dat alle parameters beginnen met een dubbel "-"-teken.

Uitleg:

  • <project-dir> vertelt OmegaT waar het project kan worden gevonden dat moet worden vertaald. Indien opgegeven start OmegaT in de console-modus en zal het opgegeven project gaan vertalen.

  • --config-dir=<config-dir> vertelt OmegaT in welke map de configuratiebestanden zijn opgeslagen. Indien niet opgegeven gaat OmegaT terug naar de standaard waarden (OmegaT-dir onder beginmap van de gebruiker, of indien niet beschikbaar: de huidige werkmap). Onthoud het dubbele "-"-teken

  • --mode=...- OmegaT begint in de console-modus om één van de volgende services automatisch uit te voeren

    • --mode=console-translate

      In deze modus zal OmegaT proberen om de bestanden in /source/ te vertalen met de beschikbare vertaalgeheugens. Dit is handig om OmegaT uit te voeren op een server waarmee TMX-bestanden automatisch worden toegevoegd aan het project.

    • --mode=console-createpseudotranslatetmx

      In deze modus zal OmegaT een TMX voor het gehele project maken, alleen gebaseerd op de bronbestanden. U specificeert dat het TMX/bestand moet worden gemaakt met

      --pseudotranslatetmx=allsegments.tmx --pseudotranslatetype=[equal|empty]

      Het argument pseudotranslatetype specificeert, of de doelsegmenten gelijk moeten zijn aan de bron of leeg moeten worden gelaten.

    • --mode=console-align

      In deze modus zal OmegaT het bestand met de Java-eigenschappen die zijn gevonden in de map /source/ van het project vergelijken met de inhoud op de opgegeven locatie. De resulterende TMX wordt opgeslagen in de map /omegat/ onder de naam align.tmx.

      Een aanvullende parameter, die de locatie van de doelgegevens specificeert, is in dit geval vereist:

      --alignDir={locatie van vertaalde bestanden}

      alignDir moet een vertaling bevatten in de doeltaal van het project. Als, bijvoorbeeld, het project EN->FR is, moet alignDir een bundle bevatten die eindigt op _fr. De resulterende TMX wordt opgeslagen in de map omegat onder de naam align.tmx.

  • --source-pattern={reguliere uitdrukking}

    Als deze modus werd gebruikt, zal deze optie de bestanden specificeren die automatisch moeten worden verwerkt. Als de parameter niet is gespecificeerd, zullen alle bestanden worden verwerkt. Hier zijn een paar typische voorbeelden om uw keuze te beperken:

    • .*\.html

      Alle HTML-bestanden zullen worden vertaald - merk op dat de punt in het gebruikelijke *.html moet worden vooraf gegaan door een backslash (\.) zoals gespecificeerd door de regels voor reguliere uitdrukkingen

    • test\.html

      Alleen het bestand test.html aan het begin van de map source zal worden vertaald. Indien er andere bestanden, genaamd test.html, in andere mappen staan, worden die genegeerd.

    • dir-10\\test\.html

      Alleen het bestand test.html in de map dir-10 zal worden verwerkt. Merk opnieuw op dat ook de backslash moet worden voorafgegaan door een backslash.

  • --output-tag-validation-={reguliere uitdrukking}

    Als deze modus werd gebruikt, zal deze optie de bestanden specificeren die automatisch moeten worden verwerkt. Als de parameter niet is gespecificeerd, zullen alle bestanden worden verwerkt. Hier zijn een paar typische voorbeelden om uw keuze te beperken:

    • .*\.html

      Alle HTML-bestanden zullen worden vertaald - merk op dat de punt in het gebruikelijke *.html moet worden vooraf gegaan door een backslash (\.) zoals gespecificeerd door de regels voor reguliere uitdrukkingen

    • test\.html

      Alleen het bestand test.html aan het begin van de map source zal worden vertaald. Indien er andere bestanden, genaamd test.html, in andere mappen staan, worden die genegeerd.

    • dir-10\\test\.html

      Alleen het bestand test.html in de map dir-10 zal worden verwerkt. Merk opnieuw op dat ook de backslash moet worden voorafgegaan door een backslash.

  • --tag-validation=[abort|warn] outputFileName

    Deze optie maakt het mogelijk het valideren van tags in modus batch uit te voeren. Als abort is geselecteerd zal het valideren van tags stoppen bij het eerste ongeldige segment. Als warn is gespecificeerd zal het valideren van tags alle segmenten verwerken en waarschuwingen over segmenten met ongeldige tags in het gespecificeerde bestand schrijven.

  • -no-team adresseert projecten die zijn ingesteld voor werken in teamverband. Gebruik hem als OmegaT de inhoud van het project niet moet synchroniseren.

  • --disable-project-locking maakt het, onder Windows, mogelijk om hetzelfde project met verschillende instanties van OmegaT te openen. Onder Windows is omegat.project standaard vergendeld en wordt een foutbericht ontvangen als wordt geprobeerd een project te openen dat al is geopend door een andere instantie van OmegaT. Met die optie wordt er niet vergrendeld.

6.3.3. optie Quiet

Een extra parameter voor de opdrachtregel, specifiek voor de console-modus: --quiet. In de modus quiet, wordt er minder informatie gelogd op het scherm. De berichten die u normaal gesproken zou vinden in de statusbalk worden niet weergegeven.

Gebruik: java -jar OmegaT.jar /pad/naar/project --mode=console-translate --quiet

6.3.4. Optie Tags valideren

Een andere parameter voor de opdrachtregel, specifiek voor de console-modus: --tag-validation=[abort|warn]. Als deze parameter wordt toegevoegd, wordt het valideren van tags toegepast voorafgaande aan vertalen/uitlijnen. Als de waarde abort is dan worden bij tagfouten de fouten afgedrukt en het programma stopt. Als de waarde warn is dan worden fouten afgedrukt maar OmegaT gaat door.

Gebruik: java -jar OmegaT.jar /pad/naar/project --mode=console-translate --tag-validation=abort

7. OmegaT bouwen vanuit de bron

Onthoud dat u ook het programma ant (http://ant.apache.org/bindownload.cgi) nodig hebt om uw eigen versie van OmegaT te bouwen. Pak het bestand OmegaT_3.n.n_Source.zip uit en geef de map OmegaT_3.n.n_Source op of voer de map ./omegat/ in voor de checkout-code van SVN. Controleer of een bestand build.xml in die map aanwezig is. Typ dan op de opdrachtregel:

$ ant jar release

Dit zal een volledige distributie van OmegaT maken in de map ./dist/, waarin u alle benodigde bestanden zult vinden om OmegaT uit te voeren.