# Laborante kun Kromaĵoj

Vi povas ebligi la individuajn kromaĵojn en la agorda dialogo, kiu ankaŭ disponigas aliron al pliaj agordaj opcioj por kromaĵoj kiuj postulas ĝin.

## &kate; Aplikaj Kromaĵoj

&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 Agordoj Agordu &kate;... Elektu Aplikon Aldonaĵoj por elekti la deziratajn kromaĵojn.

La disponeblaj aplikaĵaldonaĵoj estas:

- Eksteraj Iloj - Ruli eksterajn ilojn kaj aplikaĵojn

- Retumilo por malantaŭa spuro - C/C++ Retrovoja naviga ilo-vido

- Konstrui kromprogramon - Kompili aŭ 'Make' kaj analizi erarmesaĝojn

- Fermi Krom/Ŝati - Fermi grupon de dokumentoj bazitaj sur ofta vojo aŭ dosiera etendo

- Kolorelektanto - Montri antaŭrigardon por konataj kolornomoj

- Kolorigitaj krampoj - Koloraj krampoj por legi

- CTags - Serĉi difinojn/deklarojn per CTags

- Antaŭrigardo de dokumentoj - Antaŭrigardi la dokumenton en la celformato.

- Dokumentŝanĝilo - Rapida ŝanĝado de dokumentoj kun &Alt; konduto

- Dosiersistem-Retumilo - Dosiera retumila ilo-vido

- Dokumenta Arbo-Vido - Montras la malfermitajn dosierojn en dosierarbo

- &gdb; - Provizas simplan &gdb; fasado

- Projekta Kromaĵo - Integriĝo kun &git; kaj aliaj fontversiigsistemoj

- Replicode - Konstruktivisma AI-lingvo kaj rultempo

- LSP-kliento - LSP-kliento provizanta kodnavigadon kaj kodkompletigon por multaj lingvoj

- Serĉi & Anstataŭigi - Serĉi kaj anstataŭigi en dokumentoj, dosierujoj aŭ projektoj

- Vido de fragmentoj ilo - Vido de ilo enkonstruanta la administradon de fragmentoj

- Klavaraj makrooj - Registri kaj ludi klavarajn makroojn (t.e. klavarajn agsekvencojn)

- SQL-aldonaĵo - Efektivigi demandon al SQL-datumbazoj

- Simbol-Vidilo - Ekstrakti kaj montri referencajn simbolojn el la fonto

- Vido de terminalilo - Havu terminalon preta, uzante la fenestraĵon &konsole; de &kde;

- Teksto-Filtrilo - Prilabori tekston per finaj komandoj

- &XML;-Kompletigo - Listigas &XML; elementojn, atributojn, atributajn valorojn kaj entojn permesitajn de DTD

- &XML; Validumado- Validigas &XML; dosieroj uzante xmllint

## Eksteraj Iloj

La kromaĵo Eksteraj Iloj 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 Eksteraj Iloj de la menuo Iloj de la aplikaĵo.

La agorda paĝo permesas aldoni novajn eksterajn ilojn alklakante la butonon Aldoni. 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 Redakti..., kaj Forigi forigas la elektitajn ilojn.

### Agordo de Eksteraj Iloj

Redakti ilon malfermas agordan dialogon kiu permesas fajnan agordon de la ilo:

Kiel videblas, multaj detaloj povas esti difinitaj, nome:

- `Nomo`, la nomo de la ilo, kiu poste aperos en la menuo.

  `Piktogramo`, laŭvola piktogramo kiu estas videbla en la menuo.

  `Efektivebla`, efektivigebla inkluzivanta aŭ plenan vojon, aŭ via ruleblaĵo devas esti en la mediovariablo `PATH`.

  `Argumentoj`, laŭvolaj argumentoj, kiuj estas transdonitaj al la rulebla.

  `Enigo`, laŭvola enigo kiu estas transdonita al la procezo per stdin.

  `Labora dosierujo`, la labordosierujo en kiu la ilo estos komencita. Se malplena, la labordosierujo estas agordita al la vojo de la aktuala dokumento.

  `Mimspecoj`, se agordita, la ilo estas aktiva nur se la mime-speco de la aktuala dokumento kongruas.

  `Konservi`, kiam oni alvokas, konservas neniun, la aktualan dokumenton, aŭ ĉiujn dokumentojn.

  `Trigger`, 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.

  Jen disponeblaj ekigiloj:

- `Neniu`, ĉi tio estas la defaŭlta, tio signifas, ke la ilo ne havas ekigilon.

  `Antaŭ Konservi`, ĉi tiu ekigilo efektiviĝos ĝuste antaŭ konservi la dokumenton.

  `Post Konservi`, ĉi tiu ekigilo rulos la ilon post kiam la dokumento estis konservita.

`Reŝargi aktualan dokumenton post rulo`, utila kiam la aktuala dosiero estas modifita sur disko.

`Eligo`, la eligo difinas la celon de stdout. Ĝi estas aŭ agordita al `Ignorita`, `Enmeti ĉe Kursora pozicio`, `Anstataŭigi Elektitan Tekston`, `Anstataŭigi Aktualan Dokumenton`, `Aldoni al Aktuala Dokumento`, `Enmeti en Novan Dokumenton`, `Kopii al Tondujo`, aŭ `Montri en Paneo`.

`Komando de Redaktoro`, laŭvola komando kiu povas esti uzata por alvoki la eksteran ilon per la enkonstruita komandlinio.

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

### Variebla Vastiĝo

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

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

Ĉi tiu funkcio provizas multe da fleksebleco dum difinado de ekstera ilo ĉar ĉiuj variabloj de la formo `%{...}` estas vastigitaj kiam la ilo estas alvokita. Estas du specoj de variabloj subtenataj:

- `%{variable-name}`

- `%{variable-name:<value>}`

La unua formo `%{variable-name}` simple anstataŭigas la variablon per ĝia enhavo. Ekzemple, la variablo `%{Document:FileName}` estas anstataŭigita per la dosiernomo de la nuna dokumento sen ĝia vojo. La dua formo `%{variable-name:<value>}` ricevas la `<value>` kiel enhavon. Ekzemple, ĉi tio povas esti uzata por vastigi mediovariablon kun `%{ENV:HOME}`, aŭ oni povas akiri la aktualan daton en la preferata formato kiel `%{Date:yyyy-MM-dd}`.

Subtenataj variabloj inkluzivas:

- `Dokumento:FileBaseName`: Dosierbaza nomo sen vojo kaj sufikso de la aktuala dokumento.

  `Dokumento:FileExtension`: Dosiera etendo de la aktuala dokumento.

  `Dokumento:FileName`: Dosiernomo sen vojo de la aktuala dokumento.

  `Dokumento:Dosiero-vojo`: Plena vojo de la aktuala dokumento inkluzive de la dosiernomo

  `Dokumento:Teksto`: Enhavo de la nuna dokumento.

  `Dokument:Path`: Plena vojo de la aktuala dokumento ekskludante la dosiernomon.

  `Dokumento:NativeFilePath`: Plena dokumentvojo inkluzive de dosiernomo, kun denaska vojo apartigilo (deklivsigno ĉe Vindozo).

  `Dokumento:NativePath`: Plena dokumentvojo ekskluzive de dosiernomo, kun denaska vojo apartigilo (deklivsigno ĉe Vindozo).

  `Dokumento:Cursor:Line`: Linia numero de la teksta kursoropozicio en aktuala dokumento (komencas per 0).

  `Document:Cursor:Column`: Kolumna numero de la teksta kursoropozicio en aktuala dokumento (komencas per 0).

  `Document:Cursor:XPos`: X-komponento en ĉieaj ekrankoordinatoj de la kursora pozicio.

  `Document:Cursor:YPos`: Y-komponento en ĉieaj ekrankoordinatoj de la kursora pozicio.

  `Dokumento:Selection:Text`: Teksta elekto de la aktuala dokumento.

  `Dokumento:Selection:StartLine`: Komenca linio de elektita teksto de la aktuala dokumento.

  `Dokumento:Selection:StartColumn`: Komencu kolumnon de elektita teksto de la aktuala dokumento.

  `Dokumento:Selection:EndLine`: Finlinio de elektita teksto de la aktuala dokumento.

  `Dokumento:Selection:EndColumn`: Finkolumno de elektita teksto de la aktuala dokumento.

  `Dokumento:RowCount`: Nombro de vicoj de la aktuala dokumento.

  `Dokumento:Variable:<variable>`: Plivastigi arbitrajn dokumentvariablojn.

  `Dato:Locale`: La aktuala dato en aktuala loka formato.

  `Dato:ISO`: La aktuala dato (ISO).

  `Dato:<value>`: La aktuala dato (QDate formatstring).

  `Time:Locale`: La nuna horo en aktuala loka formato.

  `Tempo:ISO`: La nuna horo (ISO).

  `Tempo:<value>`: La nuna horo (QTime formatstring).

  `ENV:<value>`: Aliro al mediovariabloj.

  `JS:<expression>`: Taksi simplajn JavaScript-deklarojn.

  `ProcentEncoded:<text>`: Procento kodita teksto.

  `UUID`: Generi novan UUID.

### Listo de Defaŭltaj Iloj

Pluraj iloj estas senditaj defaŭlte. Tamen, se vi havas pli utilajn ilojn bonvolu kontribui tiujn al kwrite-devel@kde.org 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 Aldoni en la agorda paĝo kiel priskribite supre.

### git-cola

git-cola estas grafika git-kliento, kiu ebligas vin facile enscenigi kaj fari ŝanĝojn. Se instalite, ĝi haveblas ankaŭ per la komandlinio tajpante `git-cola`

- `Nomo`: git-cola

  `Piktogramo`: git-cola

  `Efektivigebla`: git-cola

  `Argumentoj`: -r %{Document:Path}

  `Komando de redaktilo`: git-cola

### gitk

gitk estas ankaŭ git-kliento, kiu permesas bele bildigi la git-historion.

- `Nomo`: gitk

  `Piktogramo`: git-gui

  `Efektivigebla`: gitk

  `Laboranta dosierujo`: %{Document:Path}

  `Komando de redaktilo`: gitk

### git blame

Komencas git blame por facile sekvi git-ŝanĝojn en la nuna dosiero.

- `Nomo`: git blame

  `Efektivigebla`: git

  `Argumentoj`: gui blame %{Document:FileName}

  `Konservi`: Aktuala Dokumento

  `Laboranta dosierujo`: %{Document:Path}

  `Komando de redaktilo`: git-blame

### Lanĉi Ŝelskripton

Lanĉas eksteran konzolon en kiu la aktuala dokumento estas rulita. La skripto bezonas indiki la interpretiston en la unua linio per shebang `#!/path/interpreter`.

- `Nomo`: Lanĉi Ŝelskripton

  `Piktogramo`: sistemfunkciado

  `Efektivigebla`: konsole

  `Argumentoj`: -e sh -c "cd %{Document:Path} && pwd && chmod -vc a+x %{Document:FileName} && ./%{Document:FileName} ; echo Premu iun ajn klavon por daŭrigi. && read -n 1"

  `Konservi`: Aktuala Dokumento

  `Laboranta dosierujo`: %{Document:Path}

  `Komando de redaktilo`: rul-skripto

### Guglo Elektita Teksto

Serĉi en guglo la elektitan tekston.

- `Nomo`: Guglo Elektita Teksto

  `Piktogramo`: globo

  `Efektivigebla`: xdg-open

  `Argumentoj`: "https://www.google.com/search?q=%{Document:Selection:Text}"

  `Komando de redaktilo`: guglo

### Enigi UUID

Enmetas novan UUID ĉiufoje kiam ĉi tiu ago estas alvokita.

- `Nomo`: Enigi UUID

  `Efektivigebla`: eĥo

  `Argumentoj`: %{UUID}

  `Eligo`: Enigi ĉe Kursora pozicio

  `Komando de redaktilo`: uuid

### Clang Format Plena Dosiero

Rulas clang-format sur la aktuala dosiero sur disko. La dokumento estas reŝargita poste.

- `Nomo`: Clang Format Plena Dosiero

  `Efektivigebla`: clang-format

  `Argumentoj`: -i %{Document:FileName}

  `Laboranta dosierujo`: %{Document:Path}

  `Konservi`: Aktuala Dokumento

  `Reŝargi`: Jes

  `Komando de redaktilo`: clang-format-file

### Clang-Formati Elektita Teksto

Rulas clang-format nur sur la elektita teksto en la nuna dokumento.

- `Nomo`: Clang-Formati Elektitan Tekston

  `Efektivigebla`: clang-format

  `Argumentoj`: -assume-fileName: %{Document:FileName}

  `Laboranta dosierujo`: %{Document:Path}

  `Enigo`: %{Document:Selection:Text}

  `Eligo`: Anstataŭigi Elektitan Tekston

  `Komando de redaktilo`: clang-format-selection

### Antaŭrigardo de Qt Rapida 2 (qmlscene)

Antaŭrigardas la aktualan qml-dosieron en qmlscene.

- `Nomo`: Antaŭrigardo de Qt Quick 2 (qmlscene)

  `Efektivigebla`: qmlscene

  `Argumentoj`: %{Document:FileName}

  `Konservi`: Aktuala Dokumento

  `Laboranta dosierujo`: %{Document:Path}

  `Komando de redaktilo`: qml-antaŭrigardo

### JSON Formato Plena Dosiero

Formatu la tutan JSON-dosieron.

- `Nomo`: JSON Formato Plena Dosiero

  `Piktogramo`: application-json

  `Efektivigebla`: jq

  `Argumentoj`: %{Document:FileName}

  `Konservi`: Aktuala Dokumento

  `Laboranta dosierujo`: %{Document:Path}

  `Eligo`: Anstataŭigi Aktualan Dokumenton

  `Komando de redaktilo`: json-format-file

### XML Format Plena Dosiero

Formatu la tutan XML-dosieron.

- `Nomo`: JSON Formato Plena Dosiero

  `Piktogramo`: application-xml

  `Efektivigebla`: xmllint

  `Argumentoj`: --format %{Document:FileName}

  `Konservi`: Aktuala Dokumento

  `Laboranta dosierujo`: %{Document:Path}

  `Eligo`: Anstataŭigi Aktualan Dokumenton

  `Komando de redaktilo`: xml-format-file

## Backtrace Foliumilo Kromaĵo

### Uzante la Backtrace-Retumila Kromaĵo

Ĉ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 `/home/dummy/qt-copy/…/qwidget.cpp` ankoraŭ troviĝas en aliaj maŝinoj. Por ke tio funkciu, vi devas indeksi la dosierujojn, kie troviĝas la fontkodo.

Kelkfoje estas pluraj dosieroj kun la sama nomo, ⪚

- `kdegraphics/okular/generators/dvi/config.h`
- `kdepim-runtime/resources/gmail/saslplugin/config.h`

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

- `dvi/config.h`
- `saslplugin/config.h`

Kaj tiam kutime la kromaĵo trovas la ĝustan.

Indeksado de majstro kaj branĉoj kompreneble kondukos al kolizio.

### Agordo

Sur la agorda paĝo aldonu la dosierujojn enhavantajn la fontkodon.

Backtrace Foliumilo
Agordi Vojojn en Backtrace-retumila ilvido

Klakante OK komencos indeksadon. Kiam la indeksado estas finita, malfermu la ilaron Foliumilo de retrospuro.

Nun vi povas ŝargi retrospuron el la tondujo (⪚, kiam vi klakis Kopii al Clipboard en &drkonqi;) aŭ el dosiero.

## Konstrui Kromprogramon

### Enkonduko

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

### Uzado de la Konstru-Kromprogramon

La Konstrua kromaĵo aldonas Konstrui Eligo ilan vidon malsupre kaj Konstrui 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.

Konstrua Eligo

La Konstrua Eligo ila vido havas du langetojn:

- Celaj Agordoj

- Eligo

#### Langeto de Celaj Agordoj

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

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.

Nova celaro enhavas plurajn agordajn opciojn:

Labora Adresaro

- 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.

Konstrui

- Ĉi tiu opcio permesas difini la konstruan komandon. Ĝi estas agordita al `make` defaŭlte.

Pura

- La opcio permesas difini la puran komandon. Ĝi estas agordita al `make clean` defaŭlte.

Agordo

- Ĉi tiu opcio ebligas al vi difini la agordan komandon. Ĝi estas agordita al `cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr/local ../` defaŭlte.

Supre ĉi tiu kromaĵo havas ilobreton kun la sekvaj butonoj:

- Konstruu la elektitan celon
- Aldoni novan konstrucelon
- Krei novan konstrucelon aro
- Kopiu komandon aŭ celon aro
- Forigu la aktualan komandon aŭ celo fiksita

#### Eligo langeto

La langeto Eligo montras la konzolan eliron generitan de la lasta komando.

Uzi la glitilon supre por montri aŭ kaŝi kategoriojn de eligo:

Plena Eligo, Analiza eligo, Eraroj kaj Avertoj aŭ Nur Eraroj

Ĉ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.

Por navigi al la antaŭa eraro, premu &Alt;&Shift;&Left;. Por navigi al la sekva eraro, premu &Alt;&Shift;&Right;.

### Strukturo de menuo

Konstrui Elekti Celon

- Elektu el listo de celoj agordita de la uzanto.

Konstrui Konstrui defaŭltan celon

- Konstruas la celon difinitan kiel defaŭltan en la aktiva celaro.

Konstrui Konstrui Antaŭan Celon

- Ŝanĝu al la antaŭa celo agordita de la uzanto.

Konstrui Halti

- Ĉesi konstrui celon.

&Ctrl;&Alt;&Left; Konstrui Antaŭa Eraro

- Movas la kursoron al la loko de la antaŭa eraro en la dokumento.

&Ctrl;&Alt;&Right; Konstrui Sekva Eraro

- Movas la kursoron al la loko de la sekva eraro en la dokumento.

### Dankon kaj Dankon

La &kate; Build Plugin estis verkita de Kåre Särs.

Specialan dankon al la partoprenanto de Google Code-In 2011 Salma Sultana pro verkado de granda parto de ĉi tiu sekcio.

## Fermi Krom/Kiel Kromaĵo

### Enkonduko

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

### Uzante la Fermi Krom/Kiel Kromprogramon

Supozeble, ke vi havas ĉi tiujn dokumentojn malfermitaj en &kate;:

- /tmp/subdosierujo/test.h
- /tmp/test.cpp
- /tmp/test.txt

Tiam vi havas la jenajn eblojn por fermi dokumentojn kiel montrite en la ekrankopio:

Fermi Krom

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.

### Strukturo de menuo

Dosiero Fermi Krom

- Fermi ĉiujn malfermitajn dokumentojn, krom tiuj, kiuj kongruas kun la vojo aŭ dosier-endaĵo elektita el la submenuo.

Dosiero Fermi Ŝati

- Fermi ĉiujn malfermitajn dokumentojn, kiuj kongruas kun la vojo aŭ dosiera etendo elektita el la submenuo.

## Koloro Picker Kromaĵo

### Enkonduko

Ĉi tiu kromaĵo aldonas enlinian koloran antaŭrigardon/elekton al koloroj en la teksto (⪚, `#FFFFFF`, `blanka`).

Por ŝargi ĉi tiun kromprogramon malfermu la agordan dialogon de &kate; sub Agordoj Agordi &kate;.... Poste elektu Kolorelektilo kaj fermu la dialogon.

### Agordo

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

Montri antaŭrigardon por konataj kolornomoj

- Ĉu montri la kolor-elekton por konataj kolornomoj (⪚, `ĉielbluo`). Vidu ĉi tiun paĝon por la listo de koloroj.

Meti antaŭrigardon post tekstokoloro

- Ĉu meti la enlinian antaŭrigardon post tekstokoloro en la tekston.

Hekskolora kongruo

- Ĉi tie, vi povas elekti la plej bonan kongruan opcion por la koloroj uzataj en via kodo.

## Koloraj krampoj

### Enkonduko

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.

### Agordo

La kromaĵo ne provizas iujn ajn agordojn.

## CTags Kromaĵo

### Enkonduko

CTags 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;.

Etikedo signifas lingvobjekton por kiu indeksa enskribo estas disponebla (aŭ, alternative, la indeksa enskribo kreita por tiu objekto).

Etikedgenerado estas subtenata por ĉi tiuj programlingvoj.

### Agordo

La kromaĵo CTags uzas du malsamajn datumbazdosierojn por la indekso.

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.

#### Komuna Indekso

Agordoj de CTags
Agordi CTags Global Database

Ĉe la malsupro de la agorda paĝo vi povas adapti la Komando CTags.

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; man:/ctags rekte en &konqueror;

Klako Ĝisdatigi komencos indeksadon. Kiam indeksado estas finita, fermu la dialogon.

#### Seanca Indekso

Por agordi la seanindekson malfermu la CTags vido.

Indeksaj Celoj

- Sur ĉi tiu langeto vi povas aldoni aŭ forigi dosierujojn enhavantajn la fontkodon kaj permane regeneri la sean-specifan CTags-datumbazon.

Datumbazo

- Agordoj de datumbazoj
  Agordi CTags-Seanco-Datumbazon

  Elektu alian datumbazan dosieron de CTags, agordu la komandon CTags aŭ revenu al la defaŭlta komando.

### Uzante la kromprogramon CTags

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 CTags por salti al la linio kaj dosiero kie la objekto estas difinita aŭ deklarita.

Defaŭlte la agoj en la menuo CTags havas neniujn ŝparvojojn asignitaj. Uzu la klavaran ŝparvojojn por agordi viajn proprajn ŝparvojojn.

Alternative uzu la serĉkampon en la langeto Serĉo de la CTags-vido.

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.

Elektu eron en la listo por salti al la responda linio en la fontdosiero.

### Strukturo de menuo

CTags Resalti unu paŝon

- Reiru en la historio al la lasta vizitita etikedo.

CTags Serĉi Aktualan Tekston

- Malfermas la langeton Serĉo de la vido de CTags kaj montras ĉiujn lingvobjektojn kongruajn kun la nuna tekstoelekto en la listo.

CTags Iri al Deklaro

- 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.

CTags Iri al Difino

- 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.

## Dokumenta Antaŭrigardo Kromaĵo

### Enkonduko

La kromaĵo ebligas vivan antaŭrigardon de la nuntempe redaktita tekstdokumento en la fina formato en la flanka kolumno. Do dum redaktado de ⪚ a &Markdown; teksto aŭ &SVG; bildo, la rezulto estas tuj videbla apud la fontteksto.

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.

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

### Iuj disponeblaj &kparts; kromaĵojn

&MIME;-tipo | &kparts; konekti
&Markdown; teksto | KMarkdownWebViewPart aŭ OkularPart
&SVG; bildo | SVGPart
&Qt; UI-dosieroj | KUIViewerPart
&DOT; grafikaj dosieroj | KGraphviewerPart

### Strukturo de menuo

Vido Vidoj de iloj Montri Antaŭrigardon

- Ŝaltu la montradon de la Dokumenta antaŭrigardo de &kate; en flankbreto.

### Interfaco

La butonoj ĉe la supro de la antaŭrigarda fenestro provizas ĉi tiujn agojn:

- 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.

- Ebligu aŭ malŝalti ĝisdatigojn de la antaŭrigardo de la aktuala dokumentenhavo

- Mane ĝisdatigi la antaŭrigardon de la aktuala dokumentenhavo

- Falmenuo kun agoj de la &kparts; konekti

## Document Switcher Kromaĵo

### Strukturo de menuo

&Ctrl; Vido Laste Uzataj Vidoj

&Ctrl;&Shift; Vido Laste Uzitaj Vidoj (Inversa)

- Malfermas liston kun la lastaj viditaj dokumentoj:

  Laste viditaj dokumentoj

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

  Tenu la ŝparvojon &Ctrl; 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.

## Dosiersistema Retumilo

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

### Strukturo de menuo

Vidi Ilaj Vidoj Montri Dosiersistem-Retumilon

- Ŝalti la montradon de la Dosiersistem-Retumilo de &kate;.

### Interfaco

De supre malsupren, la Dosiersistem-Retumilo konsistas el la sekvaj elementoj:

Ilobreto

- Ĉi tio enhavas normajn navigaciajn ilbutonojn:

  Reen

- Kaŭzas la dosierujon al `cd` al la antaŭe montrita dosierujo en la historio. Ĉi tiu butono estas malŝaltita, se ne ekzistas antaŭa elemento.

Antaŭen

- Kaŭzas la dosierujon al `cd` al la sekva dosierujo en la historio. Ĉi tiu butono estas malŝaltita, se ne ekzistas sekva dosierujo.

Legosignoj

- Malfermas submenuon por redakti aŭ aldoni legosignojn kaj aldoni novan legosigndosierujon.

Aktuala Dokumenta Dosierujo

- Ĉi tiu butono igos la dosierujon al `cd` 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.

Opcioj

- Mallonga Vido

- Montras nur la dosiernomojn.

Detala Vido

- Montras Nomon, Daton kaj Grandecon de la dosieroj.

Arba Vido

- Kiel Mallonga Vido, sed dosierujoj povas esti vastigitaj por vidi ilian enhavon.

Detala Arba Vido

- Ĉi tio ankaŭ permesas pligrandigi dosierujojn, sed montras la kromajn kolumnojn disponeblajn en Detala Vido.

Montri Kaŝitajn dosierojn

- Montras dosierojn kutime kaŝitajn de via &OS;.

Aŭtomate sinkronigi kun aktuala dokumento

- Kiam ĉi tiu opcio estas ebligita, la dosiersistemo retumilo aŭtomate `cd` al la dosierujo de la dokumento nuntempe malfermita en la redakta areo ĉiufoje kiam ĝi ŝanĝiĝas.

Loka Eniro

- Ĉ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.

  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.

  La &URL; eniro havas dosierujon aŭtomaten. La kompletiga metodo povas esti agordita uzante la &RMB; menuo de la teksta enigo.

Vido de Dosierujo

- Ĉi tio estas norma &kde; dosierujo vido.

Filtrila Eniro

- 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: `*.cpp *.h *.moc`

  Por montri ĉiujn dosierojn, enigu unu solan asteriskon `*`.

  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 Forpurigi tekston maldekstre de la aŭtokompleta sagobutono.

### Agordo

Ĉi tiu kromaĵo povas esti agordita sur la paĝo Dosiersistemo-Retumilo de la agordo de &kate;.

Ilobreto

- Agordu la butonojn sur la ilobreto de Dosiersistemo Foliumilo movante tiujn, kiujn vi volas ebligitaj al la listo Elektitaj Agoj, kaj ordigu ilin per la sagobutonoj ĉe la flanko de la listo.

## La Listo de Dokumentoj

### Enkonduko

La listo de dokumentoj montras liston de ĉiuj dokumentoj nuntempe malfermitaj en &kate;. Modifitaj dosieroj havos malgrandan disketon maldekstre por indiki tiun staton.

Supre la Listo de Dokumentoj havas ilobreton kun la sekvaj butonoj:

- Krei novan dokumenton
- Malfermi ekzistantan dokumenton
- Antaŭa Dokumento
- Sekva Dokumento
- Konservi la aktualan dokumenton
- Konservi la aktualan dokumenton sub nova nomo

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

Se du aŭ pli da dosieroj kun la sama nomo (troviĝantaj en malsamaj dosierujoj) estas malfermitaj en Lista Reĝimo, la nomoj de la dua estos antaŭmetitaj (2) ktp. La ilo-konsileto por la dosiero montros sian plenan nomon inkluzive de la vojo, permesante al vi elekti la deziratan.

Por montri dokumenton en la aktuale aktiva kadro, alklaku la dokumentnomon en la listo.

La kunteksta menuo havas kelkajn komunajn agojn el la menuo Dosiero.

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

Vi povas ordigi la liston en kelkaj malsamaj manieroj dekstre alklakante la liston kaj elektante el la menuo Ordigi Laŭ. La opcioj estas:

Dokumenta Nomo

- Listigas la dokumentojn alfabete laŭ ilia nomo.

Dokumenta Vojo

- Listigas la dokumentojn alfabete laŭ la vojo al ili.

Malferma Ordo

- Listigas la dokumentojn en la ordo de malfermo.

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 Dokumentoj de la agorda dialogo.

La defaŭlta loko de la dokumenta listo en la &kate; fenestro estas maldekstre de la redakta areo.

### Strukturo de menuo

&Alt;&Up; Vido Antaŭa Dokumento

- Malfermas la dokumenton montritan super la nuntempe malfermita dokumento en la Listo de Dokumentoj.

&Alt;&Down; Vido Sekva Dokumento

- Malfermas la dokumenton montritan sub la nuntempe malfermita dokumento en la Listo de Dokumentoj.

Vido Montri Aktivan

- Montras la nuntempe malfermitan dokumenton en la Listo de Dokumentoj.

### Agordo

Fona Ombrigo

- Ĉ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.

Ordigi laŭ

- Agordu kiel vi volas ordigi la dokumentan liston. Ĉi tio povas esti agordita de la &RMB; menuo en la dokumenta listo ankaŭ.

Vida Reĝimo

- Ĉi tio disponigas du opciojn kiuj efikas la montradon de la Dokumenta ilo-vido. La opcio Arba Vido montros la dokumentojn en arbo sub la dosierujoj en kiuj ili estas, dum la opcio Listo-Vido montros ebenan liston de dokumentoj.

Montri Plenan Vojon

- 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.

Montri Ilobreton

- Kiam Arba Vido kaj ĉi tiu opcio estas ebligitaj, ilobreto kun agoj kiel Konservi montriĝas super la listo de dokumentoj. Malmarku ĉi tiun opcion se la ilobreto devus esti kaŝita.

Montri Fermi Butonon

- Kiam ĉi tiu opcio estas ebligita, &kate; montros fermbutonon por malfermitaj dokumentoj dum ŝvebado.

## &gdb; Konekti

### Enkonduko

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

Antaŭa sperto kun &gdb; estas forte rekomendinda. Por pliaj informoj pri uzado de &gdb;, vizitu la &gdb; retejo.

Vi povas ebligi la &gdb; kromaĵo en la sekcio de Kromaĵoj de la agordo de &kate;.

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

Se vi kompilas per &gcc;/`g++` vi eble volas uzi la argumenton de komandlinio ``-ggdb``.

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

### Strukturo de Menuo kaj Ilobreto

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

Vido Vido de ilo Montri Sencimigan Vidon

- Montras ilan vidon enhavantan &gdb; eligo, la &gdb; komandlinio uzata, kaj aliaj agordoj.

Vido Vido de ilo Montri lokanojn kaj stakon

- Montras liston de ĉiuj nuntempe ŝargitaj variabloj kaj iliaj valoroj kaj &gdb; retrospuro.

Sencimigo Celoj

- Submenuo enhavanta liston de celoj (efektiveblaj).

Sencimigo Komenci Sencimigi

- Komencas &gdb; kun celo.

Sencimigo Mortigi/Ĉesigi Sencimigon

- Haltas &gdb;.

Sencimigo Rekomenci Sencimigon

- Rekomencas &gdb;.

Sencimigo Baskuligi Haltpunkton / Rompi

- Agordu rompopunkton ĉe la aktuala kursora pozicio.

Sencimigo Enpaŝi

- Efektivigi la aktualan deklaron (funkcivoko estos sencimigita).

Sencimigo Paŝi Super

- Efektivigi la aktualan deklaron (funkcivoko ne estos sencimigita).

Sencimigo Elpaŝi

- Rekomencas rulon ĝis la programo, kiu rulas, finiĝas.

Sencimigo Movi Programkalkulilon (PC)

- Movi programkalkulilon (sekva rulo).

Sencimigi Run al Kursoro

- Rulas la programon ĝis ĝi atingas aktualan kursoran pozicion.

Sencimigo Daŭrigi

- Ignoras ajnajn rompopunktojn kaj rulas programon ĝis ĝi finiĝas (sukcese aŭ ne).

Sencimigo Presi valoron

- Presas la valoron de la variablo al kiu la kursoro nuntempe montras.

Agordoj Montrataj ilobretoj&gdb; Kromaĵo

- Montri la sencimigan ilobreton.

### Sencimiga Vido

La Sencimiga Vido ila vido konsistas el pluraj langetoj:

&gdb; Eligo

- Enhavas eliron de &gdb; kaj a &gdb; komandlinio.

  La Eligo Tab La langeto Eligo.

  La langeto Eligo montranta la eliron de sencimiga seanco.

Agordoj

- Efektivigebla

- Vojo al la celo (efektivebla) por sencimigi.

Labora Adresaro

- La aktuala labordosierujo provizita al la celo.

Argumentoj

- Argumentoj pasis al la programo.

Konservi fokuson

- Konservas fokuson sur la &gdb; komandlinio.

Alidirekti IO

- Malfermas novan langeton IO en la Sencimiga Vido kie vi povas vidi eligon kaj provizi enigon al la ruliĝanta programo.

La dialogo de Agordoj La dialogo de Agordoj

La dialogo Agordoj montranta la agordon de sencimiga seanco.

IO

- Enhavas areon, kiu montras produktaĵon de la funkcianta programo kaj komandlinion, kie vi povas doni enigon al ĝi.

  La IO Tab La langeto IO.

  La langeto IO montranta eliron de simpla testprogramo.

### Vokstako kaj Lokaj variabloj

La Voka stako ila vido enhavas liston de la formatita malantaŭa spuro resendita de &gdb;.

La &gdb; Vokstaka Ilovido La vido de la Vokstaka ilo.

La Call Stack ilovido de la &gdb;-kromprogramo.

La ilovido de Lokuloj enhavas liston de ĉiuj aktuale ŝargitaj variabloj de la programo kaj iliajn respondajn valorojn.

La &gdb;-Ilovido de Lokuloj La ilvido de Lokuloj.

La Lokuloj-ilovido de la &gdb;-kromprogramo.

### Dankon kaj Dankon

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

## Projekta Kromprogramoo

### Enkonduko

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

1. Provizi strukturitan vidon de la dosieroj

2. Igi ĝin facila kaj tre rapida malfermi kaj ŝanĝi projektojn

3. Subteni serĉon kaj anstataŭigu projekton

4. Provizi simplan aŭtomatan kompletigon

5. Simpligi rapidan malfermadon de dosieroj en la projekto

6. Subteno por konstrui la projekton

### Strukturita Vido de la Dosieroj

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:

Projekta Vido

Kiel vi povas vidi, la nuntempe aktiva projekto estas Kate, 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 `.ui` dosiero kun Qt Designer.

Vi povas filtri la erojn tajpante partojn de la dosiernomo, kiun vi serĉas en la serĉbreton ĉe la malsupro de la listo.

### Ŝanĝado de Projektoj

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 `.kateproject` dosiero. Se trovite, la projekto estas aŭtomate ŝargita.

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.

### Serĉi kaj Anstataŭigi en Projektoj

&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:

Serĉi en Projektoj

### Simpla Aŭtomata Kompletigo

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 `/tmp`. Tiu ĉi dosiero tiam estas uzata por plenigi la ŝprucfenestron de aŭtomata kompletigo en &kate;.

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.

Kompletigo en Projektoj

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

### Subteno por Konstruado de la Projekto

Alia funkcio estas havi subtenon por la Konstrua Kromaĵo, tiel ke ĝi aŭtomate estas agordita ĝuste.

### Kreante Projektojn

#### Ŝargante Projektojn Aŭtomate

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):

Projekta Kromaĵo-Agordo

#### Krei Projektojn Mane

Vi nur devas krei dosieron `.kateproject` en la radika dosierujo de la projekto. Ekzemple, la dosiero Kate `.kateproject` aspektas jene:

    {
     "nomo": "Kate",
     "dosieroj": [
     {
     "git": 1
     }
     ]
    }

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

Ankaŭ subtenata anstataŭ `git` estas subfosado per `svn` kaj mercurial per `hg`. Se vi ne volas legi dosierojn de versio-kontrolsistemo, vi povas simple alvoki kate el komandlinio kiel:

    kate /path/to/folder

aŭ vi povas instrui ĝin rekursie ŝargi dosierojn el dosierujoj jene:

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

Ĉ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 `"kaŝita"` estas 0. `"exclude_patterns"` estas listo de regex-ŝablonoj uzeblaj por ekskludi dosierujojn kaj dosierojn el la projektarbo. En ĉi tiu ekzemplo, Ĉiuj dosieroj kaj dosierujoj en dosierujo `konstrui` el la radiko estos ekskluditaj.

Se vi volas aldoni subtenon por la konstruaĵo, vi povas skribi `.kateproject` jene:

    {
      "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"
          }
        ]
      }
    }

La celoj supre specifitaj tiam aperos en la Konstrua Kromaĵo sub "Celoj de Projektaj Kromaĵoj". Se la tabelo `"celiloj"` estas specifita tiam `"konstrui"`, `"purigi"` kaj `"instali "` estas ignoritaj. Ĉiu elemento en la tabelo precizigas celon. `"nomo"` estas la nomo de la celo, `"build_cmd"` estos uzata por konstrui la celon, `"run_cmd"` estos uzata por ruli la celon. Plej grava el ĉio estas `"dosierujo"`, ĉi tie estos rulitaj la komandoj.

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

### Aktuala Projekto

Uzante &Alt;1 Projektoj Iri Al vi povas malfermi la vidon Aktuala Projekto ĉe la malsupro de la redaktora fenestro kun kvar langetoj:

Aktuala Projekto

Terminal-Panelo

- Terminala emulilo komencanta en la radika dosierujo de la projekto.

Koda Indekso

- 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.

  Elektu eron en la listo por salti al la responda linio en la fontdosiero.

Koda Analizo

- Klaku Komenci Analizon por ruli statikan kodan analizon por la C kaj C++ uzante `cppcheck` kaj por generi raporton montrantan dosiernomon, linionumeron, severecon (stilo, averto, ktp;) kaj la afero trovita.

  Elektu eron en la listo por salti al la responda linio en la fontdosiero.

Notoj

- Teksto enigita en ĉi tiu langeto estos konservita en la dosiero `.kateproject.notes`.

### La Projektoj-Menuo

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

&Ctrl;&Alt;&Left; Projektoj Reen

- Ŝanĝi al la antaŭa projekto.

&Ctrl;&Alt;&Right; Projektoj Antaŭen

- Ŝanĝi al la sekvanta projekto.

&Alt;1 Projektoj Iri Al

- Malfermi la vidon de Aktuala Projekto ĉe la fundo de la redaktora fenestro.

## LSP-Klienta Kromaĵo

La kromaĵo de LSP-kliento disponigas multajn lingvajn funkciojn kiel kodkompletigon, kodnavigadon aŭ trovi referencojn bazitajn sur la Language Server Protocol.

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

### Strukturo de menuo

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.

LSP-Kliento Iri al Difino

- [textDocument/difino] Iru al la aktuala simboldifino.

LSP-Kliento Iri al Deklaro

- [textDocument/declaration] Iru al aktuala simbola deklaro.

LSP-Kliento Iri al Tipo-Difino

- [textDocument/typeDefinition] Iru al aktuala simboltipdifino.

LSP-Kliento Trovi Referencojn

- [textDocument/references] Trovu referencojn al aktuala simbolo.

LSP-Kliento Trovi Implementojn

- [textDocument/implementation] Trovi efektivigojn de aktuala simbolo.

LSP-kliento Elstarigu

- [textDocument/documentHighlight] Marki nunajn simbolreferencojn en aktuala dokumento.

LSP-Kliento Ŝvebi

- [textDocument/hover] Ŝveb-informoj por aktuala simbolo.

LSP-Kliento Formato

- [textDocument/formatting] [textDocument/rangeFormatting] Formatu la aktualan dokumenton aŭ aktualan elekton.

LSP-Kliento Alinomu

- [textDocument/rename] Alinomi aktualan simbolon.

LSP-Kliento Rapida solvo

- [textDocument/codeAction, workspace/executeCommand] Komputilas kaj aplikas rapidan solvon por diagnozo pri aktuala pozicio (aŭ linio).

LSP-kliento Montri elektitan kompletigdokumentaron

- Montru dokumentadon por elektita elemento en la kompletigolisto.

LSP-Kliento Ebligi subskriban helpon kun aŭtomata kompletigo

- Ankaŭ montru subskriban helpon en la kompletigolisto.

LSP-kliento Inkluzivi deklaron en referencoj

- Peto inkluzivi la deklaron de simbolo kiam oni petas referencojn.

LSP-Kliento Aldonu krampojn ĉe funkciokompletigo

- Aŭtomate aldonu paron da krampoj post kompletigo de funkcio.

LSP-kliento Montri informojn pri ŝvebado

- Montri informojn pri ŝvebado sur (muskursoro) ŝvebado. Sendepende de ĉi tiu agordo, la peto ĉiam povas esti mane iniciatita.

LSP-Kliento Formato dum tajpado

- [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.

LSP-Kliento Pliiga dokumenta sinkronigo

- Sendi partajn dokumentajn redaktojn por ĝisdatigi la servilon prefere ol tuta dokumentteksto (se subtenata).

LSP-Kliento Elstarigu iri lokon

- Provizi paseman vidan signalon post plenumo de goto al loko (de difino, deklaro, ktp).

LSP-kliento Montri diagnozajn sciigojn

- [textDocument/publishDiagnostics] Procesi kaj montri diagnozajn sciigojn senditajn de servilo.

LSP-kliento Montri diagnozajn elstaraĵojn

- Aldonu tekststaraĵojn por intervaloj indikitaj en diagnozo.

LSP-Kliento Montri diagnozajn markojn

- Aldonu dokumentmarkojn por linioj indikitaj en diagnozo.

LSP-Kliento Ŝanĝi al diagnoza langeto

- Ŝanĝi al la diagnoza langeto en la kromprograma ilvido.

LSP-Kliento Fermi ĉiujn ne-diagnozajn langetojn

- Fermi ĉiujn langetojn ne-diagnozajn (⪚ referencojn) en kromprograma ilvido.

LSP-kliento Rekomencu LSP-servilon

- Rekomenci la LSP-Servilon de aktuala dokumento.

LSP-Kliento Rekomenci ĉiujn LSP-servilojn

- Halti ĉiujn LSP-Servilojn, kiuj tiam estos (re)komencitaj laŭbezone.

### Subteno por Iri al Simbolo

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.

#### Agordi LSP-Klienta Simbolo-Skizo

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".

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

#### Ĉiea Goto-simbolsubteno

Por salti al iu ajn simbolo en via projekto, vi povas malfermi la dialogon de iri simbolo uzante &Ctrl;&Alt;p. 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.

### Aliaj Trajtoj

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 F12 .

Vi povas rapide salti al simbolo metante vian muson super la simbolon kaj poste premante &Ctrl; + maldekstran musbutonon.

### Agordo

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:

    {
        "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.*$"
            }
        }
    }

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 `PATH`. 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 `PATH`. Kiel ĉi-supre ilustrite, oni povas ankaŭ specifi "vojo" kiun oni serĉos post la normaj lokoj.

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

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.

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.

Diversaj stadioj de superregado/kunfandi estas aplikataj;

- uzanta agordo (ŝargita el dosiero) superregas (internan) defaŭltan agordon

- "lspclient" eniro en `.kateproject` projektagordo anstataŭas ĉi-supran

- la rezulta enskribo "global" estas uzata por kompletigi (ne anstataŭi) ajnan servilan eniron

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 projectBase (kiel determinite de la Projekta kromaĵo) 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.

Ĝ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.

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:

    {
            "servers":
            {
                    "python":
                    {
                            "command": ["pylsp_in_env", "%{Project:NativePath}"],
                            "root": "."
                    }
            }
    }

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.

`pylsp_in_env` estas malgranda "envolvaĵa skripto" kiu devus esti metita en `PATH` kun la sekva (alĝustigota) enhavo:

    #!/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

#### Agordo de LSP-Servilo

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

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

    {
        "servers": {
            "python": {
                "settings": {
                    "pyls": {
                        "plugins": {
                            "pylint": {
                                "enable": true
                            }
                        }
                    }
                }
            }
        }
    }

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 dokumentaron de alia LSP-kliento 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.

#### LSP Servila Formato Sur Konservi

Vi povas ebligi "formati dum konservado" de LSP-agordoj en agorda dialogo.

#### LSP-Servilo Diagnoza Subpremado

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 agorda mekanismo de clangd 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.

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.

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

Ĉ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.

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.

#### Solvo de Problemoj pri LSP-Servilo

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).

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.

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 `QT_LOGGING_RULES=katelspclientplugin=true` taŭge `eksporto`'ed.

## Serĉi & Anstataŭigi

### Enkonduko

La kromprogramo Serĉi & Anstataŭigi de &kate; permesas serĉi tekston aŭ regulajn esprimojn 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.

### Interfaco

#### Serĉa Demando

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

- 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.

- 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.

Trovi

- Ĉi tie vi tajpas tion, kion vi volas trovi. Vi povas enigi norman tekston, aŭ regulan esprimon se ĝi estas enŝaltita.

Anstataŭigi (tekstkesto)

- Anstataŭiga teksto kiu estos aldonita al dosiero(j) anstataŭ la teksto en la tekstkesto Trovu.

Serĉi

- Kiam vi finis ĉion agordi, simple premu la butonon Serĉi por fari vian serĉon. Vi ankaŭ povas premi &Enter; en la tekstokesto Trovi por fari la samon.

Anstataŭigi

- Kiam vi finos agordi ĉion, simple premu la butonon Anstataŭigi por anstataŭigi la tekston enskribitan en la tekstokesto Trovu per tiu de la teksto Anstataŭigi. skatolo. Vi ankaŭ povas premi &Enter; en la tekstokesto Anstataŭigi por fari la samon.

Sekva

- Iru al la sekva kongruo de via serĉdemando, ŝanĝante dosierojn se necese.

Anstataŭigi Markitajn

- Same kiel Anstataŭigi, sed nur faros anstataŭigojn en dosieroj, kiuj estas markitaj en la suba panelo.

#### Opcioj por Serĉi en Dosierujo

Ĉi tiuj opcioj estas montrataj sub la menciitaj demandopcioj. Se la serĉrezultoj estas montritaj anstataŭe, premu la butono por montri ilin.

Serĉi en

- Ĉi tio havas tri eblojn. Elektu Malfermi dosierojn por serĉi ĉiujn dosierojn nuntempe malfermitajn en &kate;. Elektu Dosierujon por serĉi ene de dosierujo kaj laŭvole ĝiaj subdosierujoj. Elektu Aktuala Dosiero por serĉi nur en la aktiva dosiero.

  Se la kromprogramo Projektoj estas ŝargita, vi ankaŭ povas serĉi en la Aktuala Projekto aŭ en Ĉiuj Malfermaj Projektoj.

Kongrua kazo

- Limigas serĉrezultojn al nur tiuj, kiuj havas la ĝustan saman kombinaĵon de majusklaj kaj minusklaj literoj kiel via serĉdemando.

Regulaj esprimoj

- Permesas al vi uzi regulajn esprimojn anstataŭ simpla teksto kiel via serĉdemando.

Pligrandigi rezultojn

- Montri ĉiujn rezultojn trovitajn en ĉiu dosiero, anstataŭ nur liston de dosieroj, kiuj enhavas la serĉdemandon.

Dosierujo

- Vi povas enigi la vojon de la dosierujo, kiun vi volas serĉi. Ekzemple, vi povus enigi `~/development/kde/kate/` se vi dezirus serĉi la &kate; fontkodo. Ĉi tiu opcio disponeblas nur kiam vi uzas en Dosierujo reĝimo.

Dialogo por malfermi dosieron

- 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 Dosierujo.

- Premu ĉi tiun butonon por ŝanĝi Dosierujon al la patro de la nuntempe elektita dosierujo. Ĉi tiu butono funkcias nur kiam vi uzas la reĝimon Dosierujo.

- Ĉi tiu butono agordos la eniron Dosierujo al la dosierujo en kiu troviĝas la nuntempe malfermita dokumento. Ĉi tiu butono funkcias nur kiam vi uzas la reĝimon Dosierujo.

Filtrilo

- Ĉ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 `*.cpp`. Por serĉi nur dosierojn komenciĝantajn per `kate`, ŝanĝu ĝin al `kate*`. Vi povas enigi plurajn filtrilojn apartigitajn per komo (`,`). Ĉi tiu opcio ne disponeblas kiam vi uzas la reĝimon Malfermi dosierojn.

Ekskludi

- La malo de Filtrilo, tio malhelpas &kate; de serĉado de dosieroj, kiuj kongruas kun la specifitaj ŝablonoj. Kiel ĉe Filtrilo, vi povas enigi plurajn ŝablonojn apartigitajn per komo (`,`). Ĉi tiu opcio ne disponeblas kiam vi uzas la reĝimon Malfermi dosierojn.

Rekursiva

- 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 Dosierujo.

Inkluzivi kaŝitajn

- 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 Dosierujo.

Sekvi simbolajn ligilojn

- La kromprogramo Serĉi en Dosieroj kutime ne sekvas simbolajn ligilojn. 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 Dosierujo.

  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.

Inkluzivi binarajn dosierojn

- Se ebligita, &kate; serĉos ankaŭ en dosieroj, kiuj ŝajnas ne esti tekstaj dosieroj.

#### Serĉrezultoj

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 butonon por montri ilin. Ili ankaŭ aŭtomate montriĝos tuj kiam serĉo estas farita.

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.

Por vidi liston de kongruoj en tiu dosiero, simple alklaku la vastigan sagon maldekstre de la dosiernomo. (Se vi elektis la opcion Vaŝigi rezultojn, 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.

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.

### Strukturo de menuo

&Ctrl;&Alt;F Redakti Serĉi en dosieroj

- Lanĉas la ilan vidon Serĉi kaj Anstataŭigi.

Redakti Iri al Sekva Partio

- Iru al la sekva kongruo en serĉo farita de la kromprogramo Serĉu kaj Anstataŭigi.

Redakti Iri al Antaŭa Partio

- Iri al la antaŭa kongruo en serĉo farita de la kromprogramo Serĉi kaj Anstataŭigi.

Vidi Vidoj de iloj Montri Serĉon kaj Anstataŭigi

- Baskuligi la montradon de la Serĉi kaj Anstataŭigi-ilo de &kate;.

## &kate; Fragmentoj

### Enkonduko

&kate; Fragmentoj estas kromaĵo uzata por ŝpari al vi iom da tempo aldonante subtenon por tiel nomataj fragmentoj (reuzebla fontkodo, maŝinkodo aŭ teksto). La kromaĵo ankaŭ subtenas kodkompletigon kaj &javascript;.

### Strukturo de menuo

Vido Vidoj de iloj Montri fragmentojn

- Montras panelon de fragmentoj enhavantan ĉiujn fragmentojn en via deponejo kiuj estas por la aktuale malfermita dosiertipo.

Iloj Krei Fragmenton

- Kreu novan fragmenton, kiu estas reuzebla parto de teksto, kiun vi povas enmeti en ajnan parton de iu ajn dokumento.

### Panelo de fragmentoj

&kate; Fragment-Panelo La &kate; panelo de fragmentoj.

La panelo por &kate;-Fragmentoj.

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.

#### Ŝargante Fragmentajn Deponejojn

Vi povas elŝuti fragmentajn deponejojn de la Interreto. Simple klaku Akipi novajn fragmentojn kaj malfermiĝos fenestro kun listo de fragmentoj. Post elŝuto de la dezirata fragmento, certigu, ke vi aktivigis ĝin.

#### Krei kaj Redakti Deponejojn

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

Fragmentredaktilo La deponeja redaktilo.

La interfaco de deponeja redaktilo.

La redaktilo de fragmentoj de deponejo enhavas la jenajn opciojn:

Nomo

- Aperas en la listo de fragmentoj en la ila vido kaj ankaŭ estas serĉata kiam oni uzas la kodkompletigan funkcion.

Nomspaco

- Prefikso uzata dum kodokompletigo.

Permesilo

- Elektu la permesilon por via fragmento-deponejo.

Aŭtoroj

- Enigu la nomon(j)n de la aŭtoro(j) de la fragmenta dosiero.

Dosiertipoj

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

#### Krei kaj Redakti Pecetojn

Fragmentredaktilo La redaktoro de fragmentoj.

La interfaco de redaktilo de fragmentoj.

Nomo

- La nomo estos montrata en la kompletigolisto.

Ŝparvojo

- Premante ĉi tiun ŝparvojon enigos la fragmenton en la dokumenton.

Fragmentoj

- La tekston, kiun via fragmento enigos en la dokumenton.

  Fragmento povas enhavi redakteblajn kampojn. Ili povas esti biciklitaj premante . La jenaj esprimoj povas esti uzataj en la ŝablona teksto por krei kampojn:

  `${`field_name`}` kreas simplan, redakteblan kampon. Ĉiuj postaj okazoj de la sama `field_name` kreas kampojn kiuj spegulas la enhavon de la unua dum redaktado.

  `${`field_name=defaŭlto`}` povas esti uzata por specifi defaŭltan valoron por la kampo. `defaŭlto` povas esti ajna &javascript; esprimo.

  Uzu `${`field_name`=`teksto`}` por specifi fiksan ĉenon kiel defaŭltan valoron.

  `${func(`alia_kampo1`, `alia_kampo2`, ...)}` povas esti uzata por krei kampon kiu taksas &javascript; funkcias en ĉiu redakto kaj enhavas ĝian enhavon. Vidu la langeton Skriptoj por pliaj informoj.

  `${cursor}` povas esti uzata por marki la finpozicion de la kursoro post kiam ĉio alia estis plenigita.

Skriptoj

- &javascript; helpaj funkcioj por uzi en viaj fragmentoj.

  Ĉiuj &javascript; funkcioj devas resendi la enhavon, kiun vi volas meti en ŝablonkampon kiel ĉenon.

  Funkcioj estas nomitaj en amplekso kiu enhavas la enhavon de ĉiuj redakteblaj ŝablonkampoj kiel lokaj variabloj. Ekzemple en fragmento enhavanta `${`kampo`}`, variablo nomata `kampo` ĉ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 `${func(kampo)}` aŭ `${`field2=func(kampo)`}` sintakso en la fragmentĉeno.

  Vi povas uzi la &kate; scripting API por akiri la elektitan tekston, plenan tekston, dosiernomon kaj pli uzante la taŭgajn metodojn de la objektoj `dokumento` kaj `vido`. Raportu la dokumentaron pri scripting API por pliaj informoj.

  Por pli kompleksaj skriptoj povas esti grave kompreni, ke unue, la kruda fragmento estas enmetita en la dokumenton, kaj poste funkcioj estas taksataj. Ekz., se funkcio retrovas la tekston sur la linio kie la fragmento estas enmetita, tiu teksto ankaŭ enhavos `${functionCall()}`.

  Kiel ekzemplo de laboro kun elektoj uzante la scripting API, simpla maniero envolvi elektitan tekston ene de etikedoj estas ĉi tiu fragmento: `<strong>${view.selectedText()}</strong>`

  La sekva ekzemplo alvokas skripton, kiu enmetas defaŭltan tekston, se ne ekzistas elekto. Fragmento:

  `${rangeCommand("<strong>%%1</strong>", "Grasa")}`

  Skripto:

      function gamoKomando(komando, difin) {
          if (view.selectedText().length
      > 0) {
              return komando.replace("%%1", view.selectedText());
          } else {
              return komando.replace("%%1", difin);
          }
      }

### Uzante Fragmentojn

&kate;-Fragmentoj en Praktiko Alirante &kate;-Fragmentojn de ila vido kaj falmenuo.

Elektante el listo de fragmentoj.

Vi povas voki fragmentojn en du manieroj:

- Elektante la fragmenton el la ila vido.

- Dum skribado, vi povas premi &Ctrl; &Space;, kiu montros ĉiujn fragmentojn en oportuna fenestro el kiu vi povas elekti. Ĉi tiu klavkombinaĵo disponigas funkciojn similajn al kodkompletigo.

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

### Dankon kaj Dankon

&kate; Fragmentoj estis skribitaj fare de Joseph Wenninger.

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

## Kromaĵo por klavaraj makrooj

### Enkonduko

Registri kaj ludu klavarajn makroojn (t.e. klavarajn agosekvencojn).

### Baza uzado

#### Por komenci registri klavaran makroon:

Iloj Klavaraj makrooj Registri makroon... (&Ctrl;&Shift;K).

La kromaĵo registros ĉiujn klavpremojn ĝis vi finos registradon.

#### Por fini registradon:

Iloj Klavaraj makrooj Finigi makroregistradon (&Ctrl;&Shift;K).

La kromaĵo ĉesos registri klavopremojn kaj konservos la sekvencon kiel la aktuala makroo.

#### Por nuligi registradon:

Iloj Klavaraj makrooj Nuligi makroregistradon (&Ctrl;&Alt;&Shift;K).

La kromaĵo ĉesos registri klavopremojn sed la nuna makroo ne ŝanĝiĝos.

#### Por ludi la aktualan makroon:

Iloj Klavaraj makrooj Ludi makroon (&Ctrl;&Alt;K).

La kromaĵo ludos la aktualan makroon.

La komando `kmplay` sen iuj argumentoj ankaŭ ludos la aktualan makroon.

### Nomitaj makrooj

Eblas konservi klavarajn makroojn donante al ili nomon.

Nomitaj makrooj estas konstantaj inter la seancoj de Kate, ili estas konservitaj en la dosiero `keyboardmacros.json` en la uzantdatuma dosierujo de Kate (kutime `~/.local/share/kate/`).

#### Por konservi la aktualan makroon:

Iloj Klavaraj makrooj Konservi nunan makroon (&Alt;&Shift;K).

La kromaĵo petos vin por nomo kaj konservos la makroon sub ĝi.

La komando `kmsave `nomo`` konservos la nunan makroon sub la nomo ``nomo``.

#### Por ŝargi konservitan makroon kiel la aktualan:

Iloj Klavaraj makrooj Ŝargi Nomitan Makroon....

La kromaĵo listigas konservitajn makroojn kiel erojn en ĉi tiu submenuo, aktivigi objekton ŝargos la respondan makroon kiel la aktualan.

La komando `kmload `nomo`` ŝargos la makroon konservitan sub la nomo ``nomo`` kiel la aktuala.

#### Por ludi konservitan makroon sen ŝargi ĝin:

Iloj Klavaraj makrooj Ludi Nomitan Makroon....

La kromaĵo listigas konservitajn makroojn kiel erojn en ĉi tiu submenuo, aktivigi objekton ludos la respondan makroon sen ŝargi ĝin.

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 Agordoj Agordu klavarajn ŝparvojojn... interfaco.

La komando `kmplayer `nomo`` ludos la makroon konservitan sub la nomo ``nomo`` sen ŝargi ĝin.

#### Por viŝi (t.e., forigi) konservitan makroon:

Iloj Klavaraj Makrooj Forviŝi Nomitan Makroon....

La kromaĵo listigas konservitajn makroojn kiel erojn en ĉi tiu submenuo, aktivigi objekton forviŝos (t.e., forigos) la respondan makroon.

La komando `kmwipe `nomo`` forviŝos la makroon konservitan sub la nomo ``nomo``.

#### Konsiloj por komandoj:

Notu, ke post la prefikso `km`, ĉiuj ĉi ordonoj uzas alian literon, por ke vi povu efike voki ilin uzante tabuladon!

### Limigoj

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.

## SQL Kromaĵo

### Enkonduko

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

La &kate; SQL-Aldonaĵo permesas vin:

- Krei datumbazon

- Konekti al ekzistantaj datumbazoj

- Enigi kaj forigi datumojn en la datumbazo

- Efektivigi demandojn

- Montri rezultojn en tabelo

### Konektante al datumbazo

Elektu Aldoni Konekton el la menuo aŭ ilobreto SQL, 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 Sekva.

Se la datumbazo, kiun vi elektis, uzas dosieron, simple indiku la lokon de la datumbazo kaj premu la butonon Sekva. 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 Sekva.

Fine, donu nomon al via konekto, kaj premu Finu.

### Lanĉante Aldemandojn

#### INSERT/DELETE/UPDATE

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 Ruli demandon en la ilobreto aŭ uzu SQL Ruli konsulton (&Ctrl;E).

##### Kelkaj Ekzemplaj Demandoj

`INSERT`

-     INSERT INTO table_name ("feature1", "feature2", "feature3", "feature4", "feature5")
      VALUES ("value1", "value2", "value3", "value4", "value5" )

`DELETE`

-     DELETE FROM table_name WHERE name = "teksto"

`UPDATE`

-     UPDATE tabelnomo SET "trajto1" = "teksto", "trajto2" = "teksto", "trajto3" = "teksto", "trajto4" = "teksto", "trajto5" = "teksto"

#### SELECT

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

##### Ekzemplo `SELECT` Demando

    SELECT * FROM tabelonomo

En la ilvido de SQL-Eligo de datumoj, estas pluraj butonoj:

Regrandigi kolumnojn al enhavo

- Ŝanĝas la grandecon de kolumnoj por kongrui kun ilia enhavo.

Regrandigi vicojn al enhavo

- Ŝanĝas la grandecon de vicoj por kongrui kun ilia enhavo.

Kopii

- Elektas la tutan tabelenhavon kaj kopias ĝin al la bufro de la tondujo.

Eksporto

- Eksportas la tutan tabelenhavon al dosiero, la tondujo aŭ la nuna dokumento en la formato de Komo Apartigitaj Valoroj.

Klara

- Forigas ĉion el la tablovido.

Vi nun povas ŝanĝi la kolorojn montritajn en la tabelo en la sekcio SQL de Agordoj Agordu &kate;... .

### Foliumado

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

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

### Strukturo de menuo

SQL Aldoni konekton...

- Aldonas novan konekton uzante ajna datumbaza pelilo.

SQL Forigi konekton

- Forigas la elektitan konekton.

SQL Redakti konekton...

- Redaktas la agordojn de la aktuala konekto.

Konektoj

- Ĉiuj datumbazkonektoj, kiujn vi kreis, estas listigitaj inter la menueroj Redakti konekton kaj Ruli konsulton. Elektu unu por fari demandojn aŭ fari modifojn al ĝi.

&Ctrl;E SQL Ruli konsulton

- Rulas vian demandon.

### Dankon kaj Dankon

La SQL-Kromaĵo estis verkita de Marco Mentasti.

Specialan dankon al la partoprenanto de Google Code-In 2011 Ömer Faruk ORUÇ pro verkado de granda parto de ĉi tiu sekcio.

## Simbolo Viewer Kromaĵo

### Uzante la Fermi Krom/Kiel Kromprogramon

Ĝi permesas al programistoj vidi simbolojn (funkcioj, makrooj kaj strukturoj) el fontkodo.

Alklakante la analizitajn informojn vi povas facile foliumi la kodon.

Nuntempe la sekvaj lingvoj estas subtenataj:

C/C++, &Java;, Perl, PHP, Python, Ruby, XSLT, Tcl/Tk, Fortran

Listo de funkcioj:

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

### Strukturo de menuo

&Ctrl;\ Vido Ilaj Vidoj Montri Simbolliston

- Baskuligi la montradon de la Simbollisto de &kate; montranta Funkciojn, Makroojn kaj Strukturojn de la fontkodo en la aktiva dokumento.

### Agordo

Simbol-Vidilo

Elektu la defaŭltajn analizajn opciojn

## Terminala Ilovida Kromprogramo

La enkonstruita Terminal Emulator estas kopio de la &kde; &konsole; terminala aplikaĵo, por via komforto. Ĝi estas havebla de la menuero Vido Ilaj Vidoj Montri Terminal-Panelon kaj ricevos la fokuson kiam ajn montrata. Aldone, se la opcio Aŭtomate sinkronigi la terminalon kun la nuna dokumento kiam eblas 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.

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

Vi povas agordi la &konsole; uzante sian &RMB; menuo, por pliaj informoj, vidu la &konsole; manlibro.

La enkonstruita terminala emulilo estas provizita de la kromaĵo Terminal Tool View.

### Strukturo de menuo

Vido Ilaj Vidoj Montri Terminal-Panelon

- Ŝaltas la ekranon de la enkonstruita terminal-imitilo.

  Kiam aktivigita por la unua fojo, la terminalo estos kreita.

  Kiam la terminala emulilo montriĝas, ĝi ricevos la fokuson, por ke vi povu tuj tajpi komandojn. Se la opcio Aŭtomate sinkronigi la terminalon kun la nuna dokumento kiam eblas estas ebligita en la paĝo Terminalo de la Ĉefa agorda dialogo la ŝelseanco ŝanĝiĝos al la dosierujo de la aktiva dokumento, se ĝi estas loka dosiero.

Iloj Tubo al Terminalo

- Enigu la nuntempe elektitan tekston en la enkonstruitan terminalan emulilon. Neniu nova linio estas aldonita post la teksto.

Iloj Sinkronigi Terminalon kun Aktuala Dokumento

- Ĉi tio igos la enkonstruitan Terminalon `cd` en la dosierujon de la aktiva dokumento.

  Alternative, vi povas agordi &kate; por ĉiam konservi la terminalon sinkronigita kun la nuna dokumento. Vidu konsole-config por pliaj informoj.

Iloj Ruli Aktuala Dokumento

- 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.

Iloj Fokusi/Malfokusi Terminal-Panelon

- Ŝanĝu la fokuson de la nuna dokumento al la terminalo kaj inverse.

### Agordo

Vi povas agordi la kromprogramon Vido de Terminalilo sur la paĝo Terminalo de la agorda dialogo.

La jenaj opcioj disponeblas:

Aŭtomate sinkronigi la terminalon kun la nuna dokumento kiam eblas

- Ĉi tio kaŭzos la enkonstruitan terminalon `cd` 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.

Agordi EDITOR-mediovariablon al 'kate -b'

- Ĉi tio fiksas la mediovariablon `EDITOR` 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.

Kaŝi &konsole; premante 'Esk'

- Tio ebligas fermi la enkonstruitan terminalon premante la &Esc; klavo. Povas kaŭzi problemojn kun terminalaj aplikaĵoj, kiuj uzas &Esc; klavo, ⪚ vim. Aldonu tiajn aplikaĵojn en la tekst-eniga skatolo sube. La eroj en la listo estu apartigitaj per komo.

## Tekstfiltrila Kromprogramo

### Uzante la Tekstfiltrilan Kromaĵon

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.

### Ekzemploj:

- `less /etc/fstab` - algluu la enhavon de ĉi tiu dosiero aŭ kopiu ĝin al la tondujo

- `wc` - kalkulu liniojn, vortojn kaj signojn de la elekto kaj algluu ĉi tion en la dokumenton aŭ kopiu ĝin al la tondujo

- `sort` - ordigu liniojn de la elekto kaj algluu la rezulton en la dokumenton aŭ kopiu ĝin al la tondujo

### Strukturo de menuo

&Ctrl;\ Iloj Filtrilo de teksto

- Malfermas la dialogon de Teksta Filtrilo:

  Dialogo de Teksta Filtrilo

  Enigu la ŝelan komandon en la kombokeston aŭ elektu antaŭan komandon el la historio.

  Kopii la rezulton anstataŭ glui ĝin

- Kopii la rezulton al tondujo lasante dokumenton senŝanĝa.

Kunfandi STDOUT kaj STDERR

- Se markite, eligo de STDOUT kaj STDERR estos kunfandita kaj neniuj eraroj estos raportitaj. Alie, STDERR estos montrata kiel pasiva mesaĝo.

## &XML; Valido

Ĉi tiu kromaĵo kontrolas &XML; dosieroj por valideco kaj esti bone formitaj.

Ĉ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 DOCTYPE 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, ⪚ se la doktipo rilatas al DTD/xhtml1-transitional.dtd kaj la dosiero estas `/home/peter/test.xml` la DTD estas atendita troviĝi ĉe `/ home/peter/DTD/xhtml1-transitional.dtd`. Tamen, foraj DTD-oj specifitaj per http estas subtenataj.

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

Por lerni pli pri &XML; konsultu la oficialajn W3C &XML;-paĝojn.

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

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

### Strukturo de menuo

&XML; Valigi &XML;

- Ĉi tio komencos la kontrolon, kiel priskribite supre.

### Dankon kaj Dankon

&kate; Kromaĵo &XML; Valido kopirajto 2002 &Daniel.Naber; &Daniel.Naber.mail;.

Dokumenta kopirajto 2002 &Daniel.Naber;

## &XML; Kompletigo

Ĉ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 (⪚ ĉiuj entoj estas listigitaj se la signo maldekstre de la kursoro estas &). Ankaŭ eblas fermi la plej proksiman malfermitan etikedon maldekstre.

La DTD devas ekzisti en &XML; formato, kiel produktata de la Perl-programo `dtdparse`. Ni nomos DTD en ĉi tiu formato meta DTD. Kelkaj meta DTD-oj estas liveritaj. Ili estas instalitaj en `katexmltools/` en ``qtpaths` `--paths GenericDataLocation`` , kio estas ankaŭ la defaŭlta dosierujo kiam vi elektas Asigni Meta DTD.... Por produkti viajn proprajn meta DTD-ojn, akiru `dtdparse` de http://dtdparse.sourceforge.net.

### Kiel Uzi

Komencu &kate; kaj malfermu la agordan dialogon sub Agordoj Agordu &kate;.... Tiam elektu &XML; Kompletigo kiu aperos en la paĝo Apliko Kromaĵoj kaj fermu la dialogon. Post tio, elektu &XML;Asigni Meta DTD.... Se via dokumento enhavas neniun DOCTYPE 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.

Vi nun povas uzi la kromprogramon dum tajpas vian tekston:

< (malpli-ol klavo)

- Ĉ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 (⪚ <html>).

</(malpli-ol klavo + oblikvo)

- 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 Fermi Elemento, ĉi tio funkcias nur kun DTD asignita.

" (cita klavo)

- La citoklavo ekigos liston de eblaj atributvaloroj (se ekzistas) se vi estas ene de etikedo.

(spacetoklavo)

- Ĉi tiu klavo ekigos liston de eblaj atributoj por la nuna elemento se vi estas ene de etikedo.

& (perluet-klavo)

- Ĉi tiu klavo ekigos liston de nomitaj entoj.

### Kapabloj kaj Limigoj

Vi povas testi ĉiujn funkciojn kaj limigojn ŝargante `katexmltools/testcases.xml` en ``qtpaths` `--paths GenericDataLocation`` en &kate; kaj sekvante la instrukciojn.

### Strukturo de menuo

&Ctrl;&Enter; &XML; Enmeti Elementon...

- Ĉi tio malfermos dialogon, kiu ebligas al vi enigi &XML; elemento. La <, >-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 Asigni Meta-DTD....

&Ctrl;< &XML; Fermi Elementon

- Ĉ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.

&XML; Asigni Meta DTD...

- Ĉ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.

### Dankon kaj Dankon

&kate; Kromaĵo &XML; Kompletigo kopirajto 2001,2002 &Daniel.Naber; &Daniel.Naber.mail;.

&kde; SC-4 versio kopirajto 2010 Tomáš Trnka

Dokumenta kopirajto 2001,2002 &Daniel.Naber;