Ohjelmiston tarkoitus on kääntää LibreOfficen Writerilla merkattu teksti haluttuun kieleen google-translate:n avulla.

Ohjelma lisenssi on pohdinnassa ehdotuksia otetaan vastaaan...

Riippuvuudet:
LibreOffice (libreoffice, libreoffice-common), 
trans (translate-shell) (Tästä tulee olla riittävän uusi versio. K/X/L/UBUNTU 16.04:n pakettivarastoissa oleva version on liian vanha), 
php:n komentojono-paketti (php-cli),

Asentaminen:
1. Avaa LibreOfficen Writer tyhjällä dokumentilla.

2. Salli makrojen nauhoittaminen (rajoitetusti): Työkalut->Asetukset->LibreOffice/Lisäasetukset->Täppä Salli makrojen nauhoittaminen (rajoitetusti).

3. Nauhoita minimi makro: Työkalut->Makrot->Nauhoita makro
Paina i
Klikkaa lopeta nauhoitus
Klikkaa Uusi moduuli
Kirjoita modulin nimeksi: translate
Kirjoita makron nimeksi: minimi
Klikkaa Tallenna

4. Pura libreofficetranslate0.0.2beta.tar.bz2-tiedosto kotihakemitoosi (tai minne haluat, mutta ohjeet tulee kotihakemisto-oletuksella).

5. Kopioi libreofficetranslate-hakemistosta löytyvä translate.bas-tiedosto LibreOfficen translate modulin sisällöksi:
Työkalut->Makrot->Muokkaa makroja
-> Omat makrot ja valintaikkunat
-> Kaksoisklikkaa: translate
Lisää Basic-lähdekoodi
Mene avautuneella tiedostoselaimella:
-> Koti -> libreofficetranslate -> translate.bas 
avaa translate.bas
CTRL+s

6. Muuta translate-modulin subtranslatedirectory-vakion arvoksi oikea polku:
Global Const subtranslatedirectory="/libreofficetranslate/googletranslate/"

Ja voit halutessasi muuttaa basicPath:n kotihakemistokseksesi. (Ei välttämätöntä, jos et käytä muita makroja).
Esim. voisi laittaa kyseisen vakion seuraavaksi. 
Global const basicPath = "/home/user"

Olettaen, että on purkanut paketin libreofficetranslate-kansioon.

Työkalut->Makrot->Muokkaa makroja
Omat makrot ja valintaikkunat->Standard->translate
Muokkaa Global Const translatedirectory:n arvo oikeaksi

CTRL+s

7. Nyt voitkin testata toimiiko LibreOfficen Writerin makrolla kääntäminen.
Avaa Writer:n tekstiasiakirja
Kirjoita: Osaako google kääntää tekstiä ?
Maalaa teksti: Osaako google kääntää tekstiä ?
-> Työkalut -> Makrot -> Suorita Makro -> Omat makrot -> Standard -> translate (Kirjasto) -> (Makron nimi) Translate 
Klikkaa Suorita.

Jos tuli seuraava virheilmoitus: "BASIC-syntaksivirhe. Aliproseduuri tai funktio Main on ennestään määritetty."
Klikkaa Ok:ta monta kertaa...
-> Työkalut -> Makrot -> Muokkaa makroja
-> Omat makrot ja valintaikkunat -> Standard -> translate
Poista ylimääräinen koodi: "Sub Main" ja sitä seuraava "End Sub" joko alusta tai lopusta siis sieltä, mistä kyseinen löytyy.
CTRL+s

8. Kokeile uudella yrityksellä ajaa translate-makro:
Avaa Writer:n tekstiasiakirja
Kirjoita: Osaako google kääntää tekstiä ?
Maalaa teksti: Osaako google kääntää tekstiä ?
-> Työkalut -> Makrot -> Suorita Makro -> Omat makrot -> Standard -> translate (Kirjasto) -> (Makron nimi) Translate 
Klikkaa Suorita.

Jos tuli IO-virhe, niin tutki uudestaan kohta 6.

Jos mitään ei tapahdu, niin odota hetki (20 sekuntia).

Jos pienen odottelun jälkeen tulee kysymys-lomake:
yes(fi)->Osaako google kääntää tekstiä ?
no(en)->Can google translate text ?
Cancel->No Change

Kyllä-painiketta klikkaamalla tulee maalatun tekstin tilalle:"Osaako google kääntää tekstiä?"
Ei-painiketta klikkaamalla tulee maalatun tekstin tilalle:"Can google translate text?"
Peruuta-painiketta klikkaamalla kysymys-lomake häviää muuttamatta tekstiä.

9 Näppäinoikotien määrittäminen translate-makrolle:
Työkalut->Mukauta
Valitse Pikanäppämeksi CTRL+T (Helpohko muistaa Translate:n ensimmäinen kirjain)

Valitse Luokaksi: LibreOffice makrot->Omat makrot->Standard->translate
Valitse Toiminnoksi: Translate
Klikkaa Muuta-painiketta hiiren ykkösellä
Klikkaa OK-painiketta hiiren ykkösellä

10 Kirjoita: "Pitäähän sitä kokeilla toimiiko automaattikääntäjä ollenkaan."

11 Maalaa kirjoittamasi.

12 Paina CTRL+T-pikanäppäintäsi.
Odota, kunnes tulee käännöslomake. Valitse käännösvaihtoehto, joka itseäsi miellyttää.

13 KIELEN VAIHTAMINEN
Paina välilyöntiä kerran.
Paina "Shift+vasennuoli" kerran.
Paina CTRL+T-pikanäppäintäsi.
Pitäisi tulla nopeasti:"Haluatko määritellä kielet ?"-lomake.
Klikka Kyllä-painiketta.
Kirjoita käännettäväksi kieleksi kaksi-kirjaiminen kielen lyhennys:(Esim. suomeksi->fi, englanniksi->en, ranskaksi->fr, saksaksi->de) Jos et tiedä, niin katso "https://translate.google.fi"-sivulta lyhenteet.
Klikkaa Ok.
Valitse käännöksen kieleksi haluamasi kieli. (Samat lyhenteet kuin käännettävissäkin kielissä).

Olkaa hyvät, ja nauttikaa...
