diff options
Diffstat (limited to 'tde-i18n-sk/docs/kdebase/kate/highlighting.docbook')
| -rw-r--r-- | tde-i18n-sk/docs/kdebase/kate/highlighting.docbook | 567 |
1 files changed, 0 insertions, 567 deletions
diff --git a/tde-i18n-sk/docs/kdebase/kate/highlighting.docbook b/tde-i18n-sk/docs/kdebase/kate/highlighting.docbook deleted file mode 100644 index dcc3038decc..00000000000 --- a/tde-i18n-sk/docs/kdebase/kate/highlighting.docbook +++ /dev/null @@ -1,567 +0,0 @@ -<appendix id="highlight"> -<title ->Zvýrazňovanie syntaxu</title> - -<sect1 id="highlight-overview"> - -<title ->Prehľad</title> - -<para ->Zvýrazňovanie syntaxu spôsobuje, že editor automaticky zobrazuje text v rôznych štýloch a farbách v závislosti na jeho úlohe v súbore. V zdrojovom kóde programu môžu byť príkazy vypísané tučné, dátové typy a komentáre môžu používať inú farbu než zvyšok textu. Tým sa výrazne zlepší čitateľnosť textu a to pomáha, aby bol autor výkonnejší.</para> - -<mediaobject -> <imageobject -><imagedata format="PNG" fileref="highlighted.png"/></imageobject -> <textobject -><phrase ->Funkcia v jazyku Perl so zvýraznením.</phrase -></textobject -> <caption -><para ->Funkcia v jazyku Perl so zvýraznením.</para -> </caption -> </mediaobject> - -<mediaobject -> <imageobject -><imagedata format="PNG" fileref="unhighlighted.png"/></imageobject -> <textobject -><phrase ->Rovnaká funkcia Perl bez zvýraznenia.</phrase -></textobject -> <caption -><para ->Rovnaká funkcia Perl bez zvýraznenia.</para -></caption -> </mediaobject> - -<para ->Dva príklady. Ktorý sa číta lepšie?</para> - -<para ->&kate; obsahuje flexibilný, konfigurovateľný a výkonný systém pre zvýrazňovanie syntaxu a štandardná distribúcia poskytuje definície pre veľké množstvo programovacích jazykov, jazykov markup, skriptovacích jazykov a iných textových formátov. Navyše môžete definovať svoje vlastné definície pomocou jednoduchých súborov &XML;.</para> - -<para ->&kate; automaticky určuje správne pravidlá pri otvorení súboru na základe jeho typu &MIME;. Typ súboru je určený podľa prípony alebo, ak žiadnu nemá, podľa jeho obsahu. V prípade, že sa nepodarí správne určenie, môžete správne pravidlá nastaviť pomocou menu <menuchoice -><guimenu ->Dokumenty</guimenu -><guisubmenu ->Zvýrazňovací mód</guisubmenu -></menuchoice ->.</para> - -<para ->Štýly a farby použité v každej definícii zvýraznenia spolu s typmi &MIME;, pre ktoré by sa mala definícia použiť, je možné nastaviť pomocou stránky <link linkend="config-dialog-editor-hl" ->Zvýraznenie</link -> v <link linkend="config-dialog" ->dialógu nastavenia</link ->.</para> - -<note -> <para ->Zvýraznenie syntaxu má zlepšiť čitateľnosť správneho textu, ale nemôžete si myslieť, že funguje ako overenie vášho textu. Označenie textu môže byť v závislosti na používanom formáte dosť zložité a v niektorých prípadoch budú autori pravidiel radi, ak dosiahnu 98% presnosť označenia. Aby ste ale narazili na nesprávne 2%, budete musieť mať asi dosť šťastia.</para -> </note> - -<tip -> <para ->Môžete si stiahnuť aktualizované alebo nové definície zvýrazňovania z webovej stránky &kate; kliknutím na tlačidlo <guibutton ->Stiahnutie</guibutton -> v <link linkend="config-dialog-editor-hl" ->stránke Zvýraznenie</link -> v <link linkend="config-dialog" ->dialógu nastavenia</link ->.</para -> </tip> - -</sect1> - -<sect1 id="katehighlight-system"> - -<title ->Systém zvýrazňovania &kate;</title> - -<para ->Táto kapitola detailné popisuje mechanizmus zvýrazňovania syntaxu &kate; Má zmysel v prípade, že vás to zaujíma, alebo chcete napísať alebo upraviť definíciu zvýrazňovania.</para> - -<sect2 id="katehighlight-howitworks"> - -<title ->Ako to funguje</title> - -<para ->Vždy, ked otvoríte súbor, jednou z prvých vecí, ktoré &kate; urobí je, že detekuje, ktorú definíciu zvýrazňovania má použiť pre tento súbor. Počas čítania obsahu súboru a ked píšete, systém zvýrazňovania analyzuje text pomocou pravidiel definovaných v definícii vybraného zvýrazňovania a označovať časti textu v závislosti na jeho kontexte.</para> - -<para ->Ak niečo napíšete do dokumentu, nový text sa analyzuje a označuje za behu, takže ak zmažete znak, ktorý označuje začiatok alebo koniec kontextu, štýl okolného textu sa zmení podľa toho.</para> - -<para ->Definície syntaxu používané systémom v &kate; sú súbory &XML; obsahujúce <itemizedlist -> <listitem -><para ->Pravidlá pre určenie role textu, organizované do kontextových blokov</para -></listitem -> <listitem -><para ->Zoznamy kľúčových slov</para -></listitem -> <listitem -><para ->Definície položiek štýlu</para -></listitem -> </itemizedlist -> </para> - -<para ->Pri analýze textu sa vyhodnocujú pravidlá pre detekciu v poradí, v ktorom sú definované a ak začiatok aktuálneho reťazca odpovedá pravidlu, použije sa odpovedajúci kontext. Začiatočný bod v texte sa presunie na koncový bod, kam až pravidlo odpovedá a začnú sa pravidlá vyhodnocovať znovu.</para> - -</sect2> - -<sect2 id="highlight-system-rules"> -<title ->Pravidlá</title> - -<para ->Detekčné pravidlá sú jadrom systému zvýrazňovania. Pravidlo je reťazec, znak alebo <link linkend="regular-expressions" ->regulárny výraz</link -> oproti ktorému sa text porovnáva. Obsahuje informácie o tom, ktorý štýl sa má použiť pre nájdený text. Môže prepnúť kontext bud na nejaký priamo určený alebo na predchádzajúci, ktorý sa používal predtým.</para> - -<para ->Pravidlá sú utriedené v skupinách kontextu. Skupina kontextu sa používa pre hlavné textové koncepty formátu, napríklad reťazce alebo komentáre v programovom kóde. To zabezpečí, že systém zvýrazňovania nemusí prehľadávať všetky pravidlá ak to nie je nutné a že niektoré sekvencie znakov v texte môžu byť chápané rôzne v rôznych kontextoch. </para> - -</sect2> - -<sect2 id="highlight-context-styles-keywords"> -<title ->Kontextové štýly a kľúčové slová</title> - -<para ->V niektorých programovacích jazykoch sa celé čísla v kompilátore (programe, ktorý prevádza programovací jazyk na spustiteľný program) spracovávajú inak ako reálne a môžu niektoré znaky chápať špeciálne, ak sú napríklad v úvodzovkách. V takých prípadoch má zmysel ich zobrazenie iným spôsobom tak, aby ich bolo ľahké nájsť. Takže aj ked nereprezentujú špeciálne kontexty, môže ich zvýrazňovací systém tak chápať a označiť inak.</para> - -<para ->Definície syntaxu môžu obsahovať toľko štýlov, koľko ich je treba.</para> - -<para ->Vo veľa formátoch sú zoznamy slov, ktoré reprezentujú špeciálne koncepty. Napríklad programovacie jazyky obsahujú koncept príkazov, koncept mien datových typov a koncept zabudovaných funkcií. Systém zvýrazňovania &kate; dokáže takéto zoznamy detekovať a označiť slová textu pre zvýraznenie konceptov textových formátov.</para> - -</sect2> - -<sect2 id="kate-highlight-system-default-styles"> -<title ->Štandardné štýly</title> - -<para ->Ak otvoríte zdrojový kód C++, &Java; alebo dokument <acronym ->HTML</acronym -> v &kate;, uvidíte, že aj ked sú označené iné časti textu, použijú sa rovnaké farby. To preto, lebo &kate; má preddefinované štandardné štýly, ktoré sa využívajú v jednotlivých definíciách.</para> - -<para ->Preto je jednoduché rozpoznať podobné koncepty v rôznych formátoch. Napríklad komentáre existujú skoro vo všetkých programovacích, skriptovacích a markup jazykoch. A ak sú vo všetkých jazykoch zobrazené rovnakým štýlom, nemusíte sa nad nimi vôbec zamýšľať.</para> - -<tip -> <para ->Všetky štýly v definícii používajú jeden zo štandardných štýlov. Niektoré definície používajú viac štýlov než koľko je štandardných, takže ak používate nejaký formát často, asi sa vyplatí v dialógu nastavenia overiť, že sa pre rovnaké koncepty používa rovnaký štýl. Napríklad, existuje iba jeden štandardný štýl pre reťazce, ale v programovacom jazyku perl existujú dva typ reťazcov. Preto má zmysel, aby zvýraznenie pre ne používalo trochu iné štýly.</para -> </tip> - -</sect2> - -</sect1> - -<sect1 id="katehighlight-xml-format"> -<title ->&XML; formát definície zvýrazňovania</title> - -<sect2> -<title ->Prehľad</title> - -<para ->Táto kapitola obsahuje prehľad formátu pre definíciu zvýrazňovania. Popisuje hlavné časti, ich význam a použitie. Detailne popisuje pravidlá pre detekciu.</para> - -<para ->Formálna definície, čiže <acronym ->DTD</acronym -> je uložená v súbore <filename ->language.dtd</filename ->, ktorý by mal byť nainštalovaný na vašom systéme v priečinku <filename ->$<envar ->KDEDIR</envar ->/share/apps/kate/syntax</filename ->.</para> - -<variablelist -> <title ->Hlavné časti definície zvýrazňovania v &kate;</title -> <varlistentry -> <term ->Časť General</term -> <listitem -> <para ->Časť General obsahuje informácie o formáte komentárov popisovaného jazyka a definuje, či sa u kľúčových slov rozlišuje veľkosť písmen.</para -> </listitem -> </varlistentry -> <varlistentry -> <term ->Highlighting</term -> <listitem -> <para ->Časť Highlighting obsahuje všetky dáta potrebné pre analýzu a zobrazenie textu. To znamená:</para -> <variablelist -> <varlistentry -> <term ->ItemDatas</term -> <listitem -><para ->Obsahuje elementy ItemData, každý definuje štýl.</para -></listitem -> </varlistentry -> <varlistentry -> <term ->Zoznamy kľúčových slov</term -> <listitem -> <para ->Každý zoznam má meno a môže obsahovať ľubovoľný počet položiek.</para -> </listitem -> </varlistentry -> <varlistentry -> <term ->Contexts</term -> <listitem -> <para ->Obsahuje kontexy, ktoré môžu tiež obsahovať pravidlá pre detekciu.</para -> </listitem -> </varlistentry -> </variablelist -> </listitem -> </varlistentry -> </variablelist> - -</sect2> - -</sect1> - -<sect1 id="kate-highlight-rules-detailled"> -<title ->Pravidlá pre detekciu</title> - -<para ->Táto časť popisuje pravidlá pre detekciu syntaxe.</para> - -<para ->Každé pravidlo môže nájsť nula alebo viac znakov na začiatku reťazca, ktorý sa testuje. Ak pravidlo odpovedá, nájdeným znakom sa priradí štýl alebo <emphasis ->atribút</emphasis -> definovaný pravidlom a pravidlo môže požiadať o zmenu kontextu.</para> - -<para ->Atribúty <emphasis ->attribute</emphasis -> a <emphasis ->context</emphasis -> sú spoločné a pre všetky pravidlá.</para> - -<para ->Pravidlo vyzerá takto:</para> - -<programlisting -><RuleName attribute="(identifier)" context="(identifikátor|poradie)" [atribúty pravidla] /></programlisting> - -<para -><emphasis ->attribute</emphasis -> identifikuje štýl, ktorý sa má použiť pre nájdené znaky pomocou mena alebo indexu. <emphasis ->context</emphasis -> identifikuje kontext, ktorý sa odteraz bude používať.</para> - -<para ->Atribút <emphasis ->attribute</emphasis -> je možné identifikovať menom alebo indexom (počítaným od 0) v skupine ItemDatas.</para> - -<para -><emphasis ->context</emphasis -> je možné identifikovať pomocou:</para> - -<itemizedlist -> <listitem -> <para -><emphasis ->identifikátor</emphasis ->, momentálne to môže byť iba index (počítaný od 0) v skupine kontextov.</para -> </listitem -> <listitem -> <para -><emphasis ->poradie</emphasis -> povie systému, že má zostať v aktuálnom kontexte (<userinput ->#stay</userinput ->) alebo sa vrátiť do predchádzajúceho kontextu (<userinput ->#pop</userinput ->).</para -> <para ->Ak sa chcete vrátiť o viac ako jedej krok, kľúčové slovo #pop: <userinput ->#pop#pop#pop</userinput -></para -> </listitem -> </itemizedlist> - -<para ->Niektoré pravidlá môžu mať <emphasis ->pod-pravidlá</emphasis ->, ktoré sa potom vyhodnocujú iba v prípade, že sa rodičovské pravidlo aplikuje. Celý odpovedajúci reťazec sa nájde podľa atribútu v rodičovskom pravidle. Pod-pravidlá vyzerajú takto:</para> - -<programlisting> -<MenoPravidla (atribúty)> - <MenoPodPravidla (atribúty) /> - ... -</MenoPravidla> -</programlisting> - - -<para ->Atribúty špecifické pre jednotlivé pravidlá sú popísané v nasledujúcom zozname.</para -> - -<variablelist -> <title ->Detaily pravidiel</title -> <varlistentry -> <term ->DetectChar</term -> <listitem -> <para ->Detekuje jediný znak. Obvykle sa používa napríklad pre nájdenie konca reťazca v úvodzovkách.</para -> <programlisting -><DetectChar char="(znak)" (spoločné atribúty) /></programlisting -> <para ->Atribút <userinput ->char</userinput -> definuje hľadaný znak.</para -> </listitem -> </varlistentry -> <varlistentry -> <term ->Detect2Chars</term -> <listitem -> <para ->Detekuje dva špecifické znaky v danom poradí.</para -> <programlisting -><Detect2Chars char="(znak)" char1="(znak)" (spoločné atribúty) /></programlisting -> <para ->Atribút <userinput ->char</userinput -> definuje prvý hľadaný znak a <userinput ->char1</userinput -> druhý.</para -> </listitem -> </varlistentry -> <varlistentry -> <term ->AnyChar</term -> <listitem -> <para ->Detekuje jeden znak zo skupiny zadaných znakov.</para -> <programlisting -><AnyChar String="(reťazec)" (spoločné atribúty) /></programlisting -> <para ->Atribút <userinput ->String</userinput -> definuje množinu znakov.</para -> </listitem -> </varlistentry -> <varlistentry -> <term ->StringDetect</term -> <listitem -> <para ->Detekuje presný reťazec.</para -> <programlisting -><StringDetect String="(reťazec)" [insensitive="TRUE|FALSE;"] (spoločné atribúty) /></programlisting -> <para ->Atribút <userinput ->String</userinput -> definuje hľadaný reťazec. Atribút <userinput ->insensitive</userinput -> je štandardne <userinput ->FALSE</userinput -> a predáva sa funkcii pre porovnávanie reťazcov. Ak je hodnota <userinput ->TURE</userinput ->, použije sa porovnávanie bez rozlišovania veľkosti písmen.</para -> </listitem -> </varlistentry -> <varlistentry -> <term ->RegExpr</term -> <listitem -> <para ->Hľadá pomocou regulárneho výrazu.</para -> <programlisting -><RegExpr String="(reťazec)" [insensitive="TRUE|FALSE;"] [minimal="TRUE|FALSE"] (spoločné atribúty) /></programlisting -> <para ->Atribút <userinput ->String</userinput -> definuje regulárny výraz.</para -> <para -><userinput ->insensitive</userinput -> je štandardne <userinput ->FALSE</userinput -> a predáva sa systému hľadania pomocou regulárnych výrazov.</para -> <para -><userinput ->minimal</userinput -> je štandardne <userinput ->FALSE</userinput -> a predáva sa systému hľadania pomocou regulárnych výrazov.</para -> <para ->Pretože sa pravidlá vždy hľadajú od začiatku aktuálneho reťazca, regulárny výraz začínajúci znakom <literal ->^</literal -> znamená pravidlo, ktoré má hľadať iba na začiatku riadku.</para -> <para ->Dalšie informácie o nich nájdete v kapitole <link linkend="regular-expressions" ->Regulárne výrazy</link ->.</para -> </listitem -> </varlistentry -> <varlistentry -> <term ->Keyword</term -> <listitem -> <para ->Detekuje kľúčové slovo zo zadaného zoznamu.</para -> <programlisting -><keyword String="(meno zoznamu)" (spoločné atribúty) /></programlisting -> <para ->Atribút <userinput ->String</userinput -> identifikuje zoznam kľúčových slov pomocou mena. Zoznam s týmto menom musí existovať.</para -> </listitem -> </varlistentry -> <varlistentry -> <term ->Int</term -> <listitem -> <para ->Detekuje celé číslo.</para -> <para -><programlisting -><Int (spoločné atribúty) /></programlisting -></para -> <para ->Toto pravidlo nemá žiadne špecifické atribúty. Pod-pravidlá sa typicky používajú pre detekciu kombinácií <userinput ->L</userinput -> a <userinput ->U</userinput -> po čísle, používané pre určenie celých čísel v programovom kóde.</para -> </listitem -> </varlistentry -> <varlistentry -> <term ->Float</term -> <listitem -> <para ->Detekuje reálne číslo.</para -> <para -><programlisting -><Float (spoločné atribúty) -/></programlisting -></para -> <para ->Toto pravidlo nemá žiadne špeciálne atribúty.</para -> </listitem -> </varlistentry -> <varlistentry -> <term ->HlCOct</term -> <listitem -> <para ->Detekuje číslo v osmičkovej sústave.</para -> <para -><programlisting -><HlCOct (spoločné atribúty) /></programlisting -></para -> <para ->Toto pravidlo nemá žiadne špeciálne atribúty.</para -> </listitem -> </varlistentry -> <varlistentry -> <term ->HlCHex</term -> <listitem -> <para ->Detekuje šestnástkové číslo.</para -> <para -><programlisting -><Int (spoločné atribúty) /></programlisting -></para -> <para ->Toto pravidlo nemá žiadne špeciálne atribúty.</para -> </listitem -> </varlistentry -> <varlistentry -> <term ->HlCStringChar</term -> <listitem -> <para ->Detekuje znak začínajúci \ (escaped).</para -> <para -><programlisting -><HlCStringChar (spoločné atribúty) -/></programlisting -></para -> <para ->Toto pravidlo nemá žiadne špeciálne atribúty.</para -> <para ->Nájde textovú reprezentáciu neviditeľných znakov obvykle používaných v programovacích jazykoch, napríklad <userinput ->\n</userinput -> (koniec riadku) alebo <userinput ->\t</userinput -> (tabulátor).</para -> <para ->Nasledujúce znaky budú nájdené ak sú po <literal ->\</literal ->: <userinput ->abefnrtv"'?</userinput ->. Okrem toho to nájde aj escapované šestnástkové a osmičkové čísla, napríklad <userinput ->\033</userinput ->.</para -> </listitem -> </varlistentry -> <varlistentry -> <term ->RangeDetect</term -> <listitem -> <para ->Detekuje reťazec s definovanými začiatočnými a koncovými znakmi.</para -> <programlisting -><RangeDetect char="(znak)" char1="(znak)" (spoločné atribúty) /></programlisting -> <para -><userinput ->char</userinput -> definuje prvý znak rozsahu, <userinput ->char2</userinput -> definuje posledný znak rozsahu.</para -> <para ->Hodí sa napríklad pre detekovanie malých reťazcov v úvodzovkách, ale uvedomte si, že systém pracuje po riadkoch, nenájde reťazce, ktoré majú viac riadkov.</para -> </listitem -> </varlistentry -> <varlistentry -> <term ->LineContinue</term -> <listitem -> <para ->Zodpovedá koncu riadku.</para -> <programlisting -><LineContinue (spoločné atribúty) /></programlisting -> <para ->Toto pravidlo nemá žiadne špeciálne atribúty.</para -> <para ->Toto pravidlo sa hodí pre prepínanie kontextu na konci riadku.</para -> </listitem -> </varlistentry -> </variablelist> - -</sect1> - -</appendix> - |