# &koffice;

## Sissejuhatus

### &koffice;'i komponendid

&koffice; kujutab endast K Töölaua Keskkonna (&kde;) integreeritud kontoritöö paketti. Praegu koosneb &koffice; järgmistest rakendustest:

- &kword; (raamipõhine tekstitöötlusrakendus)

- &kspread; (tabelitöötluse rakendus)

- &kpresenter; (esitluste valmistaja)

- &kivio; (vooskeemide koostamise rakendus)

- &karbon14; (vektorgraafika rakendus)

- &krita; (rastergraafika rakendus)

- &kexi; (integreeritud andmehalduse keskkond)

- &kchart; (diagrammide/graafikute loomise rakendus)

- &kformula; (matemaatiliste valemite redaktor)

&koffice;'i rakendused, mille aluseks on KPartsi komponentide mudel, suudavad väga hästi omavahelise koostööga hakkama saada. Iga &koffice;'i komponenti on võimalik põimida suvalisse &koffice;'i dokumenti. Näiteks on võimalik &kspread;iga loodud arvutustabel lisada otse &kword;i dokumenti. Sel moel saab &koffice;'i rakendustega luua vägagi keerukaid ja kompleksseid dokumente.

Pluginad laiendavad märgatavalt &koffice;'i niigi suurt funktsionaalsust. Mõnes rakenduses on neid päris palju kasutusel ning sa võid neid ka ise luua. Käsiraamatus ongi vastav osa, mis tutvustab, kuidas ise plugin valmis teha.

Käsolev käsiraamat kõneleb &koffice;'i üldistest omadustest, mis on ühised kõigile või vähemalt enamikule rakendustest. Täpsemat infot konkreetse rakenduse kohta leiab nende käsiraamatutest.

### Ülevaade &koffice;'i omadustest

#### Integreeritus

&koffice; pakub välja raamistiku, millele toetuvad kõik komponendid. See võimaldab neid väga suurel määral lõimida. Soovi korral võib iga kasutaja luua ka ise komponente, mis raamistikus ilusasti töötavad. Seda kirjeldab põhjalikumalt KPartsile pühendatud peatükk.

#### Kergus

Paljudele komponentidele vaatamata on &koffice; väga kerge ja kiire ega koorma märkimisväärselt arvuti mälu. Selle taga seisab asjaolu, et &koffice; tugineb &kde;-le, mis juba ise kujutab endast väga võimsat rakenduste arendamise raamistikku.

Samuti ei püüa &koffice; koormata kasutajaliidest üle omadustega, mille järele enamikul kasutajatest usutavasti erilist vajadust pole. Nii on tulemuseks kena ja selge kasutajaliides, mis võimaldab keskenduda just oma tööle.

Kergus võib küll harvadel juhtudel tähendada ka seda, et mõni eriline funktsioon ei ole kättesaadav. Sel juhul on aga alati võimalik vajalik funktsionaalsus ise luua &koffice;'i laiendamise teel. &koffice; ei soovi mingil juhul muutuda suureks ja raskesti hoomatavaks tarkvarakolossiks, kus on hulga selliseid omadusi ja võimalusi, mida vajavad vaid üksikud kasutajad. Selliseid asju saab alati lisada täiendavate pluginate või skriptidega, mis ei koorma &koffice;'i ennast.

#### Täielikkus

&koffice; pakub laia valikut komponente, mis peaksid katma enamiku kodu- ja ärikasutajate vajadustest. Lisavõimalusi saab alati teostada skriptide, pluginate või isegi uute, &koffice;'i raamistikule loodud komponentidega.

#### OASIS-e OpenDocument-vorming

Iga kontoritööpaketi suureks eeliseks on see, kui ta võib tugineda kindlatele standarditele. Eriti just failivormingu tasandil võimaldab see muretut dokumentide vahetamist teiste kontoritööpakettide kasutajatega. See tagab ka sõltumatuse tarkvarapakkuja hetketujudest, mis on eriti oluline ärimaailmas, aga tuleb kasuks ka kodukasutajatele.

Sel põhjusel on &koffice; võtnud oma loomupärase failivorminguna kasutusele OASIS-e OpenDocument-vormingu.

#### &kde; omadused

Kuna &koffice; tugineb &kde;-le, võimaldab &koffice; kasutada ka kõike seda, mida &kde; rakendustelt vähegi oodata võib, kaasa arvatud &DCOP;, KParts, integreerumine töölauaga, seadistatavus ja nii edasi. Kõik see muudab &koffice;'i välimuse äärmiselt tuttavaks ja integreerib &koffice;'i tõeliselt töökeskkonda, mis tagab sujuva ja tõrgeteta töö.

## &koffice;'i tehnoloogia

### KParts - &koffice;'i ehituskivid

Iga &koffice;'i rakendus täidab spetsiifilist ülesannet, näiteks &kspread; tegeleb arvutustabelitega, &kword; aga tekstitöötlusega. Konkreetsele asjale pühendudes püüab iga rakendus oma valdkonnas olla võimalikult parem. Kuid sõltuvalt sellest, mida &koffice;'iga parajasti teha soovitakse, võib sageli tekkida soov kasutada muude rakenduste võimalusi - seda parajasti avatud dokumendi raames.

Oletame, et lood &kword;i abil dokumenti ja soovid midagi illustreerida tabeli abil. &kword; pakub küll ka omalt poolt võimaluse tabel lisada, kuid sellest võib jääda väheseks. Võib-olla soovid näiteks kasutada konkreetseid valuutavorminguid või sooritada arvutustabelites tavalisi tehteid. Kindlasti suudaks mõni &kword;i programmeerijatest selle võimaluse ka oma rakendusse sisse kirjutada. Kuid nagunii ei suudaks &kword; selles osas olla nii hea kui &kspread; ja kui püüda pakkuda kõiki võimalusi, mida kasutajal eales võib vaja minna, ootab rakendust ees muutumine erakordselt keeruliseks, nii et isegi ülevaate saamine lähtekoodist võib muutuda võimatuks.

Selle dilemma lahendab KParts. KPartsi idee on imelihtne: iga rakendus tehku seda, mis tal kõige paremini välja tuleb.

#### Kompleksdokumendid KPartsi abil

KPartsi vahendusel saavad sinu loodud dokumendid kasutada ükspuha millist funktsiooni, mida suudab pakkuda ükspuha milline &koffice;'i rakendus. Seda tehakse niinimetatud komponentide lisamisega dokumenti. Kõik sellised komponendid on iseenesest omaette dokumendid, seega on tulemuseks dokument dokumendis.

Varem mainitud näites tuli lihtsalt lisada &kspread;i komponent &kword;i dokumenti. Kui nüüd redigeerid tabelit, võtab taustal kontrolli üle &kspread;. Kui pöördud tabeli juurest teksti redigeerimise juurde tagasi, läheb ka kontroll taas &kword;i kätte. Ainus muudatus, mida kasutaja seejuures märkab, on tööriistaribade ja menüü muutumine tabeli redigeerimise ajal vastavaks &kspread;i, mitte aga &kword;i tööriistaribadele ja menüüdele. Sellist ühe rakenduse võimet kaasata teise rakenduse võimalusi nimetatakse põimimiseks.

#### KPartsi kasutamine dokumentides

Kui sa ei ole kunagi varem kompleksdokumentidega töötanud, võivad need esmapilgul segadusse ajada. Järgnev samm-sammuline selgitus näitab, et KPartsi kasutamine ja töö ühesainsas rakenduses õigupoolest millegi poolest ei erinegi.

#### &kspread;i komponendi lisamine &kword;i dokumenti

1. Käivita &kword;. Seda saab teha paneelilt või kirjutades käsureale ``kword``.

2. Ava uus tühi dokument. Kirjuta sinna mingi näidistekst.

3. Vali menüükäsk Lisamine Objekti raam Tabel. Pane tähele, et hiirekursor muutub ristikujuliseks. See annab märku, et sa saad valida asukoha, kuhu raam asetada.

4. Klõpsa &HVN;ga kohas, kus soovid näha tabeli ülemist vasakut murka, hoia nuppu all ja lohista see kohta, kus peaks asuma tabeli alumine parem nurk. Lahe hiirenupp lahti. Ilmub dialoog, mis annab võimaluse lisada olemasolev dokument või luua uus. Loo tühi tööleht. Ja ongi kõik!

Lihtne, eks ju? Nüüd näed tabeli raami &kword;i dokumenids. Tee nüüd topeltklõps tabeli alal. Võid näha, et:

- Menüüriba ja tööriistaribad muutusid, omandades sellise kuju, nagu neil on &kspread;is.

- Tabeliraam sisaldab nüüd &kspread;i elemente - kerimisribad, kaardiriba tabelite valimiseks &etc;

Proovi tabelit redigeerida ja sa näed, et see käib täpselt samamoodi nagu &kspread;is. Õigupoolest tulekski öelda, et praegu töötad &kspread;is.

Nüüd klõpsa kusagil &kword;i dokumendis väljaspool tabelit. Menüüriba ja tööriistaribad muutuvad taas &kword;i omaks, &kspread;i vaate elemendid kaovad. Tabel jääb aga alles ja kajastab kõike, mida sa seal ette võtsid.

KPartsi kasutamine on imelihtne. Proovi lisada muid osi või isegi osi osadesse.

## &koffice;'i ja oma süsteemi seadistamine

Kuigi &koffice; võib töötada väga edukalt ka ilma midagi muutmata, on siiski mõningaid asju, mille näppimine võib &koffice;'i veelgi paremaks muuta. Käesolevas peatükis näitamegi, mida võib ette võtta, et saavutada uue kontoritöö paketiga kõige paremaid tulemusi. &koffice; on äärmiselt seadistatav, isegi tööriistaribasid ja menüüsid saab mitmeti muuta.

### Fondiväljundi optimeerimine

Fondid on &X-Window; puhul ikka valus teema olnud. Selles osas puudutame mõningaid probleeme, millest &koffice;'i kasutajad on sageli teada andnud. Osa neist ei ole tegelikult &koffice;'i probleemid, vaid sõltuvad süsteemi seadistustest, nii et nende lahendamiseks võib olla vajalik süsteemsete seadistusfailide muutmine. Kui sul ei ole süsteemile ligipääsuks administraatori õigusi, näita käsiraamatu vastavaid osi oma süsteemiadministraatorile ja palu tal midagi ette võtta. Kuivõrd fontide teema on liiga mahukas, et seda siin ühe hingetõmbega ära rääkida, võid täpsema info saamiseks uurida fontide HOWTO'd (inglise keeles), millest on pärit ka siinne info, sest seal on kõik üksikasjalikult ära seletatud.

#### Kuidas saada ekraanile kenasti skaleeritud fonte

JAJAH

#### Kuidas saavutada korrektne väljatrükk

&koffice; suudab küll toime tulla kõigi X11 fontidega ekraanil, kuid trükkimine võib olla problemaatilisem. Enamikus süsteemides käib see nimelt ghostscripti vahendusel ja kui ka &koffice; tunneb fontide nimesid, mida kasutab &X-Window;, ei tunne ta üldiselt fontide nimesid, mida kasutab ghostscript. &koffice; püüab neid ära arvata, kuid paraku ei saada teda sugugi alati edu.

Probleemil on siiski lahendus, kuid see pole just kõige lihtsam. Tegelikult võib juhtuda, et kasutad distributsiooni, kus see on juba põhiliselt lahendatud (nii et kui sa ei oska väljatrüki üle midagi kurta, võid selle osa vahele jätta). Selleks tuleb ghostscriptile öelda, kuidas tuleb tõlgendada (oletatud) fontide nimesid, mida &koffice; kasutab oma fontide jaoks. Seda tehakse teatud ridu failile `Fontmap` lisades. Aliase rida failis `Fontmap` võib välja näha näiteks selline:

##### Aliase rida ghostscript Fontmapis

    /Algerian-Roman /Algerian       ;

Arvesta, et tühik enne ';' on kohustuslik. Antud näites on Algerian-Roman nimi, mida &koffice; kasutab fondi Algerian jaoks. Sellised read tuleb lisada fontidele, mida &koffice; korrektselt ei näita. Et see hõlpsam oleks, kirjutas Donovan Rebecchi Perl-keeles skripti, mille võib leida veebileheküljelt http://pegasus.rutgers.edu/~elflord/font_howto/kwdfont. Oletades, et sul on fondifail `/usr/share/ghostscript/fonts/fontfile.ttf`, tuleb vajalike aliaste lisamiseks anda käsk ``kwdfont` `/usr/share/ghostscript/fonts/fontfile.ttf``. Skript peaks enamasti probleemid lahendama. Kuid, nagu juba varem mainitud, tasub täpsema ja põhjalikumat info leidmiseks uurida fontide HOWTO'd.

### &koffice;'i &GUI; kohandamine

&koffice; puhtal kujul pakub &GUI;-d (graafilist kasutajaliidest), mis peaks vastama enamiku inimeste vajadustele. Kuid võib olla mis tahes põhjusi, mis panevad sind tahtma rakenduste väljanägemist muuta.

Minu ema näiteks pelgab nuppe ja menüükirjeid, millest ta aru ei saa. &koffice;'i kohandamiseks just tema vajadustele taandasin &GUI; sõna otseses mõttes miinimumini, säilitades vaid hädavajalikud funktsioonid. Kuna ta kirjutab peaaegu ainult kirju ja kasutab vaid kindlaid malle, siis kõikvõimalikud võimalused salvestamiseks, avamiseks, trükkimiseks &etc; polnud talle vajalikud.

Tänu &Qt; ja &kde; loodud kontseptsioonile action saab &koffice;'i menüü- ja tööriistaribasid igati muuta. Kahjuks puuduvad praegu veel selleks hõlpsasti kasutatavad dialoogid. &koffice; salvestab oma &GUI; seadistused &XML;-failides, mida tuleb siis vastavalt vajadustele redigeerida. Loodetavasti muutub tulevikus asi hõlpsamaks, kuid praegu läheb selleks vaja mõningaid algteadmisi &XML; (või &HTML;, mis kujutab endast &XML;-i alamliiki) dokumentide toimimise kohta. [Kontseptsioon action vajab veel lähemat lahtiseletamist -- kt.]

Tavaliselt on igal &koffice;'i rakendusel vähemalt kaks sellist &XML;-faili: üks kirjeldab shelli &GUI;-d (see on põhimõtteliselt see, mida näeb siis, kui ühtki dokumenti ei ole avatud) ning teine vastava komponendi &GUI;-d (see on see, mida tavaliselt nähakse). Näiteks &kword;il kannavad need kaks &XML;-faili nime `kword_shell.rc` ja `kword.rc`.

Lihtne rc-fail näeb välja selline.

#### Lihtsa rc-faili näide

    <!DOCTYPE QConfig ><qconfig>
    <menubar>
    <menu name="Edit"><text>Edit</text>
    <action name="edit_cut"/>
    <action name="edit_copy"/>
    <action name="edit_paste"/>
    <separator/>
    <action name="edit_find"/>
    </menu>
    <menu name="Insert"><text>Insert</text>
    <action name="insert_picture"/>
    <action name="insert_clipart"/>
    <menu name="Variable"><text>Variable</text>
    <action name="insert_var_datefix"/>
    <action name="insert_var_datevar"/>
    </menu>
    </menu>
    </menubar>
    <toolbars>
    <toolbar name="edit_toolbar" position="right">
    <action name="edit_cut"/>
    <action name="edit_copy"/>
    <action name="edit_paste"/>
    </toolbar>
    </toolbars>
    </qconfig>

## Kuidas saada rohkem infot

### Muud &koffice;'i käsiraamatud

Täpsemat infot &koffice;'i erinevate rakenduste kohta leiab nende käsiraamatutest.

### Viidad

Järgnevad viidad võivad tulla kasuks, kui soovid saada rohkem teada &kde; või &koffice;'i kohta.

- &koffice;'i kodulehekülg. Siit leiab infot, kuidas &koffice;'it hankida ja paigaldada, uudiseid &koffice;'i arendamise kohta, pilte &etc;

- &kde; kodulehekülg. &kde; on UNIX-laadsete operatsioonisüsteemide kõige täiuslikum ja absoluutselt vaba töökeskkond. &koffice; kasutab &kde; teeke.

- Trolltech. C++ tööriistakomplekti &Qt; looja. &kde; ja &koffice; kasutavad &Qt;-d.

## &koffice;'i programmeerimine

### Sissejuhatus

Kui soovid kaasa aidata &koffice;'i arendamisele, võivad kasuks tulla järgmised kohad:

- Veebileheküljel http://developer.kde.org leiab hulganisti dokumente programmeerimise kohta &Qt; ja &kde; abil. Siin leiab ka täieliku &kde; teegi dokumentatsiooni.

- &koffice;'i lähtetekstis võib leida näidisrakenduse kataloogis `example`.

## Autoriõigus ja litsents

&koffice; on sündinud paljude arendajate ühise pingutuse tulemusena. Iga &koffice;'i lähtefail kannab selle kirjutaja autoriõigust, kelle nime võib koos faili kohta käiva litsentsiga leida iga lähtefaili algusest. Põhiarendajate nimesid näeb ka aadressil http://www.calligra.org/people.php.

Selle käsiraamatu autoriõigus kuulub &Jost.Schenck;ile. Käsiraamatut võib levitada vabalt, kuni sellele on lisatud märge autoriõiguse kohta. Seda võib ükspuha millises ulatuses muuta tingimusel, et muudatused saadetakse mulle või &kde; CVS-i. Ma ei kanna mingisugust vastutust millegi eest, mis võib juhtuda selle käsiraamatu kasutamise tagajärjel.

Muude &koffice;'i käsiraamatute autoriõigus kuulub vastavalt nende autoritele.

Tõlge eesti keelde: Marek Laane bald@smail.ee

&underFDL; &underGPL;

## Paigaldamine

### Nõuded süsteemile

&koffice;'i paigaldamiseks ja kasutamiseks on vajalikud:

- Toimiv &UNIX; süsteem (näiteks &Linux; või BSD), kus on seadistatud &X-Window; (näiteks XFree86 või X.Org).

- &Qt; 3.3 teegid Trolltechilt. Täpsemat infot leiab aadressilt www.trolltech.com.

- K töölaua keskkond 3.3 (&kde; 3.3) või uuem. &koffice;'i kompileerimine &kde; varasemate versioonidega ei ole võimalik. Infot &kde; hankimise ja paigaldamise kohta leiab aadressilt &kde-http;

- Luba paigaldada arvutisse tarkvara. Kui see on su isiklik arvuti, ei ole see probleem, kui aga töötad võrguarvuti taga, tuleb sul esmalt pöördud oma süsteemiadministraatori poole.

Pane tähele ka seda, et kuigi vaja läheb &kde; 3.3 (või uuemaid) teeke, saab &koffice;'it kasutada ka muudes töökeskkondades (näiteks XFCE või GNOME).

Kui kavatsed kompileerida &koffice;'i lähtekoodist, on lisaks nimetatutele vajalikud:

- `automake` 1.6.1 või uuem. Selle saab alla laadida aadressilt ftp://ftp.gnu.org/pub/gnu/automake/

- `autoconf` 2.53 või uuem. Selle saab alla laadida aadressilt ftp://ftp.gnu.org/pub/gnu/autoconf/

- C++ kompilaator, mis toetab erandeid. Soovitavalt GCC uusim versioon, mille allalaadimise ja paigaldamise kohta leiab infot aadressil http://gcc.gnu.org.

- Trolltechi &Qt; 3.3 arenduspaketid. Kui need ei ole juba sinu süsteemi paigaldatud ja sa ei leia neid ka oma distributsioonist, tuleb tõenäoliselt &Qt; kompileerida lähtetekstist. Selle leiab aadressilt http://www.trolltech.com/download/index.html.

Kui oled kindel, et süsteem vastab esitatud nõuetele, tuleb otsustada, kas soovid kompileerida lähtekoodist või paigaldada eelnevalt kompileeritud binaarpaketid.

Kui soovid hankida &koffice;'i kõige uuema binaarpaketi, vaata lähemalt osa Binaarpaketi hankimine.

Kui sinu süsteemile ei ole olemas eelnevalt kompileeritud binaarpaketti, on võimalik alla laadida lähtekood ja kompileerida KOffice ise. Juhiseid, kuidas hankida uusim lähtekood (ja mida sellega peale hakata, kui see käes on), leiab osast Lähtekoodi hankimine.

Täpsemat infot leiab &koffice;'i koduleheküljelt. Sealt saab alati kõige värskemat teavet nii lähtekoodi kui binaarpakettide kohta!

### Binaarpaketi hankimine

Uusima binaarpaketi saab alla laadida aadressilt:

http://calligra.org/download

või mõnelt selle arvukatest peegelsaitidest. Peegelsaitide praeguse nimekirja leiab aadressilt:

http://www.kde.org/mirrors.html

Tingimata tuleb kasutada binaarpaketti, mis sobib sinu süsteemiga. Kui kasutad operatsioonisüsteemi &Linux; ega suuda leida binaarpaketti &koffice;'i veebileheküljelt või peegelsaitidelt, võib selle vahest leida sinu distributsiooni koduleheküljelt.

### Binaarpaketi paigaldamine

&koffice;'i paigaldamiseks eelnevalt kompileeritud binaarpaketist tuleb:

1. Kontrollida, et arvutisse on paigaldatud kogu vajalik tarkvara ja et see ka töötab (välja arvatud mõistagi &koffice;). Süsteemile esitatavad nõuded võib leida osast Nõuded süsteemile.

2. Laadi &koffice;'i binaarpakett ajutisse kataloogi.

3. Kui failinimel on laiend `.rpm` (&RedHat; Package Management fail), saab &koffice;'i paigaldada sellise käsuga:

       $rpm-U failinimi

   Kui failinimel on laiend `.deb` (Debiani paketi fail), saab &koffice;'i paigaldada sellise käsuga:

       $ dpkg-i failinimi

   Kui failinimel on laiend `.tar.gz` või `.tgz` (pakitud fail), saab &koffice;'i paigaldada selliste käskudega:

       $ cd /
       $ tar -xzvf failinimi

   Toodud näidetes tuleb failinimi asendada paketi täieliku nimega, andes sealjuures selle täieliku asukoha, kui sa ei viibi just samas kataloogis, kuhu see on salvestatud.

4. See ongi kõik. &koffice; on nüüd paigaldatud.

Kui kasutad graafilist paketihalduse vahendit, näiteks &kpackage; või GnoRPM, võib olla märksa mugavam paigaldus käsurea asemel sellise rakendusega ette võtta. Kuidas seda täpselt teha, peaks selguma vastava rakenduse dokumentatsioonist.

### Lähtekoodi hankimine

Uusima lähtekoodi saab alla laadida aadressilt http://calligra.org/ või mõnelt selle peegelsaidilt. Peegelsaitide praeguse nimekirja leiab aadressilt:

http://www.kde.org/mirrors.html

### Lähtekoodi paigaldamine

Kui soovid paigaldada &koffice;i lähtekoodist, tuleb:

1. Kontrollida, et arvutisse on paigaldatud nõutav tarkvara ja et see ka tötab (välja arvatud mõistagi &koffice;). Süsteemile esitatavad nõuded leiab osast Nõuded süsteemile.

2. Laadida &koffice;'i lähtekoodi fail ajutisse kataloogi.

3. Kui failinimel on laiend `.src.rpm` (&RedHat; paketihalduse fail), saab &koffice;'i lähtekoodi paigaldada käsuga:

       $ rpm-U failinimi

   Kui failinime laiend on `.src.tar.gz` või `.src.tgz` (pakitud fail), saab &koffice;'i lähtekoodi paigaldada käsuga:

       $ tar -xzvf failinimi

4. &koffice;'i lähtekood on nüüd süsteemi paigaldatud.

&documentation.index;