# Seadistused

## Üldised ja projekti seadistused

Alates KBabeli versioonist 1.10 (KDE 3.4) võttis KBabel kasutusele projekti kontseptsiooni ning vastavalt jagati ka seadistused kahte kategooriasse: üldised seadistused ja projekti seadistused.

&GNU; gettext kasutab samuti mõistet "projekt", millel pole aga mingit pistmist KBabeli projektidega. &GNU; gettext peab projekti all silmas rakendust, mis on seotud PO-failiga. KBabelis on projekt märksa laiema tähendusega ning tähistab enamasti tervet rakenduste kogumit, näiteks kogu &kde;d.

KBabelil on alati aktiivne projekt, ka siis, kui see on vaikeprojekt. KBabel ei saagi töötada ilma projektita. KBabeli redaktor ja KBabeli kataloogihaldur kasutavad alati projekti.

### Praeguse teostuse teadaolevad piirangud

Paraku on projektidel praegusel kujul mõned teadaolevad probleemid.

Nii ei saa näiteks üldistes seadistustes määrata kindlaks vaikimisi kasutajat, tema keelt ja muid olulisi üldisi kasutajaandmeid. See tähendab, et need tuleb uue projekti loomisel alati uuesti sisestada.

Veel ühe probleemi tekitab uue projekti nõustaja, mis ei päri piisavalt palju infot. Näiteks ei küsi see meeskonna e-posti aadressit. Seepärast on soovitatav pärast nõustaja töö lõpetamist projekti seadistused üle kontrollida.

Praegu pole võimalik projekte KBabeli sees kopeerida, nii ei saa ka seadistusi lihtsal moel korduvalt kasutada. Siiski võib projekti kopeerida väljaspool KBabelit ja selle siis KBabelis laadida.

### KBabeli kasutamine &kde;-väliste projektidega

Kuigi &kbabel; on vaikimisi orienteeritud töötama &kde; raames ja huvides, saab &kbabel;i abil tõlkida ka teiste projektide PO-faile. Siiski tuleb enamasti selleks projekti seadistusi tublisti muuta. See kehtib eriti &GNU; ja &GNU;-laadsete projektide kohta, mille vaikeväärtused erinevad tunduvalt &kde; omadest.

Üks probleem seisab selles, et &kbabel; on üsna agressiivne PO-failide salvestamisel ning asendab PO-failide seadistused projekti seadistustega, kui talle just otseselt vastupidist käsku ei anta. See võib tunduda veidrana inimesele, kes pole &kde;ga palju kokku puutunud. Kuid &kde; raames on tõlkida üle 900 POT-faili ainuüksi GUI teadete jaoks. Sellise mahuga ülesande jaoks on teatud automatiseerimine hädavajalik. Projekti seadistamisele kuluv aeg tasub ennast hiljem kahtlemata ära. &kde; mittekasutamise korral pole asjad siiski nii head. Sul tuleb sel juhul seadistustega rohkem vaeva näham, sest vaikeväärtused pole kuigi sobivad ning ka paljud tõlked ei aita väga kaasa, sest &GNU; projektidel on tüüpiliselt tõlkida ainult üks POT-fail.

## &kbabel;i üldised seadistused

Seadistustedialoogi saab avada &kbabel;i menüükäsuga Seadistused KBabeli seadistamine.... Dialoog on liigendatud kaartideks, mis muudab äärmiselt lihtsaks vajaliku võimaluse leidmise ilma seda pikemalt taga otsimata.

### Redaktor

Redaktorikaart on jagatud kolmeks alamkaardiks: Üldine, Välimus, Õigekiri ja Fondid. Neis kõigis saab määrata, kuidas redaktor välja näeb ja käitub.

#### Üldine

Redaktori üldised seadistused Redaktori üldised seadistused

See kaart sisaldab hulga märkekaste.

Esimene märkekast ülaosas võimaldab määrata, kas kahtlane olek eemaldatakse automaatselt, kui MsgStr redigeerimisaknasse midagi sisestatakse. Kui see on märkimata, tuleb käsitsi kasutada menüükäsku Redigeerimine Eemalda kahtlane olek või kiirklahvi &Ctrl;U. Arvesta, et sellega eemaldatakse kirje kommentaarist string `, fuzzy`.

Järgmine võimalus lubab rakendada tarka redigeerimist, mille puhul redaktor lisab automaatselt korrektselt tähistatud erisümbolid, ⪚ `\t`, kui vajutad klahvi TAB, ning võimaldab klahvi Enter erikäsitlust.

Alumiste märkekastide abil saab määrata tõlke korrektsuse kontrollimist, õigemini küll seda, kas see sobib ikka kasutamiseks. Nii näiteks kujutavad paljud teated endast kiirmärgistega menüükäske ja C-stiilis vormindatud stringe, mille struktuur peab jääma ka tõlkes muutmata.

Argumentide kontroll

- Selle märkimisel kontrollitakse C vormingus stringe algupärandis ja tõlkes tagamaks, et vormingujadade arv ja järjekord oleks ühtlustatud.

Kiirklahvide kontroll

- Selle märkimisel kontrollib &kbabel;, kas kiirklahvimärgiste arv on algupärandis ja tõlkes ühesugune. Arvesta, et märgiseks on & (kuid seda ainult KDEs, teistes programmeerimise tööriistakomplektides võib see olla midagi muud). Täpsemat infot selle kohta, kuidas muuta kiirklahvimärgist, leiab osast Muud.

Võrduste kontroll

- See on &kde; projektiarenduse võimalus. Failid `.desktop` on tavalised tekstifailid, mis sisaldavad mitmesuguseid parameetreid vormingus `väärtus=võti`. Nii mõnigi selline `võti` on tõlgitav. Ainus piirang on siin see, et võrduse vasak pool peab jääma muutmata. Võrduste kontroll võimaldab tuvastada hulga vigu, mida määrab kahtlaste teadete `msgmerge` algoritm. Arvesta, et mõnes olukorras annab see funktsioon siiski teatud PO-failide puhul valehäireid.

Tõlgitud kontekstiinfo jälgimine

- Mõned algupärased teated on märgitud kontekstiinfoga, mis tähistab neid unikaalsena ka juhul, kui nende sisu kattub mõne muu teatega. Selle põhjuseks on see, et paljud lihtsad sõnad, näiteks Salvesta (inglise keeles Save) on tõlgitud paljudesse keeltesse. Kontekstiinfot tähistab `_:`. Paljud algajad tõlkijad tõlgivad ka kontekstiinfo ning täidavad nii oma PO-failid tarbetu taagaga. Selle kasti märkimisel antakse sellistest vigadest failis teada.

Mitmuse vormide kontroll

- &kde; projekti tõlkimisel tuleb arvestada, et see kasutab teadete mitmuse vormide määramiseks erilist süntaksit. Selle kasti märkimine arvutab automaatselt vormide arvu msgstr-is ning võrdleb seda numbriga, mis on määratud kaardil Isikuandmed. Mitmuse vormide vigane arv võib põhjustada rakenduse krahhi.

Piiks vea korral

- Selle valimisel kõlab süsteemne piiks, kui liigutakse mõne ülalkirjeldatud veaga kirjele.

Vea korral muudetakse teksti värvi

- See on teine võimalus anda teada vigadest käesolevas teates. See on kasulik võimalus neile, kel on kuulmisega raskusi või kellele lihtsalt piiksud ei meeldi. Kuidas vigade puhul teksti värv muutub, saab määrata kaardil Välimus.

#### Välimus

Redaktori välimuse seadistused Redaktori välimuse seadistused

Sellel kaardil saab määrata teadete redaktori välimust. Ülemises osas paikneb neli märkekasti:

Süntaksi värvilisus

- Selle valimisel värvitakse msgid vaatajas ja msgstr redaktoris ära erisümbolid, kiirklahvid ja teksti taust. Kui sul ei ole just must-valge kuvar või probleeme nägemisega, võiks selle võimaluse sisse lülitada.

Värviline taust

- Taust värvitakse ainult msgid ja msgstr olemasolevatel sümbolitel, kaasa arvatud tühikud. See on kasulik, kui sa ei soovi näha PO-kirjes ümbritsevaid jutumärke (vaata allpool), kuid soovid siiski näha tekstirea alguses ja lõpus paiknevaid tühimärke.

Tühimärke näidatakse punktidena

- Kui tunned, et tühikute kokkulugemine ega tausta värvimine ei vasta sinu maitsele, võib sisse lülitada selle võimaluse, mis tekitab keset tühimärki väikese punkti. Pane tähele, et punkt kujutab endast punktisümbolit tühimärgi ruumi keskel, mitte aga punkti tavalises mõttes.

Ümbritsevate jutumärkide näitamine

- Kui arvad, et msgstr või msgid tekstiridade alguse ja lõpu nägemine on igati kasulik asi, võid ära märkida selle kasti, mis ümbritseb kõik read jutumärkidega.

  Kui oled harjunud PO-faile redigeerima tavalise tekstiredaktoriga, lisab usutavasti tuttavlikkust, kui näed PO-faili ridade alguses ja lõpus topeltjutumärke.

Redigeeritava teksti erinevad elemendid võib tähistada erinevate värvidega, mis muudab redigeerimise hõlpsamaks. Värvi saab muuta klõpsuga värvi valimise nupul. Ilmuvast värvi valimise dialoogist saab valida standardse värvi, kohandatud värvi või ka haarata mõne parajasti ekraanil leiduva värvi.

Taustavärv

- See määrab sümbolite taustavärvi MsgID vaataja ja MsgStr redaktori kastis. Redigeerimiskastide üldise taustavärvi muutmiseks tuleb kasutada &kcontrolcenter;t.

Jutumärkide värv

- Siin saab muuta spetsiaalsete paomärkide, näiteks topeltjutumärkide (`\"`) või reavahetussümboli (`\n`) värvi.

Süntaksivigade värv

- See on kogu teksti värv, kui selles avastatakse PO-faili salvestamisel vigu. Vead tekivad siis, kui msgid ja msgstr ei lõpe ühtmoodi või on paomärgid sisestatud valesti.

c-formaadi märkide värv

- See määrab värvi sümbolijadale, näiteks C keele funktsioonid `printf` või `scanf`. Üldiselt algavad need protsendimärgiga (`%`), millele järgneb üks märk.

Kiirklahvi märgistaja värv

- Kiirklahvimärgised algavad &kde;s ampersandiga (&), kuid kui tõlgid mingi muu projekti faile, võivad need kasutada ka teistsuguseid kiirklahvimärgiseid. Täpsemat infot selle kohta, kuidas muuta kiirklahvimärgiseid, vaata osast Muud.

Parajasti redigeeritava kirje olekut märgib kolm tulukest (LED). Oma mugavuse huvides võid määrata need paiknema kas olekuribal või redaktoriaknas (msgid ja msgstr kirje vahel). Kui mõne värvi nägemisega tekib raskusi või kui soovid LED-tulukeste staatust hõlpsasti silma all hoida ilma erilisi silmakeerutusi tegemata, võid valida värvi valimise nupule klõpsates just sellise värvi, mis sulle meeldib.

### Otsimine

Otsimise seadistused Otsimise seadistused

See kaart lubab määrata mõningaid varem tõlgitud stringide otsimise võimalusi.

Üldised seadistused kehtivad kõigile otsinguviisidele. Märkides ära kasti Automaatne otsimine, käivitatakse otsing automaatselt redaktoris uuele kirjele liikudes. Praegu saab valida kolme viisi vahel, kuid &kbabel; kasutab sõnaraamatupluginaid, mistõttu kättesaadavad sõnaraamatud sõltuvad sellest, mida on süsteemi paigaldatud. Menüükäsuga Seadistused Sõnaraamatute seadistamine ... saab seadistada iga pluginat.

Vaikimisi paigaldatud sõmaraamatupluginad on järgmised:

&kde; andmebaasi otsingumootor ehk tõlgete andmebaas

- See uus meetod on ikka veel arenduse algjärgus ning tugineb &kbabel;iga kaasasolevale &kbabeldict;ile. Otsingumootori seadistamise kohta leiab täpsemat infot &kbabeldict;i käsiraamatust.

PO kompendium

- Kompendium on tavaline PO-fail, mis peaks sisaldama sinu tõlkemeeskonna kõiki tõlgitud stringe. Kui sul sellist ei ole, võid kasutada ka &kde; projektis loodud faili (⪚ `$lang.messages`, mille leiab aadressilt i18n.kde.org).

PO liitlane

- Liitlasfail võib aidata leida tõlkimisel konteksti, vaadates sama faili sama kirje tõlget mõnes muus keeles. Sel moel näed, kuidas on see tõlgitud teise keelde, mis võib anda ka endale parema arusaama stringi tähendusest.

Otsingu saab käivitada ka käsitsi, valides kirje hüpikmenüüs, mis ilmub kas menüükäsuga Sõnaraamatud Otsi teksti PO kompendium või hoides mõne aja all otsingunuppu tööriistaribal.

### Võrdlemine

Võrdlemise seadistused Võrdlemise seadistused

Kaardil Võrdlemine saab määrata, kuidas näidatakse msgid-ide erinevusi.

Iga erinevuse korral saab näidata nii lisatud osi kui eemaldatud sümboleid. Mõlema puhul saab määrata kasutatava näitamise viisi ja värvid. Esile tõstetud tähendab, et vastavate märkide tausta näidatakse valitud värviga, Alla joonitud (lisatud tähtede puhul) või Läbi kriipsutatud (eemaldatud tähtede puhul) märgivad aga muudetud osi värvitud ridadega.

Võrdlemiseks tuleb leida algupärane msgid. Selleks võib &kbabel; kasutada tõlgete andmebaasi, kui lülitad sisse võimaluse Kasutatakse tõlgete andmebaasi kirjeid. Teine võimalus on kasutada algupäraste PO-failide puud. Sel juhul tuleb ära määrata puu juurkataloog väljal Diff-failide kataloog.

### Fondid

Fondiseadistused Fondiseadistused

See on tavapärane &kde; fontide valija ühe väikese lisandusega. Sa saad valida ainult fikseeritud suurusega fontide kasutamise, kui märgid ära kasti Ainult fikseeritud suurusega fondid. See on tõlkimise lihtsustamiseks vägagi soovitatav. Fondidialoog võimaldab valida fondipere, stiili, suuruse ja kodeeringu. Allolevas kastis on kohe näha ka valitud võimaluse eelvaatlus.

## Uue projekti nõustaja

### Esimene kaart

Projektinõustaja esimene kaart Projektinõustaja esimene kaart

Nõustaja esimene kaart pärib projekti põhiandmeid.

Projekti nimi

- Kirjuta siia projekti nimi, mida hakkab näitama &kbabel;i menüü.

Konfiguratsioonifaili nimi

- Vali fail, mis sisaldab sinu projekti seadistusi.

Keel

- Vali või sisesta projekti keel.

Projekti tüüp

- Vali projekti tüüp.

### Teine kaart

Projektinõustaja teine kaart Projektinõustaja teine kaart

Nõustaja teisel kaardil päritakse kataloogihalduriga seotud asju.

PO-failide algkataloog

- Vali baaskataloog, kus paiknevad sinu PO-failid.

POT-failide algkataloog

- Vali baaskataloog, kus paiknevad sinu POT-failid.

Kirjuta või vali kataloogid, mis sisaldavad vastavalt PO- ja POT-faile. Seejärel liidetakse nende kataloogide alamkataloogid ja failid kataloogihalduri aknas üheks puuks.

### Projekti seadistuste kontrollimine

Nagu mainitud, on projektinõustaja äärmiselt lihtne ega oska seepärast huvi tunda mitme väga olulise asja vastu.

Nüüd, kus oled oma uue projekti loomise lõpetanud, tuleks selle seadistused üle vaadata. Vali Projekt Seadista... Pööra tähelepanu kaardile Isikuandmed ja paranda vajaduse korral meeskonna e-posti aadress väljal Tõlkemeeskonna meililist (nõustaja loodud vaikeväärtus keele põhjal on kasuks ainult siis, kui tegemist on &GNU; projektiga).

Kui tegemist ei ole KDE projektiga, on soovitatav avada kaart Salvestamine ja kõik seadistused hoolikalt üle kontrollida.

## Projekti seadistused

Projekti seadistustedialoogi saab avada &kbabel;is või kataloogihalduris menüükäsuga Projekt Seadista... Dialoog on liigendatud kaartideks, mis muudab äärmiselt lihtsaks vajaliku võimaluse leidmise ilma seda pikemalt taga otsimata.

Seadistustedialoogi vasakpoolses osas on kohandatavate elementide kategooriate nimekiri, parempoolses osas vastava kategooria võimaluste kaart. &kbabel; jätab tehtud muudatused meelde, kui vahetad kaarti, nii et kui oled teinud kõigil kaartidel soovitud muudatused, võid need kõik rakendada nupule OK klõpsates. Igal hetkel on võimalik kasutada kiirabi — klõpsa tiitliribal küsimärgile ning seejärel küsimärgiks muutunud kursoriga nupule, nimetusele või väljale, mille kohta soovid täpsemat infot saada.

&kbabel;i (redaktori) ja kataloogihalduri seadistustekaardid on järgmised.

### Isikuandmed

&kbabel;ile mõeldud seadistused.

Sellel kaardil saab määrata iga tõlgitava PO-faili standardsed väljad. Neiks on sinu enda nimi, e-posti aadress, keele täielik nimetus, tõlkemeeskonna meililisti aadress. Siin on ka ajavööndi väli, mis võimaldab määrata PO-failide viimati muudetud välja väärtuse. Selle võib määrata tähejadana, näiteks EET või erinevusena GMT-st, &ie; +0300 (Eesti puhul). Seda infot on hea kasutada päiste uuendamisel. Seda, milliseid päise välju tuleks uuendada, saab määrata seadistustedialoogi kaardil Salvestamine.

Ajavööndite tähistused ei ole standardiseeritud, mistõttu ei peaks siin määratud stringi kasutama salvestamise ajamääratluses kaardil Salvestamine, kus see tuleks anda hoopis kujul `%z`.

Mitmuse vormide arv

- Siin saab määrata oma keele mitmuse vormide arvu. Näiteks eesti keele puhul on see 2 (üks ainsuse ja teine mitmuse jaoks).

  See võimalus on praegu kasutatav ainult &kde;s pruugitava mitmuse vormide vormingu jaoks ega toimi &GNU; gettexti mitmuse vormide jaoks.

### Salvestamine

&kbabel;ile mõeldud seadistused.

Sellel kaardil saab määrata PO-faili salvestamise võimalusi. Esimene märkekastide grupp võimaldab määrata toimingute üldise käitumise PO-faili salvestamisel.

Salvestamisel uuendatakse päist

- Selle märkimisel uuendatakse faili päise infot igal salvestamisel. Päises leidub tavaliselt info faili viimase uuendamise aja, viimase tõlkija jne kohta. Seda, millist infot päises uuendatakse, saab määrata allpool olevate märkekastidega Uuendatavad väljad. Väljad, mida päises veel ei ole, lisatakse sinna. Kui soovid lisada päisele veel mõningaid välju, tuleb seda teha käsitsi, valides redaktoriaknas menüükäsu Redigeerimine Muuda päist.

Salvestamisel kontrollitakse süntaksit

- Selle märkimisel kontrollitakse faili salvestamisel automaatselt süntaksit käsuga ``msgfmt` --statistics`. Sellest saad teada ainult siis, kui ilmneb mõni viga. See peaks olema sisse lülitatud, kui sa just mõnel väga erilisel põhjusel seda välja lülitada ei soovi.

Kui sa soovid, et PO-faili päises mõningaid välju ei muudetaks või soovid hoopis mõnda välja kindlasti uuendada, saab seda määrata viie märkekastiga: muutmise kuupäev, PO-faili keel, kodeering, viimase tõlkija nimi, kooditabel. Kui välja päises veel ei ole, see lisatakse. Kui soovid päisesse veel mingit infot lisada, tuleb seda teha käsitsi, valides redaktoriaknas menüükäsu Redigeerimine Muuda päist. Kui sa ei soovi, et päist uuendataks, eemalda märge kastist Salvestamisel uuendatakse päist.

Päise välja PO-Revision-Date (muutmise kuupäev) kuupäeva ja kellaaja vormingul saab kasutada järgmisi võimalusi: Vaikevorming, Kohalik vorming, Kohandatud vorming.

Mõttekas oleks jätta kehtima vaikimisi valitud Vaikevorming. Teiste kahe valimisel ei vasta loodav PO-fail enam standardsele &GNU; gettexti PO-failile, mistõttu nende kasutamist tuleks vältida.

- Vaikevorming on vorming, mida tavaliselt PO-failides kasutatakse.

- Kohalik vorming on vorming vastavalt sinu maale.

- Kohandatud vorming võimaldab vormingu ise määrata, kasutada saab järgmisi C-stiilis vormingustringe:

  ### Aasta

  Vorming | Tähendus | Vahemik
  %y | aasta | 00 kuni 99
  %Y | aasta | 0001 kuni 9999

  ### Kuu

  Vorming | Tähendus | Vahemik
  %m | kuu numbriliselt | 01 kuni 12
  %f | kuu numbriliselt | 1 kuni 12
  %b,%h | kuu lühendiga | Jaan kuni Dets

  ### Päev

  Vorming | Tähendus | Vahemik
  %j | päev aastas | 001 kuni 366
  %d | päev kuus | 01 kuni 31
  %e | päev kuus | 1 kuni 31
  %a | nädalapäev lühendina | Esm kuni Püh

  ### Tund

  Vorming | Tähendus | Vahemik
  %H | tund | 00 kuni 23
  %k | tund | 0 kuni 23
  %í | tund | 1 kuni 12
  %I | tund | 01 kuni 12
  %p |  | AM või PM

  ### Minut, sekund, ajavöönd

  Vorming | Tähendus | Vahemik
  %M | minut | 00 kuni 59
  %S | sekund | 00 kuni 59
  %Z | ajavöönd | (vastavalt isikuandmete seadistustele)
  %z | ajavöönd | (erinevus numbriliselt, nagu määratud isikuandmete seadistustes)

Võimalust valida PO-failis kasutatav ajavorming peavad arendajad praegu iganenuks ning KBabeli tulevastes versioonides seda arvatavasti enam ei olegi.

Alumine grupp puudutab PO-faili kodeeringut salvestamisel. Kui töötad &kde; projektiga, tuleb arvestada, et vähemalt &kde; PO-failid peavad olema UTF-8. Hüpikkast võimaldab valida teadete kodeeringu. Kui sa mingil põhjusel ei soovi kogemata muuta PO-faili kodeeringut, märgi ära kast Algne kooditabel jäetakse alles.

Informatsioonivahetuse hõlbustamise nimel piirab &GNU; gettext PO-failis lubatud kodeeringute hulka. &kbabel; seda piirangut ei kasuta, mistõttu sinu lokaadile vastav kodeering ei pruugi mitte kõikjal sobida (&GNU; gettext toetab alati kodeeringut UTF-8).

### Õigekiri

&kbabel;ile mõeldud seadistused.

Siin saab määrata õigekirja kontrollimise võimalusi. Need peaksid eriti huvi pakkuma siis, kui sul on olemas oma keele (või igatahes keele, millesse tõlgid) sõnaraamatufail. Kasutada on järgmised võimalused:

Luuakse juure/lisandi kombinatsioonid, mida ei leidu sõnaraamatus

- Uute sõnade lisamisel isiklikku sõnaraamatusse loob õigekirja kontrollimise rakendus juure/lisandi kombinatsioonid, mis vastavad enam kui ühele sõnale (liitsõnad).

Kokkujooksnud sõnu tõlgendatakse vigadena

- Selle valimisel koheldakse kokkukirjutatud sõnu veana. Samas on see näiteks väga levinud saksa keeles, kus on külluses liitsõnu, nii et kui tõlgid saksa keelde, oleks usutavasti mõttekam seda mitte lubada.

Sõnaraamat

- Hüpikkastist saab valida, millist sõnaraamatut kasutada. Arvesta, et vaja oleks paigaldada igatahes selle keele sõnaraamat, millesse tõlgid. Kontrolli oma ISpelli või ASpelli paigaldust, kas selles leidub vajalik sõnaraamat.

Kodeering

- Siin saab määrata teksti kodeeringu. Valitud võimalus edastatakse õigekirja kontrollijale ning seda kasutatakse sõnaraamatu sõnade kodeeringu puhul. Täpsemat infot leiab kspelli käsiraamatust.

  Siin valitud kodeeringul ei ole seost PO-failide kodeeringuga. Sõltuvalt õigekirja kontrollijast (eriti programmi `ispell` korral) ei pruugi sul kodeeringu osas palju valikut ollagi (näiteks mitme Lääne-Euroopa keele puhul on `ispell` kasutatav ainult kodeeringuga ISO-8859-1).

Klient

- Õigekirja kontrollimisel kasutatav taustarakendus. Praegu ainult kas `ispell` (rahvusvaheline ISpell) või Aspell.

Ignoreeritud sõnad jäetakse meelde

- Kasutaja poolt PO-failide õigekirja kontrollimisel ignoreeritavaks määratud sõnad jäetakse meelde. On üsna tavaline ignoreerida lühendeid või kummalisi tähekombinatsioone, mida võib kohata &GUI; liidestes.

Ignoreeritud sõnade fail

- Siin saab määrata faili, kuhu salvestatakse ignoreeritud sõnad. Klõpsa tekstiväljast paremal pool asuval kataloogikujulisel ikoonil. Vaikimisi on see `$`HOME`/.kde/share/apps/kbabel/spellignores`, kus `$`HOME`` tähistab sinu kodukataloogi.

### Lähteteksti seadistused

&kbabel;ile mõeldud seadistused.

Projekti lähteteksti seadistused Projekti lähteteksti seadistused

Sellel kaardil saab määrata, kuidas KBabel peab siduma lähtekoodiga viited, mis leiduvad PO-faili iga kirje juures.

#### Dialoogi elemendid

Väljal Lähtekoodi algkataloog saab määrata oma projekti lähtekoodi baaskataloogi. See määrab ka allpool kirjeldatava muutuja `@CODEROOT@` väärtuse.

Sektsioonis Asukohamustrid saab määrata mustrid ehk reeglid asukohtade konstrueerimiseks mõne allpool kirjeldatava muutuja abil `@CODEROOT@`, `@PACKAGEDIR@`, `@PACKAGE@`, `@COMMENTPATH@`, `@POFILEDIR@`.

Muutuja `@PODIRFILE@` lisandus &kbabel;isse alates versioonist 1.11.1 (&kde; 3.5.1).

Nupule Lisa klõpsates saab lisada tekstikasti kirjutatud määratluse asukohamustrite nimekirja. Nupule Eemalda klõpsates saab valitud mustri nimekirjast eemaldada. Nuppudega Üles ja Alla saab muuta asukohamustrite prioriteeti.

#### Muutujad

- `@CODEROOT@`: lähtekoodi baaskataloog.

- `@PACKAGEDIR@`: paketi (s.t. PO-faili) kataloog.

- `@PACKAGE@`: paketi nimi (s.t. PO-faili nimi lma laiendita).

- `@POFILEDIR@`: POfaili kataloog.

- `@COMMENTPATH@`: PO-faili kirje kommentaaris viitena antud lähteteksti suhteline asukoht.

Muutujatel `@PACKAGEDIR@` ja `@POFILEDIR@` on samalaadne tähendus, aga mitte samasugune tulemus. `@POFILEDIR@` sisaldab alati PO-faili kataloogi, `@PACKAGEDIR@` tingimata mitte. Kui PO-fail avatakse kataloogihalduri vahendusel, on `@PACKAGEDIR@` ainult osa asukohast, mille aluseks on PO-failide baaskataloog, mis on määratud kataloogihalduri seadistustes (vaata allpool).

Muutujate `@CODEROOT@` ja `@POFILEDIR@` kasutamine on mõttekas ainult mustri alguses. Muutujat `@COMMENTPATH@` saab kasutada ainult mustri lõpus ja see on peaaegu kohustuslik. Muutujaid `@PACKAGEDIR@` ja `@POFILEDIR@` ei tohiks kasutada ühes mustris. Ka muutujaid `@CODEROOT@` ja `@POFILEDIR@` ei peaks ühte mustrisse seadma.

#### Vaikimisi asukohamustrid

Alates &kbabel;i versioonist 1.11.1 (&kde; 3.5.1) on viis vaikimisi asukohamustrit:

- `@PACKAGEDIR@`/`@PACKAGE@`/`@COMMENTPATH@`

- `@CODEROOT@`/`@PACKAGEDIR@`/`@PACKAGE@`/`@COMMENTPATH@`

- `@CODEROOT@`/`@PACKAGE@`/`@COMMENTPATH@`

- `@POFILEDIR@`/`@COMMENTPATH@`

- `@POFILEDIR@`/../`@COMMENTPATH@`

&kde; projektid vajavad tavaliselt kolmandat mustrit. Viimane muster on tüüpiline &GNU; projektidele, kus lähtekoodi viited on seotud selle kataloogi ülemkataloogiga, milles asub PO-fail.

#### Uute asukohamustrite loomine

Enamasti peaks vaikimisi asukohamustritest piisama sõltumata sellest, kas tegemist on KDE projektiga (eeldusel, et oled baaskataloogi korrektselt määranud) või &GNU; projektiga (või projektiga, mis on struktureeritud samamoodi nagu &GNU; projektid).

&kde; puhul ei sisalda siiski mõned PO-failid piisavalt infot (kaasa arvatud faili asukoht ja nimi), et &kbabel; oskaks leida õige lähtekoodifaili, millele see peaks viitama. Selleks tuleb taoliste failide puhul määrata täpse asukoha muster, mis muidugi &kde; failide ohtrust arvestades on üsna vaevarikas. Kui sul aga mõni selline fail sageli esineb, võib olla mõttekas määrata konkreetne muster just antud PO-faili jaoks.

Oma mustri loomiseks võib kasutada kõiki mainitud muutujaid, millest kohustuslik on ainult `@COMMENTPATH@` (õigupoolest pole ka `@COMMENTPATH@` kohustuslik, kuid ilma selleta on vähetõenäoline head tulemust saada).

Toome sellise omaloodud mustri näiteks &kde; faili desktop_kdebase.po. Selle korral peaks muster olema selline: `@CODEROOT@`/`@PACKAGEDIR@`/kdebase/`@COMMENTPATH@` (vaikimisi asukohamustritega võrreldes näed, et `@PACKAGE@` asemel on siin kdebase).

Eriti keeruliste probleemide korral võib muidugi määrata ka absoluutse asukoha muutujaid kasutamata (välja arvatud `@COMMENTPATH@`), näiteks /home/usr/kde-source/kdebase/`@COMMENTPATH@` (eeldusel, et /home/usr/kde-source/kdebase on koht, kus asub kdebase'i lähtekood).

### Muud

&kbabel;ile mõeldud seadistused.

Kaardil Muud on &kbabel;i seadistused, mis kuhugi mujale ei sobi.

Kiirklahvi märgistaja

- Siin saab määrata meelepärase sümboli, mis märgib &GUI;s kiirklahvi. Vaikimisi on see ampersand (&), kuid mõne programmeerimise tööriistakomplekti puhul võib see olla midagi muud. Näiteks Gnome/GTK tõlgetes tähistab kiirklahkvi alakriips _.

Kontekstiinfo regulaaravaldis

- Algajatele võib väljend "regulaaravaldis" tunduda võõristavana. Sõltumata kogemusest on soovitav vaikeväärtust muuta ainult siis, kui sa väga täpselt tead, mida teed. Mõned &GUI; programmeerimise tööriistakomplektid kasutavad omaenda kontekstiinfo kirjeldamise meetodeid. Pea nõu mõne kogenenuma kasutajaga, kui tõlgid &kde;-väliseid PO-faile. Et asi selgem oleks, "tõlgin" siinkohal vaikeregulaaravaldise: "tekst sobib, kui alguses seisab _:, millele järgneb üks või enam märki ja mis lõpeb reavahetusmärgiga".

### Projekti kataloogid

Need seadistused on kataloogihaldurile.

Siin on kaks tekstivälja. Kirjuta neisse või vali kataloogid, mis sisaldavad vastavalt PO- ja POT-faile. Seejärel liidetakse nende kataloogide alamkataloogid ja failid kataloogihalduri aknas üheks puuks.

Allpool on mõned märkekastid:

Fail avatakse uues aknas

- Selle märkimisel avatakse kõik kataloogihaldurist avatud failid alati uues aknas.

Väljumisel tapetakse protsessid

- Selle märkimisel püüab &kbabel; tappa protsessid, mis ei ole oma tööd lõpetanud rakenduse sulgemise ajaks, saates neile tapmissignaali.

  Seda, et protsessid ka tegelikult tapetakse, ei saa siiski tagada.

Luuakse faili sisu indeks

- Märkimisel loob &kbabel; iga puus oleva faili sisu indeksi, mida saab seejärel kasutada otsimis- ja asendusoperatsioonides.

  See mõjutab oluliselt kiirust. Kui lubad indeksi loomise, on failiinfo uuendamine palju aeglasem. Teisalt on jälle otsimine ja asendamine märgatavalt kiirem.

### Kataloogide käsud

Need seadistused on kataloogihaldurile.

Projekti kataloogi käskude seadistused Projekti kataloogi käskude seadistused

Siin saab anda käsud, mida soovid rakendada kataloogihalduris kataloogide puhul. Neid käske saab hiljem kasutada kataloogihalduri kontekstimenüüs alammenüüst Käsud.

Kirjuta väljale Käsu nimi käsu nimi. See võib olla suvaline, sest seda näidatakse vaid menüüs. Väljale Käsk kirjuta käsk, mida soovid vastavat menüükäsku valides rakendada. Seejärel klõpsa nuppu Lisa, mis lisab sisestatu kasutatavate käskude nimekirja. Käsu redigeerimiseks vali see, klõpsa nuppu Redigeeri ning kui oled lõpetanud, vajuta nuppu Lisa. Käsu eemaldamiseks vali see nimekirjast ning klõpsa nuppu Eemalda. Kui soovid muuta käskude järjekorda kontekstimenüüs, kasuta üles ja alla osutavaid nuppe.

Käsk käivitatakse vaikeshellis, nii et seal on võimalik käivitada mitu käsku korraga, eraldades need semikooloniga, samuti määrata vajadusel keskkonnamuutujad. Käsud käivitatakse kataloogihalduris valitud (PO-failide) kataloogis.

Järgmised stringid on käskudes asendatavad:

- `@PACKAGE@`: kataloogi nimi ilma rajata

- `@PODIR@`: PO-kataloogi nimi rajaga

- `@POTDIR@`: mallide kataloogi nimi rajaga

Näide: kui soovid käivitada käsu `make` ja seejärel `make install`, kirjuta väljale Nimi `Paigalda` ja väljale Käsk `make; make install`. Kui seejärel valid kataloogi kontekstimenüüst Käsud Paigalda, käivitatakse selles kataloogis ülalmainitud käsud.

### Failide käsud

Need seadistused on kataloogihaldurile.

Projekti failide käskude seadistused Projekti failide käskude seadistused

Siin saab määrata käsud, mida soovid kasutada kataloogihalduris failide puhul. Neid käske näeb seejärel kataloogihalduri kontekstimenüü alammenüüs Käsud.

Kirjuta väljale Käsu nimi käsu nimi. See võib olla suvaline, sest seda näidatakse vaid menüüs. Väljale Käsk kirjuta käsk, mida soovid vastavat menüükäsku valides rakendada. Seejärel klõpsa nuppu Lisa, mis lisab sisestatu kasutatavate käskude nimekirja. Käsu redigeerimiseks vali see, klõpsa nuppu Redigeeri ning kui oled lõpetanud, vajuta nuppu Lisa. Käsu eemaldamiseks vali see nimekirjast ning klõpsa nuppu Eemalda. Kui soovid muuta käskude järjekorda kontekstimenüüs, kasuta üles ja alla osutavaid nuppe.

Käsk käivitatakse vaikeshellis, nii et seal on võimalik käivitada mitu käsku korraga, eraldades need semikooloniga, samuti määrata vajadusel keskkonnamuutujad. Käsud käivitatakse kataloogihalduris valitud faili (PO-failide) kataloogis.

Järgmised stringid on käskudes asendatavad:

- `@PACKAGE@`: faili nimi ilma raja ja laiendita

- `@POFILE@`: PO-faili nimi raja ja laiendiga

- `@POTFILE@`: vastava mallifaili nimi raja ja laiendiga

- `@PODIR@`: selle kataloogi nimi koos rajaga, kus PO-fail asub

- `@POTDIR@`: selle kataloogi nimi koos rajaga, kus mallifail asub

Kui näiteks soovid liita mallifaili oma PO-faili, kirjuta väljale Nimi `Liida` ja väljale Käsk `msgmerge @POFILE@ @POTFILE@ > @PACKAGE@.new && mv @PACKAGE@.new "@PACKAGE@.po`. Kui valid seejärel faili kontekstimenüüst Käsud Liida, liidetaksegi PO-fail mallifailiga.

### Kataloogihaldur

Need seadistused on kataloogihaldurile.

Projekti kataloogihalduri seadistused Projekti kataloogihalduri seadistused

Märkekastidega saab sisse või välja lülitada vastava veeru näitamise kataloogihalduris.

### Võrdlemine

Need seadistused on kataloogihaldurile.

Projekti võrdlemise seadistused Projekti võrdlemise seadistused