diff options
Diffstat (limited to 'doc/et/index.docbook')
-rw-r--r-- | doc/et/index.docbook | 6056 |
1 files changed, 6056 insertions, 0 deletions
diff --git a/doc/et/index.docbook b/doc/et/index.docbook new file mode 100644 index 0000000..a677f38 --- /dev/null +++ b/doc/et/index.docbook @@ -0,0 +1,6056 @@ +<?xml version="1.0" ?> +<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ + <!ENTITY kile "<application +>Kile</application +>"> + <!ENTITY latex "L<superscript +>A</superscript +>T<subscript +>E</subscript +>X"> + <!ENTITY pdflatex "PDFL<superscript +>A</superscript +>T<subscript +>E</subscript +>X"> + <!ENTITY tex "T<subscript +>E</subscript +>X"> + <!ENTITY tetex "<application +>teT<subscript +>E</subscript +>X</application +>"> + <!ENTITY texlive "<application +>TeX Live</application +>"> + <!ENTITY bibtex "BibT<subscript +>E</subscript +>X"> + <!ENTITY makeindex "makeindex"> + <!ENTITY kbibtex "KBibT<subscript +>E</subscript +>X"> + <!ENTITY kbib "KBib"> + <!ENTITY asymptote "Asymptote"> + <!ENTITY imagemagick "<application +>ImageMagick</application +>"> + <!ENTITY kde "<acronym +>KDE</acronym +>"> + <!ENTITY kdvi "<application +>KDVI</application +>"> + <!ENTITY dvipng "<application +>dvipng</application +>"> + <!ENTITY kghostview "<application +>KGhostView</application +>"> + <!ENTITY kpdf "<application +>KPDF</application +>"> + <!ENTITY postscript "<application +>PostScript</application +>"> + <!ENTITY makeidx "<application +>makeidx</application +>"> + <!ENTITY kate "<application +>Kate</application +>"> + <!ENTITY cjk "<abbrev +>CJK</abbrev +>"> + <!ENTITY ucs "<abbrev +>ucs</abbrev +>"> + <!ENTITY url "<acronym +>URL</acronym +>"> + <!ENTITY kappname "&kile;"> + <!ENTITY package "kdeextragear-2"> + <!ENTITY % addindex "IGNORE"> + <!ENTITY % Estonian "INCLUDE"> +]> + +<book lang="&language;"> + +<bookinfo> +<title +>&kile; käsiraamat</title> + +<authorgroup> + <author +><firstname +>Jonathan</firstname +><surname +>Pechta</surname +></author> + <author +><firstname +>Federico</firstname +><surname +>Zenith</surname +> <affiliation +><address +><email +>zenith@chemeng.ntnu.no</email +></address +></affiliation +></author> + <author +><firstname +>Holger</firstname +><surname +>Danielsson</surname +> <affiliation +><address +><email +>holger.danielsson@versanet.de</email +></address +></affiliation +></author> + <author +><firstname +>Thomas</firstname +><surname +>Braun</surname +></author> + <author +><firstname +>Michel</firstname +><surname +>Ludwig</surname +> <affiliation +><address +><email +>michel.ludwig@kdemail.net</email +></address +></affiliation +></author> +</authorgroup> + +<othercredit role="translator" +><firstname +>Marek</firstname +><surname +>Laane</surname +><affiliation +><address +><email +>bald@starman.ee</email +></address +></affiliation +><contrib +>Tõlge eesti keelde</contrib +></othercredit +> + +<copyright> +<year +>2003</year> +<holder +>Jonathan Pechta</holder> +</copyright> + +<copyright> +<year +>2003</year +><year +>2005</year +><year +>2006</year> +<holder +>Federico Zenith</holder> +</copyright> + +<copyright> +<year +>2005</year +><year +>2006</year> +<holder +>Holger Danielsson</holder> +</copyright> + +<copyright> +<year +>2007</year> +<holder +>Thomas Braun</holder> +</copyright> + +<copyright> +<year +>2007</year> +<holder +>Michel Ludwig</holder> +</copyright> + +<date +>November 19, 2007</date> +<releaseinfo +>2.0</releaseinfo> + +<legalnotice> +&FDLNotice; +</legalnotice> + +<abstract> +<para +>&kile; on &tex;i ja &latex;i lähtetekstide redaktor ning shell. </para> +</abstract> + +<keywordset> +<keyword +>KDE</keyword> +<keyword +>kdenonbeta</keyword> +<keyword +>Kile</keyword> +<keyword +>LaTeX</keyword> +<keyword +>TeX</keyword> +</keywordset> + +</bookinfo> + +<chapter id="preface"> + +<title +>Eessõna</title> + + <sect1 id="preface_sect"> + + <title +>Nõuded</title> + + <para +>&kile; kasutamiseks peavad sinu süsteemi olema paigaldatud järgmised komponendid:</para> + + <itemizedlist> + <listitem +><para +><ulink url="http://www.kde.org/" +>K töölaua keskkond (&kde;)</ulink +>: &kde; on populaarne vaba tarkvara töölaua keskkond.</para +></listitem> + <listitem +><para +><ulink url="http://www.trolltech.com/products/qt/" +>Qt</ulink +>: Qt on &kile; kompileerimiseks vajalik C++ GUI ja võrguteek.</para +></listitem> + <listitem +><para +><ulink url="http://www.ctan.org/" +>&latex;</ulink +>: kvaliteetne dokumendi ladumissüsteem. Usutavasti on sul kasutusel &texlive; (või vanemates süsteemides &tetex;) , sest tegemist on ju UNIXilaadse süsteemiga.</para +></listitem> + </itemizedlist> + + <para +>Enamik loetletuist võivad olla kaasas sinu Linuxi distributsiooniga. Nende paigaldamiseks arvutisse uuri oma distributsiooni dokumentatsiooni või vaata üle paigaldus-CD või -DVD.</para> + + <para +>&kile; projekt pakub mitmeid erinevaid &kile; pakette, mida võib hõlpsasti paigaldada ja tööle panna ka ilma kompileerimata. Vaata täpsemalt <ulink url="http://kile.sourceforge.net/" +>&kile; koduleheküljelt</ulink +>.</para> + + </sect1> + + <sect1 id="preface_audience"> + + <title +>Eeldatav kasutajaskond</title> + + <para +>See käsiraamat on mõeldud kõigile sõltumata nende kogemustest &latex;i, &kde;, &kile; või Linuxiga.</para> + + <para +>Edasijõudnumad kasutajad vaevalt käsiraamatut loevad, küll aga sooviks meie saada nende ettepanekuid dokumentatsiooni parandamise kohta. Kui soovid anda omapoolse panuse projekti või dokumentatsiooni, uuri palun veidi <ulink url="http://kile.sourceforge.net/" +>&kile; veebilehekülge</ulink +>.</para> + + <para +>Kas sul tekkis &kile; kohta mingeid küsimusi? Või probleeme kompileerimisel? Või soovid näha mõnda uut võimalust? Kõige mõttekam on tehnilist laadi küsimusi esitada või diskussiooni alustada meie meililistis <email +>kile-devel@lists.sourceforge.net</email +>.</para> + + </sect1> + +</chapter> + +<chapter id="introduction"> + + <title +>Sissejuhatus</title> + + <sect1 id="intro_about"> + + <title +>Põhiasjad</title> + + <sect2> + + <title +>Mis on &kile;?</title> + + <para +>&kile; on integreeritud &latex;i keskkond &kde; töölaua tarbeks. &kile; pakub kõiki &latex;i funktsioone graafilises liideses, võimaldades hõlpsat, vahetut ja kohandatavat ligipääsu kõigile &latex;i kompileerimise, järeltöötluse, silumise, teisendamise ja vaatamise vahenditele. Samuti võimaldab see kasutada käepäraseid nõustajaid, &latex;i viiteid ning võimsat projektihaldust.</para> + + </sect2> + + <sect2> + + <title +>Mis on &latex;?</title> + + <para +>&latex; on tekstitöötlussüsteem, mille aluseks on juba 1977. aastal Donald Knuthi loodud programm &tex;, mis püüdis abistada autoreid enda töö professionaalsel esitamisel ladumissüsteemi pakkudes. Ladumissüsteem on professionaalne tekstitöötlemisvahend, mis esitab dokumendi välimuse vastavalt dokumenditüübi spetsifikatsioonile. &latex;i looja Leslie Lamporti eesmärk oli pakkuda autoritele automaatset ladumissüsteemi, mis oleks eriti abiks siis, kui tegemist on töömahuka matemaatiliste valemite ja ja muu sellise kirjapanemisega, mida <emphasis +>mitte mingil juhul</emphasis +> ei asetata &latex;is dollarimärkide vahele. Tänapäeval pakuvad selliseid võimalusi igale kasutajale paljud tekstitöötlusrakendused, kuid seniajani soovivad paljud, et dokument näeks hea välja, ei soovi aga kulutada tunde sellise väljanägemise kujundamisele. &latex; võtabki selle koorma sinu õlult ning lubab pühendada kogu tähelepanu dokumendi sisule, mitte välimusele. Ja muidugi <emphasis +>näebki</emphasis +> tulemus hea välja!</para> + + </sect2> + + <sect2> + + <title +>Kuidas seda hääldada ja miks selle kirjapilt nii imelik on?</title> + + <para +>&tex;-iga seotud pakettidel on naljakas komme kasutada kõige veidramat hääldust ja väljanägemist, mida vähegi võib ette kujutada. &tex; tulenevat kreekakeelsest täheühendist <emphasis +>τεχ</emphasis +>, mis ladina tähtedega näeb välja <emphasis +>tech</emphasis +>. Selle põhjuste kohta on arvukalt erinevaid seletusi, kuid tõenäoline põhjus on sellest, et &latex; oli algselt mõeldud tehniliste aruannete kirjapanemiseks ning seniajani ongi selle silmatorkavaim omadus matemaatiliste valemite äärmiselt korrektne ja ülilihtne kirjapanek, mis omal ajal nõudis väga palju aega, vaeva ja närvikulu.</para> + <para +>Hääldus peaks olema selline: <emphasis +>T</emphasis +> nagu ikka, <emphasis +>E</emphasis +> täpselt samuti nagu <emphasis +>e</emphasis +> ikka ja <emphasis +>X</emphasis +> kreekapäraselt tugevana, umbes <emphasis +>hh</emphasis +>. Kui veel täpsem olla, siis see <emphasis +>hh</emphasis +> on suhteliselt kurguhäälne. Selle IPA sümbol on /ç/. Mõned on pakkunud häälduseks pehmema <emphasis +>hh</emphasis +> (IPA sümbol /x/), kuid ma pärisin seda mõne kreeklase käest ja nemad kinnitasid, et esimene variant on õige. Aga igatahes ütlevad paljud ka /teks/ või /tek/.</para> + <para +>Ja lõpuks tasuks märkida, et &latex;is hääldatakse alguses olevad L<superscript +>A</superscript +> nagu inglise sõnas <emphasis +>lay</emphasis +> (umbes 'lei'). Seda sellepärast, et kui puhas &tex; on üsna keeruline kasutada, siis isegi lihtinimene (inglise keeles <emphasis +>lay</emphasis +>man) suudab toime tulla &latex;i makrodega. Natuke lihtsam, aga samas usutavam seletus seob need tähed &latex;i looja Leslie Lamporti perekonnanime esitähtedega. Vaat nii!</para> + + </sect2> + + </sect1> + + <sect1 id="intro_latexbasics"> + + <title +>&latex;i põhitõed</title> + + <para +>&latex;i ladumissüsteem sarnaneb muudele märkekeeltele, näiteks XML, mida tarvitatakse paljudes dokumenditüüpides (ka selles, mida sa parajasti loed), või veebilehekülgedel pruugitav HTML. Põhimõte on kasutada spetsiaalselt vormindatud võtmesõnu ehk <emphasis +>silte</emphasis +>, mis annavad rakendusele (tekstitöötlusrakendus, veebilehitseja või &latex;i kompilaator) teada, kuidas teksti esitada. &kile; pakub arvukalt silte menüüribalt leitava menüü <guimenu +>LaTeX</guimenu +> vahendusel.</para> + + <para +>Kuigi me püüame sulle võimalikult hästi &latex;it tutvustada, ei ole see kindlasti mitte &latex;i <quote +>piibel</quote +>. Kui soovid &latex;it paremini tundma õppida, võiksid pöörduda paremini varustatud raamatukogu poole. Selle käsiraamatu autorile on jätnud väga hea mulle H. Kopka ja P. W. Daley kirjutatud 'A Guide to &latex;', mis on mul seniajani raamaturiiulis.</para> + + <para +>Sarnaselt muudele märkekeeltele sisaldab &latex; <emphasis +>preambulat</emphasis +>, mis määrab ära globaalsed käsud, näiteks paberi suuruse, lehekülgede nummerdamise, teksti mõõtmed leheküljel, ning <emphasis +>sisu</emphasis +>, mis sisaldab dokumendi teksti. Preambula sisaldab minimaalselt käsku <userinput +>\documentclass</userinput +> ning eelneb sisule, mis algab käsuga <userinput +>\begin{document}</userinput +> ja lõpeb ootuspäraselt käsuga <userinput +>\end{document}</userinput +>.</para> + + </sect1> + + <sect1 id="intro_mainfeat"> + + <title +>&kile; põhiomadused</title> + + <sect2 id="intro_docwizard"> + + <title +>Kiirkäivituse nõustaja</title> + + <para +>&kile; pakutav nõustaja võimaldab väga hõlpsasti alustada dokumentide loomist &kile;s. Kui valid menüüribalt nõustaja, saad valida mitme dokumendi loomise võimaluse vahel. Samuti saab kohe määrata mõningad dokumenti puudutavad omadused.</para> + + <para +>Klassi valikud:</para> + + <itemizedlist> + <listitem +><para +><guilabel +>Dokumendiklass</guilabel +>: millist dokumenti soovid luua? On see artikkel, kiri, aruanne, raamat?</para +></listitem> + <listitem +><para +><guilabel +>Kirjatüübi suurus</guilabel +>: millises punktis kirja peaks &kile; kasutama?</para +></listitem> + <listitem +><para +><guilabel +>Paberi suurus</guilabel +>: millises suuruses või stiilis paberit sinu dokumendi jaoks kasutada?</para +></listitem> + <listitem +><para +><guilabel +>Kodeering</guilabel +>: üldiselt on mõttekas kasutada süsteemi standardset kodeeringut. Nüüdissüsteemides on selleks kõige sagedamini UTF-8. Kui see on nii ka sinu süsteemis, kasuta utf8x (just sel kujul kasutatakse seda &latex;i dokumentides). </para +></listitem> + <listitem +><para +><guilabel +>Muud valikud</guilabel +>: siin saab määrata muid trükkimise ja muu sellisega seonduvaid asju.</para +></listitem> + </itemizedlist> + + <para +>Paketid</para> + <para +>Siin on ära toodud levinumad &latex;is kasutatavad lisapaketid. Märgi kastike kõigi juures, mida soovid kasutada.</para> + + <para +>Dokumendi omadused</para> + <itemizedlist> + <listitem +><para +><guilabel +>Autor</guilabel +>: siia läheb tõenäoliselt sinu enda nimi.</para +></listitem> + <listitem +><para +><guilabel +>Pealkiri</guilabel +>: sinu dokumendi pealkiri.</para +></listitem> + <listitem +><para +><guilabel +>Kuupäev</guilabel +>: siin saab määrata kuupäeva.</para +></listitem> + </itemizedlist> + + </sect2> + + <sect2 id="intro_templates"> + + <title +>Eelnevalt määratud mallid</title> + + <para +>&kile; kasutab järgmisi eelnevalt määratud malle:</para> + + <itemizedlist> + <listitem +><para +>Tühi dokument: ässad alustavad kõike nullist!</para +></listitem> + <listitem +><para +>Artikkel: määratleb artikli vormingu, mis on piisavalt lühike, et sda ei pea jagama peatükkideks.</para +></listitem> + <listitem +><para +>Aruanne: määratleb aruande vormingu keskmise pikkusega dokumentide jaoks, kus lehekülje numbrid asuvad reeglina välisserval.</para +></listitem> + <listitem +><para +>Raamat: määratleb raamatu vormingu, mis pakub kõiki võimalusi, isegi sel määral, et selle abil kirjutatakse seniajani paljusid ülikooliõpikuid.</para +></listitem> + <listitem +><para +>Kiri: määratleb kirja vormingu, mis tekitab automaatselt need neetud taandused, mida muidu ei ole kunagi meeles jälgida.</para +></listitem> + <listitem +><para +>Beamer, HA-Prosper: võimaldab luua kena esitluse PDF-vormingus, mis näeb väga hea välja ja mõistagi kasutab kõiki &latex;i võimalusi.</para +></listitem> + <listitem +><para +>Scrartcl, Scrbook, Scrreprt, Scrlttr2: KOMA-skripti dokumendiklassid, mis on spetsiaalselt kohandatud saksa keelele. Neid tasuks kasutada eriti siis, kui kirjutad saksakeelset teksti.</para +></listitem> + </itemizedlist> + + <para +>Uutel kasutajatel ei pruugi muretseda: siin kirjeldame omadusi väga lühidalt, pikemalt kirjeldab kõiki ülesannete teostamise võimalusi edaspidi <xref linkend="quickstart"/>.</para> + + </sect2> + + <sect2 id="intro_highlight"> + + <title +>Süntaksi esiletõstmine</title> + + <para +>&kile; sarnaneb muudele lähtekoodi redigeerimisega tegelevatele rakendustele, pakkudes võimalust tõsta automaatselt esile käsud, võtmed ning muud vajalikud elemendid. Nii võimaldab &kile; kiiresti tuvastada probleemsed alad: kui näiteks märkad, et mingi suurem tekstiosa on rohelist värvi, on usutav, et unustasid kuskil matemaatikakeskkonna sulgemata. Küllaps oleksid nagunii märganud, kui jube väljundfail välja näeb, aga esiletõstmine säästab märgatavalt sinu aega.</para> + + </sect2> + + <sect2 id="intro_autocoml"> + + <title +>Keskkonna automaatne lõpetamine</title> + + <para +>&kile; pakub võimalust keskkond automaatselt lõpetada: see tähendab, et kui alustad keskkonda, kirjutades <userinput +>\begin{environment}</userinput +>, lisab &kile; automaatselt käsu <userinput +>\end{environment}</userinput +>, jättes vahele rea sinu teksti tarbeks. Selle võimaluse võib muidugi soovi korral ka välja lülitada (<menuchoice +><guimenu +>Seadistused</guimenu +> <guisubmenu +>Kile seadistamine...</guisubmenu +><guimenuitem +>LaTeX</guimenuitem +><guilabel +>Keskkonnad</guilabel +></menuchoice +>).</para> + + </sect2> + + <sect2 id="intro_jump"> + + <title +>Hüppamine struktuurielementidele</title> + + <para +>Kõik dokumendid struktureeritakse tavapäraselt teatud hierarhiasse. &latex; lubab dokumendi jaotamisel kasutada järgmist hierarhiat (kus osa on hierarhias suurim ja alamlõik väikseim jaotis)</para> + + <itemizedlist> + <listitem +><para +>\osa</para +></listitem> + <listitem +><para +>\peatükk</para +></listitem> + <listitem +><para +>\sektsioon</para +></listitem> + <listitem +><para +>\alamsektsioon</para +></listitem> + <listitem +><para +>\alamalamsektsioon</para +></listitem> + <listitem +><para +>\lõik</para +></listitem> + <listitem +><para +>\alamlõik</para +></listitem> + </itemizedlist> + + <para +>Dokumenti <guilabel +>struktuur</guilabel +>ivaates vaadates võib elementide vahel liikuda klõpsuga elemendile, mida soovid vaadata.</para> + + </sect2> + + <sect2 id="intro_inverse"> + + <title +>Pöördotsing</title> + + <para +>Oma &latex;-faili luues võib pöördotsing päris kasuks tulla. Kui oled loonud DVI-faili (seadmest sõltumatu fail), hüppab &kile; juhul, kui klõpsad DVI näitamise rakenduses hiire keskmise nupuga, vastavale reale &latex;i lähtetekstis.</para> + + <para +>DVI (DeVice Independent file) definitsioon: DVI on failitüüp, mis sisaldab vormindatud dokumendi kirjeldust koos muu vajaliku infoga, näiteks kasutatud font. See on tavapärane &tex;/&latex;i väljund. DVI-failide vaatamiseks ja trükkimiseks mitmesugustes süsteemides ja seadmetel on olemas päris palju vahendeid.</para> + + </sect2> + + <sect2 id="intro_forward"> + + <title +>Edasiotsing</title> + + <para +>Pöördotsingut kasutades seostatakse DVI-failis valitud elemendid redaktoriga, nii et kui klõpsata DVI-failis, hüpatakse vastavale kohale &latex;i lähtetekstis. Edasiotsing on täpselt vastupidine: võimaldab klõpsata mingil tekstiosal &latex; lähtetekstis, misjärel hüpatakse sellega seotud tekstosale DVI näitamise aknas.</para> + + </sect2> + + </sect1> + + <sect1 id="intro_toolbar"> + + <title +>Tööriistariba</title> + + <itemizedlist> + <listitem +><para +><guibutton +>Uus</guibutton +>: avab uue dokumendi.</para +></listitem> + <listitem +><para +><guibutton +>Ava</guibutton +>: avab uue dokumendi.</para +></listitem> + <listitem +><para +><guibutton +>Sulge</guibutton +>: sulgeb dokumendi.</para +></listitem> + <listitem +><para +><guibutton +>Defineeri dokument 'peadokumendina'</guibutton +>: seda kasutatakse mitme failiga töötades. Peadokument võimaldab kaasata dokumenti muid <literal role="extension" +>.tex</literal +>-faile. Kui kasutad projekte, saad <menuchoice +><guimenu +>Projekt-></guimenu +><guisubmenu +>Projekti valikud</guisubmenu +></menuchoice +> abil määrata ka projekti peadokumendi.</para +></listitem> + <listitem +><para +><guibutton +>Kiire ehitamine</guibutton +>: kompileerib &latex;i lähteteksti ja näitab tulemust automaatselt, kui tekstis ei ole just vigu.</para +></listitem> + <listitem +><para +><guibutton +>Faili jälgimise režiim</guibutton +>: selles režiimis "jälgitakse" DVI-failis tehtavaid muudatusi ning uuendatakse faili automaatselt pärast <guibutton +>kiire ehitamise</guibutton +> kasutamist ilma &kdvi;d uuesti käivitamata.</para +></listitem> + <listitem +><para +><guibutton +>Vaata logifaili</guibutton +>: näitab <literal role="extension" +>.log</literal +>-faili, mis lubab vaadata vigu.</para +></listitem> + <listitem +><para +><guibutton +>Eelmine viga</guibutton +>: hüppab <literal role="extension" +>.log</literal +>-failis tagasi ja tõstab esile lähtetekstis oleva vea.</para +></listitem> + <listitem +><para +><guibutton +>Järgmine viga</guibutton +>: hüppab <literal role="extension" +>.log</literal +>-failis edasi ja tõstab esile lähtetekstis oleva vea.</para +></listitem> + <listitem +><para +><guibutton +>Stopp</guibutton +>: peatab parajasti täidetava toimingu.</para +></listitem> + <listitem +><para +><guibutton +>LaTeX</guibutton +>: käivitab &latex;i aktiivse dokumendiga.</para +></listitem> + <listitem +><para +><guibutton +>DVI vaatamine</guibutton +>: käivitab DVI näitaja.</para +></listitem> + <listitem +><para +><guibutton +>DVI->PS</guibutton +>: teisendab DVI-faili &postscript; (PS) failiks.</para +></listitem> + <listitem +><para +><guibutton +>PS vaatamine</guibutton +>: käivitab &postscript; (PS) näitaja.</para +></listitem> + <listitem +><para +><guibutton +>PDFLaTeX</guibutton +>: käivitab &pdflatex;i aktiivse dokumendiga.</para +></listitem> + <listitem +><para +><guibutton +>PDF-i vaatamine</guibutton +>: käivitab PDF-i näitaja.</para +></listitem> + <listitem +><para +><guibutton +>DVI->PDF</guibutton +>: teisendab DVI PDF-iks.</para +></listitem> + <listitem +><para +><guibutton +>PS->PDF</guibutton +>: teisendab PS-i PDF-ks.</para +></listitem> + <listitem +><para +><guibutton +>HTML vaatamine</guibutton +>: näitab loodud HTML-teksti.</para +></listitem> + <listitem +><para +><guibutton +>Kdvi edasiotsing</guibutton +>: hüppab leheküljele, mis vastab redaktoris parajasti aktiivsele reale.</para +></listitem> + </itemizedlist> + + <para +>Kui vaatad <guilabel +>redigeerimisriba</guilabel +>, näed kolme laia hüpikmenüüd. Need võimaldavad kiiresti lisada dokumenti enamkasutatavaid omadusi. Esimest neist kasutatakse dokumendi kiireks struktureerimiseks osadeks, peatükkideks, lõikudeks jne. Saadaolevad käsud jaotiste lisamiseks &latex;i lähteteksti on järgmised:</para> + + <itemizedlist> + <listitem +><para +><guilabel +>osa</guilabel +>: dokumendi struktuuri kõrgeim tasand.</para +></listitem> + <listitem +><para +><guilabel +>peatükk</guilabel +>: loob uue peatüki.</para +></listitem> + <listitem +><para +><guilabel +>sektsioon</guilabel +>: loob uue sektsiooni.</para +></listitem> + <listitem +><para +><guilabel +>alamsektsioon</guilabel +>: loob uue alamsektsiooni.</para +></listitem> + <listitem +><para +><guilabel +>alamalamsektsioon</guilabel +>: sekundaarne jaotis alamsektsiooni ja lõigu vahel.</para +></listitem> + <listitem +><para +><guilabel +>lõik</guilabel +>: loob uue lõigu.</para +></listitem> + <listitem +><para +><guilabel +>alamlõik</guilabel +>: loob uue alamlõigu.</para +></listitem> + </itemizedlist> + + <para +>Hüpikmenüü kirjaga <guilabel +>pealdis</guilabel +> lubab dokumenti sisestada mitmesuguseid elemente, näiteks indekseid, allmärkusi, viiteid. Kasutada saab järgmisi käske:</para> + + <itemizedlist> + <listitem +><para +><guilabel +>pealdis</guilabel +>: käsk, mis tekitab antud tasandile pealdise.</para +></listitem> + <listitem +><para +><guilabel +>indeks</guilabel +>: loob indeksikirje.</para +></listitem> + <listitem +><para +><guilabel +>allmärkus</guilabel +>: loob dokumenti allmärkuse.</para +></listitem> + <listitem +><para +><guilabel +>viide</guilabel +>: kasutatakse viitamiseks eelnevalt määratud pealdisele, mille saab valida hüpikmenüüst.</para +></listitem> + <listitem +><para +><guilabel +>leheküljeviide</guilabel +>: nagu <guilabel +>viide</guilabel +>, ainult et viitab struktuurielemendi asemel leheküljele.</para +></listitem> + <listitem +><para +><guilabel +>tsitaat</guilabel +>: loob dokumendis bibliograafia põhjal tsitaadi.</para +></listitem> + <listitem +><para +><guilabel +>tsitaat ViewBibist</guilabel +>: ViewBibi tööriistal palutakse lisada kõik valitud viited. Praegu on see kasutatav ainult ViewBibi tööriista <ulink url="http://user.digisurf.com.au/~thachly/kbib/" +>&kbib;</ulink +> vahendusel.</para +></listitem> + </itemizedlist> + + <screenshot> + <screeninfo +><guilabel +>Pealdis</guilabel +>e hüpikmenüü</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="snap_ref_choose.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +><guilabel +>Pealdis</guilabel +>e hüpikmenüü</phrase> + </textobject> + <caption +><para +><guilabel +>Pealdis</guilabel +>e hüpikmenüü</para +></caption> + </mediaobject> + </screenshot> + + <screenshot> + <screeninfo +>Pealdise valimine viitele</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="snap_ref_select.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Pealdise valimine viitele</phrase> + </textobject> + <caption +><para +>Pealdise valimine viitele</para +></caption> + </mediaobject> + </screenshot> + + <para +>Võimaluse <guilabel +>tsitaat</guilabel +> kasutamisel pakutakse hüpikmenüüna biblioelemente, aga kui sul on kasutusel &bibtex;, siis toimib see ainult juhul, kui fail kuulub projekti. &bibtex;-failide redigeerimiseks on soovitatav kasutada spetsiaalseid redaktoreid. Autoril on head kogemused rakendustega &kbibtex; ja &kbib;. Samuti võib kirjutada &bibtex;-faile käsitsi.</para> + + <para +>Viimane hüpikmenüü kirjaga <guilabel +>tilluke</guilabel +> võimaldab määrata teksti suuruse. Võimalik on määrata teksti, allmärkuste jne. suurust. Kasutada saab järgmisi käske:</para> + + <itemizedlist> + <listitem +><para +><guilabel +>tilluke</guilabel +>: kõige väiksem.</para +></listitem> + <listitem +><para +><guilabel +>skript</guilabel +>: väga väike.</para +></listitem> + <listitem +><para +><guilabel +>allmärkus</guilabel +>: väiksem.</para +></listitem> + <listitem +><para +><guilabel +>väike</guilabel +>: väike.</para +></listitem> + <listitem +><para +><guilabel +>normaalne</guilabel +>: normaalne.</para +></listitem> + <listitem +><para +><guilabel +>suur</guilabel +>: suur.</para +></listitem> + <listitem +><para +><guilabel +>Suur</guilabel +>: suurem.</para +></listitem> + <listitem +><para +><guilabel +>SUUR</guilabel +>: veel suurem.</para +></listitem> + <listitem +><para +><guilabel +>hiiglaslik</guilabel +>: veelgi suurem.</para +></listitem> + <listitem +><para +><guilabel +>Hiiglaslik</guilabel +>: kõige suurem.</para +></listitem> + </itemizedlist> + + </sect1> + +</chapter> +<chapter id="quickstart"> + + <title +>Kiirülevaade</title> + + <sect1 id="quick_begin"> + + <title +>&latex;i dokumendi kirjutamine &kile;s algajatele</title> + + <para +>Igal &kile; kasutajal on uut dokumenti alustades kaks võimalust: ta võib selleks kasutada <guimenu +>nõustaja</guimenu +>t, valides loodava dokumendi tüübi ning muud valikud, näiteks fondi suuruse, paberi suuruse jne., või siis alustada kõige kirjutamist käsitsi.</para> + + <screen +><userinput> + \documentclass[12pt]{article} + \begin{document} + Siia tuleb LaTeXi lähtetekst. + \end{document}</userinput +></screen> + + <para +>Iga &latex;i dokument algab käsuga <userinput +>\documentclass[lisaargument]{klass}</userinput +>, kus klass määrab ära dokunmenditüübi.</para> + + <para +>Ülaltoodud koodinäite kirjutamisel saadakse selline väljund:</para> + + <screenshot> + <screeninfo +>Kompileeritud tekst DVI väljundis</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="latex_example.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Kompileeritud tekst DVI väljundis</phrase> + </textobject> + <caption +><para +>Kompileeritud tekst DVI väljundis</para +></caption> + </mediaobject> + </screenshot> + + <para +>Nurksulud pärast käsku <userinput +>\documentclass</userinput +> tähistavad kasutatavat võtit. Võti <userinput +>[12pt]</userinput +> määrab artikli fondi suuruse. Kui fondi suurust ei määrata alguses, võib seda teha ka tekstis hiljem.</para> + + <para +>Kui oled toodud näite kirja pannud, tuleb &latex;i lähtetekst ka kompileerida. Lihtsaim viis &latex;i lähteteksti kompileerida on kasutada <guimenu +>ehitamise</guimenu +>menüüd või <guilabel +>kiire ehitamise</guilabel +> nuppu.</para> + + <para +>Lähteteksti saab kompileerida ka kiirklahviga <keycombo +>&Alt;<keycap +>2</keycap +></keycombo +>.</para> + + <para +>Lähtetekst tuleb enne kompileerimist salvestada. &kile; teeb selle sinu eest automaatselt ära.</para> + + <para +>Kui dokumendi kompileerimine ei õnnestu, uuri logifaile, kus võib leida vead. <guilabel +>Kiire ehitamise</guilabel +> nuppu kasutades peaks &kdvi; automaatselt käivituma. Kui seda ei juhtu, uuri logifailist, mis viga.</para> + + </sect1> + + <sect1 id="quick_env"> + <title +>Keskkonnad</title> + + <para +>Keskkond on käsk, mis võimaldab teatud tekstiosa käsitleda ülejäänud dokumendist erinevalt. Oletame näiteks, et lood raportit fondi suurusega 12, kuid mõne lause jaoks vajad erinevat fondi suurust. Käsud <userinput +>\begin{environment}</userinput +>, <userinput +>\huge</userinput +> ja <userinput +>\end{environment}</userinput +> lubavad muuta teksti keskkonnakäskude vahel hiiglaslikuks.</para> + + <para +>Seega rakenduvad muudatused ainult käskude <userinput +>\begin{environment}</userinput +> ja <userinput +>\end{environment}</userinput +> vahel. Keskkonna sees võib teha kui palju tahes muudatusi.</para> + + <para +>Dokumendi loetavamaks ja kasutajasõbralikumaks muutmiseks on päris palju võimalusi. Dokumendile võib lisada näiteks spetsiaalseid fonte, rasvast või kaldkirja, allajoonitud teksti jne. Kõik need lõpevad kas käsuga <userinput +>\end</userinput +> või keskkonna lõppedes.</para> + + <itemizedlist> + <listitem +><para +><userinput +>\begin{emph}</userinput +>: paneb teksti kaldkirja ja kehtib seni, kuni esineb <userinput +>\begin{emph}</userinput +> või algab teine keskkond. Lauses ühe sõna panemiseks kaldkirja kasuta süntaksit: see on <userinput +>\em{minu}</userinput +> lause.</para +></listitem> + <listitem +><para +><userinput +>\textbf{Ma panen selle teksti sulgudes rasvasesse kirja}</userinput +>: muudab teksti rasvaseks.</para +></listitem> + <listitem +><para +><userinput +>\quote</userinput +>: tekitab dokumendis jutumärkides osa, mis algab käsuga <userinput +>\begin{quote}</userinput +> ja lõpeb käsuga <userinput +>\end{quote}</userinput +>.</para +></listitem> + <listitem +><para +><userinput +>\center</userinput +>: tsentreerib teksti.</para +></listitem> + <listitem +><para +><userinput +>\verse</userinput +>: loob luuletustele vajaliku keskkonna.</para +></listitem> + <listitem +><para +><userinput +>\itemize</userinput +>: tekitab loendi.</para +></listitem> + </itemizedlist> + + </sect1> + + <sect1 id="quick_using"> + + <title +>&kile; kasutamine</title> + + <para +>Nüüd, kus oleme andnud põgusa ülevaate, kuidas kirjutada teksti &latex;i märkekeeles, näitame samm-sammult, kuidas luua &kile;s dokument.</para> + + <procedure> + <step +><para +>Käivita &kile;</para +></step> + <step +><para +>Vali <menuchoice +><guimenu +>Nõustaja</guimenu +><guimenuitem +>Kiirstart</guimenuitem +></menuchoice +>, seejärel vali vorming ja määra nõustajas oma eelistused.</para +></step> + <step +><para +>Kui nõustaja on teksti sisestanud, kohanda dokument loetavamaks, lisa vähemalt üks tsitaat, üks rasvases ja üks kaldkirjas osa ning luuleosa, et näha, mille poolest ja kuidas käsud erinevad.</para +></step> + <step +><para +>Salvesta fail ja anna sellele nimeks <filename +>intro.tex</filename +>.</para +></step> + <step +><para +>Ehita dokument kiirklahviga <keycombo +>&Alt;<keycap +>2</keycap +></keycombo +> või klõpsuga nupul <guilabel +>LaTeX</guilabel +>.</para +></step> + <step +><para +>Vali <guibutton +>DVI vaatamine</guibutton +>.</para +></step> + <step +><para +>Kontrolli põhjalikult oma teksti.</para +></step> + <step +><para +>Kui oled lõpetanud, klõpsa redaktorisse naasmiseks nupule <guibutton +>Redaktorivaade</guibutton +> või vajuta kiirklahvi <keycombo +>&Ctrl;<keycap +>e</keycap +></keycombo +>, kui kasutad põimitud redaktorit, või sulge vaatamisrakenduse aken.</para +></step> + </procedure> + + <para +>Ongi kõik! Oledki valmis saanud oma esimese &latex;i dokumendi!</para> + + <para +>Kui oled DVI loonud, võid oma dokumendi trükkida või teisendada soovi korral &postscript; või PDF-failiks. Proovi ja katseta!</para> + + </sect1> + + <sect1 id="quick_dvi"> + + <title +>DVI failid</title> + + <para +>DVI tähendab <emphasis +>seadmest sõltumatu</emphasis +> (inglise keeles 'DeVice Independent') fail. Neid loob &tex; või &latex;, et teksti oleks arvutil lihtsam näidata. <literal role="extension" +>.dvi</literal +>-faili võib suunata mitmesugustele väljunditele, näiteks printerile, &postscript; või PDF konverterisse või arvutiekraanile.</para> + + <sect2 id="quick_viewdvi"> + + <title +>DVI vaatamine</title> + + <para +>Seda, kuidas DVI-faili ekraanil vaadata, sa juba tead: kasuta selleks tööriistariba nuppu <guibutton +>DVI vaatamine</guibutton +>.</para> + + </sect2> + + <sect2 id="quick_printdvi"> + + <title +>DVI trükkimine</title> + + <para +>DVI trükkimiseks saab kasutada sama meetodit, millega dokument luuakse (vaata <xref linkend="quick_using"/>). Pärast 7. sammu, kui oled klõpsanud <guibutton +>DVI vaatamine</guibutton +>, vali vaatajas <menuchoice +><guimenu +>Fail</guimenu +><guimenuitem +>Trüki</guimenuitem +></menuchoice +> ning kui printer on korrektselt seadistatud, DVI trükitaksegi.</para> + + </sect2> + + <sect2 id="quick_exportdvi"> + + <title +>DVI teisendamine</title> + + <para +>Tööriistariba võimaldab eksportida DVI mitmesse vormingusse. Kui &latex;i lähtetekstist on loodud DVI, peaks olema seda võimalik tööriistariba nuppude abil eksportida just sulle meelepärasesse vormingusse.</para> + + </sect2> + + </sect1> + + <sect1 id="quick_forward"> + + <title +>Edasiotsing &kile; ja &kdvi; vahel</title> + + <para +>Edasiotsing võimaldab redaktorist hüpata otse vastavasse asukohta &DVI; failis. </para> + <para +>&kile; võimaldab seda kasutada kõigi &latex;i binaarfailidega. Ava <menuchoice +><guimenu +>Seadistused</guimenu +><guisubmenu +>Kile seadistamine...</guisubmenu +> <guimenuitem +>Tööriistad</guimenuitem +><guilabel +>Ehitamine</guilabel +></menuchoice +> ja vali seadistus <guilabel +>Modernne</guilabel +>.</para> + + <para +>Edasiotsing võimaldab klõpsata mingile tekstiosale lähtetekstis ning hüpata käsuga <guilabel +>Kdvi edasiotsing</guilabel +> vastavale asukohale DVI näitaja aknas.</para> + </sect1> + + <sect1 id="quick_inverse"> + + <title +>Pöördotsing &kile; ja &kdvi; vahel</title> + + <para +>Pöördotsing on väga kasulik võimalus, kui kirjutad ise &latex;i dokumenti. Kui kõik on korrektselt seadistatud, võid klõpsata &kdvi; aknas &HKNga; (mõnes süsteemis saab juhul, kui hiirel ei ole kolme nuppu, selle asemel vajutada korraga hiire <mousebutton +>vasakut</mousebutton +> ja <mousebutton +>paremat</mousebutton +> nuppu). Kile laadib seejärel &latex; lähtefaili ja hüppab õigele lõigule. Pöördotsingu kasutamiseks tuleb &latex;i fail kompileerida seadistusega <guilabel +>Modernne</guilabel +>.</para> + + <para +>Pöördotsing toimib, kui:</para> + + <itemizedlist> + <listitem +><para +>Lähteteksti fail on edukalt kompileeritud.</para +></listitem> + <listitem +><para +>&kdvi; teab, millist redaktorit kasutada.</para +></listitem> + </itemizedlist> + + <para +>See &kdvi; võimalus lubab hiire keskmise nupu klõpsuga DVI dokumendis avada &kile;s vastava &latex;i dokumendi ja hea õnne korral vastavale reale minna. Pea meeles, et sul tuleb anda &kdvi;le korraldus kasutada tekstiredaktorina &kile;t (&kdvi; menüükäsk <menuchoice +><guimenu +>Seadistused</guimenu +><guimenuitem +>DVI valikud...</guimenuitem +></menuchoice +>).</para> + + <screenshot> + <screeninfo +>&kdvi; seadistamine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="snap_kdvi_settings.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>&kdvi; seadistamine</phrase> + </textobject> + <caption +><para +>&kdvi; seadistamine</para +></caption> + </mediaobject> + </screenshot> + </sect1> + + <sect1 id="quick_errors"> + + <title +>Vigade lahendamine</title> + + <para +>Kui kasutasid kiiret ehitamist ning DVI vaataja ei avanenud, on tõenäoline, et tegemist on mingi veaga. Sellisel juhul võib viga näha logifaili/teate alal, kus näidatakse vea kokkuvõtlikku kirjeldust.</para> + + <para +>Logifail selgitab, millise veaga lähtetekstis on tegemist. Redaktoris saab kasutada tööriistaribal olevaid nuppe <guibutton +>Eelmine LaTeXi viga</guibutton +> ja <guibutton +>Järgmine LaTeXi viga</guibutton +> vigade vahel liikumiseks. Logifail annab alati teada, millisel real viga esines. Kui soovid seda rida näha, klõpsa logiaknas veal ning &kile; viib sind vastavat viga sisaldavale reale.</para> + + </sect1> + +</chapter> +<chapter id="startnew"> + + <title +>Uue dokumendi loomine</title> + + <para +>Kui klõpsad tööriistaribal uue dokumendi loomise nupule, ilmub dialoog, mis pärib, millist mallitüüpi soovid dokumendi jaoks kasutada. Võimalused on vaikimisi järgmised:</para> + + <itemizedlist> + <listitem +><para +>Tühi dokument</para +></listitem> + <listitem +><para +>Artikkel</para +></listitem> + <listitem +><para +>Beamer</para +></listitem> + <listitem +><para +>Raamat</para +></listitem> + <listitem +><para +>HA-Prosper</para +></listitem> + <listitem +><para +>Kiri</para +></listitem> + <listitem +><para +>Aruanne</para +></listitem> + <listitem +><para +>Scrartcl (KOMA-Scripti paketist)</para +></listitem> + <listitem +><para +>Scrbook (KOMA-Scripti paketist)</para +></listitem> + <listitem +><para +>Scrlttr2 (KOMA-Scripti paketist)</para +></listitem> + <listitem +><para +>Scrreprt (KOMA-Scripti paketist)</para +></listitem> + </itemizedlist> + + <para +>Kui valid <guilabel +>tühja dokumendi</guilabel +>, võid alustada dokumendi loomist päris tühjalt kohalt või kasutada nõustajat uue dokumendi kiireks tekitamiseks (vaata <xref linkend="intro_docwizard"/>).</para> + + + <sect1 id="startnew_templates"> + + <title +>Mallid</title> + + <para +>&latex;i sagedasemad kasutajad tarvitavad tihtipeale peaaegu igal dokumendil üht ja sama preambulat, mille on hoolsalt just enda maitsele kohandanud. Selleks ongi olemas mallid: iga pidevalt sarnaseid dokumente loov &kile; kasutaja võidab kahtlemata võimalusest luua just enda maitsele vastavaid malle.</para> + + + <sect2> + <title +>Uue malli loomine</title> + + <para +>Uue malli loomiseks tuleb esmalt avada &tex;/&latex;-fail või luua uus fail. &kile; võib malli luua olemasoleva dokumendi põhjal, kui avad soovitud dokumendi ja kasutad menüükäsku <menuchoice +><guimenu +>Fail</guimenu +> <guimenuitem +>Loo dokumendi põhjal mall</guimenuitem +></menuchoice +>.</para> + + </sect2> + + <sect2> + + <title +>Kohatäitjate kasutamine</title> + + <para +>Kui lood uue dokumendi malli põhjal käsuga <menuchoice +><guimenu +>Fail</guimenu +><guimenuitem +>Uus</guimenuitem +></menuchoice +>, võidakse teatud sümbolite kombinatsioonid asendada mõningate andmetega, näiteks sinu nime või kasutatava kodeeringuga. Nende muutujate seadistamiseks kasuta menüükäsku <menuchoice +><guimenu +>Seadistused</guimenu +><guimenuitem +>Kile seadistamine</guimenuitem +></menuchoice +>.</para> + + <para +>Kui lood malli omal käel, on kasulik teada, millised sümbolite kombinatsioonid milliseid mallimuutujaid tähistavad:</para> + + <itemizedlist> + <listitem +><para +><userinput +>$$AUTHOR$$</userinput +>: asendatakse autorimuutujaga.</para +></listitem> + <listitem +><para +><userinput +>$$DOCUMENTCLASSOPTIONS$$</userinput +>: asendatakse dokumendiklassi võtme muutujaga. Tavaliselt kasutatakse seda umbes nii: <userinput +>\documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}</userinput +>.</para +></listitem> + <listitem +><para +><userinput +>$$INPUTENCODING$$</userinput +>: kui sisendi kodeeringu muutuja väärtuseks on näiteks <userinput +>latin1</userinput +>, asendatakse string <userinput +>\input[latin1]{inputenc}</userinput +>.</para +></listitem> + </itemizedlist> + + </sect2> + + <sect2 id="templ_wiz"> + + <title +>Malli loomine nõustajas</title> + + <para +>Lihtsaim viis uut malli luua on käivitada nõustaja ning seejärel anda vajalikud käsud paremal redaktoris. Kui dokument on võtnud sulle meelepärase kuju:</para> + + <procedure> + <step +><para +>Salvesta fail</para +></step> + <step +><para +>Ava menüü <guimenu +>Fail</guimenu +></para +></step> + <step +><para +>Vali <guimenuitem +>Loo dokumendi põhjal mall</guimenuitem +></para +></step> + <step +><para +>Vajadusel muuda veel malli</para +></step> + <step +><para +>Sisesta oma uue malli nimi</para +></step> + <step +><para +>Klõpsa <guibutton +>OK</guibutton +> malli lisamiseks menüüsse</para +></step> + </procedure> + + <para +>Kui nüüd lood uue dokumendi, võid tavapärasteemallide kõrval valida ka omaloodud malli.</para> + + </sect2> + + <sect2> + + <title +>Malli loomine mis tahes faili põhjal</title> + + <para +>Malli võib luua mis tahes faili põhjal. Kui püüad võimalikult vähese vaevaga läbi ajada, võid otsida vajalikku malli internetis ning siis võtta ette samad sammud, mida kirjeldab <xref linkend="templ_wiz"/>.</para> + + <para +>Oletame, et soovid luua korralikku A0 posterit, mida kasutatakse tihtipeale teaduskonverentsidel. &latex; mõistagi aitab sul luua väga külgetõmbava ja köitva posteri. A0 posteri malli võid leida <ulink url="http://www.stats.ox.ac.uk/~marchini/a0poster.html" +>Jonathan Marchini koduleheküljelt</ulink +>, kuid neid on märksa enamgi. Pea meeles, et sul läheb vaja paketti <filename +>a0poster</filename +>, mida standardse TeXi tarkvaraga kaasas ei ole, nii et sul tuleb see <ulink url="http://www.ctan.org/tex-archive/macros/latex/contrib/a0poster/" +>siit</ulink +> alla laadida ja kopeerida &latex;i faili kataloogi.</para> + </sect2> + + <sect2 id="templ_rem"> + + <title +>Malli eemaldamine</title> + + <para +>Malli eemaldamiseks &kile;st:</para> + + <procedure> + <step +><para +>vali <menuchoice +><guimenu +>Fail</guimenu +><guimenuitem +>Eemalda mall...</guimenuitem +></menuchoice +></para +></step> + <step +><para +>Ilmub kõiki malle näitav dialoog, kus vali mall</para +></step> + <step +><para +>Klõpsa <guilabel +>OK</guilabel +> ja mall eemaldataksegi</para +></step> + </procedure> + + <para +>Malle märkega * ei saa eemaldada, kui sul selleks õigusi pole</para> + + </sect2> + + </sect1> + +</chapter> +<chapter id="editing"> + + <title +>&latex; dokumentide redigeerimine</title> + + <para +>&kile; seesmine redaktor kasutab ära &kate;t. Kate on programmeerijatele loodud tekstiredaktor, mis suudab lugeda ja kasutada esiletõstmist paljude tekstifailide tüüpide korral, sealhulgas &latex; ja &bibtex;. Suurt osa &kate; võimalustest saab kasutada otse &kile;s menüü <guimenu +>Tööriistad</guimenu +> vahendusel.</para> + + <para +>&kate; ja selle võimaluste kohta annab rohkem teavet <ulink url="help:kate" +>Kate käsiraamat</ulink +>. &kile; kasutajad võiksid ennekõike vaadata peatükki <quote +>Töö Katega</quote +>.</para> + + <sect1 id="editing_sect"> + + <title +>&latex;i viited</title> + + <para +>&kile; pakub väga praktilist ülevaadet &latex;i viidetest, mida saab kasutada menüükäsuga <menuchoice +><guimenu +>Abi</guimenu +><guimenuitem +>LaTeXi viited</guimenuitem +></menuchoice +>. See sisaldab peaaegu kõigi &latex;is kasutatavate käskude põhjalikke selgitusi ning süntaksit.</para> + + </sect1> + + <sect1 id="editing_cursor"> + + <title +>Kursori liikumine</title> + + <para +>Kui soovid valida teksti, saab seda teha nii:</para> + + <itemizedlist> + <listitem +><para +>Hoia all hiire vasak nupp ja lohista hiirt teksti äramärkimiseks.</para +></listitem> + <listitem +><para +>Klõpsa sõnal kursori liigutamiseks uuele alale.</para +></listitem> + <listitem +><para +>Klõpsa sõnal kaks korda terve sõna valimiseks.</para +></listitem> + <listitem +><para +>Kogu TeXi sõna valimiseks tee sõnal topeltklõps ja vajuta klahvi <keycombo +>&Ctrl;</keycombo +>. Sel moel näiteks teksti <userinput +>\par\bigskip</userinput +> osal <userinput +>\par</userinput +> klõpsates valitakse ainult \par.</para +></listitem> + <listitem +><para +>Klõpsa kolm korda terve lause valimiseks.</para +></listitem> + </itemizedlist> + + <para +>Hiire vasakut nuppu all hoides ja valitavat teksti lohistades kopeeritakse valitud tekst automaatselt lõikepuhvrisse.</para> + + <para +>Klahvi Shift all hoides ning nooleklahve kasutades saab redaktoriaknas valida vajaliku lähteteksti osa.</para> + + </sect1> + + <sect1 id="editing_bracket"> + + <title +>Sulud</title> + + <para +>Sulgude lõpetamine on üks visuaalseid vahendeid, mida kasutatakse redaktorivaates paremaks näitamiseks, millised sulud teineteisega kokku lähevad. Kui avad <literal role="extension" +>.tex</literal +>-faili ja valid suvalise sulu, olgu see ümarsulg (), nurksulg [] või looksulg{}, tõstab redaktor esile nii selle kui tema paarilise kollase värviga (seda vaikevärvi saab mõistagi muuta). Kui asetad kursori näiteks looksulule käsus <userinput +>\section{Sissejuhatus}</userinput +>, näeb <userinput +>\section{Sissejuhatus}</userinput +> vaikimisi kollasena esiletõstetuna, näidates sulle sel moel alustavat ja lõpetavat looksulgu.</para> + + </sect1> + + <sect1 id="editing_highlight"> + + <title +>Esiletõstmine</title> + + <para +>&kile; suudab tuvastada ja esile tõsta erinevat tüüpi koodi. Nii on näiteks &latex;i käsud eristatud tavalisest tekstist, mis muudab tavalise teksti lugemise hõlpsamaks. Erineva värviga on tähistatud ka valemid.</para> + + </sect1> + + <sect1 id="editing_bullets"> + + <title +>Täpid</title> + + <para +>Paljud nõustajad võivad lisada täppe, omamoodi järjehoidjaid tekstis. Menüükäsud <menuchoice +><guimenu +>Redigeerimine</guimenu +><guisubmenu +>Täpid</guisubmenu +></menuchoice +> või vastavad kiirklahvid võimaldavad hüpata järgmisele või viimasele täpile. Täpp ühtlasi valitakse, nii et kui kirjutad mõne sümboli, kustutatakse see automaatselt.</para> + + <screenshot> + <screeninfo +>Täpid</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="bullets.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Täpid</phrase> + </textobject> + </mediaobject> + </screenshot> + + <variablelist> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>Nool paremale</keycap +></keycombo +></shortcut +> <guimenuitem +>Järgmine täpp</guimenuitem +></menuchoice +></term> + <listitem +><para +>Hüppab tekstis järgmisele täpile, kui see on olemas.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>Nool vasakule</keycap +></keycombo +></shortcut +> <guimenuitem +>Viimane täpp</guimenuitem +></menuchoice +></term> + <listitem +><para +>Hüppab tekstis eelmisele täpile, kui see on olemas.</para +></listitem> + </varlistentry> + + </variablelist> + + </sect1> + + <sect1 id="editing_select"> + + <title +>Valimine</title> + + <para +>Redigeerimine on mõistagi sellise rakenduse nagu &kile; kasutamise üks tähtsamaid pmadusi. Kuigi ka &kate; on väga võimekas redaktor, lisab &kile; mitmeid olulisi võimalusi, mida läheb eriti vaja &latex;i lähtekoodi kirjutamisel. &latex; vajab alati hulka keskkondi ja gruppe, mistõttu &kile; toetab nende valimise erikäske. Alammenüüs <menuchoice +><guimenu +>Redigeerimine</guimenu +><guisubmenu +>Valimine</guisubmenu +></menuchoice +> leiab järgmised teksti valimise käsud.</para +> + + <screenshot> + <screeninfo +>Redigeerimine->Elementide valimine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="select.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Redigeerimine->Elementide valimine</phrase> + </textobject> + </mediaobject> + </screenshot> + + <variablelist> + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>S</keycap +></keycombo +> <keycap +>E</keycap +></shortcut +> <guimenuitem +>Keskkond (sisemine)</guimenuitem +></menuchoice +></term> + <listitem +><para +>Valib keskkonna ilma ümbritsevate siltideta.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>S</keycap +></keycombo +> <keycap +>F</keycap +></shortcut +> <guimenuitem +>Keskkond (väline)</guimenuitem +></menuchoice +></term> + <listitem +><para +>Valib keskkonna koos ümbritsevate siltidega.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>S</keycap +></keycombo +> <keycap +>T</keycap +></shortcut +> <guimenuitem +>TeXi grupp (sisemine)</guimenuitem +></menuchoice +></term> + <listitem +><para +>Valib TeXi grupi ümbritsevate sulgude sees.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>S</keycap +></keycombo +> <keycap +>U</keycap +></shortcut +> <guimenuitem +>TeXi grupp (väline)</guimenuitem +></menuchoice +></term> + <listitem +><para +>Valib eXi grupi koos ümbritsevate sulgudega.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>S</keycap +></keycombo +> <keycap +>M</keycap +></shortcut +> <guimenuitem +>Matemaatikagrupp</guimenuitem +></menuchoice +></term> + <listitem +><para +>Valib aktiivse matemaatikagrupi koos matemaatikakäskudega.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>S</keycap +></keycombo +> <keycap +>P</keycap +></shortcut +> <guimenuitem +>Lõik</guimenuitem +></menuchoice +></term> + <listitem +><para +>Valib kogu lõigu, &ie; tekstiridade grupi, mida eraldavad mõlemalt poolt tühjad read. Lõik ei tähenda lihtsalt järjestikusi tekstiridu, nagu teistes tekstiredaktorites. Lõik hõlmab ka tabeleid, &latex;i käske ja kõiki muid lähtekoodiridu. &kile; jaoks on oluline ainult see, et lõik oleks eraldatud kahe tühja reaga.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>S</keycap +></keycombo +> <keycap +>L</keycap +></shortcut +> <guimenuitem +>Rida</guimenuitem +></menuchoice +></term> + <listitem +><para +>Valib tekstirea, kus paikneb kursor.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>S</keycap +></keycombo +> <keycap +>W</keycap +></shortcut +> <guimenuitem +>TeXi sõna</guimenuitem +></menuchoice +></term> + <listitem +><para +>Valib kursori asukohas oleva sõna. Ka see valik on laiendatud tähendusega, sest selle käsuga saab valida ka &latex;i käske, mis algavad längkriipsuga ja millel võib lõpus olla tärn.</para +></listitem> + </varlistentry> + + </variablelist> + + </sect1> + + <sect1 id="editing_delete"> + + <title +>Kustutamine</title> + + <para +>Dokumendi teatud osa kustutamiseks võib selle muidugi valida ja vajudata klahvile <keycombo +><keycap +>Delete</keycap +></keycombo +>. Kate pakub lisaks veel kiirklahvi <keycombo +>&Ctrl;<keycap +>K</keycap +></keycombo +>, mis kustutab terve rea. Kuid &kile; pakub oma kustutamiskäskudega kiiremaidki võimalusi. Alammenüüs <menuchoice +><guimenu +>Redigeerimine</guimenu +><guisubmenu +>Kustutamine</guisubmenu +></menuchoice +> leiab järgmised teksti kustutamise käsud.</para +> + + <screenshot> + <screeninfo +>Redigeerimine->Elementide kustutamine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="delete.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Redigeerimine->Elementide kustutamine</phrase> + </textobject> + </mediaobject> + </screenshot> + + <variablelist> + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>T</keycap +></keycombo +> <keycap +>E</keycap +></shortcut +> <guimenuitem +>Keskkond (sisemine)</guimenuitem +></menuchoice +></term> + <listitem +><para +>Kustutab keskkonna ilma ümbritsevate siltideta.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>T</keycap +></keycombo +> <keycap +>F</keycap +></shortcut +> <guimenuitem +>Keskkond (väline)</guimenuitem +></menuchoice +></term> + <listitem +><para +>Kustutab keskkonna koos ümbritsevate siltidega.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>T</keycap +></keycombo +> <keycap +>T</keycap +></shortcut +> <guimenuitem +>TeXi grupp (sisemine)</guimenuitem +></menuchoice +></term> + <listitem +><para +>Kustutab TeXi grupi ümbritsevate sulgude sees.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>T</keycap +></keycombo +> <keycap +>U</keycap +></shortcut +> <guimenuitem +>TeXi grupp (väline)</guimenuitem +></menuchoice +></term> + <listitem +><para +>Kustutab TeXi grupi koos ümbritsevate sulgudega.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>T</keycap +></keycombo +> <keycap +>M</keycap +></shortcut +> <guimenuitem +>Matemaatikagrupp</guimenuitem +></menuchoice +></term> + <listitem +><para +>Kustutab aktiivse matemaatikagrupi koos matemaatikakäskudega.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>T</keycap +></keycombo +> <keycap +>P</keycap +></shortcut +> <guimenuitem +>Lõik</guimenuitem +></menuchoice +></term> + <listitem +><para +>Kustutab kogu lõigu. Vaata käsu <menuchoice +><guisubmenu +>Valimine</guisubmenu +><guimenuitem +>Lõik</guimenuitem +></menuchoice +> kirjeldusest, kuidas &kile; lõiku määratleb.</para +></listitem> + </varlistentry> + + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>T</keycap +></keycombo +> <keycap +>I</keycap +></shortcut +> <guimenuitem +>Rea lõpuni</guimenuitem +></menuchoice +></term> + <listitem +><para +>Kustutab teksti alates kursori asukohast rea lõpuni. </para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>T</keycap +></keycombo +> <keycap +>W</keycap +></shortcut +> <guimenuitem +>TeXi sõna</guimenuitem +></menuchoice +></term> + <listitem +><para +>Kustutab sõna või &latex;i käsu kursori asukohas.</para +></listitem> + </varlistentry> + + </variablelist> + + </sect1> + + <sect1 id="editing_environment"> + + <title +>Keskkond</title> + + <para +>Juba eespool mainiti, et keskkonnad on &latex;is keskse tähendusega. Seepärast pakub &kile; veel viit käsku &latex;i võimalikult lihtsaks käitlemiseks alammenüüs <menuchoice +><guimenu +>Redigeerimine</guimenu +><guisubmenu +>Keskkond</guisubmenu +></menuchoice +>.</para> + + <screenshot> + <screeninfo +>Redigeerimine->Keskkonna elemendid</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="environment.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Redigeerimine->Keskkonna elemendid</phrase> + </textobject> + </mediaobject> + </screenshot> + + <variablelist> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>E</keycap +></keycombo +> <keycap +>B</keycap +></shortcut +> <guimenuitem +>Mine algusse</guimenuitem +></menuchoice +></term> + <listitem +><para +>Selle käsuga hüpatakse aktiivse keskkonna algusse. Kursor asetatakse otse keskkonda alustava sildi ette.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>E</keycap +></keycombo +> <keycap +>E</keycap +></shortcut +> <guimenuitem +>Mine lõppu</guimenuitem +></menuchoice +></term> + <listitem +><para +>Selle käsuga hüpatakse aktiivse keskkonna lõppu. Kursor asetatakse otse keskkonda lõpetava sildi järele.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>E</keycap +></keycombo +> <keycap +>M</keycap +></shortcut +> <guimenuitem +>Sobivus</guimenuitem +></menuchoice +></term> + <listitem +><para +>Kui kursor asub sildi <userinput +>\begin{keskkond}</userinput +> ees või kohal, viiakse see keskkonna teise otsa ja vastupidi.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>E</keycap +></keycombo +> <keycap +>C</keycap +></shortcut +> <guimenuitem +>Sulge</guimenuitem +></menuchoice +></term> + <listitem +><para +>Pesastatud keskkonnasiltide vahele teksti sisestades võib kaduda kontroll keskkondade üle. Selle käsuga suletakse viimati avatud keskkond, mis väldib keskkondade pesastatud struktuuri vigu.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>E</keycap +></keycombo +> <keycap +>A</keycap +></shortcut +> <guimenuitem +>Sulge kõik</guimenuitem +></menuchoice +></term> + <listitem +><para +>Sulgeb kõik keskkonnad, mitte ainult viimatu avatud keskkonna.</para +></listitem> + </varlistentry> + + </variablelist> + + </sect1> + + <sect1 id="editing_texgroup"> + + <title +>&tex;i grupp</title> + + <para +>&kile; pakub mõningaid erikäske ka &latex;i gruppidele, mida määravad sulud <userinput +>{...}</userinput +>. Alammenüüs <menuchoice +><guimenu +>Redigeerimine</guimenu +><guisubmenu +>TeXi grupp</guisubmenu +></menuchoice +> leiab mitu olulist käsku, mis vastavad alammenüü <menuchoice +><guimenu +>Redigeerimine</guimenu +><guisubmenu +>Keskkond</guisubmenu +></menuchoice +> omadele. </para> + + <screenshot> + <screeninfo +>Redigeerimine->TeXi grupp</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="texgroup.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Redigeerimine->TeXi grupp</phrase> + </textobject> + </mediaobject> + </screenshot> + + <variablelist> + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>G</keycap +></keycombo +> <keycap +>B</keycap +></shortcut +> <guimenuitem +>Mine algusse</guimenuitem +></menuchoice +></term> + <listitem +><para +>Selle käsuga hüpatakse aktiivse grupi algusse. Kursor asetatakse otse gruppi alustava sulu ette.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>G</keycap +></keycombo +> <keycap +>E</keycap +></shortcut +> <guimenuitem +>Mine lõppu</guimenuitem +></menuchoice +></term> + <listitem +><para +>Selle käsuga hüpatakse aktiivse grupi lõppu. Kursor asetatakse otse gruppi lõpetava sulu järele.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>G</keycap +></keycombo +> <keycap +>M</keycap +></shortcut +> <guimenuitem +>Sobivus</guimenuitem +></menuchoice +></term> + <listitem +><para +>Kui kursor asub &tex;i gruppi alustava sulu ees või järel, viiakse see grupi lõppu ja vastupidi.</para +></listitem> + </varlistentry> + + <varlistentry +><term +><menuchoice +><shortcut +><keycombo action="simul" +>&Ctrl;&Alt;<keycap +>G</keycap +></keycombo +> <keycap +>C</keycap +></shortcut +> <guimenuitem +>Sulge</guimenuitem +></menuchoice +></term> + <listitem +><para +>Pesastatud grupisulgude kirjutamine võib üsna vaevaline olla. Selle käsuga suletakse viimati avatud grupp, mis väldib &tex;i gruppide pesastatud struktuuri vigu.</para +></listitem> + </varlistentry> + + </variablelist> + + </sect1> + + <sect1 id="editing_dblquotes"> + + <title +>Topeltjutumärgid</title> + + <para +>&latex; kasutab topeltjutumärkidena kaht ühekordset jutumärki. Nende tõhusaks lisamiseks võimaldab &kile; kaht ühekordset alustavat jutumärki lisada klahvile <keycap +>"</keycap +> vajutades. Kui soovid tsitaadi sulgeda, tuleb samuti vajutada <keycap +>"</keycap +>. &kile; on piisavalt nutikas, et sellest aru saada ja lisada &latex;ile kaks lõpetavat jutumärki.</para> + + <para +>Otseste topeltjutumärkide saamiseks vajuta kaks korda <keycap +>"</keycap +>.</para> + + <para +>Alustava ja lõpetava topeltjutumärgi automaatse lisamise saab välja lülitada sektsioonis <menuchoice +><guimenu +>Seadistused</guimenu +><guisubmenu +>Kile seadistamine...</guisubmenu +><guimenuitem +>LaTeX</guimenuitem +></menuchoice +>.</para> + + <screenshot> + <screeninfo +>Topeltjutumärgid</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="config-dblquotes.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Topeltjutumärgid</phrase> + </textobject> + </mediaobject> + </screenshot> + + <para +>Kui kaasad keelepõhised valikud või stiilifailid, näiteks <userinput +>ngerman</userinput +> või <userinput +>french</userinput +>, saad kasutada ka saksa või prantsuse topeltjutumärke. Saadaval on muidugi veel palju rohkem keeli. </para> + + </sect1> + + <sect1 id="editing_smartnewline"> + + <title +>Nutikas reavahetus</title> + + <para +>Kui vajutad klahve <keycombo +>&Shift;<keycap +>Return</keycap +></keycombo +>, lisab &kile; nutika reavahetuse. Kui kursor asub parajasti nimekirjakeskkonnas (näiteks <userinput +>enumerate</userinput +> või <userinput +>itemize</userinput +>), ei lisa &kile; mitte ainult reavahetust, vaid ka käsu <userinput +>\item</userinput +>.</para> + + <para +>Kui oled tabelikeskkonnas, lisab &kile; aktiivse rea lõppu <userinput +>\\</userinput +> ja reavahetuse.</para> + + <para +>Kui oled &latex;i kommentaaris, lisab &kile; järgmise rea algusse <userinput +>%</userinput +>.</para> + + <para +>Kuid &kile; toetab isegi eelmääratud &latex;i ja kasutaja määratud keskkondi, mida saab lisada sektsioonis <menuchoice +><guimenu +>Seadistused</guimenu +><guisubmenu +>Kile seadistamine...</guisubmenu +><guimenuitem +>LaTeX</guimenuitem +></menuchoice +>.</para> + + </sect1> + + <sect1 id="editing_tabulator"> + + <title +>Nutikas tabulaator</title> + + <para +>Mõnele kasutajale meeldib tabelikeskkonnas veerge korraldada ja seada kõik <keycap +>&</keycap +>-märgid üksteise alla. &kile; toetab seda. Kui vajutad <keycombo +>&Shift;&Alt;<keycap +>&</keycap +></keycombo +>, otsib &kile; ülalolevas reas järgmist tabeldusmärki. Ehkki see ei pruugi muidugi olla just õige tabeldusmärk, lisab &kile; tühikuid, et sobitada veeru asukoht tabelduskohaga.</para> + + </sect1> + +</chapter> + +<chapter id="completion"> + + <title +>Koodilõpetus</title> + + <para +>Kuigi &kate; pakub juba päris häid lõpetamisvõimalusi, on &kile; laiendanud koodilõpetamist, et pakkuda mõningaid spetsiaalselt &latex;ile mõeldud võimalusi. Erinevaid režiime on kokku viis. Kolm neist aktiveeruvad nõudmisel, kaks on aga automaatse lõpetamise võimalused. Kõiki neid saab seadistada dialoogis <menuchoice +><guimenu +>Seadistused</guimenu +><guimenuitem +>Kile seadistamine...</guimenuitem +></menuchoice +></para> + + <sect1 id="complete_autoenvironment"> + + <title +>Keskkonna automaatne lõpetamine</title> + + <para +>Kui alustad uut keskkonda näiteks käsuga <userinput +>\begin{keskkond}</userinput +>, lisab &kile; automaatselt käsu <userinput +>\end{keskkond}</userinput +>, jättes nende vahele rea, kuhu saad sisestada oma teksti.</para> + + <para +>Automaatse lõpetamise saab välja lülitada dialoogi <menuchoice +><guimenu +>Seadistused</guimenu +><guisubmenu +>Kile seadistamine...</guisubmenu +> <guimenuitem +>LaTeX</guimenuitem +><guilabel +>Keskkonnad</guilabel +></menuchoice +> &latex;i sektsioonis.</para> + + <screenshot> + <screeninfo +>Võrrandikeskkonna lõpetamine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="snap_autocomplete.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Võrrandikeskkonna lõpetamine</phrase> + </textobject> + <caption +><para +>Võrrandikeskkonna lõpetamine</para +></caption> + </mediaobject> + </screenshot> + + </sect1> + + <sect1 id="complete_command"> + + <title +>&latex;i käsud</title> + + <para +>Mõned tähed kirjutanud, saab aktiveerida selle lõpetamistüübi &latex;i käskude ja tavaliste sõnade jaoks menüükäsuga <menuchoice +><guimenu +>Redigeerimine</guimenu +><guisubmenu +>Lõpetamine</guisubmenu +><guimenuitem +>(La)TeXi käsk</guimenuitem +></menuchoice +> või kiirklahviga <keycombo +>&Ctrl;<keycap +>Tühikuklahv</keycap +></keycombo +>. &kile; loeb kõigepealt tähed kursori asukohast vasakule ja peatub esimese mittetähe või längkriipsu juures. Kui alguses seisab längkriips, võtab &kile; kasutusele &tex;i või &latex;i käskude lõpetamise režiimi. Muul juhul võetakse kasutusele tavalise sõnaraamatu režiim, kust mõistagi &latex;i käske ei leia. Sõltuvalt režiimist avatakse lõpetamiskast. Seal näeb kõiki käske või sõnu, mis sobivad kirjutatud mustriga. Nimekirjas saab liikuda nooleklahvidega, vajalikule kirjele jõudes saab seda kasutada klahviga &Enter; või topeltklõpsuga.</para> + + <screenshot> + <screeninfo +>LaTeXi käsu lõpetamine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="complete_cmd1.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>LaTeXi käsu lõpetamine</phrase> + </textobject> + </mediaobject> + </screenshot> + + <para +>Kui vajutada klahvi &Backspace;, kustutatakse mustri viimane märk ja lõpetamisnimekiri võib pikeneda. Kui aga kirjutada veel üks märk, siis muster pikeneb ja pakutavade sõnade arv võib väheneda.</para> + + <para +>Kui ükski pakkumine sulle ei meeldi, saad dialoogist väljuda klahviga &Esc;.</para> + + <para +>Kastis on kõikidele käskudele lisatud nende parameetrite lühikirjeldus. Käsu valimisel neid loomulikult ei lisata. Soovi korral võib lasta &kile;l nende asemele täpid lisada, et saaksid neisse liikuda menüükäsuga <menuchoice +><guimenu +>Redigeerimine</guimenu +><guisubmenu +>Täpid</guisubmenu +><guimenuitem +>Järgmine täpp</guimenuitem +></menuchoice +> ja vajaliku parameetri sisestada.</para> + + <screenshot> + <screeninfo +>LaTeXi käsu lõpetamine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="complete_cmd2.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>LaTeXi käsu lõpetamine</phrase> + </textobject> + </mediaobject> + </screenshot> + + <para +>Nimekirjade seadistamiseks ava dialoog <menuchoice +><guimenu +>Seadistused</guimenu +><guisubmenu +>Kile seadistamine...</guisubmenu +> <guimenuitem +>Kile</guimenuitem +><guilabel +>Lõpetamine</guilabel +></menuchoice +>. Seal saab valida erinevaid sõnaloendeid &tex;i ja &latex;i käskude ning sõnaraamatuid tavaliste sõnade jaoks.</para +> + + </sect1> + + <sect1 id="complete_environment"> + + <title +>Keskkonnad</title> + + <para +><emphasis +>Käsurežiim</emphasis +> ei ole keskkondade lõpetamisel kuigi palju kasuks. Siis tuleb alati kirjutada mõned <userinput +>\begin</userinput +> tähed ning lõpetamisrežiimi väljakutsumine annab tulemuseks tohutu keskkonnasiltide nimekirja. Samas kasutatakse keskkondi nii sageli, et &kile; pakub spetsiaalse režiimi keskkondade lõpetmiseks. Ära mõtle algussildi peale ja kirjuta näiteks <userinput +>eq</userinput +>.</para +> + + <para +>Lõpetamisrežiimi menüükäsuga <menuchoice +><guimenu +>Redigeerimine</guimenu +><guisubmenu +>Lõpetamine</guisubmenu +><guimenuitem +>Keskkond</guimenuitem +></menuchoice +> või kiirklahviga <keycombo +>&Alt;<keycap +>Tühikuklahv</keycap +></keycombo +> välja kutsudes lisatakse automaatselt alustav silt, nii et sisestatu võtab kuju <userinput +>\begin{eq}</userinput +>. Pärast seda on lõpetamisnimekiri palju vähemate võimalustega.</para> + + <screenshot> + <screeninfo +>LaTeXi käsu lõpetamine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="complete_env1.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>LaTeXi käsu lõpetamine</phrase> + </textobject> + </mediaobject> + </screenshot> + + <para +>Nüüd vali keskkond ja näed, et see ka suletakse automaatselt. Veelgi enam, kui &kile; peab seda nimekirjakeskkonnaks, lisatakse ka esimene <userinput +>\item</userinput +> silt.</para> + + <screenshot> + <screeninfo +>LaTeXi käsu lõpetamine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="complete_env2.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>LaTeXi käsu lõpetamine</phrase> + </textobject> + </mediaobject> + </screenshot> + + <para +>Nimekirjade seadistamiseks vali <menuchoice +><guimenu +>Seadistused</guimenu +><guisubmenu +>Kile seadistamine...</guisubmenu +> <guimenuitem +>Kile</guimenuitem +><guilabel +>Lõpetamine</guilabel +></menuchoice +>. See režiim kasutab samu sõnade nimekirju nagu &tex;i ja &latex;i käskude lõpetamisrežiim.</para +> + + </sect1> + + <sect1 id="complete_abbreviation"> + + <title +>Lühendid</title> + + <para +>&kile; toetab kasutaja määratud lühendite nimekirju, mis asendatakse nõudmisel pikemate tekstistringidega. Nimekirjade seadistamiseks vali <menuchoice +><guimenu +>Seadistused</guimenu +><guisubmenu +>Kile seadistamine...</guisubmenu +> <guimenuitem +>Kile</guimenuitem +><guilabel +>Lõpetamine</guilabel +></menuchoice +>. Siin toodud näite puhul tuleb valida lühendite nimekiri <filename +>example.cwl</filename +>. Selles failis leidub näiteks kirje <userinput +>L=\LaTeX</userinput +>.</para> + + <para +>See tähendab, et sa võid kirjutada ainult <userinput +>L</userinput +>. Seejärel kutsu välja sõnalõpetamisrežiim menüükäsuga <menuchoice +><guimenu +>Redigeerimine</guimenu +><guisubmenu +>Lõpetamine</guisubmenu +><guimenuitem +>Lühend</guimenuitem +></menuchoice +> või kiirklahviga <keycombo +>&Ctrl;&Alt;<keycap +>Tühikuklahv</keycap +></keycombo +> ning täht <userinput +>L</userinput +> asendatakse stringiga <userinput +>LaTeX</userinput +>.</para> + + </sect1> + + <sect1 id="complete_auto"> + + <title +>Automaatse lõpetamise režiimid</title> + + <sect2 id="complete_autolatex"> + + <title +>&latex;i käsud</title> + + <para +>&latex;i käskude jaoks võib ka sisse lülitada automaatse lõpetamise. Kui kirjutad määratud arvu tähti (vaikimisi 3), ilmub hüpikaken, mis pakub kõiki sobivaid &latex;i käske. Võid nende seast valida vajaliku või neid eirata ja edasi kirjutada. Lõpetamiskastis leiduvad kirjed muutuvad vastavalt sellele, mida sa kirjutad.</para> + + <para +>Selle režiimi sisse- või väljalülitamiseks või täheläve muutmiseks vali <menuchoice +><guimenu +>Seadistused</guimenu +><guisubmenu +>Kile seadistamine...</guisubmenu +> <guimenuitem +>Kile</guimenuitem +><guilabel +>Lõpetamine</guilabel +></menuchoice +>.</para> + + <screenshot> + <screeninfo +>Võrrandikeskkonna lõpetamine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="config-complete.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Võrrandikeskkonna lõpetamine</phrase> + </textobject> + </mediaobject> + </screenshot> + + </sect2> + + <sect2 id="complete_autotext"> + + <title +>Dokumendi sõnad</title> + + <para +>Suured sõnaraamatud ei ole automaatse lõpetamise seisukohalt kuigi kasulikud. Aga mõnigi kord esineb teatud sõnu dokumendis palju kordi. Seepärast pakub &kile; võimalust lõpetada kõik sõnad, mis esinevad juba dokumendis.</para> + + <para +>Selle režiimi sisse- või väljalülitamiseks vali <menuchoice +><guimenu +>Seadistused</guimenu +><guisubmenu +>Kile seadistamine...</guisubmenu +> <guimenuitem +>Kile</guimenuitem +><guilabel +>Lõpetamine</guilabel +></menuchoice +>. Samas dialoogis saad muuta ka läve, mitme tähe kirjutamise järel pakutakse automaatse lõpetamise võimalust.</para> + + </sect2 +> + + </sect1> + + <sect1 id="complete_own_files"> + + <title +>Omaenda lõpetamisfailide kirjutamine</title> + + <para +>Lõpetamisfailide vormingu spetsifikatsiooni tutvustab lehekülg <ulink url="http://websvn.kde.org/*checkout*/tags/kile/2.0/src/README.cwl" +> CWL file format specification</ulink +>. </para> + + <para +>Lõpetamisfailid võib paigaldada kasutaja kodukataloogi alamkataloogi <filename +>~/.kde/share/apps/kile/complete/<režiim>/</filename +>, kus <parameter +><režiim></parameter +> on kas <constant +>abbreviation</constant +>, <constant +>dictionary</constant +> või <constant +>tex</constant +>. </para> + + </sect1> +</chapter> + +<chapter id="wizard"> + + <title +>Nõustajad ja dialoogid</title> + + <sect1 id="wizard_graphics"> + + <title +>Graafika kaasamine</title> + + <para +>Dialoog <guilabel +>Graafika kaasamine</guilabel +> muudab graafika lisamise võimalikult lihtsaks. Palun uuri osasid <xref linkend="build_graphics"/> ja <xref linkend="build_epsgraphics"/>, kus tutvustatakse mõningaid peamisi graafikavormingutega seotud asju.</para> + + <screenshot> + <screeninfo +>Graafilise elemendi kaasamine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="includegraphics.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Graafilise elemendi kaasamine</phrase> + </textobject> + </mediaobject> + </screenshot> + + <procedure> + <step +><para +>Vali graafikafail. See võib olla JPEG, PNG, EPS või isegi zipitud või gzipitud EPS-fail. Kui paigaldatud on <ulink url="http://www.imagemagick.org/" +>&imagemagick;</ulink +> ning &kile; on seadistatud seda kasutada (<menuchoice +><guimenu +>Seadistused</guimenu +><guisubmenu +>Kile seadistamine...</guisubmenu +> <guimenuitem +>LaTeX</guimenuitem +><guilabel +>Üldine</guilabel +></menuchoice +>), näidatakse automaatselt graafika laiust ja kõrgust. Kui &imagemagick; suudab kindlaks määrata lahutuse, näidatakse graafika suurust ka sentimeetrites.</para +></step> + + <step +><para +>Otsusta, kas pilt tuleb lehekülhel tsentreerida.</para +></step> + + <step +><para +>Vali kas traditsiooniline &latex; või &pdflatex;. Arvesta, et &pdflatex; võib luua ka DVI väljundi, mitte ainult PDF-i.</para +></step> + + <step +><para +>Vali, kas failinimi peaks olema suhteline. See on soovitatav, kui kasutad käsku <userinput +>\graphicspath</userinput +>.</para> + + <para +>Vaikimisi peavad graafikafailid olema samas kataloogis, kus asub põhidokument. Kuid vajaduse korral võib neid paigutada ka teistesse kataloogidesse. Ilma käsuta <userinput +>\graphicspath</userinput +> kaasab &kile; graafikafaili asukoha. Aga kui kasutad käsku <userinput +>\graphicspath</userinput +>, näiteks:</para> + +<programlisting +>\graphicspath{{/minu/graafika/asukoht}{teine/minu/graafika/asukoht}} +</programlisting> + + <para +>ja märgid selle valiku, kasutab &kile; ainult graafikafaili baasnime.</para> + + <para +>Teine näide: kui sinu käsk <userinput +>\graphicspath</userinput +> näeb välja nii:</para> + +<programlisting +>\graphicspath{{./}{kaamera/}{pildid/}} +</programlisting> + + <para +>otsib &latex; graafikafaili aktiivses kataloogis, seejärel kataloogis <filename +>kaamera</filename +> ja siis kataloogis <filename +>pildid</filename +>.</para +></step> + + <step +><para +>Laiust või kõrgust määrates skaleeritakse kogu graafika proportsionaalselt. Kui määrad nii laiuse kui ka kõrguse, võidakse laius ja kõrgus skaleerida erineva teguriga, mis ei pruugi olla soovitud tulemus. Vaata ka dialoogi ülaosas olevat teavet graafika originaalsuuruse kohta.</para +></step> + + <step +><para +>Määra nurk, mille võrra pöörata graafikat vastupäeva.</para +></step> + + <step +><para +>Ümbritsev kast lisatakse graafikafaili valimisel automaatselt. Seda läheb vaja ainult juhul, kui kasutad traditsioonilist &latex;i ja bittrastergraafikat. Vaata lähemalt osast <link linkend="build_epsgraphics" +>EPS graafika</link +>. </para +></step +> + + <step +><para +>Viimane valik puudutab seda, kas põimida graafika kujundi keskkonda. Kui otsustad seda teha, saad määrata ka pealdise ja tiitli. Hea mõte oleks anda igale tiitlitüübile erinev prefiks. Piltide levinud prefiks on <userinput +>fig:</userinput +>.</para +></step +> + </procedure> + + </sect1> + + <sect1 id="wizard_array"> + + <title +>Massiivinõustaja</title> + + <para +>Üks igavamaid asju, mida &latex;is teha, on tabelkeskkonnas maatriksit kirja pana. Selleks tuleb silm peal hoida kõigil elementidel, kontrollida, et keskkond on ikka õigesti vormindatud ja et kõik on seal, kus olema peab. Taanduse kasutamine tuleb siin kasuks, kuid on ka lihtsam meetod: &kile; menüü <guimenu +>_Nõustaja</guimenu +>. See sisaldab kirjeid <guimenuitem +>Tabel</guimenuitem +> ja <guimenuitem +>Massiiv</guimenuitem +> (kasutatakse matemaatikakeskkonnas). Neid valides saad maatriksikujulise sisendi, mille võid hõlpsasti täita vajalike väärtustega. Dialoogis saab määrata veel mõningad tabeli omadused.</para> + + <screenshot> + <screeninfo +>Tabelkeskkonna lisamine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="dialog-tabular.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Tabelkeskkonna lisamine</phrase> + </textobject> + </mediaobject> + </screenshot> + + <para +>Kirje <guimenuitem +>Tabbing</guimenuitem +> näitab lihtsamat menüüd tabbing-keskkonna loomiseks. Kõigis mainitud keskkondades saab määrata ridade ja veergude arvu ning veel mõned spetsiifilisemad omadused.</para> + </sect1> + + <sect1 id="wizard_postscript"> + + <title +>&postscript; abivahendid</title> + + <para +>PS-failid ei ole nii levinud kui PDF-failid, aga need sobivad suurepäraselt lehekülgede käitlemiseks ja ümberkorraldamiseks. Kui vajad PDF-i väljundit, võib leheküljed ümber korraldada mõne &postscript;i tööriistaga ja seejärel teisendada PDF-iks käsuga <command +>ps2pdf</command +>.</para> + + <para +><emphasis +>&postscript;i nõustaja</emphasis +> pakub välja mõned levinumad ümberkorraldused, aga sul on muidugi vabadus seda omal käel teha. Selleks kasutatakse programme <command +>pstops</command +> ja <command +>psselect</command +>, mida enamik distributsioone pakub paketis <userinput +>psutils</userinput +>. Kui üks neist pole saadaval, ei ole vastavat elementi näha.</para> + + <screenshot> + <screeninfo +>PSToolsi dialoog</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="dialog-pstools.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>PSToolsi dialoog</phrase> + </textobject> + </mediaobject> + </screenshot> + + <para +>Kõigepealt vali sisendfail. Kui &kile; leiab sinu põhidokumendile vastava PS-faili, on see juba lisatud sisendfailina, kuid sa võib muidugi valida ka mõne muu faili. Seejärel vali väljundfail ning mõni ülesanne. Viimaks tuleb otsustada, kas teha ainult teisendus või kutsuda tulemuse vaatamiseks välja ka &kghostview;.</para> + + <variablelist> + + <varlistentry> + <term +>1 A5 leht + tühi leht --> A4</term> + <listitem +><para +>Üks A5 leht koos ühe tühja lehega mahutatakse ühele A4 lehele. A5 lehtede liitmisel pööratakse neid 90 kraadi ning paigutatakse A4 lehele rõhtsalt.</para> + <screenshot> + <screeninfo +>A5 + tühi leht</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="psutils1.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>A5 + tühi leht</phrase> + </textobject> + </mediaobject> + </screenshot> + </listitem> + </varlistentry> + + <varlistentry> + <term +>1 A5 leht + duplikaat --> A4</term> + <listitem +><para +>Üks A5 leht ja duplikaat mahutatakse ühele A4 lehele.</para> + <screenshot> + <screeninfo +>Kaks A5 lehte</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="psutils2.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Kaks A5 lehte</phrase> + </textobject> + </mediaobject> + </screenshot> + </listitem> + </varlistentry> + + <varlistentry> + <term +>2 A5 lehte --> A4</term> + <listitem +><para +>Kaks järjestikust A5 lehte mahutatakse ühele A4 lehele.</para> + <screenshot> + <screeninfo +>Kahe A5 lehe liitmine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="psutils3.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Kahe A5 lehe liitmine</phrase> + </textobject> + </mediaobject> + </screenshot> + </listitem> + </varlistentry> + + <varlistentry> + <term +>2 A5L lehte --> A4</term> + <listitem +><para +>Kaks järjestikust rõhtpaigutusega A5 lehte mahutatakse ühele A4 lehele.</para +></listitem> + </varlistentry> + + <varlistentry> + <term +>4 A5 lehte --> A4</term> + <listitem +><para +>Neli järjestikust A5 lehte mahutatakse ühele A4 lehele. A5 lehed tuleb mahutamiseks skaleerida teguriga 0,7.</para> + <screenshot> + <screeninfo +>4 A5 lehte --> A4</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="psutils5.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>4 A5 lehte --> A4e</phrase> + </textobject> + </mediaobject> + </screenshot> + </listitem> + </varlistentry> + + <varlistentry> + <term +>1 A4 leht + tühi leht --> A4</term> + <listitem +><para +>Üks A4 leht ja üks tühi leht mahutatakse ühele A4 lehele. Kui kaks A4 lehte mahutatakse ühele A4 lehele, skaleeritakse neid teguriga 0,7 ning paigutatakse püstiselt.</para> + <screenshot> + <screeninfo +>1 A4 leht + tühi leht --> A4</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="psutils6.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>1 A4 leht + tühi leht --> A4i</phrase> + </textobject> + </mediaobject> + </screenshot> + </listitem> + </varlistentry> + + <varlistentry> + <term +>1 A4 leht + duplikaat --> A4</term> + <listitem +><para +>Üks A4 leht ja duplikaat mahutatakse ühele A4 lehele.</para> + <screenshot> + <screeninfo +>1 A4 leht + duplikaat --> A4</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="psutils7.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>1 A4 leht + duplikaat --> A4</phrase> + </textobject> + </mediaobject> + </screenshot> + </listitem> + </varlistentry> + + <varlistentry> + <term +>2 A4 lehte --> A4</term> + <listitem +><para +>Kaks järjetikust A4 lehte mahutatakse ühele A4 lehele.</para> + <screenshot> + <screeninfo +>Kahe A4 lehe liitmine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="psutils8.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Kahe A4 lehe liitmin</phrase> + </textobject> + </mediaobject> + </screenshot> + </listitem> + </varlistentry> + + <varlistentry> + <term +>2 A4L lehte --> A4</term> + <listitem +><para +>Kaks järjestikust rõhtpaigutusega A4 lehte mahutatakse ühele A4 lehele.</para +></listitem> + </varlistentry> + + <varlistentry> + <term +>Paarislehekülgede valik</term> + <listitem +><para +>Valitakse dokumendi kõik paarisleheküljed.</para +></listitem> + </varlistentry> + + <varlistentry> + <term +>Paaritute lehekülgede valik</term> + <listitem +><para +>Valitakse dokumendi kõik paaritud leheküljed.</para +></listitem> + </varlistentry> + + <varlistentry> + <term +>Paarislehekülgede valik (tagurpidi)</term> + <listitem +><para +>Valitakse dokumendi kõik paarisleheküljed tagurpidi järjekorras.</para +></listitem> + </varlistentry> + + <varlistentry> + <term +>Paaritute lehekülgede valik (tagurpidi)</term> + <listitem +><para +>Valitakse dokumendi kõik paarisleheküljed tagurpidi järjekorras.</para +></listitem> + </varlistentry> + + <varlistentry> + <term +>Kõik leheküljed tagurpidi</term> + <listitem +><para +>Kõik dokumendi leheküljed tagurpidi.</para +></listitem> + </varlistentry> + + <varlistentry> + <term +>Kõigi lehekülgede kopeerimine (sorteeritud)</term> + <listitem +><para +>Kopeeritakse dokumendi kõik leheküljed. Valida tuleb sorteeritud koopiate arv.</para> + <screenshot> + <screeninfo +>Kõigi lehekülgede kopeerimine (sorteeritud)</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="psutils15.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Kõigi lehekülgede kopeerimine (sorteeritud)</phrase> + </textobject> + </mediaobject> + </screenshot> + </listitem> + </varlistentry> + + <varlistentry> + <term +>Kõigi lehekülgede kopeerimine (sorteerimata)</term> + <listitem +><para +>Kopeeritakse dokumendi kõik leheküljed. Valida tuleb sorteerimata koopiate arv.</para> + <screenshot> + <screeninfo +>Kõigi lehekülgede kopeerimine (sorteerimata)</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="psutils16.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Kõigi lehekülgede kopeerimine (sorteerimata)</phrase> + </textobject> + </mediaobject> + </screenshot> + </listitem> + </varlistentry> + + <varlistentry> + <term +>pstops: parameetri valik</term> + <listitem +><para +>&postscript;i tööriistadel <command +>pstops</command +> ja <command +>psselect</command +> on hulk valikuid. Kui vajad neist mõnda, tuleb <command +>pstops</command +> välja kutsuda vajaliku võtmega. Võtmeid tutvustavad programmi manuaalileheküljed.</para +></listitem> + </varlistentry> + + <varlistentry> + <term +>psselect: parameetri valik</term> + <listitem +><para +>Käsu <command +>psselect</command +> võib välja kutsuda mõne vajaliku võtmega. Võtmeid tutvustavad programmi manuaalileheküljed.</para +></listitem> + </varlistentry> + + </variablelist> + + </sect1> + + <sect1 id="statistics" +> + <title +>Dokumendi statistika</title> + + <para +>Statistikadialoog annab ülevaate valikust, dokumendist või kogu projektist. See näitab sõnade arvu ning &latex;i käske ja keskkondi, samuti iga tüübi märkide arvu. Statistikat võib kopeerida tekstina või kenasti vormindatud &latex;i tabelina lõikepuhvrisse. Kui soovid näha kogu projekti statistikat, saad käsuga <menuchoice +><guimenu +>Fail</guimenu +><guisubmenu +>Ava kõik projekti failid</guisubmenu +></menuchoice +> hõlpsasti ja kiiresti avada kõik oma projekti lähtefailid.</para> + <para +>Arvude täpsust tuleb siiski võtta reservatsioonidega. Me kasutame usaldusväärse hinnangu saamiseks teatud loogikat, näiteks K\"uhler tähendab üht sõna ja üht käsku vastavalt kuue ja kahe märgiga. Kuid võib ette tulla kombinatsioone, mille korral käsu osi peetakse sõnadeks ja vastupidi. Samuti tuleb meeles pidada, et algoritm on välja töötatud ja testitud selliste keelte peal, mis sarnanevad inglise või saksa keelele. Seepärast ei tohiks arve pidada absoluutselt tõeseks. Kui pead koostama aruande, kus tuleb ära märkida sõnade või märkide täpne arv, tasuks eelnevalt testida, kas &kile; suudab neid ikka usaldusväärselt kokku lugeda.</para> + </sect1> + +</chapter> + +<chapter id="latex"> + + <title +>&latex;i erisildid</title> + + <sect1 id="latex_library"> + <title +>&latex;i siltide kasutamine</title> + + <para +>&latex; pakub sadu silte, mida saab lisada sümbolite ja erimärkide tähistamiseks. Lihtsaim viis erimärki lisada on kasutada külgriba menüüd vasakul pool redaktoriakent.</para> + + <screenshot> + <screeninfo +>Külgriba menüü</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="snap_sidebarmenu.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Külgriba menüü</phrase> + </textobject> + <caption +><para +>Külgriba menüü</para +></caption> + </mediaobject> + </screenshot> + <para +>Kasutada saab järgmisi tüüpe:</para> + + <itemizedlist> + <listitem +><para +>Enimkasutatud</para +></listitem> + <listitem +><para +>Seos</para +></listitem> + <listitem +><para +>Operaatorid</para +></listitem> + <listitem +><para +>Nooled</para +></listitem> + <listitem +><para +>Mitmesugused matemaatikasümbolid</para +></listitem> + <listitem +><para +>Mitmesugused tekstisümbolid</para +></listitem> + <listitem +><para +>Piiritlejad</para +></listitem> + <listitem +><para +>Kreeka</para +></listitem> + <listitem +><para +>Võõrtähed</para +></listitem> + <listitem +><para +>Kirillitsa</para +></listitem> + <listitem +><para +>Kasutaja määratud</para +></listitem> + </itemizedlist> + <para +>Ikoonide kohtspikrid näitavad &latex;i käske ja vajalikke lisapakette.</para> + <para +>Kui vajutada klahvi <keycombo +>&Shift;</keycombo +> ja klõpsata sümbolil, lisatakse <userinput +>$\symbolcmd$</userinput +>. Kui teha sama klahviga <keycombo +>&Ctrl;</keycombo +>, lisatakse see looksulgudes.</para> + <para +>Kui lisad käsu, mis vajab paketti, mida sinu &latex;i dokumendis ei leidu, näidatakse logivaates hoiatust.</para> + <para +>Esimene sümbolite nimekiri sisaldab <guilabel +>enimkasutatud</guilabel +> sümboleid. Lisatud sümbolid lisatakse kiireks ja hõlpsaks kasutamiseks just sellesse nimekirja. Uute sümbolite lisamisel ei muudeta sümbolite järjekorda, küll aga loendurit. Kui elementide arv ületab 30, eemaldatakse kõige väiksema esinemisarvuga element.</para> + <para +><guilabel +>Kasutaja määratud</guilabel +> sümbolite nimekirjas on sinu enda sümbolid. Oma sümbolite loomiseks on vaja programmi gesumb ja faili definitions.tex Kile lähtepaketis. Lisaks on vajalikud &latex;i kompilaator ja <ulink url="http://www.dvipng.sourceforge.net" +>&dvipng;</ulink +> (versioon 1.7 või uuem). Seejärel tuleb luua &latex;i fail käsuga <userinput +>\input{definitions}</userinput +>, mis muudab kättesaadavaks allpool toodud käsud, ning lasta käsuga <userinput +>gesymb mysymbols.tex user</userinput +> (see kutsub välja &latex;i ja &dvipng;) luua ikoonid. Kui need nüüd kopeerida asukohta <userinput +>$HOME/.kde/share/apps/kile/mathsymbols/user/</userinput +> ja Kile taaskäivitada, saadki oma sümboleid kasutada. </para> + <para +>Järgmised käsud on defineeritud failis definitions.tex: <itemizedlist> + <listitem> + <para +><userinput +>\command[\optarg]{\symbol}</userinput +>: sümboli <userinput +>\symbol</userinput +> lisamine sümbolite nimekirja, lisaargument <userinput +>\optarg</userinput +> määrab käsu, mille Kile peab lisama. Kui seda pole antud, kasutatakse käsku kohustuslikus argumendis. </para> + </listitem> + <listitem> + <para +><userinput +>\mathcommand[\optarg]{\symbol}</userinput +>: sama, mis eespool, ainult et käsk kohustuslikus argumendis lisatakse matemaatikarežiimis. </para> + </listitem> + <listitem> + <para +><userinput +>\pkgs[arg]{pkg}</userinput +>: deklareerib, et antud real antud käsk vajab &latex;i paketti <userinput +>pkg</userinput +> lisaargumendiga <userinput +>arg</userinput +>. See käsk peab seisma käsu <userinput +>\command</userinput +> ees ja tühistab kõik neededpkgs keskkonna määratud paketid. </para> + </listitem> + <listitem> + <para +><userinput +>\begin{neededpkgs}[pkgs-args]{pkgs} ... \end{neededpkgs}</userinput +>: sama, mis eespool, aga kõigi suletud käskude jaoks. </para> + </listitem> + </itemizedlist> + </para> + <para +>Toome siin ühe täieliku näite: <screen +><userinput> + \documentclass[a4paper,10pt]{article} + \usepackage{amssymb} + \input{definitions} + % + \begin{document} + \pagestyle{empty} + % + \begin{neededpkgs}{amssymb} + \mathcommand{\surd} + \pkgs{amsmath}\mathcommand[\ddddot{}]{\ddddot{a}} + \mathcommand{\angle} + \end{neededpkgs} + \command{\"A} + \mathcommand{\exists} + \mathcommand[\stackrel{}{}]{\stackrel{abc}{=}} + + %\begin{neededpkgs}[russian,koi8-r,T2C,]{babel,inputenc,fontenc,mathtext} + % + % \end{neededpkgs} + % this would need to include the packages + % \usepackage{mathtext} + % \usepackage[T2C]{fontenc} + % \usepackage[russian]{babel} + % \usepackage[koi8-r]{inputenc} + % just to explain the format + \end{document} + </userinput +></screen> + </para> + </sect1> + + <sect1 id="latex_bib"> + + <title +>Biblioelementide kasutamine</title> + + <para +><userinput +>\bibitem</userinput +> on käsk, mis viitab, et dokumendis on kasutusel <userinput +>thebibliography</userinput +>. Käsu <userinput +>\bibitem</userinput +> süntaks on <userinput +>\bibitem[pealdis]{võti}</userinput +>.</para> + + <para +>Võti <userinput +>[pealdis]</userinput +> võimaldab sul lisada bibliograafiakirjele omaenda pealdiste süsteemi. Kui seda ei ole määratud, seatakse kirjed arvulisse järjekorda: [1], [2], [3] jne.</para> + + <para +>Argumenti <userinput +>{võti}</userinput +> kasutatakse viitamiseks ja käskude <userinput +>\bibitem</userinput +> ning <userinput +>\cite</userinput +> linkimiseks üksteise ning neis leiduva infoga. Käsk <userinput +>\cite</userinput +> sisaldab pealdist, mis on seotud käsuga <userinput +>\bibitem</userinput +>, mis asub keskkonnas <userinput +>thebibliography</userinput +> ja sisaldab viiteandmeid. Nii <userinput +>\bibitem</userinput +> kui <userinput +>\cite</userinput +> peab sisaldama sama <userinput +>{võti}</userinput +>t. Kõige hõlpsam on võtmeid mõistagi korraldada autori perekonnanime järgi. Sekundaarsed suludkäsus <userinput +>{thebibliography}</userinput +> tähistavad pikimat bibliograafiapealdist, mis sul võib olla. Nii võib <userinput +>{<replaceable +>suva</replaceable +>}</userinput +> lisamisel pealdis olla maksimaalselt <userinput +><replaceable +>suva</replaceable +></userinput +> pikkune. Kui seda parameetrit korrektselt ei määrata, ei pruugi bibliograafia kuigi atraktiivne välja näha.</para> + + <para +>Bibliograafia seisab peadokumendist eraldi, selle näidiskood võib olla selline:</para> + + <screen +><userinput> + \begin{thebibliography}{50} + \bibitem{Simpson} Homer J. Simpson. \textsl{Mmmmm...donuts}. + Evergreen Terrace Printing Co., Springfield, SomewhereUSA, 1998 + \end{thebibliography)</userinput +></screen> + + <para +>Oletame nüüd, et sinu põhilähtetekstis leidub info, mida seob käsuga <userinput +>\bibitem</userinput +> käsk <userinput +>\cite</userinput +>. Lähtetekst näeb siis välja selline:</para> + + <screen +><userinput> + Minu töö aluseks Simpsonite\copyright filosoofia kohta + on mu lemmikraamat \cite{Simpson}.</userinput +></screen> + + <para +>Paljude viidete korral on sageli raske meeles hoida täpset tsitaadivõtit, mistõttu &kile; pakub välja hõlpsa võimaluse tsitaadi lisamiseks. Klõpsa <guilabel +>redigeerimisriba</guilabel +>l teisele hüpikkastile (tavaliselt seisab seal <guilabel +>pealdis</guilabel +>) ja vali <guilabel +>tsitaat</guilabel +>. Ilmub nähtavale kõigi tsitaadivõtmete loend, kust saab valida vajaliku viite ning tsitaadikirje lisataksegi dokumenti. Võtmete loendi uuendamiseks salvesta fail või vali menüükäsk <menuchoice +><guimenu +>Redigeerimine</guimenu +><guimenuitem +>Värskenda struktuuri</guimenuitem +></menuchoice +> või vajuta klahvi <keycap +>F12</keycap +>.</para> + + <para +>Sinu dokumendi bibliograafia näeb lõpuks välja siis selline:</para> + + <para +><computeroutput +>[1] Homer J. Simpson. Mmmmm...donuts. Evergreen Terrace Printing Co., Springfield, SomewhereUSA, 1998.</computeroutput +></para> + + <para +>Lihtsaim viis käskude <userinput +>\bibitem</userinput +> ja <userinput +>\cite</userinput +> kasutamiseks on tööriistariba rippmenüü kirjaga <guilabel +>tsitaat</guilabel +>. Kui soovid lisada tsitaadi, pakutakse sulle seni loodud <userinput +>bibitem</userinput +>-ite loendit, millest võid valida vajaliku. &kile; suudab nüüd ka töötada käsikäes &bibtex;i redaktoritega, näiteks &kbibtex;, mis muudab tsiteerimise märgatavalt hõlpsamaks.</para> + + </sect1> + + <sect1 id="latex_usertags"> + + <title +>Kasutaja määratud sildid</title> + + <para +>&kile; võimaldab sul luua oma silte. Silt on põhimõtteliselt kiirkorraldus, mis käivitab mingi käsu või kirjutab sinu eest sageli ettetuleva teksti. Oletame näiteks, et Julius Sarvik kasutab sageli väljendeid <userinput +>Ma eelistan \LaTeX\it \TeX\ile</userinput +> ja <userinput +>Mida ma küll hakkaksin peale Linuxita?</userinput +> Kasutaja määratud siltide loomiseks, mis paneks Juliuse eest need fraasid kirja, tuleb tal valida menüükäsk <menuchoice +><guimenu +>LaTeX</guimenu +><guisubmenu +>Kasutaja sildid</guisubmenu +><guimenuitem +>Redigeeri kasutaja silte...</guimenuitem +></menuchoice +> See avab dialoogi, kus Julius saabki luua just selliseid silte, mida tal vaja läheb.</para> + <screenshot> + <screeninfo +>Kasutaja siltide redigeerimise dialoog</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="snap_editusertag.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Kasutaja siltide redigeerimise dialoog</phrase> + </textobject> + <caption +><para +>Kasutaja siltide redigeerimise dialoog</para +></caption> + </mediaobject> + </screenshot> + + <screenshot> + <screeninfo +>Kasutaja määratud sildi sisestamine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="snap_usertag.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Kasutaja määratud sildi sisestamine</phrase> + </textobject> + <caption +><para +>Kasutaja määratud sildi sisestamine</para +></caption> + </mediaobject> + </screenshot> + + <para +>Oma kahe sildi loomiseks, mida kirjutamisel sageli vaja läheb, annab Julius neile selgelt eristava nime. Sildile antav nimi tuleb sisestada sektsiooni <guilabel +>Menüükirje</guilabel +>, vastav tekst aga sektsiooni <guilabel +>Väärtus</guilabel +>. Kui vajalikud andmed on sisestatud, võib neid silte kasutada kiirklahvidega <keycombo +>&Ctrl;&Shift;<keycap +>1</keycap +></keycombo +>, mis lisab esimese sildi teksti <userinput +>Ma eelistan \LaTeX\it \TeX\ile</userinput +>, ning <keycombo +>&Ctrl;&Shift; <keycap +>2</keycap +></keycombo +>, mis lisab teise sildi teksti <userinput +>Mida ma küll hakkaksin peale Linuxita?</userinput +></para> + + <sect2 id="latex_usertags_uc"> + + <title +>Kohanäitajad kasutaja määratud siltides</title> + + <para +>Kasutaja määratud siltides saab pruukida mõningaid kohanäitajaid: <userinput +>%B</userinput +>, <userinput +>%C</userinput +>, <userinput +>%M</userinput +> ja <userinput +>%S</userinput +>.</para> + + <itemizedlist> + <listitem +><para +><userinput +>%B</userinput +>: asendatakse täpiga.</para +></listitem> + <listitem +><para +><userinput +>%C</userinput +>: sinna viiakse kursor pärast kasutaja määratud sildi lisamist.</para +></listitem> + <listitem +><para +><userinput +>%M</userinput +> tähistab märgitud teksti; valitud tekst lisatakse kasutaja määratud siltide tarvitamisel selle asemele.</para +></listitem> + <listitem +><para +><userinput +>%S</userinput +>: asendab lähtefaili nime (ilma laiendita).</para +></listitem> + </itemizedlist> + + <para +>Selgitamaks, kuidas see toimib, oletame, et mul on kasutaja määratud silt väärtusega <userinput +>\bfseries{%M}%C</userinput +> ning ma olen dokumendis ära märkinud teksti, mille tahan panna rasvasesse kirja. Seega tõstan esile fraasi <userinput +>Ma armastan reedet</userinput +>, lisan kasutaja määratud sildi, vajutades <keycombo +>&Ctrl;&Shift;<keycap +>1</keycap +></keycombo +> ning tulemuseks on fraas <userinput +>\bfseries{Ma armastan reedet}</userinput +>, kusjuures kursor asetseb fraasi lõpus.</para> + + </sect2> + + </sect1> + +</chapter> + +<chapter id="build"> + + <title +>Ehitamistööriistad</title> + + <sect1 id="build_sect"> + + <title +>Kompileerimine, teisendamine ja vaatamine</title> + + <para +>Oma töö tulemuste nägemiseks tuleb kõigepealt lähtetekst kompileerida. Kõik ehitamisvahendid asuvad ilusasti üksteise kõrval menüüs: <menuchoice +><guimenu +>Ehitamine</guimenu +><guisubmenu +>Kompileeri</guisubmenu +></menuchoice +>, <menuchoice +><guimenu +>Ehitamine</guimenu +><guisubmenu +>Teisenda</guisubmenu +></menuchoice +>, and <menuchoice +><guimenu +>Ehitamine</guimenu +><guisubmenu +>Vaata</guisubmenu +></menuchoice +></para> + + <para +>Lähtekoodi kompileerimiseks ekraaninäitajate tarbeks, nagu &kdvi;, &kghostview;, &kpdf;, või edasiseks teisendamiseks saab kasutada kiirklahvi <keycombo +>&Alt;<keycap +>2</keycap +></keycombo +>. Seejärel võib vaadata DVI-faili vaikenäitajas kiirklahviga <keycombo +>&Alt;<keycap +>3</keycap +></keycombo +>, teisendada DVI-faili PS-failiks kiirklahviga <keycombo +>&Alt;<keycap +>4</keycap +></keycombo +> ning vaadata PS-faili kiirklahviga <keycombo +>&Alt;<keycap +>5</keycap +></keycombo +>.</para> + + <sect2> + + <title +>&bibtex;</title> + + <para +>Kui sul on bibliokirjete tarbeks kasutusel <ulink url="http://www.ecst.csuchico.edu/~jacobsd/bib/formats/bibtex.html" +>&bibtex;</ulink +>, tuleb enamasti järgida spetsiaalset kompileerimismudelit. See tähendab, et välja tuleb kutsuda &latex; ja siis &bibtex; ja siis veel kakskorda &latex;. Õnneks on &kile; piisavalt nutikas ja oskab automaatselt tuvastada, kas on vaja välja kutsuda selliseid lisatööriistu, nagu &bibtex;, &makeidx; ja &asymptote;. See on nii vähemalt vaikimisi, kuigi seda saab ka muuta, kui valida <menuchoice +><guimenu +>Seadistused</guimenu +><guisubmenu +>Kile seadistamine...</guisubmenu +><guisubmenu +>Tööriistad</guisubmenu +><guilabel +>Ehitamine</guilabel +></menuchoice +> kaardil <guilabel +>Üldine</guilabel +> &latex;i ja &pdflatex;i tööriistad. </para> + + </sect2> + + <sect2> + + <title +>&makeidx;</title> + + <para +>Kui kasutad oma dokumendile tähestikule indeksi loomiseks tööriista <ulink url="http://ipagwww.med.yale.edu/latex/makeindex.pdf" +>&makeidx;</ulink +>, tuleks samuti kasutada järgmist spetsiaalset kompileerimisvõimalust või lasta &kile;l see ära teha samamoodi, nagu see on võimalik &bibtex;i failide puhul</para> + + </sect2> + + <sect2> + + <title +>MetaPost ja Asymptote</title> + + <para +>Kui soovid kompileerida oma dokumendi pildijoonistamisrakendusega <application +>MetaPost</application +> või <application +>Asymptote</application +>, saab seda teha menüükäsuga <menuchoice +><guimenu +>Ehitamine</guimenu +><guisubmenu +>Kompileeri</guisubmenu +><guimenuitem +>Metapost</guimenuitem +></menuchoice +> või <menuchoice +><guimenu +>Ehitamine</guimenu +><guisubmenu +>Muu</guisubmenu +><guimenuitem +>Asymptote</guimenuitem +></menuchoice +>.</para> + + </sect2> + + <sect2> + + <title +>&pdflatex;</title> + + <para +>Dokumenti saab veel ühel moel kompileerida, kui soovid saada PDF-faili: käivita &pdflatex;, mis kompileerib lähteteksti otse PDF-failiks, kiirklahviga <keycombo +>&Alt;<keycap +>6</keycap +></keycombo +>. Seejärel võib kompileeritud faili vaadata kiirklahviga <keycombo +>&Alt;<keycap +>7</keycap +></keycombo +>.</para> + + <para +>Teine võimalus on teisendada PS-fail PDF-failiks kiirklahviga <keycombo +>&Alt;<keycap +>8</keycap +></keycombo +> või DVI-fail otse PDF-failiks kiirklahviga <keycombo +>&Alt;<keycap +>9</keycap +></keycombo +>.</para> + + <para +>&pdflatex;i eelistamine &latex;ile võib olla lihtsuse või harjumuse küsimus, kuid kohati on kahe programmi käitumine üpris erinev.</para> + + </sect2> + + <sect2> + + <title +>&latex; veebis</title> + + <para +>Sul võib olla ka soov avaldada oma töö veebis, mitte aga paberil. Selleks saab kasutada programmi <application +>latex2html</application +>, mille saab käivitada &kile; menüükäsuga <menuchoice +><guimenu +>Ehitamine</guimenu +><guisubmenu +>Teisendamine</guisubmenu +><guimenuitem +>LaTeX -> HTML</guimenuitem +></menuchoice +>. Tulemus asetatakse sinu töökataloogi alamkataloogi, teisenduse saadust võid näha menüükäsuga <menuchoice +><guimenu +>Ehitamine</guimenu +><guisubmenu +>Vaatamine</guisubmenu +><guimenuitem +>Vaata HTML-i</guimenuitem +></menuchoice +>.</para> + + </sect2> + + <sect2 id="build_cl"> + + <title +>Käsurea parameetrid</title> + + <para +>Võib juhtuda, et soovid anda töövahenditele oma failide kompileerimiseks, teisendamiseks või vaatamiseks mõningaid spetsiaalseid käsureaparameetreid. Standardseid tööriistu saab seadistada menüükäsuga <menuchoice +><guimenu +>Seadistused</guimenu +> <guisubmenu +>Kile seadistamine...</guisubmenu +><guisubmenu +>Tööriistad</guisubmenu +><guilabel +>Ehitamine</guilabel +></menuchoice +></para> + + </sect2> + + </sect1> + + <sect1 id="build_preview"> + <title +>Kiire eelvaatlus</title> + + <para +>&latex;iga töötades tuleb alati leida aega oma töö tulemuse uurimiseks. &latex; peab kompileerima lähteteksti ning välja kutsuma dokumendi näitaja. See võib olla tülikas, kui oled muutnud näiteks ainult mõnda tähte võrrandis. &kile; pakub selleks välja <emphasis +>kiire eelvaatluse</emphasis +> režiimi, kus kompileeritakse ainult osa dokumendist, mis säästab tublisti aega. Toetatud on neli erinevat režiimi, mida saab omavahel kombineerida seitsme seadistusega.</para +> + + <screenshot> + <screeninfo +>Kiire eelvaatlus</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="quickpreview.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Kiire eelvaatlus</phrase> + </textobject> + </mediaobject> + </screenshot> + + <para +>Kõiki seadistusi saab määrata ja muuta, kui valida <menuchoice +><guimenu +>Seadistused</guimenu +><guimenuitem +>Kile seadistamine...</guimenuitem +> <guimenuitem +>Tööriistad</guimenuitem +><guilabel +>Eelvaatlus</guilabel +></menuchoice +></para> + + <screenshot> + <screeninfo +>Kiire eelvaatluse seadistamine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="config-quickpreview.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Kiire eelvaatluse seadistamine</phrase> + </textobject> + </mediaobject> + </screenshot> + + <sect2 id="build_qp_selection"> + + <title +>Valimise režiim</title> + + <para +>Kasutajal tuleb valida dokumendi osa. Valitud programmid käivitab menüükäsk <menuchoice +><guimenu +>Ehitamine</guimenu +><guisubmenu +>Kiire eelvaatlus</guisubmenu +><guimenuitem +>Valik</guimenuitem +></menuchoice +> või kiirklahv <keycombo action="simul" +>&Ctrl;&Alt;<keycap +>P</keycap +></keycombo +>, <keycap +>S</keycap +>. &kile; kasutab originaalteksti preambulat, mistõttu peavad olema kaasatud kõik paketid ja kasutaja määratud käsud. Kasutaja saab valida seitsme eelnevalt määratud seadistuse vahel:</para> + + <itemizedlist> + <listitem +><para +><application +>LaTeX+DVI (põimitud näitaja)</application +></para +></listitem> + <listitem +><para +><application +>LaTeX+DVI (KDVI)</application +></para +></listitem> + <listitem +><para +><application +>LaTeX+PS (põimitud näitaja)</application +></para +></listitem> + <listitem +><para +><application +>LaTeX+PS (KGhostView)</application +></para +></listitem> + <listitem +><para +><application +>PDFLaTeX+PDF (põimitud näitaja)</application +></para +></listitem> + <listitem +><para +><application +>PDFLaTeX+PDF (KGhostView)</application +></para +></listitem> + <listitem +><para +><application +>PDFLaTeX+PDF (KPDF)</application +></para +></listitem> + </itemizedlist> + + <para +>Sellest peaks piisama kõigiks juhtumiteks, kus läheb vaja kiiret eelvaatlust.</para> + + </sect2> + + <sect2 id="build_qp_environment"> + + <title +>Keskkonnarežiim</title> + + <para +>Sageli võib vaja olla aktiivse keskkonna, eriti matemaatikakeskkonna eelvaatlust, mida on mõnigi kord keeruline kirja panna. &kile; võimaldab seda väga kiiresti. Valikut polegi vaja, vali lihtsalt menüükäsk <menuchoice +><guimenu +>Ehitamine</guimenu +><guisubmenu +>Kiire eelvaatlus</guisubmenu +><guimenuitem +> Keskkond</guimenuitem +></menuchoice +> või kasuta kiirklahvi <keycombo action="simul" +>&Ctrl;&Alt;<keycap +>P</keycap +></keycombo +>,<keycap +>E</keycap +> ning aktiivne keskkond kompileeritaksegi ja kuvatakse.</para> + + </sect2> + + <sect2 id="build_qp_subdocument"> + + <title +>Alamdokumendi režiim</title> + + <para +>Kui sul on paljude dokumentidega suurem projekt, ei ole kogu projekti kompileerimine arvatavasti kuigi hea mõte, kui oled teinud muudatusi ainult ühes dokumendis. &kile; võib kompileerida ja eelvaatlusena kuvada ka aktiivset alamdokumenti. Preambul võetakse põhidokumendist ning kompileeritakse ainult aktiivne osa, kui valid menüükäsu <menuchoice +><guimenu +>Ehitamine</guimenu +><guisubmenu +>Kiire eelvaatlus</guisubmenu +><guimenuitem +>Alamdokument</guimenuitem +></menuchoice +> või kiirklahvi <keycombo action="simul" +>&Ctrl;&Alt;<keycap +>P</keycap +></keycombo +>,<keycap +>D</keycap +>.</para +> + + </sect2> + + <sect2 id="build_qp_mathgroup"> + + <title +>Matemaatikagrupi režiim</title> + + <para +>Matemaatikagrupi eelvaatluse režiim võimaldab näha parajasti redigeeritavat matemaatikagruppi. &kile; võtab preambuli põhidokumendist ning kompileerib ainult matemaatikagrupi, milles asub parajasti kursor, kui valid menüükäsu <menuchoice +><guimenu +>Ehitamine</guimenu +><guisubmenu +>Kiire eelvaatlus</guisubmenu +><guimenuitem +>Matemaatikagrupp</guimenuitem +></menuchoice +> või kiirklahvi <keycombo action="simul" +>&Ctrl;&Alt;<keycap +>P</keycap +></keycombo +>,<keycap +>M</keycap +>.</para +> + + </sect2> + + <sect2 id="qp_bottombar"> + + <title +>Kiire eelvaatlus allribal</title> + + <para +>Selle asemel et näidata eelvaatlust uues dokumendis, võib &kile; panna kasutama eelvaatluse näitamiseks ka allriba. Selle valiku saab sisse lülitada kiire eelvaatluse seadistustes.</para +> + + </sect2> + + </sect1 +> + + <sect1 id="build_graphics"> + + <title +>Graafikafaili vormingud</title> + + <sect2 id="build_graphics_latex"> + + <title +>&latex; ja &pdflatex;</title> + + <para +>Pane tähele, et &pdflatex; suudab pakettide <userinput +>graphics</userinput +> või <userinput +>graphicx</userinput +> kasutamisel kompileerida korrektselt PDF-faili PNG- ja JPG-failid, aga mitte EPS-failid. Ja vastupidi, kompileerimine DVI-failiks ning teisendamine PS- või PDF-failiks toetab EPS-ide kasutamist, aga mitte PNG- ja JPG-faile.</para +> + + <para +>Paljud kasutajad soovivad luua PDF-dokumente, aga samas kasutada ka suurepärast paketti <application +>Pstricks</application +> &postscript;i graafika loomiseks või siis selliste matemaatika- ja teadusrakenduste nagu <application +>Mathematica</application +>, <application +>Maple</application +> või <application +>MuPAD</application +> &postscript;i väljundit. Sellised &latex;i kasutajad peavad kõigepealt kompileerima &postscript;i, isegi kui nad soovivad luua PDF-dokumendi, sest need rakendused loovad sellise &postscript;i koodi, millega &pdflatex; ei oska midagi peale hakata. Kuid see pole nii raske, kui esialgu võib tunduda, sest sind abistab siin &kile;.</para> + + </sect2> + + <sect2 id="build_graphics_conversion"> + + <title +>Graafika teisendamine</title> + + <para +>Selle kurvastava asjaolu lahendamiseks ning nii EPS- kui ka PNG- ja JPG-failide kaasamiseks &postscript;i koodi kõrval on mitu võimalust:</para> + + <itemizedlist> + <listitem +><para +>Kui sul on vaja faili PS-vormingus, kuid JPG- või PNG-failidega, võid lihtsalt kasutada kõigepealt &pdflatex;it DVI väljundiga ja seejärel programmi <application +>dvips</application +> Ps-faili loomiseks. Nagu näed, on &pdflatex; väga hea valik, kui sinu lähtetekst ei sisalda üldse &postscript;i koodi.</para +></listitem> + + <listitem +><para +>EPS-failid on võimalik teisendada PNG või mõnesse muusse vormingusse näiteks rakendusega <ulink url="http://www.gimp.org/" +><application +>Gimp</application +></ulink +> või <ulink url="http://www.imagemagick.org/" +>&imagemagick;</ulink +> ning seejärel kasutada &pdflatex;it.</para +></listitem> + + <listitem +><para +><anchor id="build_graphics_epstopdf" +></anchor +>Soovitatav on teisendada EPS-graafika PDF-graafikaks programmiga <command +>epstopdf</command +>, mida pakub iga &tex;i pakett, ning seejärel kasutada &pdflatex;it. See annab tulemuseks väga hea kvaliteediga graafika ning sa saad tulemust isegi juhtida mõnega järgmistest käskudest: <programlisting +>-dAutoFilterColorImages=false + -dAutoFilterGrayImages=false + -sColorImageFilter=FlateEncode + -sGrayImageFilter=FlateEncode + -dPDFSETTINGS=/prepress + -dUseFlateCompression=true +</programlisting> + </para> + + <para +>Ja mis veel parem: kui sinu süsteem toetab shelli paomärke (<userinput +>shell-escape</userinput +>), saab teisendamist teha lausa lennult. Selleks tuleb vaid kaasata pakett <application +>epstopdf</application +>, mis kuulub &tex;i koosseisu, käsuga <userinput +>\usepackage{epstopdf}</userinput +>. Oletame, et kood on <programlisting> + \includegraphics[width=5cm]{test.eps} +</programlisting +> Kui kutsud &pdflatex;i välja võtmega <option +>*--shell-escape</option +>, teisendatakse graafikafail <filename +>test.eps</filename +> automaatselt failiks <filename +>test.pdf</filename +>.</para> + + <para +>Teisendamine võetakse ette iga kord, kui käivitad &pdflatex;i. Kui graafikakäsk onantud otseselt: <programlisting> + \includegraphics[width=5cm]{test} +</programlisting +> kontrollib <application +>epstopdf</application +>, kas fail <filename +>test.pdf</filename +> on juba olemas, nii et teisendamise saab vahele jätta.</para +></listitem> + + <listitem +><para +>Teisendamise võib ette võtta ka teistpidi ning tarvitada &latex;it ja PS->PDF teisendust. See ei ole siiski soovitatav, sest JPG- või PNG-failid EPS-idena on üldiselt väga suured, mis võib kaasa tuua tarbetult mahukate dokumentide tekkimise. See sõltub siiski <emphasis +>suurel määral</emphasis +> kasutatavast graafikarakendusest, sest EPS võib kaasata endasse muud graafikat, kuid mitte kõik rakendused ei toeta seda võimalust ühtmoodi hästi. Mõned võivad isegi püüda luua JPG-pilti vektoritega ning mitmesuguste skriptimisega, mis annab tulemuseks hiiglaslikud failid. Igat tüüpi graafikafaile teisendab EPS-iks <ulink url="http://www.imagemagick.org/" +>&imagemagick;</ulink +>. Teine programm, mis tuleb sellega korralikult toime, on <ulink url="http://www.tex.uniyar.ac.ru/win32/tools/jpg2ps/" +><application +>jpg2ps</application +></ulink +>. </para +></listitem> + + <listitem +><para +>Samuti võib kasutada automaatset teisendamist. Sel juhul teisendatakse kõik graafikafailid lennult EPS-iks ja lisatakse PS-dokumenti. See on väga mugav, aga selleks tuleb süsteem vastavalt seadistada. Sellest on juttu osas <link linkend="build_epsgraphics" +>EPS-graafika</link +>.</para +></listitem> + + </itemizedlist> + + </sect2> + + <sect2 id="build_graphics_type"> + + <title +>Õige faili kasutamine õige graafika jaoks</title> + + <itemizedlist> + <listitem +><para +>EPS on omamoodi vektorgraafika skriptikeel, mis kirjeldab kõiki jooni ja punkte, millest graafika koosneb. See ei kaota eriti suurendamisel ning sobib kõige paremini skeemide ja vektorgraafika jaoks, mille loomupärane väljund ongi EPS, mis näeb välja väga puhas ja terav, olles samal ajal mahult väike.</para +></listitem> + <listitem +><para +>PNG (või iganenud GIF) on <emphasis +>kaotusteta</emphasis +> failivorming korraliku tihenduse ja kvaliteediga. See sobib hästi skeemide, jooniste ja kõige muu jaoks, kus on oluline säilitada teravus. Siiski on see mõnikord liiga ülepakutud fotode jaoks.</para +></listitem> + <listitem +><para +>JPG on <emphasis +>kaotustega</emphasis +> vorming, mis tihendab faile paremini kui PNG, ent kaotab sellevõrra omajagu pilditäpsuses. Fotode korral ei ole see tavaliselt oluline, kuid skeemide ja jooniste puhul võib tulemuseks olla kesine kvaliteet ning mõned peenemad read võivad sootuks kaduma minna. Sellisel kuhul on EPS või PNG kindlasti parem valik.</para +></listitem> + </itemizedlist> + + <para +>Kuid pea alati meeles: kus rämpsu juba on, seal seda vähemaks ei jää! Ükski teisendus ei saa muuta kehva pilti heaks.</para> + + </sect2> + + </sect1> + + <sect1 id="build_epsgraphics"> + + <title +>EPS-graafika</title> + + <para +>EPS-graafika on traditsiooniline viis graafikafailide lisamiseks &latex;i dokumentidesse. Kõikvõimalikud foorumid ja postiloendid on täis küsimusi EPS-graafika kohta, mistõttu me käsitleme siin mõningaid olulisemaid asju ja näitame, kuidas &kile; neid toetab.</para> + + <sect2 id="build_graphics_eps"> + + <title +>&latex; ja EPS-graafika</title> + + <para +>Kui otsustad kasutada EPS- või PDF-väljundi loomiseks traditsioonilist &latex;it, tekivad sul tõenäoliselt graafikaga teatud probleemid. Pead kasutama EPS-graafikat (kapseldatud &postscript;), mitte JPEG- või PNG-faile. See ei tohiks olla üldiselt probleem, sest on terve hulk <link linkend="build_graphics_conversion" +>teisendajaid</link +>, näitkes <command +>convert</command +> suurepärasest <ulink url="http://www.imagemagick.org/" +>&imagemagick;</ulink +> paketist. Kuid loomulikult läheb sul vaja natuke aega.</para +> + + <para +>EPS-faile kasutavad nii &latex;i kui ka DVI-PS teisendajad:</para> + + <itemizedlist> + <listitem +><para +>&latex; uurib EPS-faili ümbritseva kasti tuvastamiseks, mis ütleb &latex;ile, kui palju ruumi graafikale jätta.</para +></listitem> + + <listitem +><para +>DVI-PS teisendaja loeb seejärel EPS-faili sisse ja lisab graafika PS-faili.</para +></listitem> + </itemizedlist> + + <para +>Sellel on oma tagajärjed:</para> + + <itemizedlist> + <listitem +><para +>&latex; ei loe EPS-faili, kui ümbritseva kasti parameetrid on määratud graafika lisamise käsuga.</para +></listitem> + + <listitem +><para +>Et &latex; ei suuda lugeda ASCII-faile, ei suuda ta lugeda ka ümbritseva kasti teavet tihendatud või mitte-EPS-graafikafailidest.</para +></listitem> + + <listitem +><para +>EPS-graafikat ei kaasata DVI-faili. Kuna EPS-failid peavad DVI-faili teisendamisel PS-failiks olemas olema, peavad EPS-failid alati DVI-faili liigutamisel samuti asukohta vahetama.</para +></listitem> + </itemizedlist> + + <para +>Nüüd võid välja kutsuda &latex;i ja DVI-PS teisendaja, näiteks <application +>dvips</application +>'i, et luua oma &postscript;i dokument. Kui eesmärk on PDF-dokument, tuleb <command +>dvips</command +> käivitada võtmega <option +>-Ppdf</option +> ja seejärel kutsuda välja <command +>ps2pdf</command +>. Selle kohta leiab üsna palju dokumendatsiooni.</para> + + </sect2> + + <sect2 id="build_graphics_epskile"> + + <title +>&kile; ja &postscript;</title> + + <para +>&kile; aitab hankida teavet ümbritseva kasti kohta. Kui paigaldatud on <ulink url="http://www.imagemagick.org/" +>&imagemagick;</ulink +>, hangib &kile; selle teabe EPS-failist ja lisab selle võtmena. Seda tehakse graafikafaili valimisel automaatselt. Sel on kaks eelist:</para> + + <itemizedlist> + <listitem +><para +>Teave on dialoogis juba olemas, d&latex; ei pea seda hiljem hankima.</para +></listitem> + <listitem +><para +>Veel tähtsam on see, et nii saab arvutada pildi laiuse ja kõrguse, kui on teada lahutus. Seda teavet näidatakse dialoogi ülaosas ning sellest võib abi olla, kui soovid graafikat skaleerida.</para +></listitem> + <listitem +><para +>&kile; toetab ka zipitud või gzipitud EPS-faile. mis on palju väiksemad kui tihendamata EPS-failid. Seda võimalust saab siiski kasutada vaid siis, kui süsteem on vastavalt seadistatud ning muudetud kohalikku graafikaseadistust, nagu seda kirjeldab osa <link linkend="build_graphics_bitmap" +>Bittrastergraafika</link +>.</para +></listitem +> + </itemizedlist> + <!-- FIXME I don't understand the following sentence, tbraun + <para +> The <emphasis +>&postscript; Way of &kile;</emphasis +> can be turned off or on in + <menuchoice +><guimenu +>Settings</guimenu +><guisubmenu +>Configure Kile...</guisubmenu> + <guimenuitem +>LaTeX</guimenuitem +><guilabel +>General</guilabel +></menuchoice +>.</para> + --> + </sect2> + + <sect2 id="build_graphics_bitmap"> + + <title +>&postscript; ja bittrastergraafika</title> + + <para +>Kui sinu süsteemis saab shellis kasutada paomärke (<userinput +>shell-escape</userinput +>), toetab &kile; ka väga lihtsat bittrastergraafika kaasamise viisi, kui oled oma &tex;i süsteemi vastavalt seadistanud. Sel juhul pole vaja teisendada JPEG- või PNG-graafikat, seda tehakse DVI-faili teisendamisel PS-failiks automaatselt.</para> + + <para +>&latex; vajab veidi teavet faililaiendite kohta. Pakett <userinput +>graphicx</userinput +> otsib faili <filename +>graphics.cfg</filename +>, mis peab asuma &latex;i dokumentide otsinguteel. Otsi seal järgmisi kirjeid:</para> + +<programlisting +>\DeclareGraphicsRule{.pz}{eps}{.bb}{}% + \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}% + \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}% + \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}% + \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{}% +</programlisting> + + <para +>ja kirjuta nende asemele järgmised read:</para> + +<programlisting +>\DeclareGraphicsRule{.pz}{eps}{.bb}{}% + \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}% + \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}% + \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}% + % changed or new graphic rules + \DeclareGraphicsRule{.eps.zip}{eps}{.eps.bb}{`unzip -p #1}% zipped EPS + \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1}% gzipped EPS + \DeclareGraphicsRule{.jpg}{eps}{}{`convert #1 eps:-}% JPEG + \DeclareGraphicsRule{.gif}{eps}{.bb}{`convert #1 eps:-}% GIF + \DeclareGraphicsRule{.png}{eps}{.bb}{`convert #1 eps:-}% PNG + \DeclareGraphicsRule{.tif}{eps}{.bb}{`convert #1 eps:-}% TIFF + \DeclareGraphicsRule{.pdf}{eps}{.bb}{`convert #1 eps:-}% PDF-graphics +</programlisting> + + <para +>Näiteks Debianis paikneb see fail asukohas <filename +>/etc/texmf/latex/graphics.cfg</filename +>. Parim võimalus on kopeerida see oma kohalikku TeXi asukohta ja seda siis seal muuta. Kuidas leida &tex;i katalooge, saab teada &tex;i manuaalilehekülgedelt.</para> + + <para +>Selle seadistustefaili abil saab lisada &latex;isse bittrastergraafikat ja zipitud või gzipitud EPS-faile. Teisendamiskäsu annab <command +>dvips</command +>. Kui uurid teisendamiskäsku, näed, et lisafaile ei looda. Teisendamise tulemus suunatakse otse PS-faili. &latex; peab teadma ainult graafika suurust ja seepärast ongi vaja ümbritsevat kasti, mida pakub &kile;.</para> + + <para +>Võidakse öelda, et see ei ole väga turvaline, aga seda pead sa ise otsustama. Igal juhul ei ole vaja ümbritsevat kasti, sest &kile; hangib selle teabe kõigist graafikatüüpidest.</para> + + </sect2> + + <sect2 id="build_graphics_pdflatex"> + + <title +>&pdflatex; ja EPS-graafika</title> + + <para +>Nagu märgitud, ei suuda &pdflatex; käsitseda EPS-graafikafaile, kuid selle juures on abiks teisendajad, näiteks <link linkend="build_graphics_epstopdf" +>epstopdf</link +>. Parim viis on kaasata pakett <filename +></filename +>, millele peab eelnema pakett <userinput +>graphicx</userinput +>.</para> + +<programlisting +>\usepackage[pdftex]{graphicx} + \usepackage{epstopdf} +</programlisting> + + <para +>Siis saab juba lisada EPS-graafikat, kui käivitada <command +>pdflatex</command +> võtmega <option +>--shell-escape</option +>, kuid see on võimalik veelgi paremini, kusjuures käsitleda saab ka zipitud või gzipitud EPS-faile. Taas tuleb muuta graafika seadistustefaili <filename +>graphics.cfg</filename +>. Sedakorda otsime seal üles read:</para> + +<programlisting +>% pdfTeX is running in pdf mode + \ExecuteOptions{pdftex}% +</programlisting> + + <para +>ja lihtsalt lisame mõned raed.</para> + +<programlisting +>% pdfTeX is running in pdf mode + \ExecuteOptions{pdftex}% + \AtEndOfPackage{% + \g@addto@macro\Gin@extensions{.eps.gz,.eps.zip}% + \@namedef{Gin@rule@.eps.gz}#1{{pdf}{.pdf}{`gunzip -c #1 | epstopdf -f +>\Gin@base.pdf}}% + \@namedef{Gin@rule@.eps.zip}#1{{pdf}{.pdf}{`unzip -p #1 | epstopdf -f +>\Gin@base.pdf}}% + }% +</programlisting> + + <para +>Nende ridadega suudab &pdflatex; käsitleda EPS-faile ja loodetavasti ei teki graafikaga rohkem probleeme.</para> + + </sect2> + + </sect1> + + <sect1 id="build_master"> + + <title +>Põhidokument</title> + + <para +>Dokumendi määratlemine põhidokumendina võimaldab töötada erinevate failidega, nii et sul on ülemdokument (ehk põhidokument) ja töö juurde käivad alamdokumendid. Pärast põhidokumendi määramist vastava käsuga menüüs <guimenu +>Seadistused</guimenu +> käivad kõik menüü <guimenu +>Tööriistad</guimenu +> vahendusel antud käsud ainult selle dokumendi kohta isegi juhul, kui töötatakse alamdokumentidega. Põhimõtteliselt võib peadokumendi isegi sulgeda.</para> + </sect1> + + <sect1 id="build_errorhandling"> + + <title +>Veahaldusest lähemalt</title> + + <para +>Pärast kompileerimist uurib &kile; lähemalt genereeritud veateateid. Kui esineb vigu või hoiatusi, antakse neist teada <guilabel +>logi/teadeteaknas</guilabel +>. Teateid saab lähemalt uurida menüükäsuga <menuchoice +><guimenu +>Ehitamine</guimenu +> <guimenuitem +>Vaata logi</guimenuitem +></menuchoice +> või kiirklahviga <keycombo +>&Alt;<keycap +>0</keycap +></keycombo +>. Genereeritud logi näidatakse siis <guilabel +>logi/teadeteaknas</guilabel +> ning vead ja hoiatused on esile tõstetud.</para> + + <screenshot> + <screeninfo +>Logi vaatamine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="snap_compile_error.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Logi vaatamine</phrase> + </textobject> + <caption +><para +>Logi vaatamine</para +></caption> + </mediaobject> + </screenshot> + + <para +>Logifaili ühelt teatelt teisele saab hõlpsasti hüpata menüükäsuga <menuchoice +><guimenu +>Ehitamine</guimenu +> <guimenuitem +>Järgmine/Eelmine LaTeXi viga/hoiatus</guimenuitem +></menuchoice +> või vastavat tööriistariba nuppu klõpsates.</para> + + <para +>Hüppamaks &latex;i lähtetekstis reale, kus viga esineb, klõpsa <guilabel +>logi/teadeteaknas</guilabel +> lihtsalt vastaval veal/hoiatusel. &kile; viib su automaatselt vigasele reale.</para> + + </sect1> + + <sect1 id="build_watch"> + + <title +>Faili jälgimise režiim</title> + + <para +>Kui käivitad käsu <guibutton +>Kiire ehitamine</guibutton +>, avatakse tavaliselt pärast kompileerimist mingi vaatamisrakendus. Kui sa ei kasuta põimitud vaatajat, avatakse alati uus aken.</para> + + <para +>Dokumendi välimuse kohendamisel võib juhtuda, et käivitad käsku <guibutton +>Kiire ehitamine</guibutton +> päris sageli ja su töölaud kattub aina uute avanevate akendega. Selle vältimiseks võib sisse lülitada <guibutton +>faili jälgimise</guibutton +> režiimi, mis takistab käsul <guibutton +>Kiire ehitamine</guibutton +> vaataja akent avamast.</para> + + <para +>Hetkel toetab &kdvi; vaadatava DVI-faili korduvat uuendamist, kuid &kghostview; pole sugugi täiuslik: dokumendi uuendamiseks pärast kompileerimist tuleb sul muuta lehekülge, kuid &kghostview; ei näita leheküljenumbrite muutust.</para> + + <para +>Põimitud vaataja korral on see režiim mõistagi kasutu, sest sel juhul sulged nagunii akna, et pääseda tagasi dokumendi redigeerimise ja uue kompileerimise võimaluse juurde.</para> + + </sect1> + +</chapter> + +<chapter id="navigating"> + + <title +>Liikumine &latex;i lähtetekstis</title> + + <sect1 id="navigating_struct"> + + <title +>Struktuurivaate kasutamine</title> + + <para +><guilabel +>Struktuurivaade</guilabel +> näitab &kile;s loodava dokumendi struktuuri ning võimaldab selles kiiresti liikuda. Dokumendis liikumiseks on vaja vaid hiire vasaku nupuga klõpsata mis tahes pealdisel, peatükil, sektsioonil, alamsektsioonil ja nii edasi ning sind viiakse vastava ala algusesse.</para> + + <para +>Kui kaasad faili &latex;i dokumenti sildiga <userinput +>\input</userinput +> või <userinput +>\include</userinput +>, sisaldab <guilabel +>struktuurivaade</guilabel +> vastavat faili esindavat elementi. Topeltklõps failinimel paneb &kile; kaasatud faili redaktoriaknas näitama.</para> + + <para +>Hierarhiapuus on omaette haru ka tekstis kasutatud pealdistele.</para> + + <screenshot> + <screeninfo +>Struktuurivaate kasutamine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="snap_structview_label.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Struktuurivaate kasutamine</phrase> + </textobject> + <caption +><para +>Struktuurivaate kasutamine</para +></caption> + </mediaobject> + </screenshot> + + <sect2 id="navigating_update"> + + <title +>Struktuurivaate uuendamine</title> + + <para +>Struktuurivaate uuendamiseks kasuta menüükäsku <menuchoice +><guimenu +>Redigeerimine</guimenu +><guimenuitem +>Uuenda struktuuri</guimenuitem +></menuchoice +> , vajuta klahvi <keycombo +><keycap +>F12</keycap +></keycombo +> või salvesta dokument, mis samuti sunnib &kile; värskendama <guilabel +>struktuurivaadet</guilabel +>.</para> + + </sect2> + + </sect1> + + <sect1 id="navigating_bookmarks"> + + <title +>Järjehoidjad</title> + + <para +>Järjehoidjad viitavad tekstiosale või reale &kile; keskkonnas. Järjehoidja tarvitamiseks vali dokumendis rida, mille juurde soovid hiljem naasta, vajuta <keycombo +>&Ctrl; <keycap +>B</keycap +></keycombo +> ja &kile; lisabki automaatselt sellele reale järjehoidja. Järjehoidja saab määrata ka siis, kui märkida ära rida, mille juurde soovid hiljem naasta, ja valida menüükäsk <menuchoice +><guimenu +>Järjehoidja</guimenu +><guimenuitem +>Lülita järjehoidjat</guimenuitem +></menuchoice +>.</para> + + <para +>Järjehoidjate eemaldamiseks kasuta menüükäsku <menuchoice +><guimenu +>Järjehoidjad</guimenu +> <guimenuitem +>Puhasta järjehoidjad</guimenuitem +></menuchoice +>.</para> + + <para +>Palun arvesta, et praegu ei salvestata järjehoidjaid, kui väljud &kile;st.</para> + + </sect1> + +</chapter> + +<chapter id="projects"> + + <title +>Projektid</title> + + <sect1 id="projects_working"> + + <title +>Projektide kasutamine</title> + + <para +>&kile; pakub võimalust luua ja kasutada <emphasis +>projekte</emphasis +>. Projekt on rühm &latex;i, graafika-. &bibtex;i või muid faile, mis kõik on seotud sinu põhidokumendiga. Projekti tüüpiline näide on mitmest peatükist koosnev dokument, kus peatükid kujutavad endast erinevaid <literal role="extension" +>.tex</literal +>-faile. Kõik need võib kaasata projekti, mis muudab tervikdokumendi haldamise märksa hõlpsamaks. Projekti spetsifikatsioon salvestatakse spetsiaalsesse faili laiendiga <literal role="extension" +>.kilepr</literal +>.</para> + + <para +>Projekt pakub järgmisi võimalusi:</para> + + <itemizedlist> + <listitem +><para +>Põhidokumenti pole vaja määrata, &kile; teeb seda automaatselt</para +></listitem> + <listitem +><para +>Projektifaile saab hõlpsasti üheskoos arhiveerida, kui valida menüükäsk <menuchoice +><guimenu +>Ehitamine</guimenu +><guisubmenu +>Muu</guisubmenu +><guimenuitem +>Arhiiv</guimenuitem +></menuchoice +>.</para +></listitem> + <listitem +><para +>Vaade <guilabel +>Failid ja projektid</guilabel +> näitab, millised failid on dokumenti kaasatud.</para +></listitem> + <listitem +><para +>Pärast projekti avamist taastatakse kõik varem avatud failid esialgse kodeeringu ja esiletõstmistega.</para +></listitem> + <listitem +><para +>Koodilõpetamine toimib kõigis projekti failides.</para +></listitem +> + <listitem +><para +>Viidete lõpetamine toimib kõigis projekti failides.</para +></listitem +> + <listitem +><para +>Tsitaadi lõpetamine toimib kõigis projekti failides.</para +></listitem +> + <listitem +><para +>Otsimine kõigis projekti failides.</para +></listitem +> + <listitem +><para +>Kohandatud kiire ehitamise ja &makeidx; käsu määramine.</para +></listitem> + </itemizedlist> + + </sect1> + + <sect1 id="projects_creating"> + + <title +>Projekti loomine</title> + + <para +>Projekti loomiseks vali menüükäsk <menuchoice +><guimenu +>Projekt</guimenu +> <guimenuitem +>Uus projekt...</guimenuitem +></menuchoice +>. Projekti loomiseks päritakse sinu käest järgmisi asju:</para> + <itemizedlist> + <listitem +><para +>Sinu projekti pealkiri</para +></listitem> + <listitem +><para +>Projektifaili nimi laiendiga <literal role="extension" +>.kilepr</literal +></para +></listitem> + <listitem +><para +>Failinimi</para +></listitem> + <listitem +><para +>Loodava faili tüüp: tühi dokument, artikkel, raamat, kiri, aruanne...</para +></listitem> + </itemizedlist> + + <para +>Kui täidad kasti <guilabel +>failinimi</guilabel +>, tuleb määrata ka selle faili asukoht projektifaili (laiendiga <literal role="extension" +>.kilepr</literal +>) suhtes.</para> + + </sect1> + + <sect1 id="projects_view"> + + <title +>Faili ja projekti vaade</title> + + <para +><guilabel +>Faili ja projekti</guilabel +> vaate nupp kujutab endast kaht paberilehte. Selles vaates on võimalik näha projekti struktuuri, selles olevaid faile ning projekti infot sisaldava <literal role="extension" +>.kilepr</literal +>-faili nime. Failide lisamine projekti, nende eemaldamine või projekti seadistamine käibki ennekõike <guilabel +>faili ja projekti</guilabel +> vaate abil.</para> + + <screenshot> + <screeninfo +>Faili ja projekti vaade</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="snap_projectview.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Faili ja projekti vaade</phrase> + </textobject> + <caption +><para +>Faili ja projekti vaade</para +></caption> + </mediaobject> + </screenshot> + + </sect1> + + <sect1 id="projects_adding"> + + <title +>Failide lisamine ja eemaldamine</title> + + <para +>Faili lisamiseks projekti ava vajalik &tex;-fail, klõpsa selle nimel <guilabel +>faili ja projekti</guilabel +> vaates hiire parema nupuga ning vali <guilabel +>Lisa projekti</guilabel +>. Kui sul on avatud mitu projekti, küsib dialoog, millisesse projekti fail lisada.</para> + + <para +>Kui tahad lisada projekti mitu faili, vali <guilabel +>faili ja projekti</guilabel +> vaates projekt, klõpsa sellel hiire parema nupuga ja vali <guilabel +>Lisa fail</guilabel +>. Seejärel saab vajalikud failid valida ilmuvas dialoogis.</para> + + <para +>Samuti võib klõpsata <guilabel +>faili ja projekti</guilabel +> vaates projekti nimel hiire parema nupuga ning valida <guilabel +>Lisa failid...</guilabel +>. Seejärel saab vajalikud failid valida ilmuvas dialoogis.</para> + + <screenshot> + <screeninfo +>Faili lisamine projekti</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="snap_projectview_add.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Faili lisamine projekti</phrase> + </textobject> + <caption +><para +>Faili lisamine projekti</para +></caption> + </mediaobject> + </screenshot> + + <para +>Faili eemaldamiseks projektist klõpsa failinimel hiire parema nupuga ja vali <guilabel +>Eemalda fail</guilabel +>. Sinu fail eemaldataksegi projektist. See <emphasis +>ei</emphasis +> kustuta faili, vaid ainult eemaldab selle projektifailide (laiendiga <literal role="extension" +>.kilepr</literal +>) nimekirjast.</para> + + </sect1> + + <sect1 id="projects_options"> + + <title +>Projekti valikud</title> + + <para +>&kile; pakub mõned võimalused muuta projekti seadistusi. Selleks klõpsa hiire parema nupuga projekti pealkirjal ja vali <guilabel +>Projekti valikud</guilabel +>. Seejärel on võimalik muuta järgmisi asju:</para> + + <itemizedlist> + <listitem +><para +>Projekti pealkiri</para +></listitem> + <listitem +><para +>Põhidokument</para +></listitem> + <listitem +><para +>Kiirehitamise käsk</para +></listitem> + <listitem +><para +>&makeidx; valikud</para +></listitem> + </itemizedlist> + + <sect2 id="projects_archive"> + + <title +>Projekti arhiveerimine</title> + + <para +>&kile; võimaldab vähese vaevaga teha projektist varukoopia, salvestades kõik projekti failid ühte arhiivi. Projekti arhiveerimiseks klõpsa <guilabel +>faili ja projekti</guilabel +> vaates hiire parema nupuga projekti nimele või vali menüükäsk <menuchoice +><guimenu +>Projekt</guimenu +> <guimenuitem +>Arhiveeri</guimenuitem +></menuchoice +>.</para> + + <para +>Vaikimisi lisatakse arhiivi projekti kõik failid. Kui sa aga ei soovi mõne faili arhiveerimist, klõpsa <guilabel +>faili ja projekti</guilabel +> vaates hiire parema nupuga vastaval faili ja lülita võimalus <guilabel +>Kaasa arhiivi</guilabel +> välja.</para> + + <para +>Arhiveerimiskäsud on shellikäsud, mis käivitatakse projektikataloogis (koht, kus on salvestatud <literal role="extension" +>.kilepr</literal +>-fail).</para> + + </sect2> + +<!-- FIXME not working in kile, tbraun 11/3/2007 + <sect2 id="projects_ext"> + + <title +>Extensions for Non-Source Files</title> + + <para +>Non-source files are files such as pictures, PDF or &postscript; files, etc. that are + to be included in the project, but are not source files with the extension <literal role="extension" +>.tex</literal +>. You have + the option to use your own regular expressions to match non-source files.</para> + </sect2> +--> + + </sect1> + + <sect1 id="projects_closing"> + + <title +>Projekti sulgemine</title> + + <para +>Projekti sulgemiseks vali <guilabel +>faili ja projekti</guilabel +> vaade, klõpsa hiire parema nupuga projekti nimel ning vali <guimenuitem +>Sulge</guimenuitem +>. See käsk sulgeb projekti ning kõik sellega seotud failid ja lisab ka suletud projekti nime menüüs <guimenu +>Projekt</guimenu +> valikusse <guisubmenu +>Ava hiljutine projekt...</guisubmenu +>.</para> + + </sect1> + +</chapter> + +<chapter id="lang"> + + <title +>Dokumendi kodeering</title> + + <para +>&kile; üks võimsaid eeliseid on oskus lugeda, teisendada ja määrata tekstile just see kodeering, mida sa vajad. See lubab kasutada mittestandardseid tähti ja sümboleid, nii saab tarvitada näiteks itaalia või prantsuse keele rõhumärkidega tähti. Dokumendi kodeeringu saab valida kolmel moel:</para> + + <itemizedlist> + <listitem +><para +>Kasutades liitkasti <guilabel +>kodeering</guilabel +>, mis asub <guilabel +>faili avamise</guilabel +> vaate allosas.</para +></listitem> + <listitem +><para +>Teine võimalus on kasutada alammenüüd <menuchoice +><guimenu +>Seadistused</guimenu +><guisubmenu +>Kile seadistamine...</guisubmenu +><guimenuitem +>Redaktor</guimenuitem +></menuchoice +>, kus saab määrata kõigi failide vaikimisi kodeeringu.</para> + <screenshot> + <screeninfo +>Vaikimisi kodeeringu määramine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="config-encoding.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Vaikimisi kodeeringu määramine</phrase> + </textobject> + </mediaobject> + </screenshot> + </listitem> + <listitem +><para +>Valides vastava võimalus uue dokumendi loomisel nõustajas.</para +></listitem> + </itemizedlist> + + <para +>Traditsiooniliselt mõistab &latex; ainult piiratud hulka sümboleid (ASCII), mis ei luba rõhumärkidega tähti või erisümboleid vahetult sisestada. Rõhumärkidega tähtede kasutamiseks pruugib &latex; lahendusena süntaksit, mis võimaldab selliseid tähti siiski kasutada, näiteks <userinput +>\"e</userinput +> <computeroutput +>ë</computeroutput +> jaoks. Selles aitab kaasa omaette pakett <application +>inputenc</application +>, mis on kaasatud preambulisse käsuga <userinput +>\usepackage[latin1]{inputenc}</userinput +>, kus lisaargument tähistab kodeeringut, mida tahad kasutada (tänapäeval enamasti sobima <userinput +>utf8x</userinput +>). See annab &latex;ile korralduse tõlgendada kõik <userinput +>ë</userinput +> dokumendis enne kompileerimist kujule <userinput +>\"e</userinput +>. Rohkem infot <application +>inputenc</application +> kohta leiab <application +>inputenc</application +> dokumentatsioonist. Kontrolli, et fail oleks ka <emphasis +>tegelikult</emphasis +> selles kodeeringus, mida väidab <application +>inputenc</application +>!</para> + + <screenshot> + <screeninfo +>Lähteteksti kodeeringu valimine</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="snap_encoding.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Lähteteksti kodeeringu valimine</phrase> + </textobject> + <caption +><para +>Lähteteksti kodeeringu valimine</para +></caption> + </mediaobject> + </screenshot> + + <para +>Erinevate sümbolite hiigelhulk tekitab probleeme paljudele rakendustele, mistõttu on jõutud üldisele veendumusele, et varem või hiljem on vajalik kasutusele võtta <ulink url="http://www.unicode.org" +>Unicode</ulink +>. Unicode erinevaid teostusi liigub päris mitu, Linuxi maailmas on neist kõige edukam olnud <abbrev +>UTF-8</abbrev +>, samas Windows® kasutab mõneti kohmakamat ja mitte nii paindlikku <abbrev +>UCS-2</abbrev +>. Mõned distributsioonid, näiteks RedHat, on juba hakanud oma vaikekodeeringuna kasutama <abbrev +>UTF-8</abbrev +>, mistõttu ka sulle võiks huvi pakkuda argumendi <userinput +>utf8x</userinput +> tarvitamine paketi <userinput +>inputenc</userinput +> korral.</para> + + <sect1 id="ucs"> + + <title +>&ucs;-pakett</title> + <para +>Kui &ucs;-pakett ei ole paigaldatud, talita nii:</para> + <itemizedlist> + <listitem +><para +>&ucs;-paketi saab selle koduleheküljelt <ulink url="http://www.unruh.de/DniQ/latex/unicode/" +>Unicode support for &latex;</ulink +>, mida haldab Karlsruhe ülikoolis tegutsev Dominique Unruh.</para +></listitem> + <listitem> + <para +>Paigaldamiseks paki allalaaditud fail lahti ja paiguta see kataloogi, mis leidub keskkonnamuutujast $<envar +>TEXINPUTS</envar +>. Selle võib määrata ka Kiles.</para> + </listitem> + </itemizedlist> + <screen +><userinput> + \usepackage{ucs} + \usepackage[utf8x]{inputenc}</userinput +></screen> + + </sect1> + + <sect1 id="cjk"> + + <title +>&cjk; toetus</title> + + <para +>Ideograafiliste kirjade toetuse lisamine on üsna keerukas. Kui oled aga sellega hakkama saanud, peaks see täiesti korralikult töötama. Lisaks pakettide paigaldamisele tuleb siin ka üht-teist seadistada.</para> + + <tip +><para +>Võimalik, et sinu Linuxi distributsioon on juba &cjk;-paketi valmis pakendanud, mis vähendab märgatavalt vaeva kõige käsitsi paigaldamisega võrreldes. Kontrolli seda kindlasti!</para +></tip> + + <para +>Lühikeste &cjk;-tekstijuppide kirjutamiseks saab heal juhul kasutada ka &ucs;-paketti, aga see on tõesti väga piiratud, näiteks ei nii võimalik isegi reavahetusi korralikult määrata. Seepärast oleks mõttekas paigaldada täielik &cjk;-&latex;-pakett ja panna see tööle nii &latex; kui &pdflatex;i tarbeks. Suur osa siinsest tekstist on saanud innustust <ulink url="http://www.ece.uci.edu/~chou/" +>Pai H. Chou</ulink +> <ulink url="http://www.ece.uci.edu/~chou/unicode-tex.html" +>veebileheküljest &pdflatex;i häälestamise kohta</ulink +>.</para> + + <orderedlist> + + <listitem +><para +>Laadi alla <ulink url="http://www.ctan.org/tex-archive/help/Catalogue/entries/cjk.html" +>&cjk;-pakett</ulink +>. Kopeeri selle lahtipakitud failid $<envar +>TEXMF</envar +> vastavasse alamkataloogi täpselt nii, nagu see käib &ucs;-paketi puhul (vaata <xref linkend="ucs"/>). Failid pakitakse lahti kataloogi <filename +>CJK/X_Y.Z</filename +>. Neid ei ole oluline välja võtta, kuigi see muudab vahest hooldamise hiljem veidi vaevalisemaks.</para +></listitem> + + <listitem +><para +>Nüüd tuleb alla laadida font, mis toetaks kõiki &cjk; sümboleid, mida sul vaja läheb. Sa võid valida igasuguse sobiva <literal role="extension" +>*.ttf</literal +>-faili, kuid siinkohal on meil näiteks <ulink url="ftp://ftp.netscape.com/pub/communicator/extras/fonts/windows/Cyberbit.ZIP" +>Cyberbit</ulink +>. Paki fail lahti ja nimeta <filename +>Cyberbit.ttf</filename +> ümber <filename +>cyberbit.ttf</filename +>, sest suured tähed võivad süsteemi segadusse ajada.</para> + <para +>Paiguta <filename +>cyberbit.ttf</filename +> kataloogi koos failiga <ulink url="http://delloye.free.fr/Unicode.sfd" +><filename +>Unicode.sfd</filename +></ulink +> ning genereeri <literal role="extension" +>*.tfm</literal +>- ja <literal role="extension" +>*.enc</literal +>-failid käsuga <userinput +><command +>$ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@</command +></userinput +>. Vahel ei pruugi see mingil põhjusel tekitada ettenähtud sadu faile. Sellisel juhul võid alla laadida nii <ulink url="http://www.ece.uci.edu/~chou/unicode/cyberbit-tfm.tgz" +><literal role="extension" +>*.tfm</literal +></ulink +>- kui ka <ulink url="http://www.ece.uci.edu/~chou/unicode/cyberbit-enc.tgz" +><literal role="extension" +>*.enc</literal +></ulink +>-failid.</para> + <para +>Paiguta <literal role="extension" +>*.tfm</literal +>-failid sobivasse kataloogi, näiteks <filename +>$<envar +>TEXMF</envar +>/fonts/tfm/bitstream/cyberbit/</filename +>. <literal role="extension" +>*.enc</literal +>-failid võib paigutada näiteks kataloogi <filename +>$<envar +>TEXMF</envar +>/pdftex/enc/cyberbit/</filename +>.</para +></listitem> + + <listitem +><para +>Nüüd läheb vaja seosefaili, mis ühendaks <literal role="extension" +>*.enc</literal +>-failid fondiga. Laadi alla <ulink url="http://delloye.free.fr/cyberbit.map" +><filename +>cyberbit.map</filename +></ulink +> ja paigalda see kataloogi <filename +>$<envar +>TEXMF</envar +>/pdftex/config/</filename +>.</para +></listitem> + + <listitem +><para +>Laadi alla ka <ulink url="http://delloye.free.fr/c70cyberbit.fd" +><filename +>c70cyberbit.fd</filename +></ulink +> ja paiguta see sobivasse kataloogi, näiteks <filename +>$<envar +>TEXMF</envar +>/tex/misc/</filename +>.</para +></listitem> + + <listitem +><para +>Lõpuks on meil vaja genereerida &postscript; Type 1 font, mida on tarvis &latex;iga tekitatud DVI-failide lugemisel. Käivita käsk <userinput +><command +>$ ttf2pfb cyberbit.ttf -o cyberbit.pfb</command +></userinput +> ja kopeeri saadud <filename +>cyberbit.pfb</filename +> sobivasse kataloogi, näiteks <filename +>$<envar +>TEXMF</envar +>/fonts/type1/cyberbit/</filename +>.</para +></listitem> + + <listitem +><para +>Seame nüüd <filename +>cyberbit.ttf</filename +> fontide sekka, mida &latex; suudab leida ja kasutada. See tuleks paigutada kataloogi <filename +>$<envar +>TEXMF</envar +>/fonts/truetype/</filename +>.</para +></listitem> + + <listitem +><para +>Kontrolli konfiguratsioonifaili <filename +>$<envar +>TEXMF</envar +>/web2c/texmf.cnf</filename +> ja veendu, et rida, kus seisab <envar +>TTFONTS</envar +>, oleks kommenteerimata ning osutaks kataloogile, kuhu salvestasid <filename +>cyberbit.ttf</filename +>.</para +></listitem> + + <listitem +><para +>Et &pdflatex; saaks &cjk; fonte kasutada, tuleb lisada rida konfiguratsioonifaili <filename +>$<envar +>TEXMF</envar +>/pdftex/config/pdftex.cfg</filename +>. Lisa <userinput +>map +cyberbit.map</userinput +> faili ja &pdflatex; on seadistatud.</para +></listitem> + + <listitem +><para +>&latex;i seadistamiseks, et see saaks tekitada &cjk; sümbolitega DVI-faile, tuleb lisada rida faili <filename +>ttfonts.map</filename +>. Fail võib asuda kataloogis <filename +>$<envar +>TEXMF</envar +>/ttf2pk/</filename +>, aga võib-olla ka mitte. Lisa sellesse rida <userinput +>cyberbit@Unicode@ cyberbit.ttf</userinput +>.</para +></listitem> + + <listitem +><para +>Nüüd tuleb käivitada <userinput +><command +>texhash</command +></userinput +> ja süsteem peaks korras olema.</para +></listitem> + + </orderedlist> + + <para +>Seadistuse testimiseks võid proovida kompileerida <ulink url="http://www.math.nus.edu.sg/aslaksen/cs/sample-utf8.tex" +>seda testfaili</ulink +>.</para> + + <sect2> + <title +>&cjk; probleemid</title> + + <para +>&cjk; toetuse käsitsi lisamisel võib päris palju asju viltu minna. Kui see ei paista korralikult töötavat, võiks kontrollida järgmisi asju.</para> + + <itemizedlist> + + <listitem +><para +>On selge, et kui kasutada &latex;it kasutajana, mitte administraatorina (root), tuleb sul <emphasis +>lubada</emphasis +> ka tavalistele kasutajatele ligipääs uutele failidele. Kasuta käsku <command +>chmod</command +> ning kontrolli, et kõik kataloogid ja failid on selliste õigustega.</para +></listitem> + + <listitem +><para +>Kui &latex; kirjutab DVI probleemideta, aga sa ei näe seda, on ilmselgelt midagi viga <literal role="extension" +>*.pk</literal +>-fontide automaatse tekitamisega. Need peaks lennult loodama DVI-faili kuvamisel, aga see võib mitmel põhjusel ebaõnnestuda. Kontrolli kõigepealt üle faili <filename +>ttfonts.map</filename +> lisatud read. Samuti võib juhtuda, et käsk <command +>ttf2pk</command +>, mille DVI-näitaja tavaliselt välja kutsub, on kompileeritud <emphasis +>ilma</emphasis +> <application +>kpathsea</application +> teekide toetuseta. Sellisel juhul ei ütle käsk <userinput +><command +>ttf2pk</command +> <option +>--version</option +></userinput +> midagi <application +>kpathsea</application +> kohta. Et nende teekide toetus on hädavajalik, tuleks otsida uus pakett või kompileerida <application +>FreeType 1</application +> ise uuesti.</para +></listitem> + + </itemizedlist> + + </sect2> + + + <sect2> + + <title +>Kuidas sisestada &cjk; Unicode'is?</title> + + <para +>Sisendmootoreid on päris mitu ja valik sõltub rohkem sinu eelistustest. Käesoleva käsiraamatu autori lemmikuks on <ulink url="http://www.scim-im.org/projects/skim" +><application +>Skim</application +></ulink +>, mis kujutab endast mootori <ulink url="http://www.scim-im.org" +><application +>Scim</application +></ulink +> porti &kde; jaoks. Uuri oma distributsiooni dokumentatsioonist, kuidas neid programme paigaldada. Ka nende programmide seadistamine ei pruugi olla lihtne, näiteks <application +>Skim</application +>i puhul tuleb defineerida keskkonnamuutuja <userinput +><envar +>XMODIFIERS</envar +>="@im=SCIM"</userinput +> <emphasis +>enne</emphasis +> <application +>X</application +>'i käivitamist.</para> + + </sect2> + + </sect1> + +</chapter> + +<chapter id="scripting"> + + <title +>Skriptid</title> + + <sect1 id="scripting_test"> + + <title +>Skriptid ja &kile;</title> + + <para +>&kile;s skriptide kasutamise võimalus lubab käivita ECMAScripti koodi. Skripte saab hallata külgribal paikneval skriptipaneelil. </para> + + </sect1> + + <sect1 id="scripting_api"> + + <title +>API dokumentatsioon</title> + + <para +>Selles osas kirjeldatakse &kile; skriptimise programmiliidest.</para> + + <important> + <para +>Arvesta, et skriptimise API ei ole veel lõplik. Allpool kirjeldatud API võib &kile; tulevastes versioonides muutuda. </para> + </important> + + <para +>Kõigepealt pakub &kile; skriptide käivitamise keskkond globaalse objekti "kile", millele kuuluvad järgmised meetodid: </para> + + <variablelist> + <varlistentry> + <term +>(kile).<function +>currentTextDocument()</function +></term> + <listitem> + <para +>Tagastab <classname +>KileTextDocument</classname +> objekti, mis kajastab aktiivset tekstidokumenti. Tagastab <constant +>null</constant +>, kui ükski dokument pole aktiivne. </para> + </listitem> + </varlistentry> + <varlistentry> + <term +>(kile).<function +>getInputValue(<parameter +>caption</parameter +>, <parameter +>label</parameter +>)</function +></term> + <listitem> + <para +>Avab määratud pealdise ja nimetusega akna. Tagastab kasutaja sisestatud väärtuse. </para> + </listitem> + </varlistentry> + </variablelist> + + <para +>Objektid tüübiga <classname +>KileTextDocument</classname +> esindavad &kile; tekstidokumente. Neil on järgmised omadused: </para> + + <variablelist> + <varlistentry> + <term +>(KileTextDocument).<function +>backspace()</function +></term> + <listitem> + <para +>Kustutab sümboli vahetult enne kursori asukohta ja viib kursori tekstis ühe positsiooni võrra tahapoole. </para> + </listitem> + </varlistentry> + <varlistentry> + <term +>(KileTextDocument).<function +>cursorLeft()</function +></term> + <listitem> + <para +>Liigutab kursori tekstis ühe positsiooni võrra tahapoole.</para> + </listitem> + </varlistentry> + <varlistentry> + <term +>(KileTextDocument).<function +>cursorRight()</function +></term> + <listitem> + <para +>Liigutab kursori tekstis ühe positsiooni võrra ettepoole.</para> + </listitem> + </varlistentry> + <varlistentry> + <term +>(KileTextDocument).<function +>insertText(<parameter +>text</parameter +>)</function +></term> + <listitem> + <para +>Lisab muutujas <parameter +>text</parameter +> määratud teksti dokumenti kursori asukohas. </para> + </listitem> + </varlistentry> + <varlistentry> + <term +>(KileTextDocument).<function +>insertBullet()</function +></term> + <listitem> + <para +>Lisab täpi dokumenti kursori asukohas.</para> + </listitem> + </varlistentry> + <varlistentry> + <term +>(KileTextDocument).<function +>nextBullet()</function +></term> + <listitem> + <para +>Valib dokumendis esimese pärast kursori asukohta leiduva täpi. </para> + </listitem> + </varlistentry> + <varlistentry> + <term +>(KileTextDocument).<function +>previousBullet()</function +></term> + <listitem> + <para +>Valib dokumendis viimase kursori asukohale eelneva täpi. </para> + </listitem> + </varlistentry> + <varlistentry> + <term +>(KileTextDocument).<function +>up()</function +></term> + <listitem> + <para +>Liigutab kursori dokumendis ühe rea võrra ülespoole.</para> + </listitem> + </varlistentry> + <varlistentry> + <term +>(KileTextDocument).<function +>down()</function +></term> + <listitem> + <para +>Liigutab kursori dokumendis ühe rea võrra allapoole.</para> + </listitem> + </varlistentry> + <varlistentry> + <term +>(KileTextDocument).<function +>cursorLine()</function +></term> + <listitem> + <para +>Tagastab rea, milles kursor parajasti asub.</para> + </listitem> + </varlistentry> + <varlistentry> + <term +>(KileTextDocument).<function +>cursorColumn()</function +></term> + <listitem> + <para +>Tagastab veeru, milles kursor parajasti asub.</para> + </listitem> + </varlistentry> + <varlistentry> + <term +>(KileTextDocument).<function +>setCursorLine(<parameter +>line</parameter +>)</function +></term> + <listitem> + <para +>Liigutab kursori muutujaga <parameter +>line</parameter +> määratud reale.</para> + </listitem> + </varlistentry> + <varlistentry> + <term +>(KileTextDocument).<function +>setCursorColumn(<parameter +>column</parameter +>)</function +></term> + <listitem> + <para +>liigutab kursori muutujaga <parameter +>line</parameter +> määratud veergu.</para> + </listitem> + </varlistentry> + </variablelist> + + </sect1> + +</chapter> + +<chapter id="help"> + + <title +>Abi</title> + + <sect1 id="help_documents"> + + <title +>Abiidokumendid</title> + + <para +>&latex; on üpris keeruline süsteem, mille põhiomadusi saab laiendada väga suure hulga lisapakettidega. &kile; pakub kasutajale selles osas palju mitmesugust abi.</para> + + <variablelist> + + <varlistentry> + <term +><guimenu +>LaTeXi viited</guimenu +></term +> + <listitem +><para +>Levinumate &latex;i käskude tähestikuline nimekiri.</para +></listitem> + </varlistentry> + + <varlistentry> + <term +><guimenu +>TeXi dokumentatsioon</guimenu +></term> + <listitem +><para +>&tetex;/&texlive;'iga on kaasas suur hulk dokumentatsiooni. Selle hulka kuuluvad kõigi kaasatud pakettide dokumentatsioon ning täiendavad &latex;i viited.</para +></listitem> + </varlistentry> + + <varlistentry> + <term +><guimenu +>LaTeX</guimenu +></term> + <listitem +><para +>Täielik &tex;i ja tema sõprade dokumentatsioon. Lisaks kõigi programmide kirjeldusele mainitakse ka mõningaid olulisemaid pakette. Lisaks sisaldab see täielikku &latex;i käskude käsiraamatut—ideaalne viis uurida teatud kindlat vormindamisvõtet dokumendi kirjutamise ajal. Et see dokumentatsioon on tõepoolest suur, jagab &kile; selle kolme olulisema järjehoidja vahel.</para +></listitem> + </varlistentry> + + <varlistentry> + <term +><guimenu +>LaTeXi käsk</guimenu +></term> + <listitem +><para +>Veel üks &latex;i levinumate käskude tähestikuline register.</para +></listitem> + </varlistentry> + + <varlistentry> + <term +><guimenu +>LaTeXi teema</guimenu +></term> + <listitem +><para +>Tähtsamate &latex;i teemade kirjeldus.</para +></listitem> + </varlistentry> + + <varlistentry> + <term +><guimenu +>LaTeXi keskkond</guimenu +></term> + <listitem +><para +>Levinumate &latex;i keskkondade tähestikuline register.</para +></listitem> + </varlistentry> + + </variablelist> + + </sect1> + + <sect1 id="help_contextsentitive"> + + <title +>Kontekstitundlik abi</title> + + <para +>&kile; toetab ka kontekstitundlikku abi, mille saab avada kiirklahviga <keycombo action="simul" +>&Ctrl;&Alt;<keycap +>H</keycap +></keycombo +>,<keycap +>K</keycap +>. Menüükäsuga <menuchoice +><guimenu +>Seadistused</guimenu +><guisubmenu +>Kile seadistamine...</guisubmenu +> <guimenuitem +> Kile</guimenuitem +><guilabel +>Abi</guilabel +></menuchoice +> saab valida, kas kasutatakse &kile; &latex;i viiteid või &tetex;/&texlive;'i abisüsteemi, mis on ka vaikimisi valik.</para> + + <screenshot> + <screeninfo +>Täpid</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="config-userhelp.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Täpid</phrase> + </textobject> + </mediaobject> + </screenshot> + + </sect1> + + <sect1 id="help_search"> + + <title +>Võtmesõnade otsimine</title> + + <para +>Alati pole lihtne leida õiget dokumenti, sest &tetex;/&texlive; pakub tõesti väga palju dokumentatsiooni. Ühe võimaliku abivahendina pakub &tetex;/&texlive; tillukest programmi <application +>texdoctk</application +>. See sisaldab kõigi dokumentide andmebaasi, millele &kile; pakub omalt poolt liidese.</para> + + <screenshot> + <screeninfo +>Täpid</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="dialog-docbrowser1.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Täpid</phrase> + </textobject> + </mediaobject> + </screenshot> + + <para +>Kõik dokumendid on rühmitatud teatud kategooriatesse, mille peamine eelis on see, et saab otsida paketinimede või võtmesõnade järgi. &kile; näitab otsingu tulemusi.</para +> + + <screenshot> + <screeninfo +>Täpid</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="dialog-docbrowser2.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Täpid</phrase> + </textobject> + </mediaobject> + </screenshot> + + <para +>Hiirega topeltklõpsu tehes või klahvile <keycap +>Tühikuklahv</keycap +> vajutades käivitatakse antud dokumendi näitaja. See võib olla suvaline dokument, mitte tingimata DVI-, PS-, PDF- või HTML-dokument. &kile; kasutab sobiliku näitaja avamiseks &konqueror;i seadistusi.</para> + + + </sect1> + + <sect1 id="help_userdefined"> + + <title +>Kasutaja määratud abi</title> + + <para +>Lisaks staatilisele &tetex;/&texlive;'i dokumentatsioonile toetab &kile; ka veel üht muutuva loomusega kasutaja dokumentatsiooni meetodit. Menüüs <guimenu +>Abi</guimenu +> pakub &kile; spetsiaalset alammenüüd <guimenu +>Kasutaja abi</guimenu +>, kuhu kasutaja saab dokumente lisada omal valikul. Need võivad olla olulised &tetex;/&texlive;'i dokumentatsiooni osad või ka kasutaja enda kirjutatud dokumendid. Võimalik on valida isegi veebi-URL-e.</para +> + + <para +>Vali <menuchoice +><guimenu +>Seadistused</guimenu +><guisubmenu +>Kile seadistamine...</guisubmenu +> <guimenuitem +>Kile</guimenuitem +><guilabel +>Abi</guilabel +></menuchoice +> ja klõpsa seal nupule <guibutton +>Seadista</guibutton +>, mis võimaldabki seadistada alammenüü <guimenu +>Kasutaja abi</guimenu +> sisu. Menüükirjeid saab lisada ja eemaldada, võib nende järjekorda muuta, samuti lisada eraldajaid, mis lubavad alammenüüd paremini liigendada.</para> + + <para +>Klõpsuga nupule <guibutton +>Lisa</guibutton +> avaneb uus dialoog, kus saab muuta menüükirje nime ning valida vajaliku faili või veebi-&url;-i. Veebi-&url;-i valimisel käivitatakse &konqueror; ja sul tuleb vajalik &url; kopeerida.</para> + + <screenshot> + <screeninfo +>Täpid</screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="dialog-addhelp.png" format="PNG"/> + </imageobject> + <textobject> + <phrase +>Täpid</phrase> + </textobject> + </mediaobject> + </screenshot> + + </sect1> + +</chapter> + +<chapter id="credits"> + + <title +>Autorid ja litsents</title> + + <para +>&kile; on kasutajasõbralik vaba tarkvara &latex;/&tex; lähteteksti redaktor. See töötab süsteemides, kuhu on paigaldatud &kde; töölaua keskkond. &kde; on saadaval erinevate Linuxi ja muude UNIXi-laadsete süsteemide jaoks. &kile; on ka osa projektist Fink, mis tähendab, et &kile;t saab kasutada isegi Mac OS-X tingimustes!</para> + + <para +>Suur tänu kuulub kõigile neile, kes on aidanud vedada &kile; projekti ja kulutanud arvukalt tunde arendusvahenditele, mida me kõik võime kasutada vastavalt <acronym +>GNU</acronym +> litsentsile. Värskeimat teavet kaasautorite kohta pakub dialoog <guimenuitem +>&kile; info</guimenuitem +>, mille saab avada menüüst <guimenu +>Abi</guimenu +>. </para> + + <para +>Kaasautorid (paljude teiste seas): Rob Lensen, Roland Schulz, Michael Margraf, Holger Danielsson</para> + + <para +>Suur tänu kõigile kaasalöönutele!</para> +&underFDL; &underGPL; </chapter> + + +&documentation.index; + +</book> |