<chapter id="plugins">

<chapterinfo>
<authorgroup>
<author
>&Anders.Lund; &Anders.Lund.mail;</author>
<othercredit role="translator"
><firstname
>Oliver</firstname
><surname
>Kellogg</surname
><affiliation
><address
><email
>okellogg@users.sf.net</email
></address
></affiliation
><contrib
>Translation</contrib
></othercredit
> 
</authorgroup>
</chapterinfo>

<title
>Laborante kun Kromaĵoj</title>

<para
>Vi povas ebligi la individuajn kromaĵojn en la <link linkend="configuring-kate-configdialog"
>agorda dialogo</link
>, kiu ankaŭ disponigas aliron al pliaj agordaj opcioj por kromaĵoj kiuj postulas ĝin.</para>

<sect1 id="kate-application-plugins">
<title
>&kate; Aplikaj Kromaĵoj</title>

<!-- from doc/kate-addons/index.docbook -->
<para
>&kate; kromprogramoj estas aldonaj funkcioj por la &kate; redaktisto. Ili povas aldoni kromajn menuojn kaj ŝparvojojn, kaj etendi la funkciojn de &kate;. Vi povas instali tiom da aŭ kiom vi volas, el ene de &kate;. Malfermu la agordan dialogon de &kate; per <menuchoice
><guimenu
>Agordoj</guimenu
><guimenuitem
>Agordu &kate;...</guimenuitem
></menuchoice
> Elektu <menuchoice
><guimenu
>Aplikon</guimenu
><guimenuitem
>Aldonaĵoj</guimenuitem
></menuchoice
> por elekti la deziratajn kromaĵojn. </para>

<para
>La disponeblaj aplikaĵaldonaĵoj estas: </para>
<itemizedlist>
<listitem>
<para
><link linkend="kate-application-plugin-external-tools"
>Eksteraj Iloj</link
> - Ruli eksterajn ilojn kaj aplikaĵojn</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-backtracebrowser"
>Retumilo por malantaŭa spuro</link
> - C/C++ Retrovoja naviga ilo-vido</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-build"
>Konstrui kromprogramon</link
> - Kompili aŭ 'Make' kaj analizi erarmesaĝojn</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-closeexceptlike"
>Fermi Krom/Ŝati</link
> - Fermi grupon de dokumentoj bazitaj sur ofta vojo aŭ dosiera etendo</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-colorpicker"
>Kolorelektanto</link
> - Montri antaŭrigardon por konataj kolornomoj</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-colored-brackets"
>Kolorigitaj krampoj</link
> - Koloraj krampoj por legi</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-ctags"
>CTags</link
> - Serĉi difinojn/deklarojn per CTags</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-preview"
>Antaŭrigardo de dokumentoj</link
> - Antaŭrigardi la dokumenton en la celformato.</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-documentswitcher"
>Dokumentŝanĝilo</link
> - Rapida ŝanĝado de dokumentoj kun <keycombo action="simul"
>&Alt;&Tab;</keycombo
> konduto</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-fsbrowser"
>Dosiersistem-Retumilo</link
> - Dosiera retumila ilo-vido</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-documents"
>Dokumenta Arbo-Vido</link
> - Montras la malfermitajn dosierojn en dosierarbo</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-gdb"
>&gdb;</link
> - Provizas simplan &gdb; fasado</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-projects"
>Projekta Kromaĵo</link
> - Integriĝo kun &git; kaj aliaj fontversiigsistemoj</para>
</listitem>
<listitem>
<para
>Replicode - Konstruktivisma AI-lingvo kaj rultempo</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-lspclient"
>LSP-kliento</link
> - LSP-kliento provizanta kodnavigadon kaj kodkompletigon por multaj lingvoj</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-searchinfiles"
>Serĉi &amp; Anstataŭigi</link
> - Serĉi kaj anstataŭigi en dokumentoj, dosierujoj aŭ projektoj</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-snippets"
>Vido de fragmentoj ilo</link
> - Vido de ilo enkonstruanta la administradon de fragmentoj</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-keyboardmacros"
>Klavaraj makrooj</link
> - Registri kaj ludi klavarajn makroojn (t.e. klavarajn agsekvencojn)</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-sql"
>SQL-aldonaĵo</link
> - Efektivigi demandon al SQL-datumbazoj</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-symbolviewer"
>Simbol-Vidilo</link
> - Ekstrakti kaj montri referencajn simbolojn el la fonto</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-konsole"
>Vido de terminalilo</link
> - Havu terminalon preta, uzante la fenestraĵon &konsole; de &kde;</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-textfilter"
>Teksto-Filtrilo</link
> - Prilabori tekston per finaj komandoj</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmltools"
>&XML;-Kompletigo</link
> - Listigas &XML; elementojn, atributojn, atributajn valorojn kaj entojn permesitajn de DTD</para>
</listitem>
<listitem>
<para
><link linkend="kate-application-plugin-xmlcheck"
>&XML; Validumado</link
>- Validigas &XML; dosieroj uzante xmllint</para>
</listitem>
</itemizedlist>
</sect1>

<sect1 id="kate-application-plugin-external-tools">
<title
>Eksteraj Iloj</title>

<para
>La kromaĵo <guilabel
>Eksteraj Iloj</guilabel
> permesas alvoki eksterajn aplikaĵojn kun datumoj rilataj al la aktuala dokumento, ekzemple ĝia URL, dosierujo, teksto aŭ elekto. Post kiam ebligita, agorda paĝo aperas kiel ĉi-sube, kiu permesas ŝanĝi aŭ forigi ekzistantajn ilojn. Simile, novaj iloj povas esti aldonitaj laŭ via plaĉo. La iloj tiam aperos en la submenuo <guisubmenu
>Eksteraj Iloj</guisubmenu
> de la menuo <guimenu
>Iloj</guimenu
> de la aplikaĵo. </para>

<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="kateexternaltools.png"/>
</imageobject>
</mediaobject>

<para
>La agorda paĝo permesas aldoni novajn eksterajn ilojn alklakante la butonon <guilabel
>Aldoni</guilabel
>. En ĉi tiu kazo, aperas ŝprucmenuo, kie oni povas aŭ aldoni novan eksteran ilon, aldoni ekzistantan ilon el antaŭdifinita listo, aŭ aldoni novan kategorion por organizi la eksterajn ilojn en kategoriojn. Simile, la ekzistantaj iloj povas esti modifitaj aŭ per duobla klako aŭ alvokante <guilabel
>Redakti...</guilabel
>, kaj <guilabel
>Forigi</guilabel
> forigas la elektitajn ilojn. </para>

<sect2 id="kate-application-plugin-external-tools-edit">
<title
>Agordo de Eksteraj Iloj</title>

<para
>Redakti ilon malfermas agordan dialogon kiu permesas fajnan agordon de la ilo:</para>

<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="kateeditexternaltool.png"/>
</imageobject>
</mediaobject>

<variablelist>
<varlistentry>
<term
>Kiel videblas, multaj detaloj povas esti difinitaj, nome:</term>
<listitem>
<para
><userinput
>Nomo</userinput
>, la nomo de la ilo, kiu poste aperos en la menuo.</para>
<para
><userinput
>Piktogramo</userinput
>, laŭvola piktogramo kiu estas videbla en la menuo.</para>
<para
><userinput
>Efektivebla</userinput
>, efektivigebla inkluzivanta aŭ plenan vojon, aŭ via ruleblaĵo devas esti en la mediovariablo <envar
>PATH</envar
>.</para>
<para
><userinput
>Argumentoj</userinput
>, laŭvolaj argumentoj, kiuj estas transdonitaj al la rulebla.</para>
<para
><userinput
>Enigo</userinput
>, laŭvola enigo kiu estas transdonita al la procezo per stdin.</para>
<para
><userinput
>Labora dosierujo</userinput
>, la labordosierujo en kiu la ilo estos komencita. Se malplena, la labordosierujo estas agordita al la vojo de la aktuala dokumento.</para>
<para
><userinput
>Mimspecoj</userinput
>, se agordita, la ilo estas aktiva nur se la mime-speco de la aktuala dokumento kongruas.</para>
<para
><userinput
>Konservi</userinput
>, kiam oni alvokas, konservas neniun, la aktualan dokumenton, aŭ ĉiujn dokumentojn.</para>
<para
><userinput
>Trigger</userinput
>, ekigilo por ruli ĉi tiun ilon. Trigger nur influos la nuntempe aktivan dokumenton kaj nur efektiviĝos se la mime-tipo de nuna aktiva dokumento kongruas kun la mimetipo de la ekstera ilo.</para>
    <variablelist
><varlistentry>
    <term
>Jen disponeblaj ekigiloj:</term>
    <listitem>
    <para
><userinput
>Neniu</userinput
>, ĉi tio estas la defaŭlta, tio signifas, ke la ilo ne havas ekigilon.</para>
    <para
><userinput
>Antaŭ Konservi</userinput
>, ĉi tiu ekigilo efektiviĝos ĝuste antaŭ konservi la dokumenton.</para>
    <para
><userinput
>Post Konservi</userinput
>, ĉi tiu ekigilo rulos la ilon post kiam la dokumento estis konservita.</para>
    </listitem>
    </varlistentry
></variablelist>
<para
><userinput
>Reŝargi aktualan dokumenton post rulo</userinput
>, utila kiam la aktuala dosiero estas modifita sur disko.</para>
<para
><userinput
>Eligo</userinput
>, la eligo difinas la celon de stdout. Ĝi estas aŭ agordita al <userinput
>Ignorita</userinput
>, <userinput
>Enmeti ĉe Kursora pozicio</userinput
>, <userinput
>Anstataŭigi Elektitan Tekston</userinput
>, <userinput
>Anstataŭigi Aktualan Dokumenton</userinput
>, <userinput
>Aldoni al Aktuala Dokumento</userinput
>, <userinput
>Enmeti en Novan Dokumenton</userinput
>, <userinput
>Kopii al Tondujo</userinput
>, aŭ <userinput
>Montri en Paneo</userinput
>.</para>
<para
><userinput
>Komando de Redaktoro</userinput
>, laŭvola komando kiu povas esti uzata por alvoki la eksteran ilon per la enkonstruita <ulink url="help:/katepart/advanced.html#advanced-editing-tools-commandline"
>komandlinio</ulink
>.</para>
</listitem>
</varlistentry>
</variablelist>

<para
>La butono <guilabel
>Defaŭltoj</guilabel
> estas videbla nur por iloj, kiuj estas senditaj kun Kate. Kiam oni klakis, ĉiuj agordoj de ilo revenis al defaŭltaj (alinome fabriko) valoroj. </para>

</sect2>

<sect2 id="kate-application-plugin-external-tools-variables">
<title
>Variebla Vastiĝo</title>

<para
>Kelkaj redaktaj kampoj kiel la <guilabel
>Efektivebla</guilabel
>, la <guilabel
>Argumentoj</guilabel
>, la <guilabel
>Enigo</guilabel
> kaj la <guilabel
>Labora Dosierujo</guilabel
> subtenas variablojn kiuj estas vastigitaj pri ilvoko. Ĉi tio estas indikita per la piktogramo <guilabel
>{}</guilabel
> kiu aperas post kiam unu el ĉi tiuj tekstaj enigokampoj havas fokuson (vidu ruĝan cirklon): </para>

<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="katevariableexpansion.png"/>
</imageobject>
</mediaobject>

<para
>Ŝvebi super unu el ĉi tiuj tekstaj enigokampoj ankaŭ montras konsileton kun la nuna vastigita teksto. Plue, alklakante la ago <guilabel
>{}</guilabel
> malfermos dialogon kiu listigas ĉiujn disponeblajn variablojn: </para>

<mediaobject>
<imageobject>
<imagedata format="PNG" fileref="kateexternaltoolvariablechooser.png"/>
</imageobject>
</mediaobject>

<para
>Ĉi tiu funkcio provizas multe da fleksebleco dum difinado de ekstera ilo ĉar ĉiuj variabloj de la formo <userinput
>%{...}</userinput
> estas vastigitaj kiam la ilo estas alvokita. Estas du specoj de variabloj subtenataj: <itemizedlist
> <listitem
><para
><userinput
>%{variable-name}</userinput
></para
></listitem
> <listitem
><para
><userinput
>%{variable-name:&lt;value&gt;}</userinput
></para
></listitem
> </itemizedlist
> La unua formo <userinput
>%{variable-name}</userinput
> simple anstataŭigas la variablon per ĝia enhavo. Ekzemple, la variablo <userinput
>%{Document:FileName}</userinput
> estas anstataŭigita per la dosiernomo de la nuna dokumento sen ĝia vojo. La dua formo <userinput
>%{variable-name:&lt;value&gt;}</userinput
> ricevas la <userinput
>&lt;value&gt;</userinput
> kiel enhavon. Ekzemple, ĉi tio povas esti uzata por vastigi mediovariablon kun <userinput
>%{ENV:HOME}</userinput
>, aŭ oni povas akiri la aktualan daton en la preferata formato kiel <userinput
>%{Date:yyyy-MM-dd}</userinput
>. </para>

<variablelist>
<varlistentry>
<term
>Subtenataj variabloj inkluzivas:</term>
<listitem>
<para
><userinput
>Dokumento:FileBaseName</userinput
>: Dosierbaza nomo sen vojo kaj sufikso de la aktuala dokumento.</para>
<para
><userinput
>Dokumento:FileExtension</userinput
>: Dosiera etendo de la aktuala dokumento.</para>
<para
><userinput
>Dokumento:FileName</userinput
>: Dosiernomo sen vojo de la aktuala dokumento.</para>
<para
><userinput
>Dokumento:Dosiero-vojo</userinput
>: Plena vojo de la aktuala dokumento inkluzive de la dosiernomo</para>
<para
><userinput
>Dokumento:Teksto</userinput
>: Enhavo de la nuna dokumento.</para>
<para
><userinput
>Dokument:Path</userinput
>: Plena vojo de la aktuala dokumento ekskludante la dosiernomon.</para>
<para
><userinput
>Dokumento:NativeFilePath</userinput
>: Plena dokumentvojo inkluzive de dosiernomo, kun denaska vojo apartigilo (deklivsigno ĉe Vindozo).</para>
<para
><userinput
>Dokumento:NativePath</userinput
>: Plena dokumentvojo ekskluzive de dosiernomo, kun denaska vojo apartigilo (deklivsigno ĉe Vindozo).</para>
<para
><userinput
>Dokumento:Cursor:Line</userinput
>: Linia numero de la teksta kursoropozicio en aktuala dokumento (komencas per 0).</para>
<para
><userinput
>Document:Cursor:Column</userinput
>: Kolumna numero de la teksta kursoropozicio en aktuala dokumento (komencas per 0).</para>
<para
><userinput
>Document:Cursor:XPos</userinput
>: X-komponento en ĉieaj ekrankoordinatoj de la kursora pozicio.</para>
<para
><userinput
>Document:Cursor:YPos</userinput
>: Y-komponento en ĉieaj ekrankoordinatoj de la kursora pozicio.</para>
<para
><userinput
>Dokumento:Selection:Text</userinput
>: Teksta elekto de la aktuala dokumento.</para>
<para
><userinput
>Dokumento:Selection:StartLine</userinput
>: Komenca linio de elektita teksto de la aktuala dokumento.</para>
<para
><userinput
>Dokumento:Selection:StartColumn</userinput
>: Komencu kolumnon de elektita teksto de la aktuala dokumento.</para>
<para
><userinput
>Dokumento:Selection:EndLine</userinput
>: Finlinio de elektita teksto de la aktuala dokumento.</para>
<para
><userinput
>Dokumento:Selection:EndColumn</userinput
>: Finkolumno de elektita teksto de la aktuala dokumento.</para>
<para
><userinput
>Dokumento:RowCount</userinput
>: Nombro de vicoj de la aktuala dokumento.</para>
<para
><userinput
>Dokumento:Variable:&lt;variable&gt;</userinput
>: Plivastigi arbitrajn <ulink url="help:/katepart/config-variables.html"
>dokumentvariablojn</ulink
>.</para>
<para
><userinput
>Dato:Locale</userinput
>: La aktuala dato en aktuala loka formato.</para>
<para
><userinput
>Dato:ISO</userinput
>: La aktuala dato (ISO).</para>
<para
><userinput
>Dato:&lt;value&gt;</userinput
>: La aktuala dato (<ulink url="https://doc.qt.io/qt-5/qdate.html#toString"
>QDate formatstring</ulink
>).</para>
<para
><userinput
>Time:Locale</userinput
>: La nuna horo en aktuala loka formato.</para>
<para
><userinput
>Tempo:ISO</userinput
>: La nuna horo (ISO).</para>
<para
><userinput
>Tempo:&lt;value&gt;</userinput
>: La nuna horo (<ulink url="https://doc.qt.io/qt-5/qtime.html#toString"
>QTime formatstring</ulink
>).</para>
<para
><userinput
>ENV:&lt;value&gt;</userinput
>: Aliro al mediovariabloj.</para>
<para
><userinput
>JS:&lt;expression&gt;</userinput
>: Taksi simplajn JavaScript-deklarojn.</para>
<para
><userinput
>ProcentEncoded:&lt;text&gt;</userinput
>: Procento kodita teksto.</para>
<para
><userinput
>UUID</userinput
>: Generi novan UUID.</para>
</listitem>
</varlistentry>
</variablelist>

 

</sect2>

<sect2 id="kate-application-plugin-external-tools-defaults">
<title
>Listo de Defaŭltaj Iloj</title>

<para
>Pluraj iloj estas senditaj defaŭlte. Tamen, se vi havas pli utilajn ilojn bonvolu kontribui tiujn al <email
>kwrite-devel@kde.org</email
> por ke ni povu aldoni ilin al ĉi tiu listo. Ĉiuj defaŭltaj iloj estas videblaj en la listvido defaŭlte. Tamen ĉiuj iloj povas esti ŝanĝitaj laŭplaĉe, inkluzive de la kategorio aŭ eĉ forigi ilojn. Forigitaj iloj povas esti aldonitaj denove alklakante la butonon <guibutton
>Aldoni</guibutton
> en la agorda paĝo kiel priskribite supre. </para>

<variablelist>
<title
>git-cola</title>

<varlistentry>
<term
>git-cola estas grafika git-kliento, kiu ebligas vin facile enscenigi kaj fari ŝanĝojn. Se instalite, ĝi haveblas ankaŭ per la komandlinio tajpante <userinput
>git-cola</userinput
></term>
<listitem>
<para
><userinput
>Nomo</userinput
>: git-cola</para>
<para
><userinput
>Piktogramo</userinput
>: git-cola</para>
<para
><userinput
>Efektivigebla</userinput
>: git-cola</para>
<para
><userinput
>Argumentoj</userinput
>: -r %{Document:Path}</para>
<para
><userinput
>Komando de redaktilo</userinput
>: git-cola</para>
</listitem>
</varlistentry>

</variablelist>


<variablelist>
<title
>gitk</title>

<varlistentry>
<term
>gitk estas ankaŭ git-kliento, kiu permesas bele bildigi la git-historion.</term>
<listitem>
<para
><userinput
>Nomo</userinput
>: gitk</para>
<para
><userinput
>Piktogramo</userinput
>: git-gui</para>
<para
><userinput
>Efektivigebla</userinput
>: gitk</para>
<para
><userinput
>Laboranta dosierujo</userinput
>: %{Document:Path}</para>
<para
><userinput
>Komando de redaktilo</userinput
>: gitk</para>
</listitem>
</varlistentry>

</variablelist>


<variablelist>
<title
>git blame</title>

<varlistentry>
<term
>Komencas git blame por facile sekvi git-ŝanĝojn en la nuna dosiero.</term>
<listitem>
<para
><userinput
>Nomo</userinput
>: git blame</para>
<para
><userinput
>Efektivigebla</userinput
>: git</para>
<para
><userinput
>Argumentoj</userinput
>: gui blame %{Document:FileName}</para>
<para
><userinput
>Konservi</userinput
>: Aktuala Dokumento</para>
<para
><userinput
>Laboranta dosierujo</userinput
>: %{Document:Path}</para>
<para
><userinput
>Komando de redaktilo</userinput
>: git-blame</para>
</listitem>
</varlistentry>

</variablelist>


<variablelist>
<title
>Lanĉi Ŝelskripton</title>

<varlistentry>
<term
>Lanĉas eksteran konzolon en kiu la aktuala dokumento estas rulita. La skripto bezonas indiki la interpretiston en la unua linio per shebang <userinput
>#!/path/interpreter</userinput
>.</term>
<listitem>
<para
><userinput
>Nomo</userinput
>: Lanĉi Ŝelskripton</para>
<para
><userinput
>Piktogramo</userinput
>: sistemfunkciado</para>
<para
><userinput
>Efektivigebla</userinput
>: konsole</para>
<para
><userinput
>Argumentoj</userinput
>: -e sh -c &quot;cd %{Document:Path} &amp;&amp; pwd &amp;&amp; chmod -vc a+x %{Document:FileName} &amp;&amp; ./%{Document:FileName} ; echo Premu iun ajn klavon por daŭrigi. &amp;&amp; read -n 1&quot;</para>
<para
><userinput
>Konservi</userinput
>: Aktuala Dokumento</para>
<para
><userinput
>Laboranta dosierujo</userinput
>: %{Document:Path}</para>
<para
><userinput
>Komando de redaktilo</userinput
>: rul-skripto</para>
</listitem>
</varlistentry>

</variablelist>


<variablelist>
<title
>Guglo Elektita Teksto</title>

<varlistentry>
<term
>Serĉi en guglo la elektitan tekston.</term>
<listitem>
<para
><userinput
>Nomo</userinput
>: Guglo Elektita Teksto</para>
<para
><userinput
>Piktogramo</userinput
>: globo</para>
<para
><userinput
>Efektivigebla</userinput
>: xdg-open</para>
<para
><userinput
>Argumentoj</userinput
>: &quot;https://www.google.com/search?q=%{Document:Selection:Text}&quot;</para>
<para
><userinput
>Komando de redaktilo</userinput
>: guglo</para>
</listitem>
</varlistentry>

</variablelist>


<variablelist>
<title
>Enigi UUID</title>

<varlistentry>
<term
>Enmetas novan UUID ĉiufoje kiam ĉi tiu ago estas alvokita.</term>
<listitem>
<para
><userinput
>Nomo</userinput
>: Enigi UUID</para>
<para
><userinput
>Efektivigebla</userinput
>: eĥo</para>
<para
><userinput
>Argumentoj</userinput
>: %{UUID}</para>
<para
><userinput
>Eligo</userinput
>: Enigi ĉe Kursora pozicio</para>
<para
><userinput
>Komando de redaktilo</userinput
>: uuid</para>
</listitem>
</varlistentry>

</variablelist>


<variablelist>
<title
>Clang Format Plena Dosiero</title>

<varlistentry>
<term
>Rulas clang-format sur la aktuala dosiero sur disko. La dokumento estas reŝargita poste.</term>
<listitem>
<para
><userinput
>Nomo</userinput
>: Clang Format Plena Dosiero</para>
<para
><userinput
>Efektivigebla</userinput
>: clang-format</para>
<para
><userinput
>Argumentoj</userinput
>: -i %{Document:FileName}</para>
<para
><userinput
>Laboranta dosierujo</userinput
>: %{Document:Path}</para>
<para
><userinput
>Konservi</userinput
>: Aktuala Dokumento</para>
<para
><userinput
>Reŝargi</userinput
>: Jes</para>
<para
><userinput
>Komando de redaktilo</userinput
>: clang-format-file</para>
</listitem>
</varlistentry>

</variablelist>


<variablelist>
<title
>Clang-Formati Elektita Teksto</title>

<varlistentry>
<term
>Rulas clang-format nur sur la elektita teksto en la nuna dokumento.</term>
<listitem>
<para
><userinput
>Nomo</userinput
>: Clang-Formati Elektitan Tekston</para>
<para
><userinput
>Efektivigebla</userinput
>: clang-format</para>
<para
><userinput
>Argumentoj</userinput
>: -assume-fileName: %{Document:FileName}</para>
<para
><userinput
>Laboranta dosierujo</userinput
>: %{Document:Path}</para>
<para
><userinput
>Enigo</userinput
>: %{Document:Selection:Text}</para>
<para
><userinput
>Eligo</userinput
>: Anstataŭigi Elektitan Tekston</para>
<para
><userinput
>Komando de redaktilo</userinput
>: clang-format-selection</para>
</listitem>
</varlistentry>

</variablelist>


<variablelist>
<title
>Antaŭrigardo de Qt Rapida 2 (qmlscene)</title>

<varlistentry>
<term
>Antaŭrigardas la aktualan qml-dosieron en qmlscene.</term>
<listitem>
<para
><userinput
>Nomo</userinput
>: Antaŭrigardo de Qt Quick 2 (qmlscene)</para>
<para
><userinput
>Efektivigebla</userinput
>: qmlscene</para>
<para
><userinput
>Argumentoj</userinput
>: %{Document:FileName}</para>
<para
><userinput
>Konservi</userinput
>: Aktuala Dokumento</para>
<para
><userinput
>Laboranta dosierujo</userinput
>: %{Document:Path}</para>
<para
><userinput
>Komando de redaktilo</userinput
>: qml-antaŭrigardo</para>
</listitem>
</varlistentry>

</variablelist>


<variablelist>
<title
>JSON Formato Plena Dosiero</title>

<varlistentry>
<term
>Formatu la tutan JSON-dosieron.</term>
<listitem>
<para
><userinput
>Nomo</userinput
>: JSON Formato Plena Dosiero</para>
<para
><userinput
>Piktogramo</userinput
>: application-json</para>
<para
><userinput
>Efektivigebla</userinput
>: jq</para>
<para
><userinput
>Argumentoj</userinput
>: %{Document:FileName}</para>
<para
><userinput
>Konservi</userinput
>: Aktuala Dokumento</para>
<para
><userinput
>Laboranta dosierujo</userinput
>: %{Document:Path}</para>
<para
><userinput
>Eligo</userinput
>: Anstataŭigi Aktualan Dokumenton</para>
<para
><userinput
>Komando de redaktilo</userinput
>: json-format-file</para>
</listitem>
</varlistentry>

</variablelist>


<variablelist>
<title
>XML Format Plena Dosiero</title>

<varlistentry>
<term
>Formatu la tutan XML-dosieron.</term>
<listitem>
<para
><userinput
>Nomo</userinput
>: JSON Formato Plena Dosiero</para>
<para
><userinput
>Piktogramo</userinput
>: application-xml</para>
<para
><userinput
>Efektivigebla</userinput
>: xmllint</para>
<para
><userinput
>Argumentoj</userinput
>: --format %{Document:FileName}</para>
<para
><userinput
>Konservi</userinput
>: Aktuala Dokumento</para>
<para
><userinput
>Laboranta dosierujo</userinput
>: %{Document:Path}</para>
<para
><userinput
>Eligo</userinput
>: Anstataŭigi Aktualan Dokumenton</para>
<para
><userinput
>Komando de redaktilo</userinput
>: xml-format-file</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>
</sect1>

<sect1 id="kate-application-plugin-backtracebrowser">
<!--https://kate-editor.org/2008/08/12/kate-fast-backtrace-navigation/-->
<title
>Backtrace Foliumilo Kromaĵo</title>

<sect2 id="backtracebrowser-using">
<title
>Uzante la Backtrace-Retumila Kromaĵo</title>

<para
>Ĉi tiu kromaĵo estas celata por programistoj kaj verŝajne malmulte utilas por uzantoj. Ĝi montras retrospuron liverita de gdb en listvido en &kate; ilvido. Klaki sur eron malfermas la elektitan dosieron kaj saltas al la ĝusta linionumero. Ĝi funkcias por retrospuroj generitaj sur via propra maŝino, sed ĝi ankaŭ funkcios por retrospuroj de aliaj homoj, &ie; kun <filename
>/home/dummy/qt-copy/…/qwidget.cpp</filename
> ankoraŭ troviĝas en aliaj maŝinoj. Por ke tio funkciu, vi devas indeksi la dosierujojn, kie troviĝas la fontkodo. </para>

<para
>Kelkfoje estas pluraj dosieroj kun la sama nomo, &eg;</para>

<simplelist>
<member
><filename
>kdegraphics/okular/generators/dvi/config.h</filename
></member>
<member
><filename
>kdepim-runtime/resources/gmail/saslplugin/config.h</filename
></member>
</simplelist>

<para
>Por elekti la ĝustan elekton, la kromaĵo elektas la lastajn du partojn de la &URL;, ĉi-kaze tio estus</para>

<simplelist>
<member
><filename
>dvi/config.h</filename
></member>
<member
><filename
>saslplugin/config.h</filename
></member>
</simplelist>

<para
>Kaj tiam kutime la kromaĵo trovas la ĝustan.</para>

<para
>Indeksado de majstro kaj branĉoj kompreneble kondukos al kolizio.</para>

</sect2>

<sect2 id="backtracebrowser-config">
<title
>Agordo</title>

<para
>Sur la agorda paĝo aldonu la dosierujojn enhavantajn la fontkodon.</para>

<screenshot id="screenshot-backtrace-settings">
<screeninfo
>Backtrace Foliumilo</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="backtrace-settings.png" format="PNG"/></imageobject>
<caption
>Agordi Vojojn en Backtrace-retumila ilvido</caption>
</mediaobject>
</screenshot>

<para
>Klakante <guibutton
>OK</guibutton
> komencos indeksadon. Kiam la indeksado estas finita, malfermu la ilaron <guilabel
>Foliumilo de retrospuro</guilabel
>.</para>
<para
>Nun vi povas ŝargi retrospuron el la tondujo (&eg;, kiam vi klakis <guibutton
>Kopii al Clipboard</guibutton
> en &drkonqi;) aŭ el dosiero.</para>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-build">
<!--https://kate-editor.org/2011/06/21/kate-plugin-updates-part-1/ -->
<sect1info>
<authorgroup>
<author
><firstname
>Salma</firstname
> <surname
>Sultana</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>Konstrui Kromprogramon</title>

<sect2 id="build-intro">
<title
>Enkonduko</title>

<para
>La Konstrua kromaĵo permesas al vi ruli agojn kiel konstrui, purigi kaj kompili en projekto.</para>

</sect2>

<sect2 id="build-using">
<title
>Uzado de la Konstru-Kromprogramon</title>

<para
>La Konstrua kromaĵo aldonas <guilabel
>Konstrui Eligo</guilabel
> ilan vidon malsupre kaj <guimenu
>Konstrui</guimenu
> menuon sur la menubreto. La ila vido povas esti uzata por agordi konstru-celajn agordojn, dum la menuo povas esti uzata por plenumi konstruajn, purigi kaj kompili agojn.</para>

<screenshot id="screenshot-build-output">
<screeninfo
>Konstrua Eligo</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="build-output.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>La <guilabel
>Konstrua Eligo</guilabel
> ila vido havas du langetojn:</para>

<itemizedlist>
<listitem
><para
><guilabel
>Celaj Agordoj</guilabel
></para
></listitem>
<listitem
><para
><guilabel
>Eligo</guilabel
></para
></listitem>
</itemizedlist>

<sect3 id="build-using-target-settings">
<title
>Langeto de Celaj Agordoj</title>

<para
>La langeto de celaj agordoj povas esti uzata por agordi diversajn konstruajn celojn kaj difini celajn arojn.</para>

<para
>Por ŝanĝi la nomojn aŭ komandojn duoble alklaku la enskribojn en la tabelo kaj uzu la menuan skatolon por elekti la aktivan cel-aron. Uzu la markobutonon antaŭ ĉiu celo por difini defaŭltan.</para>

<para
>Nova celaro enhavas plurajn agordajn opciojn:</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Labora Adresaro</guilabel
></term>
<listitem
><para
>Vi povas agordi la vojon al la projekto ĉi tie. Lasu ĉi tion malplena por uzi la dosierujon, en kiu troviĝas la aktuala dokumento.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Konstrui</guilabel
></term>
<listitem
><para
>Ĉi tiu opcio permesas difini la konstruan komandon. Ĝi estas agordita al <command
>make</command
> defaŭlte.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Pura</guilabel
></term>
<listitem
><para
>La opcio permesas difini la puran komandon. Ĝi estas agordita al <command
>make clean</command
> defaŭlte.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Agordo</guilabel
></term>
<listitem
><para
>Ĉi tiu opcio ebligas al vi difini la agordan komandon. Ĝi estas agordita al <command
>cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr/local ../</command
> defaŭlte.</para
></listitem>
</varlistentry>
</variablelist>

<para
>Supre ĉi tiu kromaĵo havas ilobreton kun la sekvaj butonoj:</para>

<simplelist>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="dialog-ok-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> Konstruu la elektitan celon</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="list-add-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> Aldoni novan konstrucelon</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="document-new-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> Krei novan konstrucelon aro</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="edit-copy-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> Kopiu komandon aŭ celon aro</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="edit-delete-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> Forigu la aktualan komandon aŭ celo fiksita</member>
</simplelist>

</sect3>

<sect3 id="build-using-output">
<title
>Eligo langeto</title>

<para
>La langeto <guilabel
>Eligo</guilabel
> montras la konzolan eliron generitan de la lasta komando.</para>

<para
>Uzi la glitilon supre por montri aŭ kaŝi kategoriojn de eligo:</para>

<para
><guilabel
>Plena Eligo</guilabel
>, <guilabel
>Analiza eligo</guilabel
>, <guilabel
>Eraroj kaj Avertoj</guilabel
> aŭ <guilabel
>Nur Eraroj</guilabel
> </para>

<para
>Ĉiu linio enhavas mesaĝon kaj la dosiernomon kaj linionumeron se disponeblaj. Klako sur la eraro aŭ averto kondukas vin al la taŭga dosiero kaj metas la kursoron sur la responda linionumero.</para>

<para
>Por navigi al la antaŭa eraro, premu <keycombo action="simul"
>&Alt;&Shift;&Left;</keycombo
>. Por navigi al la sekva eraro, premu <keycombo action="simul"
>&Alt;&Shift;&Right;</keycombo
>.</para>

</sect3>
</sect2>

<sect2 id="build-menu">
<title
>Strukturo de menuo</title>

<variablelist id="build-build">
<varlistentry>
<term
><menuchoice id="build-targets"
><guimenu
>Konstrui</guimenu
><guisubmenu
>Elekti Celon</guisubmenu
> </menuchoice
></term>
<listitem
><para
>Elektu el listo de celoj agordita de la uzanto.</para
></listitem>
</varlistentry>

<varlistentry id="build-default">
<term
><menuchoice
><guimenu
>Konstrui</guimenu
><guimenuitem
>Konstrui defaŭltan celon</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Konstruas la celon difinitan kiel defaŭltan en la aktiva celaro.</para
></listitem>
</varlistentry>

<varlistentry id="build-previous">
<term
><menuchoice
><guimenu
>Konstrui</guimenu
><guimenuitem
>Konstrui Antaŭan Celon</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Ŝanĝu al la antaŭa celo agordita de la uzanto.</para
></listitem>
</varlistentry>

<varlistentry id="build-stop">
<term
><menuchoice
><guimenu
>Konstrui</guimenu
><guimenuitem
>Halti</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Ĉesi konstrui celon.</para
></listitem>
</varlistentry>

<varlistentry id="build-previous-error">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;&Left;</keycombo
></shortcut
> <guimenu
>Konstrui</guimenu
><guimenuitem
>Antaŭa Eraro</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Movas la kursoron al la loko de la antaŭa eraro en la dokumento.</para
></listitem>
</varlistentry>

<varlistentry id="build-next-error">
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;&Alt;&Right;</keycombo
></shortcut
> <guimenu
>Konstrui</guimenu
><guimenuitem
>Sekva Eraro</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Movas la kursoron al la loko de la sekva eraro en la dokumento.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="build-ack">
<title
>Dankon kaj Dankon</title>
<para
>La &kate; Build Plugin estis verkita de Kåre Särs.</para>
<para
>Specialan dankon al la partoprenanto de Google Code-In 2011 Salma Sultana pro verkado de granda parto de ĉi tiu sekcio.</para>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-closeexceptlike">

<title
>Fermi Krom/Kiel Kromaĵo</title>

<sect2 id="closeexceptlike-intro">
<title
>Enkonduko</title>

<para
>Ĉi tiu kromaĵo permesas fermi grupon de dokumentoj laŭ ilia etendo kaj vojo.</para>

</sect2>

<sect2 id="closeexceptlike-using">
<title
>Uzante la Fermi Krom/Kiel Kromprogramon</title>

<para
>Supozeble, ke vi havas ĉi tiujn dokumentojn malfermitaj en &kate;:</para>

<simplelist>
<member
>/tmp/subdosierujo/test.h</member>
<member
>/tmp/test.cpp</member>
<member
>/tmp/test.txt</member>
</simplelist>

<para
>Tiam vi havas la jenajn eblojn por fermi dokumentojn kiel montrite en la ekrankopio:</para>

<screenshot id="screenshot-closeexceptlike">
<screeninfo
>Fermi Krom</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="close-except-like.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Uzu la markobutonon en la lasta elemento de la listo por ebligi aŭ malŝalti konfirman dialogon. La elektita opcio aplikiĝos al ambaŭ proksimaj agoj. </para>

</sect2>

<sect2 id="closeexceptlike-menu">
<title
>Strukturo de menuo</title>

<variablelist>
<varlistentry id="file-close-except">
<term
><menuchoice
><guimenu
>Dosiero</guimenu
> <guisubmenu
>Fermi Krom</guisubmenu
> </menuchoice
></term>
<listitem>
<para
><action
>Fermi</action
> ĉiujn malfermitajn dokumentojn, <emphasis
>krom</emphasis
> tiuj, kiuj kongruas kun la vojo aŭ dosier-endaĵo elektita el la submenuo.</para>
</listitem>
</varlistentry>

<varlistentry id="file-close-like">
<term
><menuchoice
><guimenu
>Dosiero</guimenu
> <guisubmenu
>Fermi Ŝati</guisubmenu
> </menuchoice
></term>
<listitem>
<para
><action
>Fermi</action
> ĉiujn malfermitajn dokumentojn, kiuj kongruas kun la vojo aŭ dosiera etendo elektita el la submenuo.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-colorpicker">

<title
>Koloro Picker Kromaĵo</title>

<sect2 id="colorpicker-intro">
<title
>Enkonduko</title>

<para
>Ĉi tiu kromaĵo aldonas enlinian koloran antaŭrigardon/elekton al koloroj en la teksto (&eg;, <literal
>#FFFFFF</literal
>, <literal
>blanka</literal
>).</para>

<para
>Por ŝargi ĉi tiun kromprogramon malfermu la agordan dialogon de &kate; sub <menuchoice
><guimenu
>Agordoj</guimenu
> <guimenuitem
>Agordi &kate;...</guimenuitem
></menuchoice
>. Poste elektu <guilabel
>Kolorelektilo</guilabel
> kaj fermu la dialogon. </para>
</sect2>

<sect2 id="colorpicker-config">
<title
>Agordo</title>

<para
>Sur la paĝo de agordoj de Koloro Picker en la agordo de &kate;, vi povas agordi la jenajn opciojn de la aldonaĵkonduto.</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Montri antaŭrigardon por konataj kolornomoj</guilabel
></term>
<listitem>
<para
>Ĉu montri la kolor-elekton por konataj kolornomoj (&eg;, <literal
>ĉielbluo</literal
>). Vidu <ulink url="https://www.w3.org/TR/SVG11/types.html#ColorKeywords"
>ĉi tiun paĝon</ulink
> por la listo de koloroj.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Meti antaŭrigardon post tekstokoloro</guilabel
></term>
<listitem>
<para
>Ĉu meti la enlinian antaŭrigardon post tekstokoloro en la tekston.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Hekskolora kongruo</guilabel
></term>
<listitem>
<para
>Ĉi tie, vi povas elekti la plej bonan kongruan opcion por la koloroj uzataj en via kodo.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-colored-brackets">
<title
>Koloraj krampoj</title>

<sect2
><title
>Enkonduko</title>
<para
>Koloraj krampoj kromkoloraj kongruaj krampparoj en malsamaj koloroj por plibonigi legeblecon. Tamen, ne ĉiuj krampoj koloriĝas. Krampo kies kongrua malfermilo aŭ fermilo ne estas videbla estos ignorita. Simile, krampa paro kiu estas la sola krampa paro sur linio ne iĝos kolorigita. </para>
</sect2>

<sect2
><title
>Agordo</title>
<para
>La kromaĵo ne provizas iujn ajn agordojn.</para>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-ctags">
<!--https://kate-editor.org/2012/11/02/using-the-projects-plugin-in-kate/-->
<title
>CTags Kromaĵo</title>

<sect2 id="ctags-intro">
<title
>Enkonduko</title>

<para
><ulink url="https://en.wikipedia.org/wiki/Ctags"
>CTags</ulink
> generas indeksan (aŭ etikedon) dosieron de lingvobjektoj trovitaj en fontdosieroj, kiu ebligas al ĉi tiuj eroj esti rapide kaj rapide. facile troviĝas uzante ĉi tiun kromprogramon en &kate;. </para>
<para
>Etikedo signifas lingvobjekton por kiu indeksa enskribo estas disponebla (aŭ, alternative, la indeksa enskribo kreita por tiu objekto).</para>

<para
>Etikedgenerado estas subtenata por ĉi tiuj <ulink url="http://ctags.sourceforge.net/languages.html"
>programlingvoj</ulink
>. </para>
</sect2>

<sect2 id="ctags-config">
<title
>Agordo</title>

<para
>La kromaĵo CTags uzas du malsamajn datumbazdosierojn por la indekso.</para>

<para
>Sur la paĝo de agordoj de CTags en la agordo de &kate; vi povas aldoni aŭ forigi dosierujojn enhavantajn la fontkodon kaj regeneri la komunan datumbazon de CTags.</para>

<sect3 id="ctags-config-common">
<title
>Komuna Indekso</title>

<screenshot id="screenshot-ctags-global-settings">
<screeninfo
>Agordoj de CTags</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="ctags-global-setting.png" format="PNG"/></imageobject>
<caption
>Agordi CTags Global Database</caption>
</mediaobject>
</screenshot>

<para
>Ĉe la malsupro de la agorda paĝo vi povas adapti la <guilabel
>Komando CTags</guilabel
>. </para>

<para
>Por pliaj informoj pri ĉiuj disponeblaj opcioj bonvolu legi la manpaĝon de CTags. Ĉi tiu mana paĝo disponeblas en &khelpcenter; kaj vi povas anka enigi la &URL; <emphasis
>man:/ctags</emphasis
> rekte en &konqueror; </para>

<para
>Klako <guibutton
>Ĝisdatigi</guibutton
> komencos indeksadon. Kiam indeksado estas finita, fermu la dialogon.</para>
</sect3>

<sect3 id="ctags-config-session">
<title
>Seanca Indekso</title>

<para
>Por agordi la seanindekson malfermu la <guilabel
>CTags</guilabel
> vido.</para>

<variablelist>
<varlistentry>
<term
><menuchoice>
<guimenu
>Indeksaj Celoj</guimenu>
</menuchoice
></term>
<listitem>
<para
>Sur ĉi tiu langeto vi povas aldoni aŭ forigi dosierujojn enhavantajn la fontkodon kaj permane regeneri la sean-specifan CTags-datumbazon.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice>
<guimenu
>Datumbazo</guimenu>
</menuchoice
></term>
<listitem>
<screenshot id="screenshot-ctags-session-settings">
<screeninfo
>Agordoj de datumbazoj</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="ctags-session-setting.png" format="PNG"/></imageobject>
<caption
>Agordi CTags-Seanco-Datumbazon</caption>
</mediaobject>
</screenshot>
<para
>Elektu alian datumbazan dosieron de CTags, agordu la komandon CTags aŭ revenu al la defaŭlta komando.</para>
</listitem>
</varlistentry>

</variablelist>

</sect3>

</sect2>

<sect2 id="ctags-using">
<title
>Uzante la kromprogramon CTags</title>

<para
>Vi metas la muskursoron sur la lingvobjekton kiel funkcion, simbolon &etc; ke vi interesiĝas kaj tiam elektu unu el la agoj en la menuo <guimenu
>CTags</guimenu
> por salti al la linio kaj dosiero kie la objekto estas difinita aŭ deklarita.</para>
<para
>Defaŭlte la agoj en la menuo <guimenu
>CTags</guimenu
> havas neniujn ŝparvojojn asignitaj. Uzu la <ulink url="help:/fundamentals/shortcuts.html"
>klavaran ŝparvojojn</ulink
> por agordi viajn proprajn ŝparvojojn.</para>

<para
>Alternative uzu la serĉkampon en la langeto <guilabel
>Serĉo</guilabel
> de la CTags-vido.</para>
<para
>Enigi signojn en la serĉkampon komencos la serĉon kaj montros kongruajn nomojn de lingvobjektoj kiel funkcioj, klasoj, simboloj &etc; kune kun tipo kaj dosiernomo.</para>
<para
>Elektu eron en la listo por salti al la responda linio en la fontdosiero.</para>
<!--FIXME why Tag Type here but Name Kind in Project plugin, is there really any difference?-->

<!--FIXME completion as in Project plugin? -->

</sect2>

<sect2 id="ctags-menu">
<title
>Strukturo de menuo</title>

<variablelist>

<varlistentry id="ctags-jumpback">
<term
><menuchoice
><guimenu
>CTags</guimenu
> <guisubmenu
>Resalti unu paŝon</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Reiru en la historio al la lasta vizitita etikedo.</para>
</listitem>
</varlistentry>

<varlistentry id="ctags-lookup">
<term
><menuchoice
><guimenu
>CTags</guimenu
> <guisubmenu
>Serĉi Aktualan Tekston</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Malfermas la langeton <guilabel
>Serĉo</guilabel
> de la vido de CTags kaj montras ĉiujn lingvobjektojn kongruajn kun la nuna tekstoelekto en la listo.</para>
</listitem>
</varlistentry>

<varlistentry id="ctags-gotodeclaration">
<term
><menuchoice
><guimenu
>CTags</guimenu
> <guisubmenu
>Iri al Deklaro</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Se la kursoro estas en difina objekto ĉi tio malfermos la dokumenton enhavantan la respondan deklaron se necese, aktivigos ĝian vidon kaj metos la kursoron ĉe la komenco de la deklaro.</para>
</listitem>
</varlistentry>

<varlistentry id="ctags-gotodefinition">
<term
><menuchoice
><guimenu
>CTags</guimenu
> <guisubmenu
>Iri al Difino</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Se la kursoro estas en deklara objekto ĉi tio malfermos la dokumenton enhavantan la respondan difinon se necese, aktivigos ĝian vidon kaj metos la kursoron ĉe la komenco de la difino.</para>
</listitem>
</varlistentry>

</variablelist>

<!--context menu with Lookup Current Text, Goto Declaration, Goto Definition -->

</sect2>

</sect1>
<!--https://frinring.wordpress.com/2017/11/07/ktexteditorpreviewplugin-0-2-1-last-stand-alone/-->
<!-- https://frinring.wordpress.com/2017/08/21/look-what-you-have-donewwdo/-->
<sect1 id="kate-application-plugin-preview">
<title
>Dokumenta Antaŭrigardo Kromaĵo</title>

<sect2 id="preview-introduction">
<title
>Enkonduko</title>
<para
>La kromaĵo ebligas vivan antaŭrigardon de la nuntempe redaktita tekstdokumento en la fina formato en la flanka kolumno. Do dum redaktado de &eg; a &Markdown; teksto aŭ &SVG; bildo, la rezulto estas tuj videbla apud la fontteksto. </para>

<para
>Por la ekrano la kromprogramo uzas tiun &kparts; kromaĵo kiu estas nuntempe elektita kiel la preferata por la &MIME; tipo de la dokumento. Se ne ekzistas &kparts; kromaĵo por tiu tipo, neniu antaŭrigardo eblas. </para>

<para
>Por ŝanĝi la preferatan kromprogramon malfermu la modulon <guilabel
>Dosiero-Asocioj</guilabel
> en la &systemsettings; kaj redaktu la <guilabel
>Prefer-Ordon de Servoj</guilabel
> sur la langeto <guilabel
>Enkonstruado</guilabel
>. </para>

<table>
<title
>Iuj disponeblaj &kparts; kromaĵojn</title>
<tgroup cols="2">
<tbody>
<row>
<entry
>&MIME;-tipo</entry
><entry
>&kparts; konekti</entry>
</row>
<row>
<entry
>&Markdown; teksto</entry
><entry
>KMarkdownWebViewPart aŭ OkularPart</entry>
</row>
<row>
<entry
>&SVG; bildo</entry
><entry
>SVGPart</entry>
</row>
<row>
<entry
>&Qt; UI-dosieroj</entry
><entry
>KUIViewerPart</entry>
</row>
<row>
<entry
>&DOT; grafikaj dosieroj</entry
><entry
>KGraphviewerPart</entry>
</row>
</tbody>
</tgroup>
</table>
</sect2>

<sect2 id="preview-menu">
<title
>Strukturo de menuo</title>
<variablelist>

<varlistentry id="view-toolviews-show-preview">
<term
><menuchoice
><guimenu
>Vido</guimenu
><guisubmenu
>Vidoj de iloj</guisubmenu
> <guimenuitem
>Montri Antaŭrigardon</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Ŝaltu la montradon de la Dokumenta antaŭrigardo de &kate; en flankbreto.</para>
</listitem>
</varlistentry>
</variablelist>
</sect2>

<sect2 id="preview-interface">
<title
>Interfaco</title>
<para
>La butonoj ĉe la supro de la antaŭrigarda fenestro provizas ĉi tiujn agojn: </para>
<itemizedlist>
<listitem>
<para
>Rigli la antaŭrigardon al donita dokumento. Elektante ĉi tiun opcion certigas, ke se oni ŝanĝas la fokuson al la vido de alia dokumento en la sama &kate; fenestro, la antaŭrigardo ne sekvos al tiu dokumento, sed daŭre antaŭrigardos ĉi tiun dokumenton.</para>
</listitem>
<listitem>
<para
>Ebligu aŭ malŝalti ĝisdatigojn de la antaŭrigardo de la aktuala dokumentenhavo</para>
</listitem>
<listitem>
<para
>Mane ĝisdatigi la antaŭrigardon de la aktuala dokumentenhavo</para>
</listitem>
<listitem>
<para
>Falmenuo kun agoj de la &kparts; konekti</para>
</listitem>
</itemizedlist>
</sect2>

</sect1>

<sect1 id="kate-application-plugin-documentswitcher">

<title
>Document Switcher Kromaĵo</title>

<sect2 id="documentswitcher-menu">
<title
>Strukturo de menuo</title>

<variablelist>

<varlistentry id="view-documentswitcher">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Tab;</keycombo
> </shortcut
> <guimenu
>Vido</guimenu
> <guisubmenu
>Laste Uzataj Vidoj</guisubmenu
> </menuchoice
></term>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Shift;&Tab;</keycombo
> </shortcut
> <guimenu
>Vido</guimenu
> <guisubmenu
>Laste Uzitaj Vidoj (Inversa)</guisubmenu
> </menuchoice
></term>
<listitem>

<para
><action
>Malfermas</action
> liston kun la lastaj viditaj dokumentoj:</para>

<screenshot id="screenshot-documentswitcher">
<screeninfo
>Laste viditaj dokumentoj</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="documentswitcher.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Konservu la &Ctrl; klavo premita kaj uzu la &Tab; klavo por bicikli antaŭen tra la listo. Aldone premu la &Shift; klavo por inversigi la direkton. </para>

<para
>Tenu la ŝparvojon <keycombo action="simul"
>&Ctrl;&Tab;</keycombo
> premita kaj povas uzi la &Up;, &Down;, &Home; aŭ &End; klavoj por navigi en la listo. Premante sign-klavon sinsekve cirkuligos ĉiujn aĵojn kun la unua kongruo en la listo. Se vi liberigas la ŝparklavojn, la vido ŝanĝos al la elektita dokumento en la listo. </para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>


<sect1 id="kate-application-plugin-fsbrowser">

<title
>Dosiersistema Retumilo</title>

<para
>La Dosiersistema Retumilo estas dosierujo-spektilo, kiu ebligas al vi malfermi dosierojn el montrata dosierujo en la aktuala kadro.</para>

<sect2 id="fsbrowser-menu">
<title
>Strukturo de menuo</title>
<variablelist>

<varlistentry id="view-toolviews-show-filebrowser">
<term
><menuchoice
><guimenu
>Vidi</guimenu
><guisubmenu
>Ilaj Vidoj</guisubmenu
> <guimenuitem
>Montri Dosiersistem-Retumilon</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Ŝalti la montradon de la Dosiersistem-Retumilo de &kate;.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="fsbrowser-interface">
<title
>Interfaco</title>

<para
>De supre malsupren, la Dosiersistem-Retumilo konsistas el la sekvaj elementoj:</para>

<variablelist>
<varlistentry>
<term
>Ilobreto</term>
<listitem>
<para
>Ĉi tio enhavas normajn navigaciajn ilbutonojn:</para>
<variablelist>
<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="go-previous-22.png" format="PNG"/></imageobject
></inlinemediaobject
> Reen</guiicon
></term>
<listitem
><para
>Kaŭzas la dosierujon al <command
>cd</command
> al la antaŭe montrita dosierujo en la historio. Ĉi tiu butono estas malŝaltita, se ne ekzistas antaŭa elemento.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="go-next-22.png" format="PNG"/></imageobject
></inlinemediaobject
> Antaŭen</guiicon
></term>
<listitem
><para
>Kaŭzas la dosierujon al <command
>cd</command
> al la sekva dosierujo en la historio. Ĉi tiu butono estas malŝaltita, se ne ekzistas sekva dosierujo.</para
></listitem>
</varlistentry>
<!--varlistentry>
<term
><guibutton
>Parent Folder</guibutton
></term>
<listitem
><para
>This will cause the folder view to <command
>cd</command
> to the immediate parent of the currently displayed
folder if possible.</para
></listitem>
</varlistentry-->
<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="bookmarks-22.png" format="PNG"/></imageobject
></inlinemediaobject
> Legosignoj</guiicon
></term>
<listitem
><para
>Malfermas submenuon por redakti aŭ aldoni legosignojn kaj aldoni novan legosigndosierujon.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="system-switch-user-22.png" format="PNG"/></imageobject
></inlinemediaobject
> Aktuala Dokumenta Dosierujo</guiicon
></term>
<listitem
><para
>Ĉi tiu butono igos la dosierujon al <command
>cd</command
> al la dosierujo de la nuntempe aktiva dokumento se eble. Ĉi tiu butono estas malŝaltita, se la aktiva dokumento estas nova, nekonservita dosiero, aŭ la dosierujo en kiu ĝi loĝas ne povas esti decidita.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="games-config-options-22.png" format="PNG"/></imageobject
></inlinemediaobject
> Opcioj</guiicon
></term>
<listitem>
<variablelist>
<varlistentry>
<term
><guimenuitem
>Mallonga Vido</guimenuitem
></term>
<listitem
><para
>Montras nur la dosiernomojn.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Detala Vido</guimenuitem
></term>
<listitem
><para
>Montras <guilabel
>Nomon</guilabel
>, <guilabel
>Daton</guilabel
> kaj <guilabel
>Grandecon</guilabel
> de la dosieroj.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Arba Vido</guimenuitem
></term>
<listitem
><para
>Kiel Mallonga Vido, sed dosierujoj povas esti vastigitaj por vidi ilian enhavon.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Detala Arba Vido</guimenuitem
></term>
<listitem
><para
>Ĉi tio ankaŭ permesas pligrandigi dosierujojn, sed montras la kromajn kolumnojn disponeblajn en Detala Vido.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Montri Kaŝitajn dosierojn</guimenuitem
></term>
<listitem
><para
>Montras dosierojn kutime kaŝitajn de via &OS;.</para
></listitem>
</varlistentry>
<varlistentry>
<term
><guimenuitem
>Aŭtomate sinkronigi kun aktuala dokumento</guimenuitem
></term>
<listitem
><para
>Kiam ĉi tiu opcio estas ebligita, la dosiersistemo retumilo aŭtomate <command
>cd</command
> al la dosierujo de la dokumento nuntempe malfermita en la redakta areo ĉiufoje kiam ĝi ŝanĝiĝas.</para
></listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>
</variablelist>
</listitem>
</varlistentry>

<varlistentry>
<term
>Loka Eniro</term>
<listitem>
<para
>Ĉi tio montras navigadon al la nun malfermita dosierujo, simile al &dolphin;. Vi povas alklaki iun ajn dosierujon por serĉi ĝin, aŭ alklaki unu el la sagoj maldekstre de dosierujo por elekti iujn ajn dosierujojn sub ĝi. Vi ankaŭ povas elekti el via listo de Lokoj alklakante la plej maldekstran piktogramon en la panera navigado, kiu montras piktogramon kiu reprezentas vian aktualan Lokon.</para>

<para
>Vi ankaŭ povas klaki dekstre de la pano por ŝanĝi ilin al tekstkesto kie vi povas tajpi la vojon de dosierujo por foliumi. La &URL; eniro konservas liston de antaŭe tajpitaj vojoj. Por elekti unu, uzu la sagobutonon dekstre de la eniro.</para>
<tip
><para
>La &URL; eniro havas dosierujon aŭtomaten. La kompletiga metodo povas esti agordita uzante la &RMB; menuo de la teksta enigo.</para
></tip>
</listitem>
</varlistentry>

<varlistentry>
<term
>Vido de Dosierujo</term>
<listitem
><para
>Ĉi tio estas norma &kde; dosierujo vido.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Filtrila Eniro</term>
<listitem>
<para
>La enskribo Filtrilo permesas vin enigi filtrilon por la dosieroj montrataj en la dosierujo. La filtrilo uzas normajn globojn; ŝablonoj devas esti apartigitaj per blanka spaco. Ekzemplo: <userinput
>*.cpp *.h *.moc</userinput
></para>
<para
>Por montri ĉiujn dosierojn, enigu unu solan asteriskon <userinput
>*</userinput
>.</para>
<para
>La filtrila eniro konservas la lastajn 10 filtrilojn enigitajn inter seancoj. Por uzi unu, premu la sagobutonon dekstre de la eniro kaj elektu la deziratan filtrilon. Vi povas malŝalti la filtrilon premante la butonon <guibutton
>Forpurigi tekston</guibutton
> maldekstre de la aŭtokompleta sagobutono.</para>
</listitem>
</varlistentry>

</variablelist>
</sect2>


<sect2 id="fsbrowser-config">
<title
>Agordo</title>

<para
>Ĉi tiu kromaĵo povas esti agordita sur la paĝo <guilabel
>Dosiersistemo-Retumilo</guilabel
> de la agordo de <link linkend="configuring-kate-configdialog"
>&kate;</link
>.</para>

<variablelist>
<varlistentry>
<term
><guilabel
>Ilobreto</guilabel
></term>
<listitem
><para
>Agordu la butonojn sur la ilobreto de Dosiersistemo Foliumilo movante tiujn, kiujn vi volas ebligitaj al la listo <guilabel
>Elektitaj Agoj</guilabel
>, kaj ordigu ilin per la sagobutonoj ĉe la flanko de la listo.</para>
 </listitem>
</varlistentry>

</variablelist>
</sect2>
</sect1>

<sect1 id="kate-application-plugin-documents">
<title
>La Listo de Dokumentoj</title>
<!-- https://kate-editor.org/2010/09/12/kate-tree-view-plugin-update/-->
<sect2 id="documents-intro">
<title
>Enkonduko</title>

<para
><indexterm
><primary
>Listo de dokumentoj</primary
></indexterm
> La listo de dokumentoj montras liston de ĉiuj dokumentoj nuntempe malfermitaj en &kate;. Modifitaj dosieroj havos malgrandan <guiicon
>disketon</guiicon
> maldekstre por indiki tiun staton.</para>

<para
>Supre la Listo de Dokumentoj havas ilobreton kun la sekvaj butonoj:</para>

<simplelist>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="document-new-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> Krei novan dokumenton</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="document-open-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> Malfermi ekzistantan dokumenton</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="go-up-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> Antaŭa Dokumento</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="go-down-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> Sekva Dokumento</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="document-save-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> Konservi la aktualan dokumenton</member>
<member
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="document-save-as-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> Konservi la aktualan dokumenton sub nova nomo</member>
</simplelist>

<para
>Defaŭlte, la Listo de Dokumentoj aperas en <guimenuitem
>Arba Reĝimo</guimenuitem
>, kiu montras la dosierujon ĉirkaŭantan ĉiujn nuntempe malfermitajn dokumentojn. Ankaŭ disponebla estas <guimenuitem
>Lista Reĝimo</guimenuitem
>, kiu montras simplan liston de ĉiuj malfermitaj dokumentoj. Vi povas ŝanĝi reĝimojn dekstre alklakante la liston kaj elektante el la menuo <guisubmenu
>Vido-Reĝimo</guisubmenu
>.</para>

<para
>Se du aŭ pli da dosieroj kun la sama nomo (troviĝantaj en malsamaj dosierujoj) estas malfermitaj en <guimenuitem
>Lista Reĝimo</guimenuitem
>, la nomoj de la dua estos antaŭmetitaj <quote
>(2)</quote
> ktp. La ilo-konsileto por la dosiero montros sian plenan nomon inkluzive de la vojo, permesante al vi elekti la deziratan.</para
> <para
>Por montri dokumenton en la aktuale aktiva kadro, alklaku la dokumentnomon en la listo.</para>

<para
>La kunteksta menuo havas kelkajn komunajn agojn el la menuo <guimenu
>Dosiero</guimenu
>.</para>

<para
>Aldone estas dosiermanaĝeraj agoj por renomi aŭ forigi la dosieron. Per <guimenuitem
>Kopii Lokon</guimenuitem
> vi povas kopii la plenan vojon de la dokumento al la tondujo.</para>

<para
>Vi povas ordigi la liston en kelkaj malsamaj manieroj dekstre alklakante la liston kaj elektante el la menuo <guisubmenu
>Ordigi Laŭ</guisubmenu
>. La opcioj estas: <variablelist>

<varlistentry>
<term
><guimenuitem
>Dokumenta Nomo</guimenuitem
></term>
<listitem
><para
>Listigas la dokumentojn alfabete laŭ ilia nomo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Dokumenta Vojo</guimenuitem
></term>
<listitem
><para
>Listigas la dokumentojn alfabete laŭ la vojo al ili.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guimenuitem
>Malferma Ordo</guimenuitem
></term>
<listitem
><para
>Listigas la dokumentojn en la ordo de malfermo.</para
></listitem>
</varlistentry>

</variablelist>

</para>

<para
>La dokumentlisto defaŭlte bildigos vian historion ombrigante la enskribojn por la plej lastatempaj dokumentoj kun fonkoloro. Se la dokumento estis redaktita, kroma koloro estas miksita. La plej lastatempa dokumento havas la plej fortan koloron, tiel ke vi povas facile trovi la dokumentojn pri kiuj vi laboras. Ĉi tiu funkcio povas esti malŝaltita en la paĝo <link linkend="config-dialog-documents"
>Dokumentoj</link
> de la agorda dialogo.</para>
<para
>La defaŭlta loko de la dokumenta listo en la &kate; fenestro estas maldekstre de la redakta areo.</para>

</sect2>

<sect2 id="documents-menus">
<title
>Strukturo de menuo</title>

<variablelist>

<varlistentry id="view-document-previous">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Alt;&Up;</keycombo
> </shortcut
> <guimenu
>Vido</guimenu
> <guimenuitem
>Antaŭa Dokumento</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Malfermas la dokumenton montritan super la nuntempe malfermita dokumento en la Listo de Dokumentoj.</para>
</listitem>
</varlistentry>

<varlistentry id="view-document-next">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Alt;&Down;</keycombo
> </shortcut
> <guimenu
>Vido</guimenu
> <guimenuitem
>Sekva Dokumento</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Malfermas la dokumenton montritan sub la nuntempe malfermita dokumento en la Listo de Dokumentoj.</para>
</listitem>
</varlistentry>

<varlistentry id="view-active">
<term
><menuchoice
><guimenu
>Vido</guimenu
> <guimenuitem
>Montri Aktivan</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Montras la nuntempe malfermitan dokumenton en la Listo de Dokumentoj.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="config-dialog-documents">
<title
>Agordo</title>

<variablelist>
<varlistentry>
<term
><guilabel
>Fona Ombrigo</guilabel
></term>
<listitem
><para
>Ĉi tiu sekcio permesas al vi ebligi aŭ malŝalti la fonan ombran bildigon de via lastatempa agado, kaj elekti kiujn kolorojn uzi se ĝi estas ebligita.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ordigi laŭ</guilabel
></term>
<listitem
><para
>Agordu kiel vi volas ordigi la dokumentan liston. Ĉi tio povas esti agordita de la &RMB; menuo en la dokumenta listo ankaŭ.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Vida Reĝimo</guilabel
></term>
<listitem
><para
>Ĉi tio disponigas du opciojn kiuj efikas la montradon de la Dokumenta ilo-vido. La opcio <guilabel
>Arba Vido</guilabel
> montros la dokumentojn en arbo sub la dosierujoj en kiuj ili estas, dum la opcio <guilabel
>Listo-Vido</guilabel
> montros ebenan liston de dokumentoj. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Montri Plenan Vojon</guilabel
></term>
<listitem
><para
>Kiam Arba Vido kaj ĉi tiu opcio estas ebligitaj, la dosierujoj montrataj en la vido de Dokumentoj montros la plenan dosiersisteman vojon al la dosierujo krom la nomo de la dosierujo. Ĝi havas neniun efikon en ListView.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Montri Ilobreton</guilabel
></term>
<listitem
><para
>Kiam Arba Vido kaj ĉi tiu opcio estas ebligitaj, ilobreto kun agoj kiel <guibutton
>Konservi</guibutton
> montriĝas super la listo de dokumentoj. Malmarku ĉi tiun opcion se la ilobreto devus esti kaŝita.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Montri Fermi Butonon</guilabel
></term>
<listitem
><para
>Kiam ĉi tiu opcio estas ebligita, &kate; montros fermbutonon por malfermitaj dokumentoj dum ŝvebado.</para
></listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-gdb">
<!--https://kate-editor.org/2011/06/23/kate-plugin-updates-part-2/-->
<sect1info>
<authorgroup>
<author
><firstname
>Martin</firstname
> <surname
>Gergov</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>&gdb; Konekti</title>

<sect2 id="gdb-intro">
<title
>Enkonduko</title>

<para
>la &gdb; de &kate; kromaĵo provizas simplan fasadon al la populara &GNU; Projekta Erarserĉilo.</para>

<important>
<para
>Antaŭa sperto kun &gdb; estas forte rekomendinda. Por pliaj informoj pri uzado de &gdb;, vizitu <ulink url="https://www.gnu.org/software/gdb/"
>la &gdb; retejo</ulink
>.</para>
</important>

<para
>Vi povas ebligi la &gdb; kromaĵo en <link linkend="config-dialog-plugins"
>la sekcio de Kromaĵoj de la agordo de &kate;</link
>.</para>

<para
>Por ke la kromprogramo funkciu ĝuste, vi devas havi fontdosieron (de iu ajn tipo subtenata de &gdb;) kaj ruleblaĵo.</para>

<tip>
<para
>Se vi kompilas per &gcc;/<command
>g++</command
> vi eble volas uzi la argumenton de komandlinio <command
><parameter
>-ggdb</parameter
></command
>. </para>
</tip>

<para
>Post kiam ĉi tiuj preparoj estas faritaj, malfermu la fontdosieron en &kate;, enigu la vojon al la plenumebla en la langeto <guilabel
>Agordoj</guilabel
> de la ila vido de <guilabel
>Sensirmiga Vido</guilabel
>, kaj elektu <menuchoice
> <guimenu
>Sensirigi</guimenu
><guimenuitem
>Komenci Sencimigi</guimenuitem
></menuchoice
> el la menuo por komenci.</para>

</sect2>

<sect2 id="gdb-menus">
<title
>Strukturo de Menuo kaj Ilobreto</title>

<para
>Ĉiuj ĉi tiuj opcioj disponeblas en la menuoj de &kate;, kaj multaj disponeblas ankaŭ ĉe la ilobreto Sencimiga.</para>

<variablelist>

<varlistentry id="gdb-menus-show-debug-view">
<term
><menuchoice
><guimenu
>Vido</guimenu
><guisubmenu
>Vido de ilo</guisubmenu
><guimenuitem
>Montri Sencimigan Vidon</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Montras ilan vidon enhavantan &gdb; eligo, la &gdb; komandlinio uzata, kaj aliaj agordoj.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-show-locals-and-stack">
<term
><menuchoice
><guimenu
>Vido</guimenu
><guisubmenu
>Vido de ilo</guisubmenu
><guimenuitem
>Montri lokanojn kaj stakon</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Montras liston de ĉiuj nuntempe ŝargitaj variabloj kaj iliaj valoroj kaj &gdb; retrospuro. </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-targets">
<term
><menuchoice
><guimenu
>Sencimigo</guimenu
><guisubmenu
>Celoj</guisubmenu
> </menuchoice
></term>
<listitem
><para
>Submenuo enhavanta liston de celoj (efektiveblaj). </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-start">
<term
><menuchoice
><guimenu
>Sencimigo</guimenu
><guimenuitem
>Komenci Sencimigi</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Komencas &gdb; kun celo.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-kill">
<term
><menuchoice
><guimenu
>Sencimigo</guimenu
><guimenuitem
>Mortigi/Ĉesigi Sencimigon</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Haltas &gdb;.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-restart">
<term
><menuchoice
><guimenu
>Sencimigo</guimenu
><guimenuitem
>Rekomenci Sencimigon</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Rekomencas &gdb;.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-break">
<term
><menuchoice
><guimenu
>Sencimigo</guimenu
><guimenuitem
>Baskuligi Haltpunkton / Rompi</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Agordu rompopunkton ĉe la aktuala kursora pozicio. </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-step-in">
<term
><menuchoice
><guimenu
>Sencimigo</guimenu
><guimenuitem
>Enpaŝi</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Efektivigi la aktualan deklaron (funkcivoko estos sencimigita). </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-step-over">
<term
><menuchoice
><guimenu
>Sencimigo</guimenu
><guimenuitem
>Paŝi Super</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Efektivigi la aktualan deklaron (funkcivoko ne estos sencimigita).</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-step-out">
<term
><menuchoice
><guimenu
>Sencimigo</guimenu
><guimenuitem
>Elpaŝi</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Rekomencas rulon ĝis la programo, kiu rulas, finiĝas.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-move-pc">
<term
><menuchoice
><guimenu
>Sencimigo</guimenu
><guimenuitem
>Movi Programkalkulilon (PC)</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Movi programkalkulilon (sekva rulo).</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-run-to-cursor">
<term
><menuchoice
><guimenu
> Sencimigi</guimenu
><guimenuitem
>Run al Kursoro</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Rulas la programon ĝis ĝi atingas aktualan kursoran pozicion. </para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-continue">
<term
><menuchoice
><guimenu
>Sencimigo</guimenu
><guimenuitem
>Daŭrigi</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Ignoras ajnajn rompopunktojn kaj rulas programon ĝis ĝi finiĝas (sukcese aŭ ne).</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-print-value">
<term
><menuchoice
><guimenu
>Sencimigo</guimenu
><guimenuitem
>Presi valoron</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Presas la valoron de la variablo al kiu la kursoro nuntempe montras.</para
></listitem>
</varlistentry>

<varlistentry id="gdb-menus-toolbar">
<term
><menuchoice
><guimenu
>Agordoj</guimenu
><guisubmenu
>Montrataj ilobretoj</guisubmenu
><guimenuitem
>&gdb; Kromaĵo</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Montri la sencimigan ilobreton.</para
></listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="gdb-debug-view">
<title
>Sencimiga Vido</title>

<para
>La <guilabel
>Sencimiga Vido</guilabel
> ila vido konsistas el pluraj langetoj: </para>

<variablelist>

<varlistentry>
<term
><guilabel
>&gdb; Eligo</guilabel
></term>
<listitem>
<para
>Enhavas eliron de &gdb; kaj a &gdb; komandlinio.</para>

<screenshot id="screenshot-gdb-output">
<screeninfo
>La Eligo Tab</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-output.png" format="PNG"/></imageobject>
<textobject
><phrase
>La langeto Eligo.</phrase
></textobject>
<caption
><para
>La langeto <guilabel
>Eligo</guilabel
> montranta la eliron de sencimiga seanco.</para
></caption>
</mediaobject>
</screenshot>

</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Agordoj</guilabel
></term>
<listitem>
<variablelist>

<varlistentry>
<term
><guilabel
>Efektivigebla</guilabel
></term>
<listitem
><para
>Vojo al la celo (efektivebla) por sencimigi.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Labora Adresaro</guilabel
></term>
<listitem
><para
>La aktuala labordosierujo provizita al la celo. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Argumentoj</guilabel
></term>
<listitem
><para
>Argumentoj pasis al la programo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Konservi fokuson</guilabel
></term>
<listitem
><para
>Konservas fokuson sur la &gdb; komandlinio.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Alidirekti IO</guilabel
></term>
<listitem
><para
>Malfermas novan langeton <guilabel
>IO</guilabel
> en la <guilabel
>Sencimiga Vido</guilabel
> kie vi povas vidi eligon kaj provizi enigon al la ruliĝanta programo.</para
></listitem>
</varlistentry>

</variablelist>

<screenshot id="screenshot-gdb-settings">
<screeninfo
>La dialogo de Agordoj</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-settings.png" format="PNG"/></imageobject>
<textobject
><phrase
>La dialogo de Agordoj</phrase
></textobject>
<caption
><para
>La dialogo <guilabel
>Agordoj</guilabel
> montranta la agordon de sencimiga seanco.</para
></caption>
</mediaobject>
</screenshot>

</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>IO</guilabel
></term>
<listitem>
<para
>Enhavas areon, kiu montras produktaĵon de la funkcianta programo kaj komandlinion, kie vi povas doni enigon al ĝi.</para>

<screenshot id="screenshot-gdb-io">
<screeninfo
>La IO Tab</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-io.png" format="PNG"/></imageobject>
<textobject
><phrase
>La langeto IO.</phrase
></textobject>
<caption
><para
>La langeto <guilabel
>IO</guilabel
> montranta eliron de simpla testprogramo.</para
></caption>
</mediaobject>
</screenshot>

</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="gdb-other">
<title
>Vokstako kaj Lokaj variabloj</title>

<para
>La <guilabel
>Voka stako</guilabel
> ila vido enhavas liston de la formatita malantaŭa spuro resendita de &gdb;.</para>

<screenshot id="screenshot-gdb-call-stack">
<screeninfo
>La &gdb; Vokstaka Ilovido</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-call-stack.png" format="PNG"/></imageobject>
<textobject
><phrase
>La vido de la Vokstaka ilo.</phrase
></textobject>
<caption
><para
>La <guilabel
>Call Stack</guilabel
> ilovido de la &gdb;-kromprogramo. </para
></caption>
</mediaobject>
</screenshot>

<para
>La ilovido de <guilabel
>Lokuloj</guilabel
> enhavas liston de ĉiuj aktuale ŝargitaj variabloj de la programo kaj iliajn respondajn valorojn.</para>

<screenshot id="screenshot-gdb-locals">
<screeninfo
>La &gdb;-Ilovido de Lokuloj</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="gdb-locals.png" format="PNG"/></imageobject>
<textobject
><phrase
>La ilvido de Lokuloj.</phrase
></textobject>
<caption
><para
>La <guilabel
>Lokuloj</guilabel
>-ilovido de la &gdb;-kromprogramo. </para
></caption>
</mediaobject>
</screenshot>

</sect2>

<sect2 id="gdb-ack">
<title
>Dankon kaj Dankon</title>

<para
>Specialan dankon al la partoprenanto de Google Code-In 2011 Martin Gergov pro verkado de granda parto de ĉi tiu sekcio.</para>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-projects">
<!--https://kate-editor.org/2012/11/02/using-the-projects-plugin-in-kate -->

<title
>Projekta Kromprogramoo</title>

<sect2 id="project-intro">
<title
>Enkonduko</title>

<para
>La baza ideo de la Projekta kromaĵo estas havi strukturitan liston de dosieroj apartenantaj al la projekto kun la sekvaj trajtoj:</para>

<orderedlist>
<listitem
><para
>Provizi strukturitan vidon de la dosieroj</para
></listitem>
<listitem
><para
>Igi ĝin facila kaj tre rapida malfermi kaj ŝanĝi projektojn</para
></listitem>
<listitem
><para
>Subteni serĉon kaj anstataŭigu projekton</para
></listitem>
<listitem
><para
>Provizi simplan aŭtomatan kompletigon</para
></listitem>
<listitem
><para
>Simpligi rapidan malfermadon de dosieroj en la projekto</para
></listitem>
<listitem
><para
>Subteno por konstrui la projekton</para
></listitem>
</orderedlist>
</sect2>

<sect2 id="project-view">
<title
>Strukturita Vido de la Dosieroj</title>

<para
>Post kiam la Projekta kromaĵo estas ŝargita en la &kate; agorda paĝo, malfermu dosieron en projekto kaj aperos flanka kolumno, kiu listigas ĉiujn projektojn kaj la projektodosierojn jene:</para>

<screenshot id="screenshot-project-view">
<screeninfo
>Projekta Vido</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="project-view.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Kiel vi povas vidi, la nuntempe aktiva projekto estas <quote
>Kate</quote
>, kaj ĝia enhavo estas listigita en la arba vido. Alklakante dosierojn en la arba vido malfermas la dosieron en la redaktilo. Plue, kunteksta menuo estas provizita per kiu vi povas malfermi dosierojn kun aliaj aplikaĵoj, kiel ekzemple <filename class="extension"
>.ui</filename
> dosiero kun Qt Designer.</para>
<para
>Vi povas filtri la erojn tajpante partojn de la dosiernomo, kiun vi serĉas en la serĉbreton ĉe la malsupro de la listo.</para>
</sect2>

<sect2 id="project-switch">
<title
>Ŝanĝado de Projektoj</title>

<para
>La ideo estas, ke vi neniam devas malfermi projekton permane, ĉi tio eĉ tute ne estas subtenata. Tial, kio okazas se vi malfermas dosieron, la Projekta kromaĵo rapide skanas la dosierujon kaj ĝiajn gepatrajn dosierujojn por <filename
>.kateproject</filename
> dosiero. Se trovite, la projekto estas aŭtomate ŝargita.</para>

<para
>Krome, se vi malfermas alian dokumenton en &kate;, kiu apartenas al alia projekto, la Projekta kromaĵo aŭtomate ŝanĝas la aktualan projekton. Do intuicie, ĉiam la ĝusta projekto estas aktiva. Kompreneble, vi ankaŭ povas ŝanĝi la nuntempe aktivan projekton per la kombokesto.</para>

</sect2>

<sect2 id="project-search-replace">
<title
>Serĉi kaj Anstataŭigi en Projektoj</title>

<para
>&kate; havas Serĉi-kaj-Anstataŭigi kromaĵon kiu aperas en la malsupra flanka kolumno. Se projekto estas ŝargita, malfermu la Serĉu kaj Anstataŭigi flankbreton, kaj ŝanĝu al la reĝimo por serĉi kaj anstataŭigi en la aktuala projekto:</para>

<screenshot id="screenshot-projects-search">
<screeninfo
>Serĉi en Projektoj</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="project-search.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

</sect2>

<sect2 id="project-autocompletition">
<title
>Simpla Aŭtomata Kompletigo</title>

<para
>Kun la scio pri ĉiuj dosieroj apartenantaj al projekto, la Projekta kromaĵo disponigas simplajn aŭtokompletajn instalaĵojn bazitajn sur CTags. Se projekto estas komence malfermita, CTags analizas ĉiujn projektodosierojn en fona fadeno kaj konservas la informojn de CTags al <filename class="directory"
>/tmp</filename
>. Tiu ĉi dosiero tiam estas uzata por plenigi la ŝprucfenestron de aŭtomata kompletigo en &kate;.</para>

<para
>Kontraste, sen ĉi tiu aŭtomata kompletigo, &kate; kapablas nur montri aŭtomatajn kompletigojn bazitajn sur la vortoj en la aktuala dosiero. Do la aŭtomata kompletigo provizita de la Projekta kromaĵo estas multe pli potenca.</para>

<screenshot id="screenshot-completion-search">
<screeninfo
>Kompletigo en Projektoj</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="project-completition.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Se CTags mankas, pasiva ŝprucfenestro avertas vin pri ĉi tiu problemo. Estas ankaŭ rimarkinde, ke la CTags-dosiero en <filename class="directory"
>/tmp</filename
> estas purigita kiam &kate; eliras, do la kromaĵo ne poluas iun dosierujon kun nedezirataj dosieroj.</para>

</sect2>

<sect2 id="project-build">
<title
>Subteno por Konstruado de la Projekto</title>

<para
>Alia funkcio estas havi subtenon por la <link linkend="projects-build-support"
>Konstrua Kromaĵo</link
>, tiel ke ĝi aŭtomate estas agordita ĝuste.</para>

</sect2>

<sect2 id="project-create">
<title
>Kreante Projektojn</title>

<sect3 id="project-autoload">
<!--https://kate-editor.org/2014/10/12/autoloading-projects-plugin-kate-5/-->
<title
>Ŝargante Projektojn Aŭtomate</title>

<para
>La Projekta kromaĵo havas aŭtomatan ŝargan funkcion. Vi povas legi la dosierliston de la versio-kontrolsistemo. Tiucele, aŭtomata ŝargo por la respektiva versio-kontrolsistemo devas esti ebligita en la agordoj (aktivigita defaŭlte): </para>

<screenshot id="screenshot-project-configure">
<screeninfo
>Projekta Kromaĵo-Agordo</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="project-configure.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

</sect3>

<sect3 id="project-manual">
<title
>Krei Projektojn Mane</title>
<para
>Vi nur devas krei dosieron <filename
>.kateproject</filename
> en la radika dosierujo de la projekto. Ekzemple, la dosiero <quote
>Kate</quote
> <filename
>.kateproject</filename
> aspektas jene: </para>

<screen
>{
 "nomo": "Kate",
 "dosieroj": [
 {
 "git": 1
 }
 ]
}
</screen>

<para
>La dosierenhavo estas skribita en &JSON; sintakso. La projektonomo estas <quote
>Kate</quote
>, kaj la dosieroj enhavitaj en devus esti legitaj de &git;. </para>

<para
>Ankaŭ subtenata anstataŭ <literal
>git</literal
> estas subfosado per <literal
>svn</literal
> kaj mercurial per <literal
>hg</literal
>. Se vi ne volas legi dosierojn de versio-kontrolsistemo, vi povas simple alvoki kate el komandlinio kiel: <screen>
kate /path/to/folder
</screen
> aŭ vi povas instrui ĝin rekursie ŝargi dosierojn el dosierujoj jene: </para>

<screen
>{
  "name": "Kate",
  "files": [
    {
      "directory": "kate",
      "filters": [
        "*.cpp",
        "*.h",
        "*.ui",
        "CMakeLists.txt",
        "Find*.cmake"
      ],
      "recursive": 1,
      "hidden": 1
    }
  ],
  "exclude_patterns" : [
    "^build/.*"
  ]
}
</screen>

<para
>Ĉi tie, subdosierujoj kaj filtriloj difinas kio estas parto de la projekto. Vi ankaŭ povas miksi versiokontrolon kaj dosierojn bazitajn sur filtriloj. Kaŝitaj dosieroj ne estos reakiritaj se la opcio <code
>"kaŝita"</code
> estas 0. <code
>"exclude_patterns"</code
> estas listo de regex-ŝablonoj uzeblaj por ekskludi dosierujojn kaj dosierojn el la projektarbo. En ĉi tiu ekzemplo, Ĉiuj dosieroj kaj dosierujoj en dosierujo <filename
>konstrui</filename
> el la radiko estos ekskluditaj. </para>

<para id="projects-build-support"
>Se vi volas aldoni subtenon por la konstruaĵo, vi povas skribi <filename
>.kateproject</filename
> jene:</para>

<screen
>{
  "name": "Kate",
  "files": [
    {
      "git": 1
    }
  ],
  "build": {
    "directory": "build",
    "build": "make all",
    "clean": "make clean",
    "install": "make install",
    "targets": [
      {
        "name": "all",
        "build_cmd": "ninja"
        "run_cmd": "./bin/kate"
      },
      {
        "name": "kate",
        "build_cmd": "ninja kate-bin"
      }
    ]
  }
}
</screen>

<para
>La celoj supre specifitaj tiam aperos en la <link linkend="kate-application-plugin-build"
>Konstrua Kromaĵo </link
> sub <emphasis role="bold"
> "Celoj de Projektaj Kromaĵoj"</emphasis
>. Se la tabelo <code
>"celiloj"</code
> estas specifita tiam <code
>"konstrui"</code
>, <code
>"purigi"</code
> kaj <code
>"instali "</code
> estas ignoritaj. Ĉiu elemento en la tabelo precizigas celon. <code
>"nomo"</code
> estas la nomo de la celo, <code
>"build_cmd"</code
> estos uzata por konstrui la celon, <code
>"run_cmd"</code
> estos uzata por ruli la celon. Plej grava el ĉio estas <code
>"dosierujo"</code
>, ĉi tie estos rulitaj la komandoj. </para>

<para
>Se vi havas <filename
>.kateproject</filename
> dosieron spurita de kontrolversia sistemo, sed vi devas ĝustigi la agordon por aparta laborspaco, vi povas konservi tiujn ŝanĝojn en aparta dosiero nomita <filename
>.kateproject.local</filename
>. La enhavo de ĉi tiu dosiero havos prioritaton super <filename
>.kateproject</filename
>. </para>

</sect3>

</sect2>

<sect2 id="project-current">
<title
>Aktuala Projekto</title>

<para
>Uzante <menuchoice
><shortcut
><keycombo action="simul"
>&Alt;<keycap
>1</keycap
></keycombo
></shortcut
> <guimenu
>Projektoj</guimenu
><guimenuitem
>Iri Al</guimenuitem
></menuchoice
> vi povas malfermi la vidon <guilabel
>Aktuala Projekto</guilabel
> ĉe la malsupro de la redaktora fenestro kun kvar langetoj:</para>

<screenshot id="screenshot-project-current">
<screeninfo
>Aktuala Projekto</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="project-current-analysis.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<variablelist>

<varlistentry>
<term>
<guimenu
>Terminal-Panelo</guimenu>
</term>
<listitem>
<para
><link linkend="kate-application-plugin-konsole"
>Terminala emulilo</link
> komencanta en la radika dosierujo de la projekto.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guimenu
>Koda Indekso</guimenu>
</term>
<listitem>
<para
>Enigi signojn en la serĉbreton komencos la serĉon kaj montros kongruajn nomojn de funkcioj, klasoj, simboloj &etc; kune kun speco, dosiernomo kaj linionumero.</para>
<para
>Elektu eron en la listo por salti al la responda linio en la fontdosiero.</para>
</listitem>
</varlistentry>

<varlistentry>
<term>
<guimenu
>Koda Analizo</guimenu>
</term>
<listitem>
<para
>Klaku <guilabel
>Komenci Analizon</guilabel
> por ruli statikan kodan analizon por la C kaj C++ uzante <command
>cppcheck</command
> kaj por generi raporton montrantan dosiernomon, linionumeron, severecon (stilo, averto, ktp;) kaj la afero trovita.</para>
<para
>Elektu eron en la listo por salti al la responda linio en la fontdosiero.</para>
</listitem>
</varlistentry>
<!--FIXME options for cppcheck? configurable?-->
<varlistentry>
<term>
<guimenu
>Notoj</guimenu>
</term>
<listitem>
<para
>Teksto enigita en ĉi tiu langeto estos konservita en la dosiero <filename
>.kateproject.notes</filename
>.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="projects-menu">
<title
>La Projektoj-Menuo</title>

<para
>La menuo <guimenu
>Projektoj</guimenu
> permesas ŝanĝi inter nun malfermitaj projektoj. Ĝi estas montrata de la Projekta kromaĵo.</para>

<variablelist>

<varlistentry id="projects-back">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Alt;&Left;</keycombo
> </shortcut
> <guimenu
>Projektoj</guimenu
> <guimenuitem
>Reen</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Ŝanĝi al la antaŭa projekto.</para>
</listitem>
</varlistentry>

<varlistentry id="projects-forward">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Alt;&Right;</keycombo
> </shortcut
> <guimenu
>Projektoj</guimenu
> <guimenuitem
>Antaŭen</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Ŝanĝi al la sekvanta projekto.</para>
</listitem>
</varlistentry>

<varlistentry id="projects-goto">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Alt;<keycap
>1</keycap
></keycombo
> </shortcut
> <guimenu
>Projektoj</guimenu
><guimenuitem
>Iri Al</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Malfermi la vidon de <guilabel
>Aktuala Projekto</guilabel
> ĉe la fundo de la redaktora fenestro.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>
<!--
context menu Project->Lookup:xxx
-->

</sect1>

<!--FIXME Replicode
Projects Replicode run / stop-->

<sect1 id="kate-application-plugin-lspclient">
<title
>LSP-Klienta Kromaĵo</title>

<para
>La kromaĵo de LSP-kliento disponigas multajn lingvajn funkciojn kiel kodkompletigon, kodnavigadon aŭ trovi referencojn bazitajn sur la <ulink url="https://microsoft.github.io/language-server-protocol/"
>Language Server Protocol</ulink
>.</para>

<para
>Post kiam vi ebligis la LSP-klienton en la krompaĝo, nova paĝo nomata LSP-kliento aperos en via &kate; agorda dialogo. </para>

<sect2 id="lspclient-menu">
<title
>Strukturo de menuo</title>

<para
>Se konvene, responda LSP-komando ankaŭ estas menciita en la klarigo malsupre, kies dokumentado tiam povas disponigi kroman fonon kaj interpreton, kvankam ĝi povas varii dependi de la fakta lingvo. La frazo 'nuna simbolo' rilatas al la simbolo egalrilatanta al la nuna kursorpozicio, kiel tiel determinite per la lingvo kaj servila efektivigo. </para>

<variablelist>

<varlistentry id="lspclient-definition">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Iri al Difino</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>[textDocument/difino] Iru al la aktuala simboldifino.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-declaration">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Iri al Deklaro</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>[textDocument/declaration] Iru al aktuala simbola deklaro.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-typedefinition">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Iri al Tipo-Difino</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>[textDocument/typeDefinition] Iru al aktuala simboltipdifino.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-references">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Trovi Referencojn</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>[textDocument/references] Trovu referencojn al aktuala simbolo.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-implementation">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Trovi Implementojn</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>[textDocument/implementation] Trovi efektivigojn de aktuala simbolo.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-highlight">
<term
><menuchoice
><guimenu
>LSP-kliento</guimenu
> <guisubmenu
>Elstarigu</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>[textDocument/documentHighlight] Marki nunajn simbolreferencojn en aktuala dokumento.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-hover">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Ŝvebi</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>[textDocument/hover] Ŝveb-informoj por aktuala simbolo.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-format">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Formato</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>[textDocument/formatting] [textDocument/rangeFormatting] Formatu la aktualan dokumenton aŭ aktualan elekton.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-rename">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Alinomu</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>[textDocument/rename] Alinomi aktualan simbolon.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-quick-fix">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Rapida solvo</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>[textDocument/codeAction, workspace/executeCommand] Komputilas kaj aplikas rapidan solvon por diagnozo pri aktuala pozicio (aŭ linio).</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-completion-documentation">
<term
><menuchoice
><guimenu
>LSP-kliento</guimenu
> <guisubmenu
>Montri elektitan kompletigdokumentaron</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Montru dokumentadon por elektita elemento en la kompletigolisto.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-signature-help">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Ebligi subskriban helpon kun aŭtomata kompletigo</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Ankaŭ montru subskriban helpon en la kompletigolisto.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-declaration-references">
<term
><menuchoice
><guimenu
>LSP-kliento</guimenu
> <guisubmenu
>Inkluzivi deklaron en referencoj</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Peto inkluzivi la deklaron de simbolo kiam oni petas referencojn.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-completion-parens">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Aldonu krampojn ĉe funkciokompletigo</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Aŭtomate aldonu paron da krampoj post kompletigo de funkcio.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-show-hover">
<term
><menuchoice
><guimenu
>LSP-kliento</guimenu
> <guisubmenu
>Montri informojn pri ŝvebado</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Montri informojn pri ŝvebado sur (muskursoro) ŝvebado. Sendepende de ĉi tiu agordo, la peto ĉiam povas esti mane iniciatita. </para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-format-typing">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Formato dum tajpado</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>[document/onTypeFormatting] Formati partojn de dokumento dum tajpado de certaj ekigilsignoj. Ekzemple, ĉi tio povus apliki indentaĵon sur novlinio, aŭ kiel alie determinite de LSP-Servilo. Notu, ke redaktaj indentskriptoj eble provas fari la samon (depende de la reĝimo) kaj do eble ne estas konsilinde havi ambaŭ ebligitaj samtempe. </para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-incremental-sync">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Pliiga dokumenta sinkronigo</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Sendi partajn dokumentajn redaktojn por ĝisdatigi la servilon prefere ol tuta dokumentteksto (se subtenata).</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-highlight-goto">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Elstarigu iri lokon</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Provizi paseman vidan signalon post plenumo de goto al loko (de difino, deklaro, ktp).</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-diagnostics">
<term
><menuchoice
><guimenu
>LSP-kliento</guimenu
> <guisubmenu
>Montri diagnozajn sciigojn</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>[textDocument/publishDiagnostics] Procesi kaj montri diagnozajn sciigojn senditajn de servilo.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-diagnostics-highlight">
<term
><menuchoice
><guimenu
>LSP-kliento</guimenu
> <guisubmenu
>Montri diagnozajn elstaraĵojn</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Aldonu tekststaraĵojn por intervaloj indikitaj en diagnozo.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-diagnostics-marks">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Montri diagnozajn markojn</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Aldonu dokumentmarkojn por linioj indikitaj en diagnozo.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-diagnostics-tab">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Ŝanĝi al diagnoza langeto</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Ŝanĝi al la diagnoza langeto en la kromprograma ilvido.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-close-non-diagnostics">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Fermi ĉiujn ne-diagnozajn langetojn</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Fermi ĉiujn langetojn ne-diagnozajn (&eg; referencojn) en kromprograma ilvido.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-restart">
<term
><menuchoice
><guimenu
>LSP-kliento</guimenu
> <guisubmenu
>Rekomencu LSP-servilon</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Rekomenci la LSP-Servilon de aktuala dokumento.</para>
</listitem>
</varlistentry>

<varlistentry id="lspclient-restart-all">
<term
><menuchoice
><guimenu
>LSP-Kliento</guimenu
> <guisubmenu
>Rekomenci ĉiujn LSP-servilojn</guisubmenu
> </menuchoice
></term>
<listitem>
<para
>Halti ĉiujn LSP-Servilojn, kiuj tiam estos (re)komencitaj laŭbezone.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="lspclient-go-to-symbol">
<title
>Subteno por Iri al Simbolo</title>
<para
>LSP Kliento povas helpi vin salti al ajna simbolo en via projekto aŭ aktuala dosiero. Por salti al iu ajn simbolo en la dosiero, uzu la ilovidon "LSP Klienta Simbolo Skizo" ĉe la dekstra rando de kate. Ĉi tiu ilvido listigas ĉiujn simbolojn trovitajn de la servilo en aktuala dokumento. </para>

<sect3 id="lspclient-symbol-outline-config">
<title
>Agordi LSP-Klienta Simbolo-Skizo</title>

<para
>Defaŭlte la simboloj estas ordigitaj laŭ sia apero en la dokumento sed vi povas ŝanĝi la ordigon por esti alfabeta. Por fari tion, dekstre alklaku en la ilovido kaj marku "Ordigi Alfabete". </para>

<para
>La ilvido montras la simbolojn en arbreĝimo defaŭlte, tamen vi povas ŝanĝi ĝin al listo uzante la kuntekstan menuon. </para>
</sect3>

<sect3 id="lspclient-global-go-to-symbol">
<title
>Ĉiea Goto-simbolsubteno</title>
<para
>Por salti al iu ajn simbolo en via projekto, vi povas malfermi la dialogon de iri simbolo uzante <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>p</keycap
></keycombo
>. La dialogo estas malplena kiam ĝi malfermiĝas, sed tuj kiam vi tajpas ion, la dialogo komencos montri al vi kongruajn simbolojn. La kvalito de kongruoj kaj ankaŭ filtraj kapabloj dependas de la servilo, kiun vi uzas. Ekzemple, clangd subtenas neklaran filtradon sed iu alia servilo eble ne. </para>
</sect3>

</sect2>

<sect2 id="lspclient-extra">
<title
>Aliaj Trajtoj</title>

<para
>Clangd-ŝanĝa fontokapa komando estas subtenata. Por ŝanĝi fontan kaplinion en projekto C aŭ C++ aŭ uzu la opcion "Switch Source Header" de la kunteksta menuo aŭ la ŝparvojo <keycombo action="simul"
><keycap
>F12</keycap
></keycombo
> . </para>

<para
>Vi povas rapide salti al simbolo metante vian muson super la simbolon kaj poste premante <keycombo action="simul"
>&Ctrl;</keycombo
> + maldekstran musbutonon. </para>

</sect2>

<sect2 id="lspclient-configuration">
<title
>Agordo</title>

<para
>La agorda paĝo de la kromaĵo plejparte ebligas konstantan agordon de iuj el ĉi-supraj menueroj. Tamen, ekzistas unu plia eniro por specifi la servilan agordan dosieron. Ĉi tio estas &JSON; dosiero kiu povas esti uzata por specifi la LSP-servilon por komenci (kaj poste por komuniki kun super stdin/stdout). Por komforto, iu defaŭlta agordo estas inkluzivita, kiu povas esti inspektita en la agorda paĝo de la kromaĵo. Por helpi en la klarigo malsupre, eltiraĵo de tiu agordo estas donita ĉi tie: </para>

<screen
>{
    "servers": {
        "bibtex": {
            "use": "latex",
            "highlightingModeRegex": "^BibTeX$"
        },
        "c": {
            "command": ["clangd", "-log=error", "--background-index"],
            "commandDebug": ["clangd", "-log=verbose", "--background-index"],
            "url": "https://clang.llvm.org/extra/clangd/",
            "highlightingModeRegex": "^(C|ANSI C89|Objective-C)$"
        },
        "cpp": {
            "use": "c",
            "highlightingModeRegex": "^(C\\+\\+|ISO C\\+\\+|Objective-C\\+\\+)$"
        },
        "d": {
            "command": ["dls", "--stdio"],
            "url": "https://github.com/d-language-server/dls",
            "highlightingModeRegex": "^D$"
        },
        "fortran": {
            "command": ["fortls"],
            "rootIndicationFileNames": [".fortls"],
            "url": "https://github.com/hansec/fortran-language-server",
            "highlightingModeRegex": "^Fortran.*$"
        },
        "javascript": {
            "command": ["typescript-language-server", "--stdio"],
            "rootIndicationFileNames": ["package.json", "package-lock.json"],
            "url": "https://github.com/theia-ide/typescript-language-server",
            "highlightingModeRegex": "^JavaScript.*$",
            "documentLanguageId": false
        },
        "latex": {
            "command": ["texlab"],
            "url": "https://texlab.netlify.com/",
            "highlightingModeRegex": "^LaTeX$"
        },
        "go": {
            "command": ["go-langserver"],
            "commandDebug": ["go-langserver", "-trace"],
            "url": "https://github.com/sourcegraph/go-langserver",
            "highlightingModeRegex": "^Go$"
        },
        "python": {
            "command": ["python3", "-m", "pyls", "--check-parent-process"],
            "url": "https://github.com/palantir/python-language-server",
            "highlightingModeRegex": "^Python$"
        },
        "rust": {
            "command": ["rls"],
            "path": ["%{ENV:HOME}/.cargo/bin", "%{ENV:USERPROFILE}/.cargo/bin"],
            "rootIndicationFileNames": ["Cargo.lock", "Cargo.toml"],
            "url": "https://github.com/rust-lang/rls",
            "highlightingModeRegex": "^Rust$"
        },
        "ocaml": {
            "command": ["ocamlmerlin-lsp"],
            "url": "https://github.com/ocaml/merlin",
            "highlightingModeRegex": "^Objective Caml.*$"
        }
    }
}
</screen>

<para
>Notu, ke ĉiu "komando" povas esti tabelo aŭ ĉeno (tiam ĝi estas dividita en tabelon). Ankaŭ, altnivela "ĉiea" enskribo (apud "servilo") estas konsiderata ankaŭ (vidu pli sube). La specifita duumaro estas serĉata laŭ la kutima maniero, ekz. uzante <literal
>PATH</literal
>. Se ĝi estas instalita en iu propra loko, tiam ĉi-lasta eble devos esti etendita. Aŭ alternative, (sim)ligo aŭ envolvaĵskripto povas esti uzata en loko kiu estas ene de la kutima <literal
>PATH</literal
>. Kiel ĉi-supre ilustrite, oni povas ankaŭ specifi "vojo" kiun oni serĉos post la normaj lokoj. </para>

<para
>Ĉiuj enskriboj en "komando", "radiko" kaj "pado" estas submetataj al varia ekspansio. </para>

<para
>La "highlightingModeRegex" estas uzata por mapi la reliefan reĝimon kiel uzatan de &kate; al la lingvoid de la servilo. Se neniu regula esprimo estas donita, la lingvo-id mem estas uzata. Se "documentLanguageId" eniro estas agordita kiel malvera, tiam neniu lingvo-identigilo estas provizita al la servilo dum malfermado de la dokumento. Ĉi tio povas havi pli bonajn rezultojn por iuj serviloj, kiuj estas pli precizaj por determini la dokumentspecon ol fari tion surbaze de kate-reĝimo. </para>

<para
>De la supra ekzemplo, la esenco estas supozeble klara. Krome, ĉiu servila enira objekto ankaŭ povas havi "initializationOptions" eniron, kiu estas transdonita al la servilo kiel parto de la 'initialize' metodo. Se ĉeestas, "agordoj" eniro estas transdonita al la servilo per la sciigo 'workspace/didChangeConfiguration'. Aŭ de "completionTriggerCharacters" aŭ "signatureTriggerCharacters" povas esti specifita kiel JSON-objekto kun ĉenoj "exclude" kaj/aŭ "include". Ĉi tiuj estos uzataj por respektive ekskludi aŭ aldoni kelkajn signojn al la respektiva ekigilaro kiel provizita de la servilo. </para>

<para
>Diversaj stadioj de superregado/kunfandi estas aplikataj; <itemizedlist>
<listitem>
<para
>uzanta agordo (ŝargita el dosiero) superregas (internan) defaŭltan agordon</para>
</listitem>
<listitem>
<para
>"lspclient" eniro en <filename
>.kateproject</filename
> projektagordo anstataŭas ĉi-supran</para>
</listitem>
<listitem>
<para
>la rezulta enskribo "global" estas uzata por kompletigi (ne anstataŭi) ajnan servilan eniron</para>
</listitem>
</itemizedlist>
</para>

<para
>Unu servila instanco estas uzata per (radiko, servilospeco) kombinaĵo. Se "root" estas specifita kiel absoluta vojo, tiam ĝi uzis kiel-estas, alie ĝi estas relative al la <quote
>projectBase</quote
> (kiel determinite de la <link linkend="kate-application-plugin-projects"
>Projekta kromaĵo</link
>) se aplikebla, aŭ alie rilate al la dosierujo de la dokumento. Se ne specifita kaj "rootIndicationFileNames" estas tabelo kiel dosiernomoj, tiam gepatra dosierujo de aktuala dokumento enhavanta tian dosieron estas elektita. Alternative, se "root" ne estas specifita kaj "rootIndicationFilePatterns" estas tabelo de dosierŝablonoj, tiam gepatra dosierujo de la nuna dokumento kongrua kun la dosierŝablono estas elektita. Kiel lasta rezerva, la hejma dosierujo estas elektita kiel "radiko". Por iu ajn dokumento, la rezulta "root" tiam determinas ĉu aŭ ne aparta kazo estas necesa. Se jes, la "root" estas transdonita kiel rootUri/rootPath. </para>

<para
>Ĝenerale, oni rekomendas lasi radikon nespecifita, ĉar ĝi ne estas tiom grava por servilo (via kilometraĵo tamen povas varii). Pli malmultaj servilaj instancoj estas evidente pli efikaj, kaj ili ankaŭ havas "pli larĝan" vidon ol la vido de multaj apartaj okazoj. </para>

<para
>Kiel menciite supre, pluraj eniroj estas submetataj al varia ekspansio. Taŭga apliko de tio kombinita kun aliroj de "envolvaĵo-skripto" permesas personigon al multaj cirkonstancoj. Ekzemple, konsideru python-disvolvan scenaron kiu konsistas el pluraj projektoj (ekz. git repos), ĉiu kun sia propra virtualenv-aranĝo. Uzante la defaŭltan agordon, la pitona lingvoservilo ne konscios pri la virtuala env. Tamen, tio povas esti riparita per la sekva aliro. Unue, la sekva fragmento povas esti enigita en la "Uzanto-Servilo-Agordoj" de LSPClient: </para>
<screen
>{
        "servers":
        {
                "python":
                {
                        "command": ["pylsp_in_env", "%{Project:NativePath}"],
                        "root": "."
                }
        }
}
</screen>
<para
>La radika eniro supre estas relativa al la projekta dosierujo kaj certigas ke aparta lingvoservilo estas komencita por ĉiu projekto, kio estas necesa en ĉi tiu kazo ĉar ĉiu havas apartan virtualan medion. </para>
<para
><filename
>pylsp_in_env</filename
> estas malgranda "envolvaĵa skripto" kiu devus esti metita en <literal
>PATH</literal
> kun la sekva (alĝustigota) enhavo: </para>
<screen
>#!/bin/bash
cd $1
# rulu la servilon (python-lsp-server) ene de la virtualenv
# (t.e. kun agordo de virtualenv-variabloj)
# do fontu la virtualenv
source XYZ
# servilaj postuloj aŭ argumentoj povas varii
exec miaservilo
</screen>


<sect3 id="lspclient-customization">
<title
>Agordo de LSP-Servilo</title>

<para
>Ĉiu aparta LSP-servilo havas sian propran manieron de personigo kaj povas uzi specifajn rimedojn de lingvo/ilo por agordo, &eg; <filename
>tox.ini</filename
> (a.a. por python), <filename
>.clang-format</filename
> por C++-stila formato. Tia agordo povas tiam ankaŭ esti uzata de aliaj (ne-LSP) iloj (kiel tiam <application
>tox</application
> aŭ <application
>clang-format</application
>). Krom tio, iuj LSP-serviloj ankaŭ ŝargas agordon de propraj dosieroj (&eg; <filename
>.ccls</filename
>). Krome, laŭmenda servila agordo ankaŭ povas esti trapasita per LSP (protokolo), vidu la menciitajn "initializationOptions" kaj "settings" enskribojn en servila agordo. </para>

<para
>Ĉar diversaj niveloj de superregado/kunfandiĝo estas aplikata, la sekva ekzemplo de uzanto-specifita kliento-agordo ĝustigas iun python-lingvo-servila agordo. </para>

<screen
>{
    "servers": {
        "python": {
            "settings": {
                "pyls": {
                    "plugins": {
                        "pylint": {
                            "enable": true
                        }
                    }
                }
            }
        }
    }
}
</screen>

<para
>Bedaŭrinde, LSP-servila agordo/personigo ofte ne estas tiel bone dokumentita, tiel ke nur ekzamenado de la fontkodo montras agordaalirojn kaj la aron de disponeblaj agordaj elektoj. Aparte, la servilo de ĉi-supra ekzemplo subtenas multajn pliajn opciojn en "agordoj". Vidu <ulink url="https://github.com/neoclide/coc.nvim/wiki/Language-servers"
> dokumentaron de alia LSP-kliento</ulink
> por diversaj aliaj lingvoservilaj ekzemploj kaj respondaj agordoj, kiuj povas facile; kaj facile esti transformita al la &JSON; agordo kiu estas uzata ĉi tie kaj skizita supre. </para>

</sect3>

<sect3 id="lspclient-format-on-save">
<title
>LSP Servila Formato Sur Konservi</title>

<para
>Vi povas ebligi "formati dum konservado" de LSP-agordoj en agorda dialogo. </para>

</sect3>

<sect3 id="lspclient-diagnostics-suppression">
<title
>LSP-Servilo Diagnoza Subpremado</title>

<para
>Povas okazi, ke oni raportas diagnozojn, kiuj ne estas tute utilaj. Ĉi tio povas esti sufiĉe ĝena, precipe se estas multaj (ofte de la sama speco). En iuj kazoj, ĉi tio povas esti tajlita per specifaj rimedoj de lingvo (servilo). Ekzemple, la <ulink url="https://clangd.llvm.org/config.html"
>agorda mekanismo de clangd</ulink
> permesas ĝustigi iujn diagnozajn aspektojn. Ĝenerale, tamen, eble ne ĉiam estas evidente kiel fari tion, aŭ eble eĉ tute ne eblas laŭ dezirataj manieroj pro servilaj limigoj aŭ cimo. </para>

<para
>Kiel tia, la kromaĵo subtenas diagnozsubpremadon simila al ekz. valgrind-subpremoj. La plej fajngrajna agordo povas esti liverita en ŝlosilo "suppressions" en la (kunfandita) &JSON; agordo. </para>

<screen
>{
    "servers": {
        "c": {
            "suppressions": {
                "rulename": ["filename", "foo"],
                "clang_pointer": ["", "clang-tidy", "clear_pointer"],
            }
        }
    }
}
</screen>

<para
>Ĉiu (valida) regulo havas arbitran nomon kaj estas difinita per tabelo de longo 2 aŭ 3 kiu provizas regex por kongrui kun la (plena) dosiernomo, regex por kongrui kun la diagnoza (teksto) kaj laŭvola regex kongrua kun la (fontokodo gamo de) teksto al kiu la diagnozo validas. </para>

<para
>Krom ĉi-supra fajngrajna agordo, la kunteksta menuo en la diagnoza langeto ankaŭ subtenas aldoni/forigi subpremojn, kiuj kongruas precize kun aparta diagnozo (teksto), ĉu ĉie (iu ajn dosiero) ĉu loke (la specifa dosiero koncerna). Ĉi tiuj subpremoj estas konservitaj kaj ŝargitaj de seanc-agordo. </para>

</sect3>

<sect3 id="lspclient-troubleshooting">
<title
>Solvo de Problemoj pri LSP-Servilo</title>

<para
>Unu afero estas priskribi kiel agordi (personan) LSP-servilon por iu ajn aparta lingvo, alia estas fini, ke la servilo funkcias glate. Kutime, ĉi-lasta estas feliĉe la kazo. Kelkfoje, tamen, problemoj povas aperi pro aŭ iu "stulta" misagordo aŭ pli fundamenta problemo kun la servilo mem. Ĉi-lasta povus kutime manifesti sin kiel kelkaj provoj komenci la servilon, kiel tiel raportite en &kate; Eligo langeto. Ĉi-lasta tamen nur intencas transdoni altnivelajn mesaĝojn aŭ progresi prefere ol disponigi detalajn diagnozojn, kaj eĉ malpli por kio estas fakte alia procezo (la LSP-servilo). </para>

<para
>La kutima maniero por diagnozi tion estas aldoni iun flago(j)n al la startkomando (de la lingvoservilo) kiu ebligas (aldonan) ensalutadon (al iu dosiero aŭ norma eraro), tiom kiom ĝi ne faras tion defaŭlte. . Se &kate; tiam estas komencita sur la komandlinio, tiam oni povus akiri pli da (en)vido pri kio eble misfunkcias. </para>

<para
>Povas ankaŭ esti informi ekzameni la protokolan interŝanĝon inter la LSP-kliento de &kate; kaj la LSP-servilo. Denove, ĉi-lasta kutime havas manierojn spuri tion. La LSP-kliento ankaŭ disponigas kroman sencimigan spuradon (al stderr) kiam &kate; estas alvokita per la jena <literal
>QT_LOGGING_RULES=katelspclientplugin=true</literal
> taŭge <literal
>eksporto</literal
>'ed. </para>

</sect3>

</sect2>

<!--TODO: Supported languages, describe features and actions a bit -->

<!--<screenshot id="screenshot-rust-configuration">
<screeninfo
>Rust Configuration</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="rust-configuration.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Edit the command to run <ulink url="https://github.com/phildawes/racer"
>Racer</ulink
>,
an utility intended to provide Rust code completion for editors.</para>

<para
>You also need the Rust source code and have to provide the path to the source tree.
</para>

<para
>While typing code a popup list appears with items for completion:
</para>

<screenshot id="screenshot-rust-completion">
<screeninfo
>Rust Completion</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="rust-completion.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>In addition to code completion popups, the plugin also installs
a <guimenuitem
>Go to Definition</guimenuitem
> action in the <guimenu
>Edit</guimenu
> menu and
in the context menu. You can configure a keyboard shortcut for it as well.
</para>

<para
>This action will open the document containing the definition if needed, activate
its view and place the cursor at the start of the definition.
</para
>-->

</sect1>

<sect1 id="kate-application-plugin-searchinfiles">
<sect1info>
<authorgroup
><author
>&TC.Hollingsworth; &TC.Hollingsworth.mail; </author
></authorgroup>
</sect1info>
<title
>Serĉi &amp; Anstataŭigi</title>

<sect2 id="searchinfiles-intro">
<title
>Enkonduko</title>
<para
>La kromprogramo Serĉi &amp; Anstataŭigi de &kate; permesas serĉi tekston aŭ <ulink url="help:/katepart/regular-expressions.html"
>regulajn esprimojn</ulink
> en multaj malsamaj dosieroj samtempe. Vi povas serĉi ĉiujn malfermitajn dosierojn, ĉiujn dosierojn en unu dosierujo kaj laŭvole ĝiaj subdosierujoj, aŭ en la aktiva dosiero. Vi povas eĉ filtri laŭ dosiernomo, ekzemple serĉante nur dosierojn, kiuj finiĝas per aparta dosier-etendaĵo.</para>

</sect2>

<sect2 id="searchinfiles-ui">
<title
>Interfaco</title>

<sect3 id="searchinfiles-ui-query">
<title
>Serĉa Demando</title>

<para
>La sekvaj opcioj ĉiam montriĝas ĉe la supro de la ilo Serĉi en Dosieroj:</para>

<variablelist>

<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="tab-new-22.png" format="PNG"/>
</imageobject
></inlinemediaobject
></guiicon
></term>
<listitem
><para
>Vi povas havi tiom da serĉoj kiom vi volas malfermitaj samtempe. Simple alklaku la butonon de la nova langeto ĉe la supra maldekstra angulo de la vido de Serĉilo kaj malfermiĝos nova langeto de rezultoj permesante al vi fari alian serĉon. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="games-config-options-22.png" format="PNG"/>
</imageobject
></inlinemediaobject
></guiicon
></term>
<listitem
><para
>La butono en la supra dekstra angulo de la ilo-vido Serĉi en Dosieroj ŝanĝos la malsupran duonon de la ila vido inter montrado de pliaj opcioj por la reĝimo Serĉo en Dosierujo kaj la rezultoj de via serĉo. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Trovi</guilabel
></term>
<listitem
><para
>Ĉi tie vi tajpas tion, kion vi volas trovi. Vi povas enigi norman tekston, aŭ regulan esprimon se ĝi estas enŝaltita. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Anstataŭigi</guilabel
> (tekstkesto)</term>
<listitem
><para
>Anstataŭiga teksto kiu estos aldonita al dosiero(j) anstataŭ la teksto en la tekstkesto <guilabel
>Trovu</guilabel
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Serĉi</guibutton
></term>
<listitem
><para
>Kiam vi finis ĉion agordi, simple premu la butonon <guibutton
>Serĉi</guibutton
> por fari vian serĉon. Vi ankaŭ povas premi &Enter; en la tekstokesto <guilabel
>Trovi</guilabel
> por fari la samon. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Anstataŭigi</guibutton
></term>
<listitem
><para
>Kiam vi finos agordi ĉion, simple premu la butonon <guibutton
>Anstataŭigi</guibutton
> por anstataŭigi la tekston enskribitan en la tekstokesto <guilabel
>Trovu</guilabel
> per tiu de la teksto <guilabel
>Anstataŭigi</guilabel
>. skatolo. Vi ankaŭ povas premi &Enter; en la tekstokesto <guilabel
>Anstataŭigi</guilabel
> por fari la samon. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Sekva</guibutton
></term>
<listitem
><para
>Iru al la sekva kongruo de via serĉdemando, ŝanĝante dosierojn se necese. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Anstataŭigi Markitajn</guibutton
></term>
<listitem
><para
>Same kiel <guibutton
>Anstataŭigi</guibutton
>, sed nur faros anstataŭigojn en dosieroj, kiuj estas markitaj en la suba panelo. </para
></listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="searchinfiles-ui-folder">
<title
>Opcioj por Serĉi en Dosierujo</title>

<para
>Ĉi tiuj opcioj estas montrataj sub la menciitaj demandopcioj. Se la serĉrezultoj estas montritaj anstataŭe, premu la <guiicon
><inlinemediaobject
><imageobject
> <imagedata fileref="games-config-options-22.png" format="PNG"/></imageobject
></inlinemediaobject
></guiicon
> butono por montri ilin.</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Serĉi en</guilabel
></term>
<listitem
><para
>Ĉi tio havas tri eblojn. Elektu <guilabel
>Malfermi dosierojn</guilabel
> por serĉi ĉiujn dosierojn nuntempe malfermitajn en &kate;. Elektu <guilabel
>Dosierujon</guilabel
> por serĉi ene de dosierujo kaj laŭvole ĝiaj subdosierujoj. Elektu <guilabel
>Aktuala Dosiero</guilabel
> por serĉi nur en la aktiva dosiero. </para>
<para
>Se la kromprogramo <guilabel
>Projektoj</guilabel
> estas ŝargita, vi ankaŭ povas serĉi en la <guilabel
>Aktuala Projekto</guilabel
> aŭ en <guilabel
>Ĉiuj Malfermaj Projektoj</guilabel
>. </para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Kongrua kazo</guilabel
></term>
<listitem
><para
>Limigas serĉrezultojn al nur tiuj, kiuj havas la ĝustan saman kombinaĵon de majusklaj kaj minusklaj literoj kiel via serĉdemando. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Regulaj esprimoj</guilabel
></term>
<listitem
><para
>Permesas al vi uzi <ulink url="help:/katepart/regular-expressions.html"
>regulajn esprimojn</ulink
> anstataŭ simpla teksto kiel via serĉdemando. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Pligrandigi rezultojn</guilabel
></term>
<listitem
><para
>Montri ĉiujn rezultojn trovitajn en ĉiu dosiero, anstataŭ nur liston de dosieroj, kiuj enhavas la serĉdemandon. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Dosierujo</guilabel
></term>
<listitem
><para
>Vi povas enigi la vojon de la dosierujo, kiun vi volas serĉi. Ekzemple, vi povus enigi <userinput
>~/development/kde/kate/</userinput
> se vi dezirus serĉi la &kate; fontkodo. Ĉi tiu opcio disponeblas nur kiam vi uzas <guilabel
>en Dosierujo</guilabel
> reĝimo. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
>Dialogo por malfermi dosieron</guiicon
></term>
<listitem
><para
>Premu ĉi tiun butonon por lokalizi la dosierujon en la dosierujo-retumilo de via labortablo. Ĉi tiu butono funkcias nur kiam vi uzas la reĝimon <guilabel
>Dosierujo</guilabel
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="go-up-22.png" format="PNG"/>
</imageobject
></inlinemediaobject
></guiicon
></term>
<listitem
><para
>Premu ĉi tiun butonon por ŝanĝi <guilabel
>Dosierujon</guilabel
> al la patro de la nuntempe elektita dosierujo. Ĉi tiu butono funkcias nur kiam vi uzas la reĝimon <guilabel
>Dosierujo</guilabel
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="view-refresh-22.png" format="PNG"/>
</imageobject
></inlinemediaobject
></guiicon
></term>
<listitem
><para
>Ĉi tiu butono agordos la eniron <guilabel
>Dosierujo</guilabel
> al la dosierujo en kiu troviĝas la nuntempe malfermita dokumento. Ĉi tiu butono funkcias nur kiam vi uzas la reĝimon <guilabel
>Dosierujo</guilabel
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Filtrilo</guilabel
></term>
<listitem
><para
>Ĉi tio ebligas al vi serĉi nur dosiernomojn kiuj kongruas kun aparta ŝablono. Ekzemple, por nur serĉi dosierojn skribitajn en C++, ŝanĝu ĝin al <userinput
>*.cpp</userinput
>. Por serĉi nur dosierojn komenciĝantajn per <literal
>kate</literal
>, ŝanĝu ĝin al <userinput
>kate*</userinput
>. Vi povas enigi plurajn filtrilojn apartigitajn per komo (<userinput
>,</userinput
>). Ĉi tiu opcio ne disponeblas kiam vi uzas la reĝimon <guilabel
>Malfermi dosierojn</guilabel
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Ekskludi</guilabel
></term>
<listitem
><para
>La malo de <guilabel
>Filtrilo</guilabel
>, tio malhelpas &kate; de serĉado de dosieroj, kiuj kongruas kun la specifitaj ŝablonoj. Kiel ĉe <guilabel 
>Filtrilo</guilabel
>, vi povas enigi plurajn ŝablonojn apartigitajn per komo (<userinput
>,</userinput
>). Ĉi tiu opcio ne disponeblas kiam vi uzas la reĝimon <guilabel
>Malfermi dosierojn</guilabel
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Rekursiva</guilabel
></term>
<listitem
><para
>Se ĉi tiu opcio estas ebligita, &kate; serĉos ankaŭ en ĉiuj subdosierujoj de la elektita dosierujo. Ĉi tiu opcio disponeblas nur kiam vi uzas la reĝimon <guilabel
>Dosierujo</guilabel
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Inkluzivi kaŝitajn</guilabel
></term>
<listitem
><para
>Se ĉi tiu opcio estas ebligita, &kate; ankaŭ serĉos en dosieroj aŭ dosierujoj, kiuj estas kutime kaŝitaj de via &OS;. Ĉi tiu opcio disponeblas nur kiam vi uzas la reĝimon <guilabel
>Dosierujo</guilabel
>. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Sekvi simbolajn ligilojn</guilabel
></term>
<listitem
><para
>La kromprogramo Serĉi en Dosieroj kutime ne sekvas <ulink url="https://en.wikipedia.org/wiki/Symbolic_link"
>simbolajn ligilojn</ulink
>. Kiam ĉi tiu opcio estas ebligita, la kromaĵo sekvos ilin anstataŭe kaj serĉos en la dosieroj aŭ dosierujoj, kiujn ili referencas. Ĉi tiu opcio disponeblas nur kiam vi uzas la reĝimon <guilabel
>Dosierujo</guilabel
>. </para>
<warning
><para
>Eblas simbolaj ligiloj referenci dosierujon, kiu estas la gepatro de la dosierujo nuntempe serĉata, aŭ aliajn dosierujojn, kiuj enhavas simbolajn ligilojn al sia gepatro. Se estas tia ligilo en la serĉata dosierujo kaj ĉi tiu opcio estas ebligita, &kate; plurfoje sekvos la ligilon kaj serĉos la dosierujon, kaj la serĉo neniam finiĝos.</para
></warning>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Inkluzivi binarajn dosierojn</guilabel
></term>
<listitem
><para
>Se ebligita, &kate; serĉos ankaŭ en dosieroj, kiuj ŝajnas ne esti tekstaj dosieroj. </para
></listitem>
</varlistentry>

</variablelist>
</sect3>

<sect3 id="searchinfiles-ui-results">
<title
>Serĉrezultoj</title>

<para
>La rezultoj de via serĉo estas montrataj sub la demandopcioj. Se ebloj por Serĉi en Dosierujo-reĝimo montriĝas, simple premu la <guiicon
><inlinemediaobject
><imageobject
><imagedata fileref="games-config-options-22.png" format="PNG"/> </imageobject
></inlinemediaobject
></guiicon
> butonon por montri ilin. Ili ankaŭ aŭtomate montriĝos tuj kiam serĉo estas farita.</para>

<para
>La serĉrezultoj montras liston de dosieroj, kiuj enhavas tekston, kiu kongruas kun via serĉdemando, sekvata de la nombro da kongruoj trovitaj en tiu dosiero.</para>

<para
>Por vidi liston de kongruoj en tiu dosiero, simple alklaku la vastigan sagon maldekstre de la dosiernomo. (Se vi elektis la opcion <guilabel
>Vaŝigi rezultojn</guilabel
>, tio jam estos farita por vi.) La linionumero, sur kiu ĉiu kongruo troviĝas, estos montrata, sekvata de la enhavo de tiu linio, kun via serĉdemando indikita. en grasa teksto.</para>

<para
>Por malfermi la dosieron, en kiu troviĝis via rezulto, simple duoble alklaku ĝin. &kate; malfermos la dosieron se necese. Vi ankaŭ povas movi la kursoron al la loko de aparta kongruo per duobla alklako sur ĝia listo anstataŭ la dosiernomo. </para>

</sect3>
</sect2>

<sect2 id="searchinfiles-menu">
<title
>Strukturo de menuo</title>

<variablelist>

<varlistentry id="edit-searchinfiles">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Alt;<keycap
>F</keycap
></keycombo
> </shortcut
> <guimenu
>Redakti</guimenu
> <guimenuitem
>Serĉi en dosieroj</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Lanĉas la ilan vidon Serĉi kaj Anstataŭigi.</para>
</listitem>
</varlistentry>

<varlistentry id="edit-next-match">
<term
><menuchoice
><guimenu
>Redakti</guimenu
> <guimenuitem
>Iri al Sekva Partio</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Iru al la sekva kongruo en serĉo farita de la kromprogramo Serĉu kaj Anstataŭigi.</para>
</listitem>
</varlistentry>

<varlistentry id="edit-previous-match">
<term
><menuchoice
><guimenu
>Redakti</guimenu
> <guimenuitem
>Iri al Antaŭa Partio</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Iri al la antaŭa kongruo en serĉo farita de la kromprogramo Serĉi kaj Anstataŭigi.</para>
</listitem>
</varlistentry>

<varlistentry id="view-toolviews-searchandreplace">
<term
><menuchoice
><guimenu
>Vidi</guimenu
><guisubmenu
>Vidoj de iloj</guisubmenu
> <guimenuitem
>Montri Serĉon kaj Anstataŭigi</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Baskuligi la montradon de la <guilabel
>Serĉi kaj Anstataŭigi</guilabel
>-ilo de &kate;. </para>
</listitem>
</varlistentry>

</variablelist>

</sect2>
</sect1>

<sect1 id="kate-application-plugin-snippets">
<sect1info>
<authorgroup>
<author
><firstname
>Martin</firstname
> <surname
>Gergov</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>&kate; Fragmentoj</title>

<sect2 id="snippets-intro">
<title
>Enkonduko</title>
<para
>&kate; Fragmentoj estas kromaĵo uzata por ŝpari al vi iom da tempo aldonante subtenon por tiel nomataj <quote
>fragmentoj</quote
> (reuzebla fontkodo, maŝinkodo aŭ teksto). La kromaĵo ankaŭ subtenas kodkompletigon kaj &javascript;.</para>
</sect2>

<sect2 id="snippets-menu">
<title
>Strukturo de menuo</title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Vido</guimenu
><guisubmenu
>Vidoj de iloj</guisubmenu
> <guimenuitem
>Montri fragmentojn</guimenuitem
></menuchoice
></term>
<listitem
><para
>Montras panelon de fragmentoj enhavantan ĉiujn fragmentojn en via deponejo kiuj estas por la aktuale malfermita dosiertipo.</para
></listitem>
</varlistentry>

<varlistentry id="tools-create-snippet">
<term
><menuchoice
><guimenu
>Iloj</guimenu
> <guimenuitem
>Krei Fragmenton</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Kreu novan fragmenton, kiu estas reuzebla parto de teksto, kiun vi povas enmeti en ajnan parton de iu ajn dokumento.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="snippets-panel">
<title
>Panelo de fragmentoj</title>

<screenshot id="screenshot-snippets-panel">
<screeninfo
>&kate; Fragment-Panelo</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-panel.png" format="PNG"/></imageobject>
<textobject
><phrase
>La &kate; panelo de fragmentoj.</phrase
></textobject>
<caption
><para
>La panelo por &kate;-Fragmentoj.</para
></caption>
</mediaobject>
</screenshot>

<para
>En la panelo vi devus vidi liston de fragmentaj deponejoj, kune kun ebloj por krei viajn proprajn, akiri ilin de la Interreto aŭ ŝargi ilin el loka dosiero. Ĉiu deponejo havas markobutonon, kiu povas esti uzata por aktivigi aŭ malaktivigi ĝin. Estas ankaŭ butonoj por redakti kaj forigi ekzistantajn deponejojn.</para>

<sect3 id="snippets-repo-internet">
<title
>Ŝargante Fragmentajn Deponejojn</title>
<para
>Vi povas elŝuti fragmentajn deponejojn de la Interreto. Simple klaku <guibutton
>Akipi novajn fragmentojn</guibutton
> kaj malfermiĝos fenestro kun listo de fragmentoj. Post elŝuto de la dezirata fragmento, certigu, ke vi aktivigis ĝin.</para>
<!--FIXME no way to load a local file ?
<para
>You can also load snippet repositories from a local file using the file
browser at the bottom of the panel.  Click <guibutton
>Copy to repository</guibutton>
when finished.</para
>-->
</sect3>

<sect3 id="snippets-repo-editor">
<title
>Krei kaj Redakti Deponejojn</title>

<para
>Por krei novan deponejon de fragmentoj, alklaku <guibutton
>Aldoni Deponejon</guibutton
>. Vi nun devus vidi dialogon, kiu petas la nomon de la fragmenta dosiero, permesilo kaj aŭtoro. Post elekto de la dezirataj opcioj, alklaku <guibutton
>OK</guibutton
>.</para>

<screenshot id="screenshot-snippets-repository">
<screeninfo
>Fragmentredaktilo</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-repository.png" format="PNG"/></imageobject>
<textobject
><phrase
>La deponeja redaktilo.</phrase
></textobject>
<caption
><para
>La interfaco de deponeja redaktilo.</para
></caption>
</mediaobject>
</screenshot>

<para
>La redaktilo de fragmentoj de deponejo enhavas la jenajn opciojn:</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Nomo</guilabel
></term>
<listitem
><para
>Aperas en la listo de fragmentoj en la ila vido kaj ankaŭ estas serĉata kiam oni uzas la kodkompletigan funkcion.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Nomspaco</guilabel
></term>
<listitem
><para
>Prefikso uzata dum kodokompletigo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Permesilo</guilabel
></term>
<listitem
><para
>Elektu la permesilon por via fragmento-deponejo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Aŭtoroj</guilabel
></term>
<listitem
><para
>Enigu la nomon(j)n de la aŭtoro(j) de la fragmenta dosiero.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Dosiertipoj</guilabel
></term>
<listitem
><para
>Elektu la dosiertipojn, al kiuj vi volas ke la fragmento-deponejo apliku. Ĝi estas agordita al <quote
></quote
> defaŭlte, do la deponejo validas por ĉiuj dosieroj. Vi povas ŝanĝi ĝin al io kiel <userinput
>C++</userinput
> ekzemple, aŭ elekti el listo alklakante la aĵojn. Vi povas specifi pli ol unu dosiertipo premante la &Shift; dum aldonado de tipoj.</para
></listitem>
</varlistentry>

</variablelist>

</sect3>

<sect3 id="snippets-editor">
<title
>Krei kaj Redakti Pecetojn</title>

<screenshot id="screenshot-snippets-form">
<screeninfo
>Fragmentredaktilo</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-form.png" format="PNG"/></imageobject>
<textobject
><phrase
>La redaktoro de fragmentoj.</phrase
></textobject>
<caption
><para
>La interfaco de redaktilo de fragmentoj.</para
></caption>
</mediaobject>
</screenshot>

<variablelist>

<varlistentry>
<term
><guilabel
>Nomo</guilabel
></term>
<listitem
><para
>La nomo estos montrata en la kompletigolisto.</para
></listitem>
</varlistentry>

<varlistentry>
<term
>Ŝparvojo</term>
<listitem
><para
>Premante ĉi tiun ŝparvojon enigos la fragmenton en la dokumenton.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Fragmentoj</guilabel
></term>
<listitem
><para
>La tekston, kiun via fragmento enigos en la dokumenton.</para>
<para
>Fragmento povas enhavi redakteblajn kampojn. Ili povas esti biciklitaj premante &Tab;. La jenaj esprimoj povas esti uzataj en la ŝablona teksto por krei kampojn:</para>
<para
><userinput
>${<replaceable
>field_name</replaceable
>}</userinput
> kreas simplan, redakteblan kampon. Ĉiuj postaj okazoj de la sama <replaceable
>field_name</replaceable
> kreas kampojn kiuj spegulas la enhavon de la unua dum redaktado.</para>
<para
><userinput
>${<replaceable
>field_name=defaŭlto</replaceable
>}</userinput
> povas esti uzata por specifi defaŭltan valoron por la kampo. <replaceable
>defaŭlto</replaceable
> povas esti ajna &javascript; esprimo.</para>
<para
>Uzu <userinput
>${<replaceable
>field_name</replaceable
>=<replaceable
>teksto</replaceable
>}</userinput
> por specifi fiksan ĉenon kiel defaŭltan valoron.</para>
<para
><userinput
>${func(<replaceable
>alia_kampo1</replaceable
>, <replaceable
>alia_kampo2</replaceable
>, ...)}</userinput
> povas esti uzata por krei kampon kiu taksas &javascript; funkcias en ĉiu redakto kaj enhavas ĝian enhavon. Vidu la langeton <guilabel
>Skriptoj</guilabel
> por pliaj informoj.</para>
<para
><userinput
>${cursor}</userinput
> povas esti uzata por marki la finpozicion de la kursoro post kiam ĉio alia estis plenigita.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Skriptoj</guilabel
></term>
<listitem
><para
>&javascript; helpaj funkcioj por uzi en viaj fragmentoj.</para>
<para
>Ĉiuj &javascript; funkcioj devas resendi la enhavon, kiun vi volas meti en ŝablonkampon kiel ĉenon.</para>
<para
>Funkcioj estas nomitaj en amplekso kiu enhavas la enhavon de ĉiuj redakteblaj ŝablonkampoj kiel lokaj variabloj. Ekzemple en fragmento enhavanta <userinput
>${<replaceable
>kampo</replaceable
>}</userinput
>, variablo nomata <userinput
>kampo</userinput
> ĉeestos kiu enhavas la ĝisdatigitan enhavon de la ŝablona kampo. Tiuj variabloj povas aŭ esti uzataj en la funkcio statike aŭ transdonitaj kiel argumentoj, uzante la <userinput
>${func(kampo)}</userinput
> aŭ <userinput
>${<replaceable
>field2=func(kampo)</replaceable
>}</userinput
> sintakso en la fragmentĉeno.</para>
<para
>Vi povas uzi la <ulink url="help:/katepart/dev-scripting.html#dev-scripting-api"
>&kate; scripting API</ulink
> por akiri la elektitan tekston, plenan tekston, dosiernomon kaj pli uzante la taŭgajn metodojn de la objektoj <userinput
>dokumento</userinput
> kaj <userinput
>vido</userinput
>. Raportu la dokumentaron pri scripting API por pliaj informoj.</para>
<para
>Por pli kompleksaj skriptoj povas esti grave kompreni, ke <emphasis
>unue</emphasis
>, la kruda fragmento estas enmetita en la dokumenton, kaj <emphasis
>poste</emphasis
> funkcioj estas taksataj. Ekz., se funkcio retrovas la tekston sur la linio kie la fragmento estas enmetita, tiu teksto ankaŭ enhavos <userinput
>${functionCall()}</userinput
>.</para>
<para
>Kiel ekzemplo de laboro kun elektoj uzante la scripting API, simpla maniero envolvi elektitan tekston ene de etikedoj estas ĉi tiu fragmento: <userinput
>&lt;strong&gt;${view.selectedText()}&lt;/strong&gt;</userinput
> </para>
<para
>La sekva ekzemplo alvokas skripton, kiu enmetas defaŭltan tekston, se ne ekzistas elekto. Fragmento:</para>
<para>
<userinput
>${rangeCommand("&lt;strong&gt;%%1&lt;/strong&gt;", "Grasa")}</userinput
></para>
<para
>Skripto: <programlisting
>function gamoKomando(komando, difin) {
    if (view.selectedText().length 
> 0) {
        return komando.replace("%%1", view.selectedText());
    } else {
        return komando.replace("%%1", difin);
    }
}
</programlisting>
</para>
</listitem>
</varlistentry>

</variablelist>
</sect3>
</sect2>

<sect2 id="snippets-using">
<title
>Uzante Fragmentojn</title>

<screenshot id="screenshot-snippets-usage">
<screeninfo
>&kate;-Fragmentoj en Praktiko</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="snippets-usage.png" format="PNG"/></imageobject>
<textobject
><phrase
>Alirante &kate;-Fragmentojn de ila vido kaj falmenuo.</phrase
></textobject>
<caption
><para
>Elektante el listo de fragmentoj.</para
></caption>
</mediaobject>
</screenshot>

<para
>Vi povas voki fragmentojn en du manieroj:</para>

<itemizedlist>
<listitem
><para
>Elektante la fragmenton el la ila vido.</para
></listitem>
<listitem
><para
>Dum skribado, vi povas premi <keycombo action="simul"
>&Ctrl; &Space;</keycombo
>, kiu montros ĉiujn fragmentojn en oportuna fenestro el kiu vi povas elekti. Ĉi tiu klavkombinaĵo disponigas funkciojn similajn al kodkompletigo.</para
></listitem>
</itemizedlist>

<para
>Se la fragmento enhavas variablojn (krom <literal
>${cursor}</literal
>) la kursoro aŭtomate iros al la unua okazo de variablo kaj atendos ke vi skribu ion. Kiam vi finos, vi povas premi &Tab; movi al la sekva variablo, kaj tiel plu.</para>

</sect2>

<sect2 id="snippets-ack">
<title
>Dankon kaj Dankon</title>
<para
>&kate; Fragmentoj estis skribitaj fare de Joseph Wenninger.</para>
<para
>Specialan dankon al la partoprenanto de Google Code-In 2011 Martin Gergov pro verkado de granda parto de ĉi tiu sekcio.</para>
</sect2>

</sect1>

<sect1 id="kate-application-plugin-keyboardmacros">
<sect1info>
<authorgroup>
<!--author
>&Pablo.Rauzy; &Pablo.Rauzy.mail;</author--> <!-- TODO: use that when the version of KDocTools that Kate depends on has it -->
<author
><firstname
>Pablo</firstname
> <surname
>Rauzy</surname
> <email
>r .at. uzy.me</email
></author>
</authorgroup>
</sect1info>
<title
>Kromaĵo por klavaraj makrooj</title>

<sect2 id="keyboardmacros-intro">
<title
>Enkonduko</title>
<para
>Registri kaj ludu klavarajn makroojn (t.e. klavarajn agosekvencojn).</para>
</sect2>

<sect2 id="keyboardmacros-basicusage">
<title
>Baza uzado</title>

<sect3 id="keyboardmacros-basicusage-record">
<title
>Por komenci registri klavaran makroon:</title>
<para
><menuchoice
><guimenu
>Iloj</guimenu
><guimenuitem
>Klavaraj makrooj</guimenuitem
><guimenuitem
>Registri makroon...</guimenuitem
></menuchoice
> (<keycombo action="simul"
>&Ctrl;&Shift;<keycap
>K</keycap
></keycombo
>). </para>
<para
>La kromaĵo registros ĉiujn klavpremojn ĝis vi finos registradon.</para>
</sect3>

<sect3 id="keyboardmacros-basicusage-record-end">
<title
>Por fini registradon:</title>
<para
><menuchoice
><guimenu
>Iloj</guimenu
><guimenuitem
>Klavaraj makrooj</guimenuitem
><guimenuitem
>Finigi makroregistradon</guimenuitem
></menuchoice
> (<keycombo action="simul"
>&Ctrl;&Shift;<keycap
>K</keycap
></keycombo
>). </para>
<para
>La kromaĵo ĉesos registri klavopremojn kaj konservos la sekvencon kiel la aktuala makroo.</para>
</sect3>

<sect3 id="keyboardmacros-basicusage-record-cancel">
<title
>Por nuligi registradon:</title>
<para
><menuchoice
><guimenu
>Iloj</guimenu
><guimenuitem
>Klavaraj makrooj</guimenuitem
><guimenuitem
>Nuligi makroregistradon</guimenuitem
></menuchoice
> (<keycombo action="simul"
>&Ctrl;&Alt;&Shift;<keycap
>K</keycap
></keycombo
>). </para>
<para
>La kromaĵo ĉesos registri klavopremojn sed la nuna makroo ne ŝanĝiĝos.</para>
</sect3>

<sect3 id="keyboardmacros-basicusage-play">
<title
>Por ludi la aktualan makroon:</title>
<para
><menuchoice
><guimenu
>Iloj</guimenu
><guimenuitem
>Klavaraj makrooj</guimenuitem
><guimenuitem
>Ludi makroon</guimenuitem
></menuchoice
> (<keycombo action="simul"
>&Ctrl;&Alt;<keycap
>K</keycap
></keycombo
>). </para>
<para
>La kromaĵo ludos la aktualan makroon.</para>
<para
>La komando <userinput
>kmplay</userinput
> sen iuj argumentoj ankaŭ ludos la aktualan makroon.</para>
</sect3>

</sect2>

<sect2 id="keyboardmacros-namedmacros">
<title
>Nomitaj makrooj</title>

<para
>Eblas konservi klavarajn makroojn donante al ili nomon.</para>
<para
>Nomitaj makrooj estas konstantaj inter la seancoj de Kate, ili estas konservitaj en la dosiero <filename
>keyboardmacros.json</filename
> en la uzantdatuma dosierujo de Kate (kutime <filename
>~/.local/share/kate/</filename
>).</para>

<sect3 id="keyboardmacros-namedmacros-save">
<title
>Por konservi la aktualan makroon:</title>
<para
><menuchoice
><guimenu
>Iloj</guimenu
><guimenuitem
>Klavaraj makrooj</guimenuitem
><guimenuitem
>Konservi nunan makroon</guimenuitem
></menuchoice
> (<keycombo action="simul"
>&Alt;&Shift;<keycap
>K</keycap
></keycombo
>). </para>
<para
>La kromaĵo petos vin por nomo kaj konservos la makroon sub ĝi.</para>
<para
>La komando <userinput
>kmsave <replaceable
>nomo</replaceable
></userinput
> konservos la nunan makroon sub la nomo <userinput
><replaceable
>nomo</replaceable
></userinput
>.</para>
</sect3>

<sect3 id="keyboardmacros-namedmacros-load">
<title
>Por ŝargi konservitan makroon kiel la aktualan:</title>
<para
><menuchoice
><guimenu
>Iloj</guimenu
><guimenuitem
>Klavaraj makrooj</guimenuitem
><guimenuitem
>Ŝargi Nomitan Makroon...</guimenuitem
></menuchoice
>. </para>
<para
>La kromaĵo listigas konservitajn makroojn kiel erojn en ĉi tiu submenuo, aktivigi objekton ŝargos la respondan makroon kiel la aktualan.</para>
<para
>La komando <userinput
>kmload <replaceable
>nomo</replaceable
></userinput
> ŝargos la makroon konservitan sub la nomo <userinput
><replaceable
>nomo</replaceable
></userinput
> kiel la aktuala.</para>
</sect3>

<sect3 id="keyboardmacros-namedmacros-play">
<title
>Por ludi konservitan makroon sen ŝargi ĝin:</title>
<para
><menuchoice
><guimenu
>Iloj</guimenu
><guimenuitem
>Klavaraj makrooj</guimenuitem
><guimenuitem
>Ludi Nomitan Makroon...</guimenuitem
></menuchoice
>. </para>
<para
>La kromaĵo listigas konservitajn makroojn kiel erojn en ĉi tiu submenuo, aktivigi objekton ludos la respondan makroon sen ŝargi ĝin.</para>
<para
>Notu, ke ĉiu konservita makroo estas ago kiu estas parto de la nuna agadkolekto tiel ke propra ŝparvojo povas esti asignita al ĝi per la <menuchoice
><guimenu
>Agordoj</guimenu
><guimenuitem
>Agordu klavarajn ŝparvojojn...</guimenuitem
></menuchoice
> interfaco.</para>
<para
>La komando <userinput
>kmplayer <replaceable
>nomo</replaceable
></userinput
> ludos la makroon konservitan sub la nomo <userinput
><replaceable
>nomo</replaceable
></userinput
> sen ŝargi ĝin.</para>
</sect3>

<sect3 id="keyboardmacros-namedmacros-wipe">
<title
>Por viŝi (t.e., forigi) konservitan makroon:</title>
<para
><menuchoice
><guimenu
>Iloj</guimenu
><guimenuitem
>Klavaraj Makrooj</guimenuitem
><guimenuitem
>Forviŝi Nomitan Makroon...</guimenuitem
></menuchoice
>. </para>
<para
>La kromaĵo listigas konservitajn makroojn kiel erojn en ĉi tiu submenuo, aktivigi objekton forviŝos (t.e., forigos) la respondan makroon.</para>
<para
>La komando <userinput
>kmwipe <replaceable
>nomo</replaceable
></userinput
> forviŝos la makroon konservitan sub la nomo <userinput
><replaceable
>nomo</replaceable
></userinput
>.</para>
</sect3>

<sect3 id="keyboardmacros-namedmacros-command-tips">
<title
>Konsiloj por komandoj:</title>
<para
>Notu, ke post la prefikso <userinput
>km</userinput
>, ĉiuj ĉi ordonoj uzas alian literon, por ke vi povu efike voki ilin uzante tabuladon!</para>
</sect3>

</sect2>

<sect2 id="keyboardmacros-limitations">
<title
>Limigoj</title>

<para
>Aktuale, klavaraj makrooj ne ludas ĝuste se iuj specoj de GUI-fenestraĵoj estas uzataj: QMenu, QuickOpenLineEdit aŭ TabSwitcherTreeView, ekzemple. Mi ne certas kial sed mia unua supozo estus, ke ĉi tiuj fenestraĵoj funkcias ne-norma maniero rilate klavarajn eventojn.</para>

</sect2>

</sect1>


<sect1 id="kate-application-plugin-sql">
<sect1info>
<authorgroup>
<author
><firstname
>Ömer</firstname
> <othername
>Faruk</othername
> <surname
>ORUÇ</surname
></author>
<author
>&TC.Hollingsworth; &TC.Hollingsworth.mail;</author>
</authorgroup>
</sect1info>
<title
>SQL Kromaĵo</title>

<sect2 id="sql-intro">
<title
>Enkonduko</title>

<para
>La Structured Query Language (SQL) estas speciala lingvo por ĝisdatigi, forigi kaj peti informojn de datumbazoj.</para>

<para
>La &kate; SQL-Aldonaĵo permesas vin:</para>

<itemizedlist>
<listitem
><para
>Krei datumbazon</para
></listitem>
<listitem
><para
>Konekti al ekzistantaj datumbazoj</para
></listitem>
<listitem
><para
>Enigi kaj forigi datumojn en la datumbazo</para
></listitem>
<listitem
><para
>Efektivigi demandojn</para
></listitem>
<listitem
><para
>Montri rezultojn en tabelo</para
></listitem>
</itemizedlist>

</sect2>

<sect2 id="sql-connecting">
<title
>Konektante al datumbazo</title>

<para
>Elektu <guibutton
>Aldoni Konekton</guibutton
> el la menuo aŭ ilobreto <guimenu
>SQL</guimenu
>, kaj poste elektu la &Qt; datumbaza pelilo, kiun vi volas uzi (inkluzive de QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7 kaj QPSQL). Se vi ne povas vidi la deziratan pelilon, vi devas instali ĝin. Tiam, premu <guibutton
>Sekva</guibutton
>. </para>

<para
>Se la datumbazo, kiun vi elektis, uzas dosieron, simple indiku la lokon de la datumbazo kaj premu la butonon <guibutton
>Sekva</guibutton
>. Se ĝi postulas konektiĝi al servilo, vi devas enigi la gastigan nomon de la servilo, vian uzantnomon kaj pasvorton, kaj ajnan alian informon, kiun specifa pelilo povas postuli. Tiam premu <guibutton
>Sekva</guibutton
>.</para>

<para
>Fine, donu nomon al via konekto, kaj premu <guibutton
>Finu</guibutton
>.</para>

</sect2>

<sect2 id="sql-querying">
<title
>Lanĉante Aldemandojn</title>

<sect3 id="sql-querying-insert-delete-update">
<title
>INSERT/DELETE/UPDATE</title>

<para
>Vi povas enmeti, forigi kaj ĝisdatigi datumojn uzante la SQL-kromaĵon same kiel vi farus de la komandlinio aŭ de ene de programo. Simple enigu demandon kaj premu la butonon <guibutton
>Ruli demandon</guibutton
> en la ilobreto aŭ uzu <menuchoice
><guimenu
>SQL</guimenu
><guimenuitem
>Ruli konsulton</guimenuitem
></menuchoice
> (<keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
>).</para>

<example>
<title
>Kelkaj Ekzemplaj Demandoj</title>
<variablelist>

<varlistentry>
<term
><command
>INSERT</command
></term>
<listitem
><para
><programlisting
>INSERT INTO <replaceable
>table_name</replaceable
> ("<replaceable
>feature1</replaceable
>", "<replaceable
>feature2</replaceable
>", "<replaceable
>feature3</replaceable
>", "<replaceable
>feature4</replaceable
>", "<replaceable
>feature5</replaceable
>")
VALUES ("<replaceable
>value1</replaceable
>", "<replaceable
>value2</replaceable
>", "<replaceable
>value3</replaceable
>", "<replaceable
>value4</replaceable
>", "<replaceable
>value5</replaceable
>" )
</programlisting
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><command
>DELETE</command
></term>
<listitem
><para
><programlisting
>DELETE FROM <replaceable
>table_name</replaceable
> WHERE name = "<replaceable
>teksto</replaceable
>"
</programlisting
></para
></listitem>
</varlistentry>

<varlistentry>
<term
><command
>UPDATE</command
></term>
<listitem
><para
><programlisting
>UPDATE <replaceable
>tabelnomo</replaceable
> SET "<replaceable
>trajto1</replaceable
>" = "<replaceable
>teksto</replaceable
>", "<replaceable
>trajto2</replaceable
>" = "<replaceable
>teksto</replaceable
>", "<replaceable
>trajto3</replaceable
>" = "<replaceable
>teksto</replaceable
>", "<replaceable
>trajto4</replaceable
>" = "<replaceable
>teksto</replaceable
>", "<replaceable
>trajto5</replaceable
>" = "<replaceable
>teksto</replaceable
>"
</programlisting
></para
></listitem>
</varlistentry>

</variablelist>
</example>

</sect3>

<sect3 id="sql-querying-select">
<title
>SELECT</title>

<para
>Post rulado de <command
>SELECT</command
>-demando, vi povas vidi la rezultojn kiel tabelo, kiu aperos en la ilo <guilabel
>SQL-Eligo</guilabel
> ĉe la malsupro de &kate;, aŭ kiel teksto en la <guilabel
>SQL-Teksto-Eligo</guilabel
>. Se estas eraro, vi povas vidi ĝin en la teksta eligo.</para>

<example>
<title
>Ekzemplo <command
>SELECT</command
> Demando</title>
<para
><programlisting
>SELECT * FROM <replaceable
>tabelonomo</replaceable
>
</programlisting
></para>
</example>

<para
>En la ilvido de <guilabel
>SQL-Eligo de datumoj</guilabel
>, estas pluraj butonoj:</para>

<variablelist>

<varlistentry>
<term
><guibutton
>Regrandigi kolumnojn al enhavo</guibutton
></term>
<listitem
><para
>Ŝanĝas la grandecon de kolumnoj por kongrui kun ilia enhavo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Regrandigi vicojn al enhavo</guibutton
></term>
<listitem
><para
>Ŝanĝas la grandecon de vicoj por kongrui kun ilia enhavo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Kopii</guibutton
></term>
<listitem
><para
>Elektas la tutan tabelenhavon kaj kopias ĝin al la bufro de la tondujo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Eksporto</guibutton
></term>
<listitem
><para
>Eksportas la tutan tabelenhavon al dosiero, la tondujo aŭ la nuna dokumento en la formato de Komo Apartigitaj Valoroj.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guibutton
>Klara</guibutton
></term>
<listitem
><para
>Forigas ĉion el la tablovido.</para
></listitem>
</varlistentry>

<!--FIXME Use system locale -->

</variablelist>

<para
>Vi nun povas ŝanĝi la kolorojn montritajn en la tabelo en la sekcio <guilabel
>SQL</guilabel
> de <menuchoice
><guimenu
>Agordoj</guimenu
><guimenuitem
>Agordu &kate;...</guimenuitem
> </menuchoice
> .</para>

</sect3>
</sect2>

<sect2 id="sql-browsing">
<title
>Foliumado</title>

<para
>Vi povas foliumi vian datumbazon per la <guilabel
>Datumbaza skemo</guilabel
> retumila ilo-vido maldekstre. La informoj montritaj varias depende de kiun datumbazan pelilon vi uzas.</para>

<para
>Por refreŝigi ĉi tiun liston, dekstre alklaku ie ajn en la ila vido kaj elektu <guimenuitem
>Refreŝigi</guimenuitem
>. Por generi demandon pri iu ajn enskribo en la listo, dekstre alklaku enskribon, elektu <guisubmenu
>Generu</guisubmenu
>, kaj elektu la demandtipon (<guimenuitem
>SELECT</guimenuitem
>, <guimenuitem
>UPDATE</guimenuitem
>, <guimenuitem
>INSERT</guimenuitem
>, aŭ <guimenuitem
>DELETE</guimenuitem
>) de la submenuo kiu aperas.</para>

</sect2>

<sect2 id="sql-menus">
<title
>Strukturo de menuo</title>
<variablelist>

<varlistentry>
<term
><menuchoice
><guimenu
>SQL</guimenu
><guimenuitem
>Aldoni konekton...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Aldonas novan konekton uzante ajna datumbaza pelilo. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>SQL</guimenu
><guimenuitem
>Forigi konekton</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Forigas la elektitan konekton. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>SQL</guimenu
><guimenuitem
>Redakti konekton...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Redaktas la agordojn de la aktuala konekto. </para
></listitem>
</varlistentry>

<varlistentry>
<term
>Konektoj</term>
<listitem
><para
>Ĉiuj datumbazkonektoj, kiujn vi kreis, estas listigitaj inter la menueroj <guimenuitem
>Redakti konekton</guimenuitem
> kaj <guimenuitem
>Ruli konsulton</guimenuitem
>. Elektu unu por fari demandojn aŭ fari modifojn al ĝi. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>E</keycap
></keycombo
></shortcut
> <guimenu
>SQL</guimenu
><guimenuitem
>Ruli konsulton</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Rulas vian demandon. </para
></listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="sql-ack">
<title
>Dankon kaj Dankon</title>

<para
>La SQL-Kromaĵo estis verkita de Marco Mentasti.</para>
<para
>Specialan dankon al la partoprenanto de Google Code-In 2011 Ömer Faruk ORUÇ pro verkado de granda parto de ĉi tiu sekcio.</para>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-symbolviewer">
<!--https://kate-editor.org/2010/10/27/php-treeview-improvements-in-kate/?-->
<title
>Simbolo Viewer Kromaĵo</title>

<sect2 id="symbolviewer-using">
<title
>Uzante la Fermi Krom/Kiel Kromprogramon</title>

<para
>Ĝi permesas al programistoj vidi simbolojn (funkcioj, makrooj kaj strukturoj) el fontkodo.</para>
<para
>Alklakante la analizitajn informojn vi povas facile foliumi la kodon.</para>
<para
>Nuntempe la sekvaj lingvoj estas subtenataj:</para>
<para
>C/C++, &Java;, Perl, PHP, Python, Ruby, XSLT, Tcl/Tk, Fortran</para>

<para
>Listo de funkcioj:</para>
<simplelist>
<member
>Lista/Arba reĝimo</member>
<member
>Ebligi/malŝalti ordigon</member>
<member
>Kaŝi/Montri Funkciajn Parametrojn</member>
<member
>Reĝimo de Vastigi/malvastigi arbon</member>
<member
>Aŭtomata ĝisdatigo je dokumentŝanĝo</member>
<member
>Kod-analizo baziĝas sur la Sintaks-Reliefiga kadro de &kde-frameworks;</member>
</simplelist>

</sect2>

<sect2 id="symbolviewer-menu">
<title
>Strukturo de menuo</title>
<variablelist>

<varlistentry id="tools-symbolviewer">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>\</keycap
></keycombo
> </shortcut
> <guimenu
>Vido</guimenu
> <guisubmenu
>Ilaj Vidoj</guisubmenu
> <guimenuitem
>Montri Simbolliston</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Baskuligi la montradon de la Simbollisto de &kate; montranta Funkciojn, Makroojn kaj Strukturojn de la fontkodo en la aktiva dokumento.</para>
</listitem>
</varlistentry>

</variablelist>

</sect2>

<sect2 id="symbolviewer-config">
<title
>Agordo</title>

<screenshot id="screenshot-symbolviewer-settings">
<screeninfo
>Simbol-Vidilo</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="symbolviewer-settings.png" format="PNG"/></imageobject>
<caption
><para
>Elektu la defaŭltajn analizajn opciojn</para
></caption>
</mediaobject>
</screenshot>

</sect2>

</sect1>


<sect1 id="kate-application-plugin-konsole">
<title
>Terminala Ilovida Kromprogramo</title>

<para
><indexterm
><primary
>Terminal-imitilo</primary
></indexterm
> La enkonstruita Terminal Emulator estas kopio de la &kde; &konsole; terminala aplikaĵo, por via komforto. Ĝi estas havebla de la menuero <menuchoice
><guimenu
>Vido</guimenu
><guisubmenu
>Ilaj Vidoj</guisubmenu
> <guimenuitem
>Montri Terminal-Panelon</guimenuitem
></menuchoice
> kaj ricevos la fokuson kiam ajn montrata. Aldone, se la opcio <link linkend="konsole-config"
>Aŭtomate sinkronigi la terminalon kun la nuna dokumento kiam eblas</link
> estas ebligita, ĝi ŝanĝiĝos al la dosierujo de la aktuala dokumento se eble kiam ĝi estas montrata, aŭ kiam la aktuala dokumento ŝanĝiĝas.</para>

<para
>La defaŭlta loko en la &kate;-fenestro estas malsupre, sub la redakta areo.</para>

<para
>Vi povas agordi la &konsole; uzante sian &RMB; menuo, por pliaj informoj, vidu la <ulink url="help:/konsole/index.html"
>&konsole; manlibro</ulink
>.</para>

<para
>La enkonstruita terminala emulilo estas provizita de la kromaĵo Terminal Tool View.</para>

<sect2 id="konsole-menus">
<title
>Strukturo de menuo</title>

<variablelist>

<varlistentry id="view-toolviews-show-terminal">
<term
><menuchoice
><guimenu
>Vido</guimenu
><guisubmenu
>Ilaj Vidoj</guisubmenu
> <guimenuitem
>Montri Terminal-Panelon</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Ŝaltas la ekranon de la enkonstruita terminal-imitilo.</para>
<para
>Kiam aktivigita por la unua fojo, la terminalo estos kreita.</para>
<para
>Kiam la terminala emulilo montriĝas, ĝi ricevos la fokuson, por ke vi povu tuj tajpi komandojn. Se la opcio <link linkend="konsole-config"
>Aŭtomate sinkronigi la terminalon kun la nuna dokumento kiam eblas</link
> estas ebligita en la paĝo <guilabel
>Terminalo</guilabel
> de la <link linkend="config-dialog"
>Ĉefa agorda dialogo</link
> la ŝelseanco ŝanĝiĝos al la dosierujo de la aktiva dokumento, se ĝi estas loka dosiero.</para>
</listitem>
</varlistentry>

<varlistentry id="view-toolviews-pipe-to-terminal">
<term
><menuchoice
><guimenu
>Iloj</guimenu
><guimenuitem
>Tubo al Terminalo</guimenuitem
></menuchoice
></term>
<listitem
><para
>Enigu la nuntempe elektitan tekston en la enkonstruitan terminalan emulilon. Neniu nova linio estas aldonita post la teksto.</para
></listitem>
</varlistentry>

<varlistentry id="tools-sync-terminal-document">
<term
><menuchoice
><guimenu
>Iloj</guimenu
> <guimenuitem
>Sinkronigi Terminalon kun Aktuala Dokumento</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Ĉi tio igos la enkonstruitan Terminalon <command
>cd</command
> en la dosierujon de la aktiva dokumento.</para>

<para
>Alternative, vi povas agordi &kate; por ĉiam konservi la terminalon sinkronigita kun la nuna dokumento. Vidu <xref linkend="konsole-config"/> por pliaj informoj.</para>
</listitem>
</varlistentry>

<varlistentry id="tools-run-current-document">
<term
><menuchoice
><guimenu
>Iloj</guimenu
> <guimenuitem
>Ruli Aktuala Dokumento</guimenuitem
></menuchoice
></term>
<listitem>
<para
>Ruli la nunan dokumenton en &konsole;. Nur la lokaj dokumentoj povas esti rulitaj. &kate; montros averton antaŭ ol ruli dokumenton ĉar ĉi tiu ago povas esti grava sekureca minaco.</para>
</listitem>
</varlistentry>

<varlistentry id="tools-focus-terminal">
<term
><menuchoice
><guimenu
>Iloj</guimenu
> <guimenuitem
>Fokusi/Malfokusi Terminal-Panelon</guimenuitem
> </menuchoice
></term>
<listitem>
<para
>Ŝanĝu la fokuson de la nuna dokumento al la terminalo kaj inverse. </para>
</listitem>
</varlistentry>

</variablelist>
</sect2>

<sect2 id="konsole-config">
<title
>Agordo</title>

<para
>Vi povas agordi la kromprogramon Vido de Terminalilo sur la paĝo <guilabel
>Terminalo</guilabel
> de la <link linkend="configuring-kate"
>agorda dialogo</link
>.</para>

<para
>La jenaj opcioj disponeblas:</para>

<variablelist>
<varlistentry>
<term>
<guilabel
>Aŭtomate sinkronigi la terminalon kun la nuna dokumento kiam eblas</guilabel
></term>
<listitem
><para
>Ĉi tio kaŭzos la enkonstruitan terminalon <command
>cd</command
> en la dosierujon de la aktiva dokumento kiam ĝi estas lanĉita kaj kiam nova dokumento ricevas la fokuson. Se ne estas ebligita, vi devas fari vian tutan navigadon en la terminalo memstare. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Agordi EDITOR-mediovariablon al 'kate -b'</guilabel
></term>
<listitem
><para
>Ĉi tio fiksas la mediovariablon <envar
>EDITOR</envar
> tiel ke programoj ruliĝas en la enkonstruita terminalo kiu aŭtomate malfermas dosieron en redaktilo malfermos ilin en &kate; anstataŭ la defaŭlta redaktilo agordita en via ŝelo. Vi ne povos daŭrigi uzi la terminalon ĝis vi fermos la dosieron en &kate;, do la alvokanta programo konscias, ke vi finis redakti la dosieron.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Kaŝi &konsole; premante 'Esk'</guilabel
></term>
<listitem
><para
>Tio ebligas fermi la enkonstruitan terminalon premante la &Esc; klavo. Povas kaŭzi problemojn kun terminalaj aplikaĵoj, kiuj uzas &Esc; klavo, &eg; <application
>vim</application
>. Aldonu tiajn aplikaĵojn en la tekst-eniga skatolo sube. La eroj en la listo estu apartigitaj per komo.</para
></listitem>
</varlistentry>

</variablelist>
</sect2>

</sect1>

<sect1 id="kate-application-plugin-textfilter">

<title
>Tekstfiltrila Kromprogramo</title>

<sect2 id="textfilter-using">
<title
>Uzante la Tekstfiltrilan Kromaĵon</title>

<para
>Vi povas uzi ĉi tiun kromprogramon por prilabori elektitan tekston per finaj komandoj. La elekto estos uzata kiel enigo por la komando, kaj la eligo aŭ anstataŭigos la elekton aŭ estos kopiita al la tondujo, depende de la prefero de la uzanto. </para>

<itemizedlist>
<title
>Ekzemploj:</title>
<listitem
><para
><command
>less /etc/fstab</command
> - algluu la enhavon de ĉi tiu dosiero aŭ kopiu ĝin al la tondujo </para
></listitem>
<listitem
><para
><command
>wc</command
> - kalkulu liniojn, vortojn kaj signojn de la elekto kaj algluu ĉi tion en la dokumenton aŭ kopiu ĝin al la tondujo </para
></listitem>
<listitem
><para
><command
>sort</command
> - ordigu liniojn de la elekto kaj algluu la rezulton en la dokumenton aŭ kopiu ĝin al la tondujo </para
></listitem>
</itemizedlist>

</sect2>

<sect2 id="textfilter-menu">
<title
>Strukturo de menuo</title>

<variablelist>

<varlistentry id="tools-textfilter">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>\</keycap
></keycombo
> </shortcut
> <guimenu
>Iloj</guimenu
> <guisubmenu
>Filtrilo de teksto</guisubmenu
> </menuchoice
></term>
<listitem>

<para
><action
>Malfermas</action
> la dialogon de Teksta Filtrilo:</para>

<screenshot id="screenshot-filtertext">
<screeninfo
>Dialogo de Teksta Filtrilo</screeninfo>
<mediaobject>
<imageobject
><imagedata fileref="textfilter.png" format="PNG"/></imageobject>
</mediaobject>
</screenshot>

<para
>Enigu la ŝelan komandon en la kombokeston aŭ elektu antaŭan komandon el la historio.</para>

<variablelist>

<varlistentry>
<term
><guilabel
>Kopii la rezulton anstataŭ glui ĝin</guilabel
></term>
<listitem>
<para
>Kopii la rezulton al tondujo lasante dokumenton senŝanĝa.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><guilabel
>Kunfandi STDOUT kaj STDERR</guilabel
></term>
<listitem>
<para
>Se markite, eligo de STDOUT kaj STDERR estos kunfandita kaj neniuj eraroj estos raportitaj. Alie, STDERR estos montrata kiel pasiva mesaĝo.</para>
</listitem>
</varlistentry>

</variablelist>

</listitem>
</varlistentry>

</variablelist>

</sect2>

</sect1>

<sect1 id="kate-application-plugin-xmlcheck">
<!-- from doc/kate-addons/xmlcheck.docbook -->
<sect1info>
<authorgroup
><author
>&Daniel.Naber; &Daniel.Naber.mail; </author
></authorgroup>
</sect1info>

<title
>&XML; Valido</title>

<para
>Ĉi tiu kromaĵo kontrolas &XML; dosieroj por valideco kaj esti bone formitaj.</para>
<para
>Ĉi tiu kromaĵo kontrolas la nunan dosieron. Listo de avertoj kaj eraroj aperos malsupre de la ĉefa fenestro de &kate;. Vi povas alklaki erarmesaĝon por salti al la responda loko en la dosiero. Se la dosiero havas <quote
>DOCTYPE</quote
> la DTD donita kun ĉi tiu doktipo estos uzata por kontroli la dosieron pri valideco. La DTD estas atendita je pozicio relative al la aktuala dosiero, &eg; se la doktipo rilatas al <quote
>DTD/xhtml1-transitional.dtd</quote
> kaj la dosiero estas <filename
>/home/peter/test.xml</filename
> la DTD estas atendita troviĝi ĉe <filename
>/ home/peter/DTD/xhtml1-transitional.dtd</filename
>. Tamen, foraj DTD-oj specifitaj per http estas subtenataj.</para>

<para
>Se la dosiero ne havas doktipon, ĝi estos kontrolita por esti bone formita.</para>

<para
>Por lerni pli pri &XML; konsultu la <ulink url="https://www.w3.org/XML/"
> oficialajn W3C &XML;-paĝojn</ulink
>.</para>

<para
>Interne ĉi tiu kromaĵo nomas la eksteran komandon <command
>xmllint</command
>, kiu estas parto de libxml2. Se ĉi tiu komando ne estas ĝuste instalita en via sistemo, la kromaĵo ne funkcios.</para>

<para
>Por ŝargi ĉi tiun kromprogramon malfermu la agordan dialogon de &kate; sub <menuchoice
><guimenu
>Agordoj</guimenu
> <guimenuitem
>Agordu &kate;...</guimenuitem
></menuchoice
>. Tiam elektu <guilabel
>&XML; Valido</guilabel
> kiu aperos en la sekcio <guilabel
>Apliko</guilabel
> / <guilabel
>Kromaĵoj</guilabel
> kaj fermu la dialogon. </para>

<sect2 id="xmlcheck-menu">
<title
>Strukturo de menuo</title>

<variablelist>
<varlistentry>
<term>
<menuchoice
><guimenu
>&XML;</guimenu
> <guimenuitem
>Valigi &XML;</guimenuitem
> </menuchoice>
</term>
<listitem
><para
>Ĉi tio komencos la kontrolon, kiel priskribite supre.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmlcheck-thanks-and-acknowledgements">
<title
>Dankon kaj Dankon</title>
<para
>&kate; Kromaĵo <quote
>&XML; Valido</quote
> kopirajto 2002 &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para
>Dokumenta kopirajto 2002 &Daniel.Naber;</para>

</sect2>
</sect1>

<sect1 id="kate-application-plugin-xmltools">
<!-- from doc/kate-addons/xmlcheck.docbook -->
<sect1info>
<authorgroup
><author
>&Daniel.Naber; &Daniel.Naber.mail; </author
></authorgroup>
</sect1info>
<title
>&XML; Kompletigo</title>

<para
>Ĉi tiu kromaĵo donas helpetojn pri tio, kio estas permesita ĉe certa pozicio en &XML; dosiero, laŭ la DTD de la dosiero. Ĝi listigos eblajn elementojn, atributojn, atributajn valorojn aŭ entojn, depende de la pozicio de la kursoro (&eg; ĉiuj entoj estas listigitaj se la signo maldekstre de la kursoro estas <quote
>&amp;</quote
>). Ankaŭ eblas fermi la plej proksiman malfermitan etikedon maldekstre.</para>

<para
>La <acronym
>DTD</acronym
> devas ekzisti en &XML; formato, kiel produktata de la Perl-programo <command
>dtdparse</command
>. Ni nomos DTD en ĉi tiu formato <quote
>meta DTD</quote
>. Kelkaj meta DTD-oj estas liveritaj. Ili estas instalitaj en <filename class="directory"
>katexmltools/</filename
> en <userinput
><command
>qtpaths</command
> <option
>--paths GenericDataLocation </option
></userinput
>, kio estas ankaŭ la defaŭlta dosierujo kiam vi elektas <guimenuitem
>Asigni Meta DTD...</guimenuitem
>. Por produkti viajn proprajn meta DTD-ojn, akiru <command
>dtdparse</command
> de <ulink url="http://dtdparse.sourceforge.net"
>http://dtdparse.sourceforge.net</ulink
>.</para>

<sect2 id="xmltools-how-to-use">
<title
>Kiel Uzi</title>

<para
>Komencu &kate; kaj malfermu la agordan dialogon sub <menuchoice
><guimenu
>Agordoj</guimenu
> <guimenuitem
>Agordu &kate;...</guimenuitem
></menuchoice
>. Tiam elektu <guilabel
>&XML; Kompletigo</guilabel
> kiu aperos en la paĝo <menuchoice
><guimenu
>Apliko</guimenu
> <guimenuitem
>Kromaĵoj</guimenuitem
></menuchoice
> kaj fermu la dialogon. Post tio, elektu <menuchoice
><guimenu
>&XML;</guimenu
><guimenuitem
>Asigni Meta DTD...</guimenuitem
></menuchoice
>. Se via dokumento enhavas neniun <quote
>DOCTYPE</quote
> aŭ la doktipo estas nekonata, vi devos elekti meta DTD el la dosiersistemo. Alie la meta DTD kiu kongruas kun la DOCTYPE de la aktuala dokumento estos ŝargita aŭtomate.</para>

<para
>Vi nun povas uzi la kromprogramon dum tajpas vian tekston:</para>

<variablelist>

<varlistentry>
<term
><keycap
>&lt;</keycap
> (malpli-ol klavo)</term>
<listitem
><para
>Ĉi tio ekigos liston de eblaj elementoj krom se la kursoro jam estas ene de etikedo. Notu, ke vi nuntempe ne povas uzi ĉi tion por enmeti la supran nivelan elementon (&eg; <quote
>&lt;html&gt;</quote
>).</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&lt;</keycap
><keycap
>/</keycap
>(malpli-ol klavo + oblikvo)</term>
<listitem
><para
>Enigi ĉi tiujn signojn proponos fermi la nunan elementon (plej proksima malfermita maldekstre de la kursoro). Premu &Enter; akcepti la sugeston. Male al la menuero <guimenuitem
>Fermi Elemento</guimenuitem
>, ĉi tio funkcias nur kun DTD asignita.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>"</keycap
> (cita klavo)</term>
<listitem
><para
>La citoklavo ekigos liston de eblaj atributvaloroj (se ekzistas) se vi estas ene de etikedo.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&nbsp;</keycap
> (spacetoklavo)</term>
<listitem
><para
>Ĉi tiu klavo ekigos liston de eblaj atributoj por la nuna elemento se vi estas ene de etikedo.</para>
</listitem>
</varlistentry>

<varlistentry>
<term
><keycap
>&amp;</keycap
> (perluet-klavo)</term>
<listitem
><para
>Ĉi tiu klavo ekigos liston de nomitaj entoj.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmltools-features-and-limitations">
<title
>Kapabloj kaj Limigoj</title>

<para
>Vi povas testi ĉiujn funkciojn kaj limigojn ŝargante <filename
>katexmltools/testcases.xml</filename
> en <userinput
><command
>qtpaths</command
> <option
>--paths GenericDataLocation </option
></userinput
> en &kate; kaj sekvante la instrukciojn.</para>

</sect2>


<sect2 id="xmltools-menu">
<title
>Strukturo de menuo</title>

<variablelist id="xml-insert-element">
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;&Enter;</keycombo
> </shortcut
> <guimenu
>&XML;</guimenu
> <guimenuitem
>Enmeti Elementon...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Ĉi tio malfermos dialogon, kiu ebligas al vi enigi &XML; elemento. La &lt;, &gt;-signoj kaj la ferma etikedo estos enmetitaj aŭtomate. Se vi elektis tekston kiam ĉi tiu menuero estas elektita, la elektita teksto estos ĉirkaŭita de la malferma kaj ferma etikedo. La dialogo ankaŭ ofertas kompletigon de ĉiuj elementoj, kiuj povas esti enmetitaj ĉe la nuna kursora pozicio, se vi asignis metan DTD uzante <guimenuitem
>Asigni Meta-DTD...</guimenuitem
>. </para
></listitem>
</varlistentry>

<varlistentry id="xml-close-element">
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>&lt;</keycap
></keycombo
> </shortcut
> <guimenu
>&XML;</guimenu
> <guimenuitem
>Fermi Elementon</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Ĉi tio serĉos vian tekston por etikedo kiu ankoraŭ ne estas fermita kaj fermos ĝin per enmeto de la responda fermetikedo. La serĉo komenciĝas ĉe la pozicio de la kursoro kaj iras maldekstren. Se ĝi ne povas trovi malfermitan etikedon, nenio okazos.</para
></listitem>
</varlistentry>

<varlistentry id="xml-assign-metadtd">
<term
><menuchoice
><guimenu
>&XML;</guimenu
> <guimenuitem
>Asigni Meta DTD...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Ĉi tio instruos al la kromprogramo kiun meta-DTD uzi por la aktuala dokumento. Notu, ke ĉi tiu atribuo ne estos konservita. Vi devos ripeti ĝin kiam vi komencos &kate; la venontan fojon.</para
></listitem>
</varlistentry>
</variablelist>

</sect2>

<sect2 id="xmltools-thanks-and-acknowledgements">
<title
>Dankon kaj Dankon</title>
<para
>&kate; Kromaĵo <quote
>&XML; Kompletigo</quote
> kopirajto 2001,2002 &Daniel.Naber; &Daniel.Naber.mail;. </para>
<para
>&kde; SC-4 versio kopirajto 2010 Tomáš Trnka</para>
<para
>Dokumenta kopirajto 2001,2002 &Daniel.Naber;</para>
</sect2>
</sect1>

</chapter>
