Instalacija i pokretanje OmegaT - Priručnik za korisnike OmegaT 1.7.3.

# Instalacija i pokretanje OmegaT

- Korisnici Linux (Intel)
  - Paketi za preuzimanje
  - Instalacija
  - OS meni setup
    - u KDE
    - u GNOME
  - Pokretanje OmegaT
- Korisnici na Windows-ima
  - Paketi za preuzimanje
  - Instalacija
  - Windows meni setup
  - Pokretanje OmegaT
- Korisnici MacOSX
  - Paketi za preuzimanje
  - Instalacija
  - Dock setup
  - Pokretanje OmegaT
- Drugi sistemi (Solaris SPARC/x86/x64, Linux x64/PowerPC, Windows x64)
  - Paketi za preuzimanje
  - Instalacija
  - Pokretanje OmegaT
- Pokretanje komandne linije
  - Otvaranje prozora za komandnu liniju
  - Izmjena skripta za pokretanje
  - Pozivanje argumenata preko komandne linije
- Gradnja OmegaT iz "source"
  - Paketi za preuzimanje
  - Proces gradnje

# Korisnici Linux (Intel)

## Koji paket treba preuzeti?

Imaš li u sistemu implementaciju Java kompatibilnu sa SUN Java 1.4 JRE?

→ Da
  preuzmi `OmegaT_1.7.3_Without_JRE.zip`
  *Ovaj se paket može korisiti na bilo kojoj platformi gdje postoji JRE kompatibilan sa Java 1.4 JRE.
→ Ne / Ne znam
  preuzmi `OmegaT_1.7.3_Linux.tar.gz`
  *Ovaj paket sadrži u sebi i SUN Java Runtime Environment. Ovaj JRE neće biti u konfliktu sa ostalim Java implementacijama koje su eventualno već instalirane na tvom sistemu.

## Instalacija OmegaT

Radi instalacije, jednostavno otpakiraj/"untar" preuzetu datoteku. Tada će se napraviti omegat/ direktorijum u radnom direktorijumu i u njemu će biti sve datoteke potrebne za rad OmegaT.

Za "untar" `.tar.gz` datoteke:

`$ tar xf preuzeta_datoteka.tar.gz`

## Dodavanje OmegaT tvojim menijima na KDE, ili panelima na Gnome.

### Korisnici KDE

Možeš dodati OmegaT tvojim menijima na slijedeći način:

- `Control Center - Desktop - Panels - Menus - Edit K Menu - File - New Item/New Submenu`
- Pošto si odabrao/la pogodan meni, tada možeš dodati submenu/item pomoću `File - New Submenu and File - New Item`. Za ime novog "item" stavi OmegaT.
- U polju "Command", koristi navigaciono dugme za nalaženje tvog skripta za pozivanje OmegaT (datoteka po imenu OmegaT u otpakiranom direktorijumu), te ga selektuj.
- Klikni na dugme ikonice (s desne strane od Name/Description/Comment fields) - Other Icons - Browse, te pronađi pod-direktorijum /images subfolder u aplikacijskom direktorijumu OmegaT. Odaberi ikonicu OmegaT.png.
- I na kraju, spasi promjene pomoću `File - Save`.

### Korisnici Gnome

OmegaT možeš dodati tvom panelu (traka pri vrhu ekrana) na slijedeći način:

- Desni klik na panel - `Add New Launcher`.
- Unesi "OmegaT" u polje "Name"; U polju "Command", koristi navigaciono dugme za nalaženje tvog skripta za pozivanje OmegaT (datoteka po imenu OmegaT u otpakiranom direktorijumu), te ga selektuj. Selektuj ga i potvrdi sa OK.

## Pokretanje OmegaT

Po instalaciju OmegaT, možeš pozvati program direktno sa komandne linije, napraviti skript sa parametrima pozivanja sa komandne linije ili pak, radi direktnog pokretanja, možeš i kliknuti na `OmegaT.jar`. Metode se razlikuju ovisno od paketa. Uvjeri se da je tvoja `PUTANJA` ispravno naznačena i da su `.jar` datoteke pravilno asocirane sa Java launcher.

# Korisnici na Windows-ima

## Koji paket treba preuzeti?

Imaš li u sistemu implementaciju Java kompatibilnu sa SUN Java 1.4 JRE?

→ Da
  preuzmi `OmegaT_1.7.3_Without_JRE.zip`
  *Ovaj se paket može korisiti na bilo kojoj platformi gdje postoji JRE kompatibilan sa Java 1.4 JRE.
→ Ne / Ne znam
  preuzmi `OmegaT_1.7.3_Windows.zip`
  *Ovaj paket sadrži u sebi i SUN Java Runtime Environment. Ovaj JRE neće biti u konfliktu sa ostalim Java implementacijama koje su eventualno već instalirane na tvom sistemu.

## Instalacija OmegaT

Radi instalacije OmegaT, jednostavno napravi neki pogodni direktorijum za kopiranje preuzete datoteke (na pr. `C:\Program Files\OmegaT`). Radi dekompatacije klikni dva puta po njoj. U tom će se direktorijumu, znači, dekompatirati sve datoteke neophodne za funkcionisanje OmegaT. Poslije možeš obrisati fajl preuzet sa interneta.

## Dodavanje OmegaT meniju start ili na Desktop.

Za datoteke `OmegaT-JRE.exe`, `OmegaT.exe` ili `OmegaT.bat` možeš načiniti link na desktop ili Meni Start, tako da u njima imaš vezu na program.

## Pokretanje OmegaT

Po instalaciji OmegaT, radi direktnog aktiviranja možeš kliknuti na `OmegaT.jar`, ili na datoteku `OmegaT.bat` čime uključuješ i parametre koje želiš, ili je, pak, možeš direktno pozvati sa komandne linije.

# Korisnici MacOSX

## Koji paket treba preuzeti?

Preuzmi `OmegaT_1.7.3_MacOSX.zip`.

## Instalacija OmegaT

Radi dekompatacije klikni dva puta po `OmegaT_1.7.3_MacOSX`. OSX disk image (`OmegaT.dmg`) će se podići i prikazati 2 datoteke: `documentation.html` i `OmegaT.app`. Iskopiraj obe te datoteke u pogodan direktorijum (na pr. Applications, u kome možeš napraviti direktorijum OmegaT). Potom možeš obrisati fajl preuzet sa interneta: `OmegaT_1.7.3_MacOSX.zip`.

## Dodavanje OmegaT na Dock.

OmegaT se na Dock dodaje povlačenjem datoteke `OmegaT.app` i spuštanjem iste na Dock.

## Pokretanje OmegaT

Dvaput klikni na `OmegaT.app` ili na njeno mjesto na Dock-u.

Ako imaš potrebu da mijenjaš pozivne parametre sa komandne linije, savjetujemo ti da koristiš paket koji se nalazi u "Other systems". O ovome pročitaj u nastavku. Takođe je moguće direktno modificirati datoteku `Info.plist` koja se nalazi u paketu `OmegaT.app`.

# Drugi operativni sistemi

## Koji paket treba preuzeti?

OmegaT postoji u varijanti sa SUN Java JRE za Linux (Intel x86) i Windows platforme. Da bi mogli koristiti OmegaT, korisnici na drugim platformama (Linux PowerPC, Linux x64, Solaris SPARC/x86/x64, Windows x64 itd) moraju u svojim sistemima imati radno instalisanu Java JRE.

Imaš li u sistemu implementaciju Java kompatibilnu sa SUN Java 1.4 JRE?

→ Da
  preuzmi `OmegaT_1.7.3_Without_JRE.zip`
  *Ovaj se paket može korisiti na bilo kojoj platformi gdje postoji JRE kompatibilan sa Java 1.4 JRE.
→ Ne znam
  otvori terminal i ukucaj "java -version". Ako se pojavi poruka: "command not found" ili njoj slična, vrlo je vjerovatno da u svom operativnom sistemu nemaš instalisanu Java.
→ Ne
  obezbjedi Java JRE za tvoj sistem (vidi dole) i preuzmi `OmegaT_1.7.3_Without_JRE.zip`.

  SUN ima JRE za Solaris SPARC/x86 (Java 1.4) i za Linux x64, Solaris x64, Windows x64 (Java 1.5):
  http://java.sun.com/products/archive/
  IBM ima JRE za Linux PowerPC:
  http://www.ibm.com/developerworks/java/jdk/linux/download.html

U vezi paketa koji tebi odgovara, pridržavaj se uputstava za instalaciju.

## Instalacija OmegaT

Radi instalacije, jednostavno otpakiraj datoteku `OmegaT_1.7.3_Without_JRE.zip`. Tada će se napraviti direktorijum `./OmegaT_1.7.3_Without_JRE/` u radnom direktorijumu i u njemu će biti sve datoteke potrebne za rad OmegaT.

## Instalacija pogodnih kratica

Slijedi uputstva iz tvog operativnog sistema u vezi pravljenja kratica na pogodnim mjestima.

## Pokretanje OmegaT

Po instalaciju OmegaT, možeš pozvati program direktno sa komandne linije, napraviti skript sa parametrima pozivanja sa komandne linije ili pak, radi direktnog pokretanja, možeš i kliknuti na `OmegaT.jar`. Metode se razlikuju ovisno od paketa. Uvjeri se da je tvoja `PUTANJA` ispravno naznačena i da su `.jar` datoteke pravilno asocirane sa Java launcher.

# Pokretanje komandne linije

U normalnim situacijama nije potrebno pozivati OmegaT sa komandne linije. Međutim, metod pozivanja OmegaT preko komandne linije očekuje unaprijed da će se ponašanje ovog programa kontrolirati pomoću nekih modifikacija. Postoje dva načina pozivanja OmegaT preko komandne linije.

Korisnici Mac OSX paketa koji žele da kontrolišu rad OmegaT sa komandne linije, trebalo bi da koriste paket koji predlažemo pod "Drugi operativni sistemi". Pogledaj gore.

## Metod 1: otvaranjem prozora za komandnu liniju

Prozor komandne linije se takođe naziva i "prozor terminala". Na Windows-ima se zove "MS-DOS prozor" i nalazi se u Start meniju, unutar programa, kao pozicija "MS-DOS". Takva ista aplikacija u Mac OSX je terminal za aplikacije koji se nalazi u Applications → Utilities.

Za pozivanje OmegaT, obično moraš ukucati dvije komande. Prva od njih je:

`cd {direktorijum}`

gdje je `direktorijum}` ime direktorijuma s njegovom cjelovitom putanjom, u kome se nalazi tvoj OmegaT program - tj. preciznije, datoteka `OmegaT.jar` u njemu. U praksi će, stoga, ova komanda izledati nekako ovako:

Na Windows-ima:
  `cd C:\Program Files\OmegaT`
Na Mac OSX
  `cd /Applications/OmegaT`
Na Linux
  `cd /usr/local/omegat`

Ovom se komandom mijenja direktorijum, i ide se u onaj koji sadrži izvršnu datoteku OmegaT. Druga komanda je ona kojom se stvarno pokreće OmegaT. Njen najosnovniji vid je :

`java -jar OmegaT.jar`

Obrati pažnju na mala odn. velika slova - to je uvijek važno.

Ovaj metod je posebno koristan jer je pogodan za debugging: Ako se tokom korištenja programa desi neka greška, poruka sa greškom pojavljuje se u prozoru terminala i ta poruka može sadržati i korisne informacije o uzroku greške.

## Metod 2: izmjena datoteke `.bat` file/launch script

1. metod je pomalo nepraktičan način za redovno pozivanje programa. Iz tog razloga su dvije gore opisane komande smještene u jednu datoteku ("script", koji se na Windows sistemima zove i ""`.bat` datoteka").

Kad se ovakva datoteka izvršava, komande ispisane u njoj, automatski se izvršavaju. Stoga je, radi izmjene komande za pozivanje, dovoljno modifikovati tu datoteku. Kad se OmegaT podigne preko datoteke, tade se izvršavaju neke nove komande.

## Pozivanje argumenata preko komandne linije

Osnovna komanda je već opisana gore. Promene ove komande obavljaju se preko dodavanja "argumenata" u nju. Argumenti se dodaju prije početnog "`java`", i prije dijela sa "`-jar OmegaT.jar`".

Slijedi popis mogućih argumenata. Dalje informacije o argumentima mogu se dobiti kucanjem `man java` u prozoru terminala. `man` predstavlja komandu u prozoru terminala kojom se prikazuje uputstvo za izabranu komandu. U tvom sistemu eventualno može postojati i uputstvo za komandu `java` na tvom jeziku.

`-Duser.language=XX`

  Normally, i.e. when OmegaT is launched without any arguments, the program first detects the language of the user's operating system. Ako postoji korisnička radna površina na tom jeziku, OmegaT je koristi. Tako, ako je korisnikov operativni sistem na ruskom jeziku, a OmegaT je bila prevedena na ruski, ona se prikazuje sa ruskom korisničkom radnom površinom, sa menijima na ruskom, itd. Ako ne postoji lokalni jezik korisnikovog sistema, Omegat se pod default drži svoje verzije na engleskom. To je standardno ponašanje.

  Argument "`-Duser.language=XX`" čini da se koristi specifični jezik, drugačiji od jezika korisnikovog operativnog sistema. "XX" u komandi služi za dvocifrenu šifru željenog jezika. Da bi se pozvala OmegaT sa interfejsom na francuskom (na primer, na ruskom operativnom sistemu), komanda bi tada bila:

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

`-Duser.country=XX`

  Do jezika, možeš specificirati i državu, na primjer CN ili TW kad se radi o kineskom jeziku. Da bi se dobilo i pravilno uputstvo za brzi početak, moraš specificirati oboje, i jezik i zemlju. Ovo je potrebno i onda kada postoji samo jedna kombinacija, kao na primjer kod pt_BR u slučaju portugalskog jezika u Brazilu. .

`-Dswing.aatext=true`

  Ovaj argument utiče na efekt anti-aliasing kod slova, tako što poboljšava njihov izgled.

`-XmxZZM`

  Ova komanda dodjeljuje više memorije za OmegaT. Pod default, dodjeljuje se 256 MB, tako da se nema prednosti ako se odvoji manje od ove veličine. "ZZ" predstavlja količinu dodijeljene memorije i to u Megabajtima. Komanda za dizanje OmegaT sa 1024 MB (1 gigabyte) memorije, stoga bi bila:

  `java -Xmx1024M -jar OmegaT.jar`

Argumenti se mogu i kombinovati. Za pozivanje OmegaT sa svim gore pomenutim primjerima, komanda bi bila:

`java -Dswing.aatext=true -Duser.language=pt -Duser.country=BR -Xmx1024M -jar OmegaT.jar`

# Gradnja OmegaT iz "source"

## Koji paket treba preuzeti?

Preuzmi OmegaT_1.7.3_Source.zip
  Ovaj paket sadrži source datoteke koje odgovaraju dotičnoj verziji i mogu se koristiti na bilo kom sistemu instalisanom sa Java 1.4 JDK ili kompatibilnim Java sistemom. Za građenje OmegaT takođe će ti biti potrebna i alatka ant.
Sa CVS servera možeš preuzeti i najnovije kodove:
  `cvs -z3 -d:pserver:anonymous@omegat.cvs.sourceforge.net:/cvsroot/omegat co -P omegat`

## Građenje OmegaT

  Dekompatiraj OmegaT_1.7.3_Source.zip file i unesi direktorijum OmegaT_1.7.3_Source ili unesi ./omegat/ direktorijum proverenih CVS kodova. Provjeri da li je i datoteka build.xml file prisutna u tom direktorijumu. Onda upiši sa komandne linije:

`$ ant jar release`

  Tada će se napraviti detaljna distribucija OmegaT u ./dist/ direktorijumu u kome ćeš naći sve potrebne datoteke za rad OmegaT.

Napomene pravne prirode