Kate pluginate käsiraamat
Autoriõigus © 2001, 2002
Käesolevat dokumenti võib kopeerida, edasi levitada ja/või muuta vastavalt GNU Vaba Dokumentatsiooni Litsentsi tingimustele, nagu need on avaldanud Vaba Tarkvara Fond; kas Litsentsi versioon 1.1 või ükskõik milline hilisem versioon; kaasa arvatud mittemuudetavad sektsioonid (puudub), esikaane tekstid (puudub), ja tagakaane tekstid (puudub). Litsentsi koopiaga võimaldab tutvuda sektsioon "GNU Vaba Dokumentatsiooni Litsents".
See on KDE võimsa tekstiredaktori Kate pluginate käsiraamat.
Sisukord
Kate pluginad on Kate redaktori lisafunktsioonid. Need võivad lisada menüüsid ja kiirviitu, samuti laiendada Kate võimalusi. Neid võib paigaldada Katele just nii vähe või palju, kui sulle endale meeldib. Ava Kate seadistustedialoog menüükäsuga -> Vali soovitud pluginad kaardilt ->.
Rohkem infot Kate kasutamise ja soovitavate pluginate rakendamise kohta leiab Kate käsiraamatust.
Pluginad, mida selles käsiraamatus käsitletakse, on:
See plugin pakub variante, mis on XML-failis mingis positsioonis vastavalt faili DTD-le lubatud ja mis mitte. Plugin loetleb võimalikud elemendid, atribuudid, atribuudi väärtused ja olemid vastavalt kursori asukohale (nt. kõik olemid, kui märk kursorist vasakul on “&”). Samuti võimaldab see sulgeda lähima vasakul avatud sildi.
DTD peab eksisteerima XML-vormingus nii, nagu selle on loonud Perli rakendus dtdparse. Me nimetame selles vormingus DTD-d “meta-DTD-ks”. Mõned meta-DTD-d on juba paketiga kaasas, need asuvad kataloogis $KDEDIR/share/apps/katexmltools/, mis on ühtlasi ka vaikekataloog, kui valid menüükäsu . Omaenda DTD loomiseks tõmba dtdparse internetist: http://dtdparse.sourceforge.net.
Käivita Kate ja ava seadistustedialoog menüükäsuga ->. Seejärel vali Kate XML soovitaja, mille leiab sektsioonis Rakendus/Pluginad, ja sulge dialoog. Pärast seda vali -> Kui dokumendil puudub “DOCTYPE” või on see tundmatu, tuleb failisüsteemist valida meta-DTD. Muidu laaditakse aktiivse dokumendiga sobiv DOCTYPE automaatselt.
Nüüd saab kasutada pluginat kirjutamise ajal:
See toob esile võimalike elementide loendi, kui kursor ei asu juba sildi sees. Arvesta, et praegu ei ole seda võimalik kasutada tipptaseme elemendi lisamiseks (nt. “<html>”).
See toob esile võimalike atribuutide väärtuste nimekirja (kui neid on), kui kursor on sildi sees.
See toob esile paeguse elemendi võimalikud väärtused, kui kursor on sildi sees.
See toob esile võimalike olemite nimekirja.
Kõiki funktsioone ja piiranguid saab testida, kui avada Kates $KDEDIR/share/apps/katexmltools/testcases.xml ja järgida juhiseid. Pane tähele, et plugina praegune versioon ei toeta veel mitut vaadet dokumendi kohta.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
See avab dialoogi, mis võimaldab lisada XML-elemendi. Märgid <, > ja lõpusilt lisatakse automaatselt. Kui valisid enne selle menüükäsu kasutamist mingi teksti, ümbritsetakse valitud tekst ava- ja lõpusildiga. Dialoog soovitab ka muid elemente, mida on võimalik lisada kursori asukohta, kui oled menüükäsu abil omistanud dokumendile meta-DTD.
See otsib tekstis silti, mis ei ole veel suletud, ning lisab vastava lõpusildi. Otsing algab kursori asukohast ja suundub vasakule. Kui midagi ei leita, siis ka midagi ei juhtu.
See ütleb pluginale, millist meta-DTD-d kasutada aktiivse dokumendi jaoks. Pane tähele, et omistamist ei saa salvestada ja operatsiooni tuleb korrata, kui käivitad Kate uuesti.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate plugin “XML soovitaja”: autoriõigus 2001, 2002: Daniel Naber (daniel.naber AT t-online.de).
Dokumentatsiooni autoriõigus 2001, 2002: Daniel Naber
Tõlge eesti keelde: Marek Laane 2002 (bald AT starman.ee)
Käesolev programm on litsenseeritud vastavalt GNU Üldise Avaliku Litsentsi tingimustele.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
See plugin kontrollib aktiivset faili. Hoiatuste ja vigade nimekiri ilmub Kate põhiakna allserva. Veateatele klõpsates saab hüpata vastavale kohale failis. Kui failil on “DOCTYPE”, kasutatakse faili kontrollimiseks selle dokumenditüübiga seotud DTD-d. DTD eeldatakse asuvat suhtelises asukohas aktiivse faili suhtes - nt. kui dokumenditüüp viitab tüübile “DTD/xhtml1-transitional.dtd” ja failinimi on /home/juku/test.xml, siis eeldatakse, et DTD paikneb asukohas /home/juku/DTD/xhtml1-transitional.dtd. Kuid toetatud on ka võrgu-DTD, mis on määratud http vahendusel.
Kui failil puudub dokumenditüüp, kontrollitakse vormistust.
XML süntaksi kontrollimise kohta leiab rohkem infot internetist W3C ametlikult XML-leheküljelt.
Seesmiselt kutsub see plugin välja käsu xmllint, mis on osa paketist libxml2. Kui see käsk ei ole süsteemi korrektselt paigaldatud, ei hakka plugin tööle.
Kontrollimise ajal on vajalik kirjutada ajutine fail samasse kataloogi, kus asub kontrollitav fail, nii et sul peab olema sellesse kataloogi kirjutamisõigus.
Plugina sisselülitamiseks ava Kate seadistustedialoog menüükäsuga -> Seejärel vali Kate XML süntaksi kontrollija, mille leiad kaardilt Rakendus/Pluginad, ja sulge dialoog.
Kate plugin “XML süntaksi kontrollija” autoriõigus 2002: Daniel Naber (daniel.naber AT t-online.de).
Dokumentatsiooni autoriõigus 2002: Daniel Naber
Tõlge eesti keelde: Marek Laane 2002 (bald AT starman.ee)
Käesolev programm on litsenseeritud vastavalt GNU Üldise Avaliku Litsentsi tingimustele.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Plugin “Käsulisaja” võimaldab lisada shellikäsu väljundi Kates avatud dokumenti.
Plugina “Käsulisaja” sisselülitamiseks vali menüükäsk -> ja märgi ära valik Kate käsulisaja sektsiooni Rakendus kaardil Pluginad.
Plugina kasutamiseks vali menüüst käsk , mis toob esile väikese dialoogi, kus saab sisestada käsu, valida töökataloogi ja sellegi, kas lisada teksti ka vead (STDERR väljund). Ühtlasi võib määrata ka käsurea näitamise väljundi kohal.
Plugin võib meeles pidada nii palju käske, kui sa oled seadistuste leheküljel määranud. Plugin kasutab automaatset lõpetamist ning käsurea hüpikkastis saab valida sobiva käsu.
Vaikimisi käivitatakse käsk Kate töökataloogis, mis on tavaliselt sinu kodukataloog. Seda saab aga plugina seadistuste lehel muuta.
Pane tähele, et iga shellikäsk, mis nõuab kasutaja sekkumist (nt passwd) või mis kasutab ncurses keskkonda või midagi sarnast (nt. top), ei anna tulemuseks oodatud väljundit.
Plugina “Käsulisaja” seadistamiseks ava Kate seadistuste dialoog menüükäsuga -> ja vali kaart +Käsulisaja.
Seadistada on võimalik järgmisi asju:
Selle puhul on sinu ees keritav kastike, kus saab määrata, mitu käsku meeles peetakse. Sobivad kõik numbrid vahemikus 0-99, vaikeväärtus on 20.
See raadionuppudena esitatav valik võimaldab määrata, kuidas peaks valima käsu töökataloogi. Võimalusteks on Kate töökataloog (enamasti sinu kodukataloog, kui oled käivitanud Kate menüüst), dokumendi asukohakataloog (kui see erineb; muidu kasutatakse esimest võimalust) või plugina abil viimase kasutatud käsu töökataloog.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate plugin “Käsulisaja”: autoriõigus 2001: Anders Lund (anders AT alweb.dk).
Dokumentatsiooni autoriõigus 2001: Anders Lund (anders AT alweb.dk)
Tõlge eesti keelde: Marek Laane 2002 (bald AT starman.ee)
Käesolev programm on litsenseeritud vastavalt GNU Üldise Avaliku Litsentsi tingimustele.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
See plugin avab dialoogi, mis pärib sinu käest HTML sildi nime. Avavas sildis esinevad atribuudid ja väärtused tuleb anda kujul atribuudi-nimi="atribuudi-väärtus"
Kate plugina “HTML vahendid” autoriõigus 2002: Joseph Wenninger (kde AT jowenn.at).
Dokumentatsiooni autoriõigus 2005: Francis Giannaros
Tõlge eesti keelde: Marek Laane (bald AT starman.ee)
Käesolev programm on litsenseeritud vastavalt GNU Üldise Avaliku Litsentsi tingimustele.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate pluginal “Päisefaili avaja” puudub praegu dokumentatsioon. Kui oled huvitatud sellise olukorra muutmisest, võta palun ühendust Lauri Wattsi (lauri AT kde.org), KDE dokumentatsioonimeeskonna koordinaatoriga.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate pluginal “Tekstifilter” puudub praegu dokumentatsioon. Kui oled huvitatud sellise olukorra muutmisest, võta palun ühendust Lauri Wattsiga (lauri AT kde.org), kes on KDE dokumentatsioonimeeskonna koordinaator.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Failimallide plugin lubab olemasolevate failide baasil luua uusi faile. Mallina saab kasutada iga faili: sellest luuakse koopia tühja URL-iga. Samuti võib kasutada spetsiaalset mallifaili, kus on juba olemas teatud makrod, mis annavad ette mõningase info, näiteks sinu nime ja e-posti aadressi, kuupäeva ja keskkonnamuutujad ning isegi kursori asukoha uues failis.
Mallikataloogides asuvaid malle saab näha menüükäsuga ->.
Plugin lubab ka hõlpsasti luua uue malli avatud dokumendi põhjal.
Mallikataloogid on osa KDE failisüsteemist ning neiks on vähemalt KDEDIR/share/applications/kate/plugins/katefiletemplates/templates ja KDEHOME/share/applications/kate/plugins/katefiletemplates/templates. Kui sinu keskkonnamuutujas KDEDIRS on veel katalooge, otsitakse ka neist samasuguseid alamkatalooge. Kui leitakse ühenimelised mallid, valitakse neist kohalikus kataloogis (KDEHOME) leiduv.
Avab failiavamise dialoogi, kus võid valida malliks suvalise faili. Kui valitul on laiend katetemplate, parsitakse seda malliinfo ja makrode leidmiseks.
Näitab hiljuti mallina kasutatud failide loendit, tuues ära nende URL-id.
Alammenüü ülejäänud osa sisaldab viitu mallidele. Klõpsa menüükirjel, kui soovid luua sellele vastavat faili.
Avab dialoogi, kus on ära toodud kõik mallikataloogides leitud mallid, ning kus saab neid lisada, muuta või eemaldada.
Luues makrosid sisaldava malli põhjal faili, ilmuvad mõned makrod teksti redigeeritavate muutujatena. Selliseid muutujaid eristatakse allajoonimisega.
Esimene muutuja on kohe valitud, nii et sul tuleb selle redigeerimiseks vaid kirjutama asuda. Kui sama muutujat esineb dokumendis rohkemgi, muudetakse ka kohe ka neid. Järgmisele redigeeritavale muutujale saab liikuda tabeldusklahviga (TAB). Pärast viimase muutuja redigeerimist nimekiri kaob ning tabeldusklahv hakkab taas normaalselt tööle.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Uue malli loomiseks käivita mallihaldur menüükäsuga ->. Selle avanedes klõpsa nupul , mis käivitab failimalli nõustaja. Sinu käest päritakse faili, mida malliks muuta, võimaldatakse määrata malli info ja seejärel luuaksegi mall.
Muidugi võib malli ka päris käsitsi luua, lisades malli info mis tahes faili algusse, andes teksti, makrod ja kursori asukoha markeri ning salvestades faili laiendiga katetemplate.
Mallimenüü uuendatakse automaatselt, kui salvestad mallikataloogi uue malli.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Malli muutmiseks vali menüükäsk -> Vali mall, mida soovid muuta, ja klõpsa nupule Seejärel avatakse mallifail. Sulge dialoog, muuda faili, salvesta ja sulge. Malli tehtud muudatused rakendatakse otsekohe, soovi korral võid selle kohe pärast salvestamist ja sulgemist uuesti avada, et vaadata, kas kõik sai nii, nagu tahtsid.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kui kasutad faile laiendiga katetemplate, parsitakse neid malli info, makrode ja kursori asukoha leidmiseks.
Fali lugedes otsib parser ridu, mille alguses seisab katetemplate:, sest just neisse peaks olema salvestatud malli info kujul MUUTUJANIMI=VÄÄRTUS. Esimest rida, mille alguses ei seisa katetemplate:, peetakse malli sisu alguseks. VÄÄRTUS võib olla mis tahes sümbol, välja arvatud võrdusmärk (=). Kindlasti tuntakse ära järgmised muutujad:
TemplateSee on malli nimi, mida näidatakse menüüs ->.
GroupGrupp asetab malli menüü -> alammenüüsse.
NameDokumendi nimi, mida näidatakse nii failinimekirjas kui tiitliribal. Kui nimes leidub %N, asendatakse see numbriga, mis samanimeliste dokumentide korral kasvab.
HighlightPlugin püüab uue dokumendi esiletõstu määrata selle muutuja väärtusele. Väärtus peab olema nimi, nagu see esineb menüüs ->.
DescriptionMalli lühike kirjeldus. Praegu on see kasutatav abivõimaluse 'Mis see on?' jaoks, kuid tulevikus võib-olla muukski.
See string määrab autori, näiteks kujul Nimi <e-posti aadress>. Praegu on see kasutatav abivõimaluse 'Mis see on?' jaoks, kuid tulevikus võib-olla muukski.
Malli sisu parsides avatakse makrod kujul %{NAME} või ${NAME}. Kui kasutad prefiksit $, koheldakse avatud makrot redigeeritava muutujana, kui dokument luuakse malli põhjal. % kasutamisel seda ei tehta, kui just avamine ei ebaõnnestu.
Toetatud on järgmised makrod:
Näitab käesolevat kellaaega kohalikul kujul.
Näitab käesolevat kuupäeva lühivormingus.
Näitab käesolevat kuupäeva ja kellaaega stringina kohalikul kujul.
Käesolev aasta neljakohalise numbrina.
Käesoleva kuu täisnimi kohalikul kujul.
Näitab käesolevat kuu päeva.
Näitab arvuti masinanime.
Näitab 'i'.
Näitab sinu täielikku nime, nagu selle määrab sinu standardse KDE aadressiraamatu omaniku aadress.
Näitab sinu eesnime, nagu selle määrab sinu standardse KDE aadressiraamatu omaniku aadress.
Näitab sinu perekonnanime, nagu selle määrab sinu standardse KDE aadressiraamatu omaniku aadress.
Näitab sinu e-posti aadressi, nagu selle määrab sinu standardse KDE aadressiraamatu omaniku aadress.
Kõiki muid makrosid tõlgendatakse prefiksist sõltumata redigeeritavate muutujatena. Kui üks ja sama muutuja esineb mallis mitu korda, saab neid redigeerida kohe korraga pärast dokumendi loomist malli põhjal.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Kate plugina “failimallid” autoriõigus 2004: Anders Lund (anders AT alweb.dk).
Dokumentatsiooni autoriõigus 2004: Anders Lund
Tõlge eesti keelde: Marek Laane (bald AT starman.ee)
Käesolev programm on litsenseeritud vastavalt GNU Üldise Avaliku Litsentsi tingimustele.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Iga apleti autoriõigus on ära märgitud vastavas peatükis.
Käesolev dokumentatsioon on litsenseeritud vastavalt GNU Vaba Dokumentatsiooni Litsentsi tingimustele.
Käesolev programm on litsenseeritud vastavalt GNU Üldise Avaliku Litsentsi tingimustele.
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team
Would you like to make a comment or contribute an update to this page?
Send feedback to the KDE Docs Team