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), chromium-browser, 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.1beta.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 translatedirectory-vakion arvoksi oikea polku:
Esim user-käyttäjä voisi laittaa kyseisen vakion seuraavaksi. 
Global Const translatedirectory="/home/user/libreofficetranslate/googletranslate/"

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. Käynnistä translate-palvelin.
CTRL+T:llä avaat terminaalin kotikansioosi.
cd libreofficetranslate
cd googletranslate
php translate.php 
# Odottamalla rupeaa translate-palvelin tulostamaan ok:ta hitaasti
# avaa uusi terminaali-ikkuna normaalilla käyttäjällä
CTRL+T
cd libreofficetranslate
cd googletranslate
echo "Kääntyykö englanniksi ?" > param.txt
# Tämän jälkeen pitäisi serverin ikkunaan ilmestyä käännös 
# Ja sen jälkeen serveri rupeaa tulostamaan ok:ta jälleen (Jätä palvelin päälle)

8. 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

9. 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 silloinkaan ei tapahdu mitään, niin tarkista, että palvelin on edelleen päällä, kuten kohdassa 7. on neuvottu.

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ä.

10 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ä

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

12 Maalaa kirjoittamasi.

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

14 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ä).

15 Jokaista käyttöä varten tarvitsee käynnistää palvelin, kuten kohdassa 7-neuvotaan, jotta LibreOfficeen saadaan lähetettyä käännösehdotus.

Olkaa hyvät, ja nauttikaa...
