OmegaT 3.5 – Korisnički priručnik

# Instaliranje i pokretanje programa OmegaT

## Korisnici sustava Windows

### Preuzimanje paketa

Imate li instaliran programski jezik Java koji je kompatibilan s Oracleovim paketom Java 1.6 JRE?

- Da: preuzmite OmegaT_3.n.n_Windows_without_JRE.exe .

- Ne/ne znam: preuzmite OmegaT_3.n.n_Windows.exe.

  Ovaj paket sadržava Oracleov Java Runtime Environment. Taj JRE neće ometati funkcije drugih instaliranih inačica programskoga jezika Java koje možda već imate na računalu.

### Instaliranje programa OmegaT

Za instaliranje programa OmegaT dvaput pritisnite lijevom tipkom miša na preuzetu instalacijsku datoteku.

Na početku instalacije možete odabrati jezik za korištenje tijekom samoga instaliranja. U sljedećemu prozoru možete odrediti da se odabrani jezik koristi i u samome programu OmegaT. Ako označite odgovarajući potvrdni kvadratić, datoteka OmegaT.l4J.ini bit će preinačena radi korištenja odabranoga jezika (o čemu više možete doznati u narednom odjeljku). Nadalje, nakon što prihvatite licencni ugovor, slijedi upit instalacijskoga programa želite li izraditi mapu na izborniku Start i prečac na radnoj površini i traci za brzo pokretanje. Navedene prečace možete izraditi i naknadno jednostavnim odvlačenjem simbola OmegaT.exe na radnu površinu ili na traku za brzo pokretanje. Posljednji okvir instalacijskoga programa nudi mogućnost uvida u datoteke procitajme i promjene za inačicu koju instalirate.

### Pokretanje programa OmegaT

Nakon instaliranja programa OmegaT možete pritisnuti OmegaT.jar za njegovo izravno pokretanje ili ga pak pokrenuti putem naredbenoga retka.

Općenito uzevši, program OmegaT najjednostavnije je pokrenuti putem programske datoteke OmegaT.exe . U tom se slučaju postavke pokretanja programa učitavaju iz datoteke OmegaT.l4J.ini , koja se nalazi u istoj mapi u kojoj je i datoteka exe file, a u njoj možete i mijenjati odgovarajuće podatke u vezi s postavkama. U sljedećem primjeru datoteke INI rezervirali smo 1 GB memorije, postavili francuski kao korisnički jezik, a za državu smo izabrali Kanadu:

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

Savjet: ako OmegaT usporeno funkcionira u radu s udaljenom radnom površinom u sustavu Windows, pokušajte to riješiti upisivanjem sljedeće postavke:

`-Dsun.java2d.noddraw=false`

### Nadogradnja programa OmegaT

Sljedeće informacije vrijede samo za „tradicionalne” inačice programa OmegaT u sustavima Windows. Ne odnosi se na inačice Web Start, koje se nadograđuju automatski, kao ni na međuplatformske inačice instalirane u sustavima Windows.

Ako na računalu već imate instaliranu neku inačicu programa OmegaT, a želite je nadograditi novijom, imate dvije mogućnosti:

- Instaliranje preko postojeće instalacije. U ovome slučaju prilikom instaliranja nove inačice jednostavno odaberite istu instalacijsku mapu u kojoj se već nalazi postojeći program. „Stara” inačica programa OmegaT bit će zamijenjena, ali sve njene postavke se zadržavaju. To obuhvaća postavke namještene putem programa OmegaT, sve izmjene koje ste unijeli u datoteku`OmegaT.l4J.ini`, kao i skriptu za pokretanje (datoteka .bat file), ako je koristite.

Ova metoda omogućava i preuzimanje inačice „Windows without JRE”, pa će nova instalacija koristiti vaš postojeći JRE.

- Instaliranje u novu mapu. Ovaj vam način omogućava zadržavanje obiju inačica, što je poželjno za one koji se najprije žele priviknuti na novu inačicu. Ova metoda također koristi postavke koje ste namjestili putem programa OmegaT. Međutim, u ovome slučaju:

  - ako ste mijenjali datoteku`OmegaT.l4J.ini` i/ili koristite datoteku .bat, morate ih kopirati u mapu nove inačice,

  - ako je postojeća instalacija programa OmegaT inačica „Windows with JRE”, nova inačica također mora biti „Windows with JRE”.

## Korisnici sustava Linux (Intel)

### Preuzimanje odgovarajućega paketa

Imate li instaliran programski jezik Java koji je kompatibilan s Oracleovim paketom Java 1.6 JRE?

- Da: preuzmite OmegaT_3.n.n_Without_JRE.zip .

- Ne/ne znam: preuzmite OmegaT_3.n.n_Linux.tar.bz2.

  Ovaj paket sadržava Oracleov Java Runtime Environment. Taj JRE neće ometati funkcije drugih instaliranih inačica programskoga jezika Java koje možda već imate na računalu.

### Instaliranje programa OmegaT

Raspakirajte preuzetu datoteku. Time se izrađuje mapa omegat/ u radnoj mapi, i to sa svim datotekama potrebnim za rad programa OmegaT. Za raspakiravanje datoteke .tar.gz :

$ tar xf downloaded_file.tar.gz

### Dodavanje programa OmegaT izbornicima (KDE) ili pločama (Gnome)

#### Korisnici radnoga okruženja KDE 4

Program OmegaT možete dodati izbornicima kako slijedi:

- Pritisnite Alt+F2 da biste otvorili KRunner. Za pokretanje naredbe upišite kmenuedit+enter . Prikazat će se KMenuEditor. U programu KMenuEditor odaberite Datoteka -> Nova stavka.

- Potom, a nakon odabira odgovarajućega izbornika, dodajte podizbornik/stavku putem Datoteka - Novi podizbornik i Datoteka - Nova stavka . Kao naziv nove stavke upišite OmegaT.

- U polju „Naredba” koristite navigacijski gumb da biste pronašli skriptu za pokretanje programa OmegaT, tj. datoteku pod nazivom OmegaT u neraspakiranoj mapi, a zatim je odaberite.

- Pritisnite simbol (desno od polja Naziv/Opis/Komentar)

- Ostali simboli - Pregled, a zatim prijeđite na podmapu /images u programskoj mapi OmegaT. Odaberite simbol OmegaT.png.

- Na koncu spremite promjene putem Datoteka - Spremi.

#### Korisnici radnoga okruženja GNOME

Program OmegaT možete dodati izbornicima kako slijedi:

- Desnom tipkom miša pritisnite na ploču pa odaberite Dodaj novi pokretač.

- Upišite „OmegaT” u polje „Naziv”, a u polju „Naredba” koristite navigacijski gumb da biste pronašli skriptu za pokretanje programa OmegaT, tj. datoteku pod nazivom OmegaT u neraspakiranoj mapi. Odaberite je i potvrdite pritiskom na U redu.

- Pritisnite na simbol, a zatim na Pregled... pa prijeđite na podmapu /images u programskoj mapi OmegaT. Odaberite simbol OmegaT.png . GNOME možda neće prikazati datoteke simbola u raspoloživim formatima te će se ispočetka činiti da očekuje datoteku SVG, ali ako je mapa odabrana, datoteke bi trebale biti prikazane, čime je omogućen odabir OmegaT.png.

### Pokretanje programa OmegaT

Program OmegaT možete pokrenuti naredbenim retkom s pomoću skripte koja sadržava postavke pokretanja, ili možete pritisnuti na OmegaT.jar za izravno pokretanje. Metode se razlikuju u ovisnosti o distribucijskome paketu. Vodite računa da postavke za PATH budu ispravne i da su datoteke .jar pravilno pridružene za pokretanje programskoga jezika Java. Više informacija naći ćete niže u tekstu na temu pokretanja programa naredbenim retkom.

## Korisnici sustava Mac OS X

### Preuzimanje paketa

OmegaT sadržava Java JRE 1.8

Preuzmite OmegaT_3.n.n_Mac.zip.

### Instaliranje programa OmegaT

Za raspakiravanje dvaput pritisnite OmegaT_3.n.n_Mac.zip . Time nastaje mapa pod nazivom OmegaT . Ta mapa sadržava dvije datoteke: index.html i OmegaT.app. Kopirajte mapu u odgovarajuću mapu, npr. Aplikacije. Kad to obavite, izbrišite datoteku OmegaT_3.n.n_Mac.zip , jer više nije potrebna.

### Dodavanje programa OmegaT u Dock

Odvucite i ispustite datoteku OmegaT.app na Dock.

### Pokretanje programa OmegaT

Dvaput pritisnite datoteku OmegaT.app ili njenu lokaciju u Docku.

Funkcije programa OmegaT's možete mijenjati putem stavke Svojstva ili datoteke Configuration.properties iz paketa.

Datoteci Configuration.properties možete pristupiti pritiskom desnom tipkom miša na OmegaT.app , nakon čega odabirete „Prikaži sadržaj paketa”, a zatim otvarate datoteku u Sadržaj/Resursi pritiskom desnom tipkom miša na nju i odabirom željenoga programa za obradu teksta. Datoteci Configuration.properties možete pristupiti i izravno naredbenim retkom (putem naredbe „cd”) ili nekim programom za uređivanje naredbenih redaka, kao što su emacs ili vi.

Postavke mijenjate unošenjem izmjena u datoteku Configuration.properties . Kod unaprijed definiranih postavki uklonite znak # prije parametra kako biste ga uključili. Primjerice, `LANGUAGE="-Duser.language=ja"` (bez znaka #) služi za pokretanje programa OmegaT s korisničkim sučeljem na japanskome jeziku.

Ako želite promijeniti veličinu raspoložive memorije, unesite izmjene u <string>-Xmx1024M</string> u datoteci OmegaT.app/Contents/Info.plist . Primjerice, <string>-Xmx2048M</string> znači da je za rad programa OmegaT rezervirano dva gigabajta memorije.

Za pokretanje više pojavnica OmegaT.app , dvaput pritisnite na datoteku OmegaT.sh iz OmegaT.app/ Contents/MacOS/ .

Za pokretanje programa OmegaT naredbenim retkom koristite datoteku OmegaT.jar iz OmegaT.app/Contents/MacOS/Java/ . Više informacija naći ćete niže u tekstu na temu pokretanja programa naredbenim retkom.

### Dodatni sadržaji za Mac OS X

Datoteka OmegaT.app je dostupna putem Usluga za Mac OS X. Stoga možete odabrati bilo koju riječ u okviru programa OmegaT i koristiti Usluge za njenu provjeru, primjerice na servisima Spotlight ili Google. Također možete koristiti AppleScript ili Automator za izradu Usluga ili skripata radi automatiziranja čestih radnji.

## Ostali sustavi

Sljedeće informacije vrijede za sustave kao što su Solaris SPARC/x86/x64, Linux x64/PowerPC i Windows x64.

### Preuzimanje odgovarajućega paketa

OmegaT je raspoloživa u paketu s Oracle Java JRE-om za platforme Linux (Intel x86) i Windows. Korisnici drugih platformi (Linux PowerPC, Linux x64, Solaris SPARC/x86/x64 i Windows x64 etc) moraju na svojim sustavima imati instaliran kompatibilni Java JRE da bi mogli koristiti program OmegaT.

Imate li instaliran programski jezik Java koji je kompatibilan s Oracleovim paketom Java 1.6 JRE?

- Da: preuzmite OmegaT_3.n.n_Windows_without_JRE. zip. Ovaj se paket može koristiti na bilo kojoj platformi s instaliranim JRE-om kompatibilnim s paketom Java 1.6 JRE.

- Ne znam: otvorite terminal i upišite „java -version”. Ako se prikaže poruka „command not found” ili slično upozorenje, vjerojatno nemate instaliran programski jezik Java.

- Ne: instalirajte Java JRE na svoj sustav (v. tekst dolje) pa preuzmite OmegaT_3.n.n_Without_JRE.zip .

  Oracle nudi JRE-e za Solaris SPARC/x86 (Java 1.6) i za Linux x64, Solaris x64 i Windows x64 (Java 1.6) na stranici http://www.oracle.com/technetwork/java/archive-139210.html.

  IBM nudi JRE-e za Linux PowerPC na stranici http://www.ibm.com/developerworks/java/jdk/linux/download.htm.

  Pridržavajte se uputa za instaliranje odgovarajućega paketa.

### Instaliranje programa OmegaT

Program OmegaT možete instalirati jednostavnim raspakiravanjem datoteke OmegaT_3.n.n_Without_JRE.zip . Time se izrađuje mapa ./OmegaT_3.n.n_Without_JRE/ u radnoj mapi, i to sa svim datotekama potrebnim za pokretanje programa OmegaT.

### Postavljanje odgovarajućih prečaca

Prečace programa OmegaT možete postaviti na odgovarajuća mjesta prema svojim potrebama u skladu s uputama za sustav koji koristite.

### Pokretanje programa OmegaT

Nakon instaliranja, program OmegaT možete pokretati izravno naredbenim retkom, a možete i izraditi skriptu koja sadržava parametre pokretanja za naredbeni redak, ili ga možete pokretati pritiskom na datoteku OmegaT.jar . Metode se razlikuju u ovisnosti o distribucijskome paketu. Vodite računa da postavke za PATH budu ispravne i da su datoteke .jar pravilno pridružene za pokretanje programskoga jezika Java. Više informacija naći ćete niže u tekstu na temu pokretanja programa naredbenim retkom.

## Odvlačenje i ispuštanje

Većina sustava omogućava otvaranje projekta odvlačenjem i ispuštanjem datoteke `omegat.project` na simbol programa OmegaT na radnoj površini. Postoji i mogućnost otvaranja projekta u sklopu programa OmegaT dvostrukim pritiskom mišem na datoteku `omegat.project`.

## Korištenje tehnologije Java Web Start

Tehnologija Java Web Start (dio paketa Java 1.6 i novijih) može poslužiti za korištenje samostalnih programskih aplikacija Java putem mreže samo jednim pritiskom mišem. Java Web Start osigurava korištenje najnovije inačice, kao i ispravne inačice okruženja Java Runtime Environment (JRE). Za prvo pokretanje programa OmegaT tehnologijom Java Web Start, u preglednik upišite sljedeću URL adresu:

https://omegat.sourceforge.io/webstart/OmegaT.jnlp

Preuzmite datoteku OmegaT.jnlp , a zatim pritisnite mišem na nju. Moguće je da će se za vrijeme instalacije prikazati nekoliko sigurnosnih upozorenja, ovisno o operacijskome sustavu. Dozvole koje dajete ovoj inačici, a koje mogu biti prikazane kao neograničeni pristup računalu, istovjetne su dozvolama koje dajete lokalnoj inačici, tj. dopuštaju pristup disku računala. Pritisnete li opet na datoteku OmegaT.jnlp , aktivirat ćete provjeru dostupnosti nadogradnji, koje zatim možete instalirati, ako ih ima, a na koncu pokrenuti program OmegaT. Naravno, nakon početne instalacije, datoteku OmegaT.jnlp možete koristiti i kada niste na mreži.

Privatnost : OmegaT Java Web Start ne sprema nikakve vaše informacije, osim o računalu na kojemu ga koristite. Program radi samo na vašemu računalu. Vaši dokumenti i prijevodne memorije ostaju na vašemu računalu, a projekti u sklopu programa OmegaT nemaju pristup vašim datotekama ili informacijama.

Imajte na umu da u slučaju potrebe za korištenjem bilo koje naredbene argumente za pokretanje (v. tekst gore) morate koristiti uobičajenu instalaciju.

## Pokretanje programa OmegaT naredbenim retkom

Obično nema potrebe za pokretanjem programa OmegaT naredbenim retkom. Međutim, ta mogućnost daje korisnicima prigodu da nadziru i mijenjaju funkcije programa. Program OmegaT je moguće pokrenuti naredbenim retkom na dva načina.

### Otvaranje prozora naredbenoga retka

Prozor naredbenoga retka naziva se i „prozorom terminala”. U sustavu Windows poznat je kao „prozor MS-DOS-a”, a dostupan je putem startnoga izbornika programa, gdje je naveden kao „MS-DOS”. Ekvivalent u sustavu Mac OS X je program Terminal, koji možete otvoriti putem izbornika Aplikacije → Uslužni programi.

Za pokretanje programa OmegaT obično morate upisati dvije naredbe. Prva od njih je:

`cd {mapa}`

pri čemu je {mapa} naziv mape (s cjelokupnom putanjom do nje) u kojoj se nalazi program OmegaT, odnosno datoteka OmegaT.jar . U praksi bi navedena naredba glasila otprilike ovako:

U sustavu Windows

`cd C:\Program Files\OmegaT`

U sustavu Mac OS X

``cd <lokacija gdje se nalaziOmegaT.app>/OmegaT.app/Contents/Resources/Java/``

U sustavu Linux

`cd /usr/local/omegat`

Tom se naredbom poziva mapa u kojoj se nalazi izvršna datoteka programa OmegaT. Drugom se naredbom zapravo pokreće program OmegaT. U svom najjednostavnijem obliku ta naredba glasi ovako:

`java -jar OmegaT.jar`

Pazite na veličinu slova, jer, s izuzetkom sustava Windows, program neće biti moguće pokrenuti u drugim operacijskim sustavima ako upišete omegat umjesto OmegaT !

Ova je metoda posebno korisna jer je pogodna za pronalaženje uzroka problema: u slučaju pogreške prilikom korištenja programa u prozoru terminala se prikazuje poruka o pogrešci, i to nerijetko s korisnim informacijama o uzrocima.

Navedena metoda pak nije sasvim praktična za rutinsko pokretanje programa. Iz toga se razloga dvije gore opisane naredbe nalaze u datoteci („skripti”, koju također nazivamo „datoteka .bat” u sustavima Windows).

Izvršavanjem te datoteke automatski se provode u nju upisane naredbe. Stoga, kad trebate promijeniti naredbu za pokretanje, dovoljno je unijeti izmjene u datoteku.

### Naredbeni argumenti za pokretanje

Osnovnu smo naredbu već spomenuli u gornjemu tekstu. Izmjene te naredbe obuhvaćaju „argumente” koje joj valja dodati. Argumenti se dodaju iza početnoga „ java ”, a ispred „ -jar OmegaT.jar ”. Ne zaboravite da u sustavu Windows možete mijenjati `OmegaT.l4J.ini` prema svojim potrebama. Kod drugih platformi isto možete napraviti mijenjanjem datoteke `Configuration.properties` u sustavu Mac, ili datoteke za pokretanje programa `OmegaT` u sustavu Linux.

Slijedi popis mogućih argumenata. Napredniji korisnici mogu dobiti uvid u dodatne informacije o argumentima upisivanjem izraza man java u prozoru terminala.

- Jezik korisničkoga sučelja

  -Duser.language=XX U uobičajenim slučajevima, tj. kada se OmegaT pokreće bez ikakvih argumenat, program najprije traži jezik operacijskoga sustava korisnika. Ako je korisničko sučelje raspoloživo na tom jeziku, OmegaT ga koristi. Stoga, ako operacijski sustav koristi ruski jezik, a OmegaT je lokalizirana na ruski, program OmegaT se prikazuje s korisničkim sučeljem, izbornicima i drugim stavkama na ruskome. Ako jezik operacijskoga sustava korisnika nije na raspolaganju, OmegaT koristi engleski jezik prema zadanim vrijednostima. To je standardni način funkcioniranja.

  Argument "-Duser.language=XX" određuje da OmegaT koristi naznačeni jezik, a ne onaj operacijskoga sustava korisnika. „XX” u naredbi služi za upisivanje dvoslovnoga koda željenoga jezika. Za pokretanje programa OmegaT sa sučeljem na francuskom, i to, primjerice, na operacijskome sustavu koji koristi ruski jezik, naredba bi glasila ovako:

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

- Država korisnika

  -Duser.country=XX Pored jezika, možete naznačiti i državu, primjerice CN ili TW u slučaju kineskoga jezika. Ako želite prikaz vodiča za brzi početak rada na željenome jeziku, trebate naznačiti i jezik i državu. To je obavezno čak i kada postoji samo jedna kombinacija, kao što je to pt_BR za brazilski portugalski.

- Rezerviranje memorije

  -XmxZZM Ovom se naredbom rezervira više memorije za program OmegaT. Prema zadanim vrijednostima rezervirano je 512 MB, a smanjivanje te veličine ne donosi nikakve prednosti. „ZZ” predstavlja veličinu rezervirane memorije u megabajtima. Naredba za pokretanje programa OmegaT s rezerviranih 1024 MB (1 gigabajt) memorije stoga glasi ovako:

  `java -Xmx1024M -jar OmegaT.jar`

- IP adresa proxy glavnoga računala

  -Dhttp.proxyHost=nnn.nnn.nnn.nnn IP adresa vašega proxy poslužitelja, ako koristite proxy u svome sustavu.

- Broj priključka proxy glavnoga računala

  -Dhttp.proxyPort=NNNN Broj priključka koji vaš sustav koristi za pristup proxy poslužitelju.

- Google prevoditelj V2

  -Dgoogle.api.key=A123456789B123456789C123456789D12345678 Ako ste prijavljeni za korištenje servisa Google prevoditelj, ovdje upišite svoj privatni ključ API-ja za Google. Imajte na umu da se ključ sastoji od 38 znakova.

- Microsoft prevoditelj

  Za ovu funkciju morate imati besplatni Microsoftov račun. Trebat će vam za prijavu na servis Windows Azure Marketplace i korištenje usluga prevođenja. Dobro je znati da mjesečno možete besplatno koristiti do dva milijuna znakova. Dvije potrebne stavke dostupne su na vašoj stranici računa kao primarni ključ računa (Primary account key) i oznaka klijenta (Customer-ID):

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

  - Dmicrosoft.api.client_secret=XXXX9xXxX9xXXxxXXX9xxX99xXXXX9xx9XXxXxXXXXX=

- Yandex Translate

  Za ovu funkciju morate imati besplatni Yandexov račun. Trebat će vam da biste dobili i koristili ključ API-ja za Yandex Translate. Ključeve API-ja možete zatražiti putem obrasca molbe za izdavanje ključeva, a prikazuju se na stranici osobnih ključeva.

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

Argumente je moguće kombinirati: za pokretanje programa OmegaT sa svim gore navedenim primjerima, naredba bi glasila ovako:

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

### OmegaT u načinu rada naredbenim retkom

Namjena konzolnoga načina rada je korištenje programa OmegaT kao prevoditeljskoga alata u okruženju skriptiranja. Pokretanjem u konzolnome načinu rada ne učitava se grafičko korisničko sučelje (što omogućava rad na bilo kojoj konzoli), a projekti se automatski obrađuju prema nalogu.

#### Preduvjeti

Za pokretanje programa OmegaT u načinu rada naredbenim retkom morate imati ispravan projekt u sklopu programa OmegaT. Lokacija nije bitna, budući da je ionako morate unijeti u naredbeni redak prilikom pokretanja.

Ako trebate drugačije postavke, morate imati konfiguracijske datoteke. To možete ostvariti na dva načina:

- Pokrenite program OmegaT na uobičajeni način (s grafičkim korisničkim sučeljem) pa namjestite postavke. Ako program OmegaT pokrenete u konzolnome načinu rada, koristit će iste postavke.

- Ako nije moguće pokretanje programa OmegaT na uobičajeni način (jer nema raspoloživoga grafičkog okruženja): u odgovarajuću mapu kopirajte postavke iz neke druge instalacije programa OmegaT s drugoga računala. Lokacija nije bitna, budući da je unosite u naredbeni redak prilikom pokretanja. Potrebne su datoteke `filters.conf` i `segmentation.conf`, a možete ih pronaći u korisničkoj početnoj mapi (npr. `C:\Documents and Settings\%User%\OmegaT` u sustavu Windows, ili `%user%/.omegat/` u sustavu Linux).

#### Pokretanje u konzolnome načinu rada

Za pokretanje programa OmegaT u konzolnome načinu rada potrebni su još neki dodatni parametri. Najznačajniji je `<mapa-projekta>`, a po izboru i `--config-dir=<mapa-konfiguracijskih-datoteka>.` Primjer:

`java -jar OmegaT.jar /putanja/do/projekta \`

`--config-dir=/putanja/do/konfiguracijskih datoteka/ \`

`--config-file=/putanja/do/konfiguracijske-datoteke/ \`

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

`--source-pattern={regularni-izraz}`

Vodite računa da svi parametri započinju dvostrukim znakom „-” (bez navodnika).

Objašnjenje:

- `<mapa-projekta>` kazuje programu OmegaT gdje se nalazi prijevodni projekt. Kada je ovaj parametar naveden, OmegaT se pokreće u konzolnome načinu rada i prevodi određeni projekt.

- `--config-dir=<mapa-konfiguracijskih-datoteka>` kazuje programu OmegaT gdje je mapa u kojoj se nalaze konfiguracijske datoteke. Kada ovaj parametar nije naveden, OmegaT koristi zadane vrijednosti (mapa OmegaT u korisničkoj početnoj mapi ili, ako ona nije raspoloživa, u tekućoj radnoj mapi). I ovdje imamo dvostruki znak „-” (bez navodnika).

- `--config-file=<konfiguracijska datoteka>` kazuje programu OmegaT koju će konfiguracijsku datoteku koristiti.

- `--mode`=...- OmegaT se pokreće u konzolnome načinu rada radi automatskoga obavljanja jedne od sljedećih radnji:

  - `--mode=console-translate`

    OmegaT će u ovome načinu rada pokušati prevesti datoteke iz mape /source/ s pomoću raspoloživih prijevodnih memorija. To je korisno kod pokretanja programa OmegaT na poslužitelju s automatski učitanim datotekama TMX za projekt.

  - `--mode=console-createpseudotranslatetmx`

    OmegaT će u ovome načinu rada izraditi datoteku TMX za cijeli projekt, i to samo na temelju izvorišnih datoteka. Datoteku TMX za izrada određujete sljedećim parametrom:

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

    Argument pseudotranslatetype određuje trebaju li odredišni segmenti biti istovjetni izvorišnima, ili pak ostati prazni.

  - `--mode=console-align`

    OmegaT u ovome načinu rada sravnjuje datoteku svojstava jezika Java iz projektne mape `/source/` sa sadržajem pronađenim na naznačenoj lokaciji. Nastala datoteka TMX sprema se u mapu `/omegat/` pod nazivom `align.tmx`.

    U ovome je slučaju potreban dodatni parametar, a kojim se određuje lokacija odredišnih podataka:

    `--alignDir={lokacija datoteka prijevoda}`

    `alignDir` mora sadržavati prijevod na odredišnome jeziku projekta. Primjera radi, ako je projekt postavljen za jezični smjer EN->FR, alignDir mora sadržavati paket čiji naziv završava nastavkom _fr. Nastala datoteka TMX sprema se u mapu `omegat` pod nazivom `align.tmx`.

- `--source-pattern={regularni-izraz}`

  Nakon korištenja ovoga načina rada, navedenom se postavkom određuju datoteke za automatsku obradu. Ako ovaj parametar nije naznačen, obrađuju se sve datoteke. Evo nekoliko primjera za konkretne odabire:

  - `.*\.html`

    Prevode se sve datoteke HTML, ali vodite računa da ispred točke u općenitome izrazu *.html treba dodati prekidni znak (\.) u skladu s pravilima za regularne izraze.

  - `test\.html`

    Ovime je za prijevod određena samo datoteka test.html u korijenskoj mapi izvorišnih sadržaja. Ignoriraju se sve druge datoteke pod nazivom test.html, a koje eventualno postoje u drugim mapama.

  - `dir-10\\test\.html`

    Ovime je za obradu odrđena samo datoteka test.html u mapi dir-10. Opet vodite računa da ispred točke dodate obrnutu kosu crtu.

- `--output-tag-validation-={regularni-izraz}`

  Nakon korištenja ovoga načina rada, navedenom se postavkom određuju datoteke za automatsku obradu. Ako ovaj parametar nije naznačen, obrađuju se sve datoteke. Evo nekoliko primjera za konkretne odabire:

  - `.*\.html`

    Prevode se sve datoteke HTML, ali vodite računa da ispred točke u općenitome izrazu *.html treba dodati prekidni znak (\.) u skladu s pravilima za regularne izraze.

  - `test\.html`

    Ovime je za prijevod određena samo datoteka test.html u korijenskoj mapi izvorišnih sadržaja. Ignoriraju se sve druge datoteke pod nazivom test.html, a koje eventualno postoje u drugim mapama.

  - `dir-10\\test\.html`

    Ovime je za obradu odrđena samo datoteka test.html u mapi dir-10. Opet vodite računa da ispred točke dodate obrnutu kosu crtu.

- `--tag-validation=[abort|warn]` `naziv-izlazne-datoteke`

  Ovom se postavkom omogućava skupna provjera valjanosti oznaka teksta. Odabirom `abort` , provjera valjanosti oznaka teksta zaustavlja se na prvome neispravnom segmentu. Odabirom `warn`, provjera valjanosti oznaka teksta obrađuje sve segmente i ispisuje upozorenja u naznačenu datoteku u vezi sa svim segmentima koji sadržavaju neispravne oznake teksta.

- `--no-team` se odnosi na projekte postavljene za timski rad. Koristite ga kada ne želite da OmegaT sinkronizira sadržaje projekta.

- `--disable-project-locking` omogućava u sustavu Windows otvaranje jednoga projekta u nekoliko pojavnica programa OmegaT. Prema zadanim postavkama, datoteka `omegat.project` je zaključana u sustavu Windows, a prilikom pokušaja otvaranja projekta koji je već otvoren u nekoj drugoj pojavnici programa OmegaT prikazuje se poruka o pogrešci. Ovom se postavkom onemogućava zaključavanje.

#### Tihi način rada

Za „tihi” rad imamo dodatni parametar naredbenoga retka koji vrijedi isključivo za konzolni način rada: `--quiet.` U tihome načinu rada na zaslonu se prikazuje manje informacija o događajima. Ne prikazuju se ni poruke koje se obično nalaze na traci stanja.

Korištenje: `java -jar OmegaT.jar /putanja/do/projekta --mode=console-translate --quiet`

#### Provjera valjanosti oznaka teksta

Za provjeru valjanosti oznaka teksta imamo dodatni parametar naredbenoga retka koji vrijedi isključivo za konzolni način rada: `--tag-validation=[abort|warn].` Dodamo li ovaj parametar, provjera valjanosti oznaka teksta obavlja se prije prevođenja/sravnjivanja. Odaberemo li vrijednost `abort`, prilikom pronalaska pogrešaka u vezi s oznakama teksta prikazuju se poruke, a program se zaustavlja. Odaberemo li pak vrijednost `warn`, poruke o pogreškama se prikazuju, ali program OmegaT nastavlja s radom.

Korištenje: `java -jar OmegaT.jar /putanja/do/projekta --mode=console-translate --tag-validation=abort`

## Sastavljanje programa OmegaT iz izvornoga koda

Za sastavljanje vlastite inačice programa OmegaT trebate program ant, koji možete pronaći na adresi http://ant.apache.org/bindownload.cgi . Raspakirajte datoteku OmegaT_3.n.n_Source.zip i unesite mapu OmegaT_3.n.n_Source folder ili pak unesite mapu ./omegat/ iz preuzetoga koda SVN-a. Vodite računa da se u navedenoj mapi nalazi datoteka build.xml. Zatim u naredbeni redak upišite sljedeće:

`$ ant jar release`

Time se stvara cijeli distribucijski paket programa OmegaT u mapi ./dist/ folder, gdje će se nalaziti i sve datoteke potrebne za pokretanje programa OmegaT.