La Kate Manlibro

# La Kate Manlibro

Anders Lund `<anders@alweb.dk>`

Seth Rothberg `<sethmr@bellatlantic.org>`

Dominik Haumann `<dhdev@gmx.de>`

T.C. Hollingsworth `<tchollingsworth@gmail.com>`

Translation: Oliver Kellogg
Versio Aplikoj 22.08 (2022-04-22)

Kopirajto © 2000, 2001 Seth Rothberg

Kopirajto © 2002, 2003, 2005 Anders Lund

Kopirajto © 2005, 2009 Dominik Haumann

Kopirajto © 2011, 2012, 2013, 2014 T.C. Hollingsworth

Leĝa Avizo

Kate estas programista tekstredaktilo de KDE.

Ĉi tiu manlibro dokumentas Kate Version 22.08

Listo de Tabeloj

4.1. Iuj disponeblaj KParts kromaĵojn

Listo de Ekzemploj

4.1. Kelkaj Ekzemplaj Demandoj
4.2. Ekzemplo SELECT Demando

Ĉapitro 1. Enkonduko
Enkonduko

# Ĉapitro 1. Enkonduko

Bonvenon al Kate, tekstredaktilo de programisto de KDE. Kelkaj el la multaj funkcioj de Kate inkluzivas agordeblan sintaksan reliefigon por lingvoj de C kaj C++ al HTML al bash-skriptoj, la kapablo krei kaj konservi projektojn, multoblan dokumentinterfacon (MDI), kaj memstara fina emulilo.

Sed Kate estas pli ol redaktilo de programisto. Ĝia kapablo malfermi plurajn dosierojn samtempe faras ĝin ideala por redakti la multajn agordajn dosierojn de UNIX®. Ĉi tiu dokumento estis skribita en Kate.

Redaktante ĉi tiun manlibron...

Ĉapitro 2. La Fundamentoj
La Fundamentoj

# Ĉapitro 2. La Fundamentoj

Translation: Oliver Kellogg

Se vi iam uzis tekstredaktilon, vi ne havos problemon uzi Kate. En la sekvaj du sekcioj, Starti Kate kaj en Laborante kun Kate, ni montros al vi ĉion, kion vi bezonas por rapide ekfunkcii.

## Komencante Kate

Vi povas komenci Kate de la aplikaĵlanĉilo aŭ de la komandlinio.

### De la Menuo

Malfermu la KDE programmenuo alklakante la aplikaĵlanĉilo-piktogramon sur la ilobreto maldekstre malsupre de via ekrano. Ĉi tio altigos menuon. Movu vian kursoron supren laŭ la menuo al la menuero Aplikoj → Uzaĵoj → Altnivela Tekstredaktilo Kate.

### De la Komandlinio

Vi povas komenci Kate tajpante ĝian nomon sur la komandlinio. Se vi donas al ĝi dosiernomon, kiel en la ekzemplo sube, ĝi malfermos aŭ kreos tiun dosieron.

    %kate mia dosiero.txt

Se vi havas aktivan konekton, kaj permeson, vi povas utiligi la retan travideblecon de KDE por malfermi dosierojn en la interreto.

    %kate ftp://ftp.kde.org/pub/kde/LEGUMIN

Por ŝanĝi la dosierujon por provizoraj dosieroj, kiu defaŭlte estas `/tmp` agordu la mediovariablon `TMPDIR` antaŭ ol komenci Kate, ekz.

    %mkdir /tmp/kate -p && export TMPDIR=/tmp/kate && kate

#### Komandliniaj Opcioj

Kate akceptas jenajn komandliniajn opciojn:

`kate `--help``

  Ĉi tio listigas la disponeblajn elektojn ĉe la komandlinio.

`kate `-s` `--start` `nomo``

  Komencas Kate kun la seanco `nomo`. La seanco estas kreita se ĝi ne jam ekzistas. Se Kate-instanco rulanta la specifita seanco ekzistas, la specifitaj dosieroj estas ŝargitaj en tiu kazo.

`kate `-p` `-- pid` `PID``

  Nur reuzas ekzemplon kun la specifita PID (Process ID).

`kate `-e` `-- kodo` `kodado` `URL``

  Uzas la specifitan kodigon por la dokumento.

`kate `-l` `-- linio` `linio` `URL``

  Navigas al la specifita linio post malfermi la dokumenton.

`kate `-c` `-- kolumno` `kolumno` `URL``

  Navigas al la specifita kolumno post malfermi la dokumenton.

`kate `-i` `--stdin``

  Legas la dokumentenhavon de STDIN. Ĉi tio similas al la komuna opcio `-` uzata en multaj komandliniaj programoj, kaj ebligas vin enkonduki komandan eligon en Kate.

`kate `--startanon``

  Komencu Kate kun nova anonima seanco, implicas `-n`.

`kate `-n` `--new``

  Devigi la komencon de nova Kate ekzemplo (estas ignorita se `komenco` estas uzata kaj alia petskribo de Kate jam havas la donitan seancon malfermita), devigita se neniuj parametroj kaj URL-oj estas donitaj.

`kate `-b` `--bloki``

  Se vi uzas jam funkciantan Kate-instancon, bloki ĝis ĝi eliras, se doniĝis URLoj por malfermi.

  Vi povas uzi Kate kun ĉi tiu opcio kiel redaktilo por tajpi en kommit mesaĝojn por versio-kontrolsistemoj kiel Git aŭ Subversigo. Ĉi tiuj sistemoj atendas bloki la redaktilon ĝis vi enigis vian mesaĝon, ĉar ili tiam malfermas la provizoran dosieron, kiu estus malplena se Kate tuj revenis al la alvokanto.

  Ĉi tiu opcio ankaŭ estas bezonata ĉe KIO (KDE Enigo/Eligo), se vi malfermas foran dosieron (kiu estis elŝutita al provizora) kaj devus esti re-alŝutita, post kiam vi konservis ĝin.

`kate `--tempfile``

  Kiam ili estas uzataj, la specifitaj dosieroj estas traktataj kiel provizoraj dosieroj kaj forigitaj (se ili estas lokaj dosieroj kaj vi havas sufiĉajn permesojn) kiam ili estas fermitaj, krom se ili estis modifitaj de kiam ili estis malfermitaj.

`kate `--desktopfile` `dosiernomo``

  La baza dosiernomo de la labortabla eniro por ĉi tiu aplikaĵo.

  Ĉi tio estas precipe utila por envolvaĵaplikoj kaj aplikaĵoj havantaj ĝenerale multoblajn labortablajn dosierojn. Tiel ĉiu labortabla dosiero povas havi sian propran komandlinion por la eniro `Exec`.

`kate `--aŭtoro``

  Listigas la aŭtorojn de Kate en la fina fenestro.

`kate `-v` `--version``

  Listigas versiinformojn por Kate.

`kate `--licenco``

  Montras informojn pri licenco.

### Treni kaj Faligi

Kate uzas la KDE Treni kaj Faligi protokolon. Dosieroj povas esti trenitaj kaj faligitaj sur Kate de la Labortablo, la dosieradministranto Dolphin aŭ iu fora FTP retejo malfermiĝis en unu el la fenestroj de Dolphin.

Laborante kun Kate
Laborante kun Kate

## Laborante kun Kate

Rapida Komenco montros al vi kiel ŝanĝi kvar simplajn opciojn, kiuj permesos al vi agordi kelkajn el la pli potencaj funkcioj de Kate tuj. Ŝparvojoj prezentas kelkajn el la defaŭltaj klavoklavoj por tiuj, kiuj ne povas aŭ ne volas uzi muson.

### Rapida Komenco

Ĉi tiu sekcio priskribos kelkajn el la eroj en la menuo Vidi por ke vi povu rapide agordi Kate labori kiel vi volas ĝin.

Kiam vi komencas Kate unuafoje vi vidos du fenestrojn kun blankaj fonoj. Super la du fenestroj estas ilobreto kun la kutimaj etikeditaj piktogramoj. Kaj super tio, menubreto.

La maldekstramana fenestro estas flanka stango. Ĝi kombinas la fenestrojn Dokumentoj kaj Dosiersistema Foliumilo. Ŝanĝu inter la du klakante sur la langetoj maldekstre de la fenestro.

Se vi komencis Kate kun dosiero, la dekstra fenestro montros la dosieron kiun vi redaktas kaj la Dokumentoj sur la flanka stango montros la nomon de la dosiero. Uzu la fenestron Dosiersistema Foliumilo por malfermi dosierojn.

Vi povas ŝalti kaj malŝalti ĉiujn flankajn fenestrojn en la menuo Vidi → Ilaj Vidoj aŭ uzi Ctrl+Alt+Majuskligo+F. Ĉi tiu menuo ofertas al vi vian unuan ekvidon pri la potenco kaj fleksebleco de Kate.

En Ilaj Vidoj vi havas liston de ĉiuj ebligitaj kromprogramoj. Alklaku la markobutonon antaŭ ĉiu elemento aŭ alklaku per la musbutono maldekstra sur la ilbutonoj en la flanka kolumno por ŝalti kaj malŝalti ĉi tiun ilan vidon.

### Ŝparvojoj

Multaj el la klavpremaj komandoj (mallongigoj) de Kate estas agordeblaj per la menuo Agordoj. Defaŭlte Kate honoras la sekvajn klavligilojn.

F1 | Helpo
Majuskligo+F1 | Kio estas tio?
Ctrl+N | Nova dokumento
Ctrl+L | Konservi Ĉion
Ctrl+O | Malfermi dokumenton
Ctrl+Alt+O | Rapida Malfermo
Ctrl+Majuskligo+F | Plena Ekrana Reĝimo
Ctrl+Majuskligo+, | Agordi Kate
Ctrl+W / Ctrl+Esc | Fermi
Ctrl+Q | Quit - fermi aktivan kopion de redaktilo
Ctrl+Alt+Majuskligo+F | Montri Flankmenuojn
Ctrl+Majuskligo+T | Split Horizontala
Ctrl+Majuskligo+L | Split Vertikala
F8 | Sekva Split View
Majuskligo+F8 / Ctrl+Esc | Antaŭa Split View
Ctrl+Majuskligo+R | Fermi Aktualan Vidon
Alt+Right | Sekva Langeto
Alt+Left | Antaŭa Langeto

Aldone vi povas uzi la ŝparvojojn provizitajn de la komponanto KatePart kaj de ĉiuj aktivigitaj Kate kromaĵojn.

Laborante Kun la Kate MDI
Laborante Kun la Kate MDI

## Laborante Kun la Kate MDI

### Superrigardo

Fenestro, Vido, Dokumento, Kadro, Redaktilo... Kio estas ili ĉiuj en la terminologio de Kate, kaj kiel vi povas profiti el ĝi la plej grandan parton? Ĉi tiu ĉapitro klarigos ĉion, kaj eĉ pli.

#### La Ĉefa Fenestro

La Kate Ĉefa Fenestro estas norma KDE aplika fenestro, kun aldono de flankaj stangoj enhavantaj ilajn vidojn. Ĝi havas menubreton kun ĉiuj komunaj menuoj, kaj kelkajn pli, kaj ilobreton havigante aliron al ofte uzataj komandoj.

La plej grava parto de la fenestro estas la redakta areo, defaŭlte montranta ununuran tekstredaktilkomponenton, en kiu vi povas labori kun viaj dokumentoj.

La aldokaj kapabloj de la fenestro estas uzataj por la ilaj fenestroj de iu ajn kromaĵo ebligita en la agorda dialogo.

Ilvidoj povas esti poziciigitaj en iu ajn flanka kolumno, por movi ilon dekstre alklaku ĝian flankan butonon kaj elektu el la musbutono dekstra menuo

Ila vido povas esti markita kiel persistenta en la musbutono dekstra menuo por ĝia flankbretobutono. La flankbreto povas enhavi pli da iloj samtempe tiel ke kiam ilo estas persista aliaj iloj povas esti montritaj samtempe.

Se kromaĵo havas agordajn opciojn, vi povas uzi la unuan eron en la kunteksta menuo por malfermi la respondan paĝon en la agorda dialogo de Kate.

### La Redaktora areo

Kate kapablas havi pli ol unu dokumenton malfermitaj samtempe, kaj ankaŭ dividi la redaktan areon en ajnan nombron da kadroj, simile al kiel ekzemple Konqueror aŭ la populara emacs tekstredaktilo funkcias. Tiel vi povas vidi plurajn dokumentojn samtempe, aŭ pli da ekzemploj de la sama dokumento, utila ekzemple se via dokumento enhavas difinojn en la supro, kiujn vi volas ofte vidi por referenco. Aŭ vi povus vidi programfontokapon en unu kadro, dum vi redaktas la efektivigdosieron en alia.

Kiam dokumento estas havebla en pli ol unu redaktilo, ŝanĝoj faritaj en unu redaktilo tuj estos reflektitaj ankaŭ en la aliaj. Ĉi tio inkluzivas ŝanĝi la tekston kaj elekti tekston. Serĉaj operacioj aŭ kursoromovo nur reflektiĝas en la nuna redaktilo.

Nuntempe ne eblas havi pliajn okazojn de la sama dokumento malfermitaj en la senco, ke unu okazo estos redaktita dum la alia ne.

Dum dividado de redaktilo en du kadrojn, ĝi estas dividita en du samgrandajn kadrojn, ambaŭ montrante la nunan dokumenton de tiu redaktilo. La nova kadro estos malsupre (kaze de horizontala disigo) aŭ dekstre (por vertikala disigo). La nova kadro ricevas la fokuson, kiu estas bildigita per la palpebruma kursora stango en la fokusita kadro.

Uzante Seancojn
Uzante Seancojn

## Uzante Seancojn

Seancoj estas kiel Kate permesas konservi pli ol unu liston de dosieroj kaj GUI agordo ĉirkaŭe. Vi povas havi tiom da nomitaj seancoj kiom vi volas, kaj vi povas uzi nenomitajn aŭ anonimajn seancojn por dosieroj, kiujn vi volas uzi nur unufoje. Nuntempe Kate povas konservi la liston de malfermitaj dosieroj, kaj la ĝeneralan fenestran agordon en la seanco; estontaj versioj de Kate povas aldoni pliajn funkciojn, kiuj povas esti konservitaj en seancoj. Kun la enkonduko de seancoj, Kate ankaŭ permesas vin malfermi ajnan nombron da okazoj de la aplikaĵo anstataŭ nur unu kiel ĝi kutimis fari kiel la defaŭlta konduto.

Seancoj estas subtenataj en tri areoj:

- Komandliniaj opcioj kiu ebligas al vi elekti kaj komenci seancojn dum lanĉo de Kate de la komandlinio.

- La Seancoj-menuo kiu ebligas al vi ŝanĝi, konservi, komenci kaj administri viajn seancojn.

- Agordaj opcioj kiu ebligas al vi decidi kiel sesioj ĝenerale devus konduti.

Kiam oni komencas novan seancon, la GUI agordo de Defaŭlta Seanco estas ŝargita. Por konservi fenestran agordon en la defaŭlta seanco, vi devas ebligi konservadon de fenestra agordo en la paĝo de agordo de seancoj de la agorda dialogo kaj poste ŝargi la defaŭltan seancon, agordi la fenestron laŭdezire kaj konservi la seancon denove.

Kiam nomita seanco estas ŝargita, Kate montros la sean nomon je la komenco de la fenestrotitolo, kiu tiam havas la formon “`Seancnomo`: `Dokumentnomo aŭ URL` - Kate” .

Kiam oni malfermas dosierojn sur la komandlinio per `--start `nomo`` aŭ se seanco estas elektita per la seanca elektilo, la specifita seanco estas ŝargita antaŭ la dosieroj specifitaj sur la komando linio. Por malfermi dosierojn el la komandlinio en nova, nenomita seanco, agordu Kate por komenci novan seancon defaŭlte en la seanpaĝo de la agorda dialogo aŭ uzu `--start` kun malplena ĉeno: `''`.

Ekde Kate 2.5.1 la PID de la nuna okazo estas eksportita al la mediovariablo `KATE_PID`. Kiam oni malfermas dosierojn el la enkonstruita terminalo, Kate aŭtomate elektos la nunan kazon se nenio alia estas indikita sur la komandlinio.

Rapida Malfermo
Rapida Malfermo

## Rapida Malfermo

Por povi rapide malfermi/ŝanĝi inter dosieroj, Kate venas kun enkonstruita rapida malferma dialogo. Vi povas malfermi ĝin per Ctrl+Alt+O.

Rapida malfermo povas montri ĉiujn malfermitajn dokumentojn en Kate kaj ankaŭ ĉiujn dosierojn en malfermitaj projektoj. Por povi vidi projektdosierojn, vi devas ebligi Projekta kromprogramo.

### Uzante Rapidan Malfermon

Uzi rapidan malfermon estas tre simpla. Post kiam vi malfermas ĝin, simple tajpu la nomon aŭ partojn de la nomo de la dosiero, kiun vi volas malfermi, kaj rapida malfermo filtros la liston laŭ tio, kion vi tajpis. Premante Enigu malfermas la elektitan dosieron, dum Esc kaŝas la rapidan malfermon.

Defaŭlte, nur la dosiernomo kongruas dum filtrado. Se vi volas kongrui vojon, vi devas havi "/" en la tajpita teksto. Ekzemple: "doc/index" kongruos kun ĉiuj dosieroj kiuj enhavas "index" ene de la dosierujo "doc".

La dokumentoj kiuj estas jam malfermitaj estas emfazitaj en grasa skribo kaj estas listigitaj supre kiam la dialogo malfermiĝas. Ankaŭ, kiam aperas rapida malfermo, la antaŭa malfermita dokumento jam estas elektita, do vi povas simple premi Enigu kaj ĝi kondukos vin al tiu dokumento.

### Agordo Rapida Malfermo

Rapida malfermo provizas kelkajn agordajn opciojn. Por aliri ĉi tiujn opciojn, dekstre alklaku en la enigolinia redakto.

Nuntempe disponeblaj opcioj estas:

  `Aktuala Projekto` - Montri dosierojn nur de aktuala projekto

  `Ĉiuj Projektoj` - Montri dosierojn de ĉiuj malfermitaj projektoj

  `Malklara Filtrado` - Uzi 'fuzzy' kongruoalgoritmon por filtri dosierojn

  `Filtrado de ĵokeroj`- Uzi ĵokeran kongruon por filtri dosierojn

Ricevi Helpon
Ricevi Helpon

## Ricevi Helpon

### Kun Kate

Ĉi tiu manlibro

  Proponas detalan dokumentadon pri ĉiuj menukomandoj, agordaj opcioj, iloj, dialogoj, kromprogramoj ktp. same kiel priskriboj de la Kate fenestro, la redaktilo kaj diversaj konceptoj uzataj en la aplikaĵo.

  Premu F1 aŭ uzu la Helpon → Kate Manlibro menua temo por vidi ĉi tiun manlibron.

Kio estas Ĉi Helpo

  Kio estas Ĉi tiu helpo ofertas tujan helpon kun unuopaj elementoj de grafikaj fenestroj, kiel butonoj aŭ aliaj fenestraj areoj.

  Ni strebas provizi Kio estas Ĉi helpo por iuj elementoj por kiuj ĝi havas sencon. Ĝi estas havebla ĉie en la agorda dialogo, kaj en multaj aliaj dialogoj ankaŭ.

  Por utiligi la helpon de Kio estas Ĉi, premu Majuskligo+F1 aŭ uzu la Helpon → Kio estas Ĉi menuero por ebligi Kio estas Ĉi tiu reĝimo. La kursoro fariĝos sago kun demandosigno, kaj vi nun povas klaki iun ajn elementon en la fenestro por legi la Helpon Kio estas Ĉi por tiu elemento, se ĝi disponeblas.

Helpbutonoj en Dialogoj

  Iuj dialogoj havas Helpo Butonon. Premante ĝin komencos la KHelpCenter kaj malfermu la koncernan dokumentaron.

### Kun Viaj Tekstaj Dosieroj

Kate ne (ankoraŭ!) provizas ajnan rimedon por legi dokumentan rilatan dokumentadon. Depende de la dosiero, kiun vi redaktas, vi eble trovos la Konstruita en Terminal Emulator utila por vidi rilatajn UNIX® manlibroj aŭ informdokumentado, aŭ vi povas uzi Konqueror.

### Artikoloj pri Kate

La hejmpaĝo de Kate provizas kelkajn Artikolojn kaj Kieltojn kun pliaj informoj ekster la amplekso de ĉi tiu manlibro.

Ĉapitro 3. Laborante kun la Redaktilo Kate
Laborante kun la Redaktilo Kate

# Ĉapitro 3. Laborante kun la Redaktilo Kate

Por informoj pri la bazoj pri laboro kun la redaktilo subesta Kate, vidu la Laborado kun la KatePart Redaktila ĉapitro de la KatePart Manlibro.

Ĉapitro 4. Laborante kun Kromaĵoj
Laborante kun Kromaĵoj

# Ĉapitro 4. Laborante kun Kromaĵoj

Anders Lund `<anders@alweb.dk>`

Translation: Oliver Kellogg

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+Tab 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
Eksteraj Iloj

## 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 AT 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
Backtrace Foliumilo Kromaĵo

## 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, t.s. 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, ekz.

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

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 (ekz., kiam vi klakis Kopii al Clipboard en DrKonqi) aŭ el dosiero.

Konstrui Kromprogramon
Konstrui Kromprogramon

## Konstrui Kromprogramon

Salma Sultana

T.C. Hollingsworth `<tchollingsworth@gmail.com>`

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

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+Majuskligo+Left. Por navigi al la sekva eraro, premu Alt+Majuskligo+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.

Konstrui → Antaŭa Eraro (Ctrl+Alt+Left)

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

Konstrui → Sekva Eraro (Ctrl+Alt+Right)

  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
Fermi Krom/Kiel Kromaĵo

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

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
Koloro Picker Kromaĵo

## Koloro Picker Kromaĵo

### Enkonduko

Ĉi tiu kromaĵo aldonas enlinian koloran antaŭrigardon/elekton al koloroj en la teksto (ekz., `#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 (ekz., `ĉ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
Koloraj krampoj

## 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
CTags Kromaĵo

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

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
  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 ktp. 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 ktp. 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
Dokumenta Antaŭrigardo Kromaĵo

## 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 ekz. 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 Sistemargordoj kaj redaktu la Prefer-Ordon de Servoj sur la langeto Enkonstruado.

Tabelo 4.1. 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
Document Switcher Kromaĵo

## Document Switcher Kromaĵo

### Strukturo de menuo

Vido → Laste Uzataj Vidoj (Ctrl+Tab), Vido → Laste Uzitaj Vidoj (Inversa) (Ctrl+Majuskligo+Tab)

  Malfermas liston kun la lastaj viditaj dokumentoj:

  Konservu la Ctrl klavo premita kaj uzu la Tab klavo por bicikli antaŭen tra la listo. Aldone premu la Majuskligo klavo por inversigi la direkton.

  Tenu la ŝparvojon Ctrl+Tab 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
Dosiersistema Retumilo

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

    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.

  ### Sugesto

  La URL eniro havas dosierujon aŭtomaten. La kompletiga metodo povas esti agordita uzante la musbutono dekstra 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
La Listo de Dokumentoj

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

Vido → Antaŭa Dokumento (Alt+Up)

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

Vido → Sekva Dokumento (Alt+Down)

  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 musbutono dekstra 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
GDB Konekti

## GDB Konekti

Martin Gergov

T.C. Hollingsworth `<tchollingsworth@gmail.com>`

### Enkonduko

la GDB de Kate kromaĵo provizas simplan fasadon al la populara GNU Projekta Erarserĉilo.

### Grava

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.

### Sugesto

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 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 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 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 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 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
Projekta Kromprogramoo

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

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:

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

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

#### 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 Projektoj → Iri Al (Alt+1) vi povas malfermi la vidon Aktuala Projekto ĉe la malsupro de la redaktora fenestro kun kvar langetoj:

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

Projektoj → Reen (Ctrl+Alt+Left)

  Ŝanĝi al la antaŭa projekto.

Projektoj → Antaŭen (Ctrl+Alt+Right)

  Ŝanĝi al la sekvanta projekto.

Projektoj → Iri Al (Alt+1)

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

LSP-Klienta Kromaĵo
LSP-Klienta Kromaĵo

## 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 (ekz. 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, ekz. `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 (ekz. `.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
Serĉi & Anstataŭigi

## Serĉi & Anstataŭigi

T.C. Hollingsworth `<tchollingsworth@gmail.com>`

### 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 Enigu 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 Enigu 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 Operacisistemo. Ĉ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.

  ### Averto

  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

Redakti → Serĉi en dosieroj (Ctrl+Alt+F)

  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
Kate Fragmentoj

## Kate Fragmentoj

Martin Gergov

T.C. Hollingsworth `<tchollingsworth@gmail.com>`

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

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.

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 Majuskligo dum aldonado de tipoj.

#### Krei kaj Redakti Pecetojn

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

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+Spaceto, 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 Tab 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
Kromaĵo por klavaraj makrooj

## Kromaĵo por klavaraj makrooj

Pablo Rauzy `<r .at. uzy.me>`

### Enkonduko

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

### Baza uzado

#### Por komenci registri klavaran makroon:

Iloj → Klavaraj makrooj → Registri makroon... (Ctrl+Majuskligo+K).

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

#### Por fini registradon:

Iloj → Klavaraj makrooj → Finigi makroregistradon (Ctrl+Majuskligo+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+Majuskligo+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+Majuskligo+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
SQL Kromaĵo

## SQL Kromaĵo

Ömer Faruk ORUÇ

T.C. Hollingsworth `<tchollingsworth@gmail.com>`

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

Ekzemplo 4.1. 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 4.2. 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.

SQL → Ruli konsulton (Ctrl+E)

  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
Simbolo Viewer Kromaĵo

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

Vido → Ilaj Vidoj → Montri Simbolliston (Ctrl+\)

  Baskuligi la montradon de la Simbollisto de Kate montranta Funkciojn, Makroojn kaj Strukturojn de la fontkodo en la aktiva dokumento.

### Agordo

Elektu la defaŭltajn analizajn opciojn

Terminala Ilovida Kromprogramo
Terminala Ilovida Kromprogramo

## 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 musbutono dekstra 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 la sekcio nomata “Agordo” 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, ekz. vim. Aldonu tiajn aplikaĵojn en la tekst-eniga skatolo sube. La eroj en la listo estu apartigitaj per komo.

Tekstfiltrila Kromprogramo
Tekstfiltrila Kromprogramo

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

Iloj → Filtrilo de teksto (Ctrl+\)

  Malfermas la dialogon 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
XML Valido

## XML Valido

Daniel Naber `<daniel.naber@t-online.de>`

Ĉ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, ekz. 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 AT t-online.de)`.

Dokumenta kopirajto 2002 Daniel Naber

XML Kompletigo
XML Kompletigo

## XML Kompletigo

Daniel Naber `<daniel.naber@t-online.de>`

Ĉ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 (ekz. ĉ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 (ekz. “<html>”).

</(malpli-ol klavo + oblikvo)

  Enigi ĉi tiujn signojn proponos fermi la nunan elementon (plej proksima malfermita maldekstre de la kursoro). Premu Enigu 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

XML → Enmeti Elementon... (Ctrl+Enigu)

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

XML → Fermi Elementon (Ctrl+<)

  Ĉ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 AT t-online.de)`.

KDE SC-4 versio kopirajto 2010 Tomáš Trnka

Dokumenta kopirajto 2001,2002 Daniel Naber

Ĉapitro 5. Altnivelaj Redaktaj Iloj
Altnivelaj Redaktaj Iloj

# Ĉapitro 5. Altnivelaj Redaktaj Iloj

Por informoj pri la altnivelaj redaktaj iloj inkluzivitaj kun Kate, vidu la ĉapitron Altnivelaj redaktaj iloj de la KatePart-Manlibro.

Ĉapitro 6. Etendante Kate
Etendante Kate

# Ĉapitro 6. Etendante Kate

T.C. Hollingsworth `<tchollingsworth@gmail.com>`

Translation: Oliver Kellogg

## Enkonduko

Kiel ajna altnivela tekstredaktilo, Kate proponas diversajn manierojn etendi ĝian funkciecon. Vi povas skribi simplajn skriptojn por aldoni funkciojn per JavaScript aŭ aldoni eĉ pli da funkcioj al la redaktilo mem per Kate Aplikaj Kromaĵoj skribitaj en C++. Fine, post kiam vi etendis Kate, vi bonvenas aliĝi al ni kaj kunhavigi viajn plibonigojn kun la mondo!

Laborante kun Syntax Highlighting
Laborante kun Syntax Highlighting

## Laborante kun Syntax Highlighting

Por informoj pri aldono aŭ modifo de sintaksaj emfazado de difinoj, vidu la sekcion Labori kun sintaksa reliefigo de la Disvolva ĉapitro de la KatePart-Manlibro.

Skripto per JavaScript
Skripto per JavaScript

## Skripto per JavaScript

Por informoj pri skripto per JavaScript, vidu la Skriptoj per JavaScript sekcio de la Disvolva ĉapitro de la KatePart Manlibro.

Kate (C++) Aplikaj Kromaĵoj
Kate (C++) Aplikaj Kromaĵoj

## Kate (C++) Aplikaj Kromaĵoj

Kate Aplikaj kromprogramoj etendas la funkciojn de la Kate redaktilo mem iel ajn vi povas imagi, uzante la saman programlingvon Kate estas skribita en, C++.

Por komenci, vidu la Skribi Kate-Plugin lernilon en la Kate retejo.

Ĉapitro 7. La VI Eniga Reĝimo
La VI Eniga Reĝimo

# Ĉapitro 7. La VI Eniga Reĝimo

Por informoj pri la VI-enigreĝimo de Kate, vidu la ĉapitron VI-enigreĝimo de la KatePart-Manlibro.

Ĉapitro 8. La Menu-Enskriboj
La Menu-Enskriboj

# Ĉapitro 8. La Menu-Enskriboj

## La Dosier-Menuo

Dosiero → Nova (Ctrl+N)

  Ĉi tiu komando komencas novan dokumenton en la redakta fenestro. En la listo Dokumentoj maldekstre la nova dosiero nomiĝas Sentitola.

Dosiero → Malfermi... (Ctrl+O)

  Montras norman KDE dialogo Malfermi Dosieron. Uzu la dosieron por elekti la dosieron, kiun vi volas malfermi, kaj alklaku Malfermi por malfermi ĝin.

Dosiero → Malfermi Lastatempan

  Ĉi tio estas ŝparvojo por malfermi lastatempe konservitajn dokumentojn. Alklakante ĉi tiun eron malfermas liston flanke de la menuo kun pluraj el la plej lastatempe konservitaj dosieroj. Klako sur specifa dosiero malfermos ĝin en tiu ĉi aplikaĵo - se la dosiero ankoraŭ loĝas en la sama loko.

Dosiero → Malfermi Per

  Ĉi tiu submenuo prezentas liston de aplikaĵoj konataj pritrakti la MIME-tipo de via nuna dokumento. Aktivigi eniron malfermos la nunan dokumenton kun tiu aplikaĵo.

  Krome, enskribo Aliaj... lanĉas la malferman kun dialogujo, kiu ebligas al vi elekti alian aplikaĵon por malfermi la aktivan dosieron. Via dosiero ankoraŭ estos malfermita en Kate.

Dosiero → Konservi (Ctrl+S)

  Ĉi tio konservas la nunan dokumenton. Se jam okazis konservado de la dokumento, tiam ĉi tio anstataŭigos la antaŭe konservitan dosieron sen peti la konsenton de la uzanto. Se ĝi estas la unua konservado de nova dokumento la konservi kiel dialogo (priskribita malsupre) estos alvokita.

Dosiero → Konservi kiel... (Ctrl+Majuskligo+S)

  Ĉi tio permesas konservi dokumenton kun nova dosiernomo. Ĉi tio estas farita per la dosiera dialogkesto priskribita supre en la sekcio Malfermi de ĉi tiu helpdosiero.

Dosiero → Konservi kiel kun kodado

  Konservu dokumenton kun nova dosiernomo en malsama kodigo.

Dosiero → Konservi kopion kiel

  Konservu kopion de la dokumento kun nova dosiernomo kaj daŭrigu redakti la originalan dokumenton.

Dosiero → Konservi Ĉion (Ctrl+L)

  Ĉi tiu komando konservas ĉiujn modifitajn malfermitajn dosierojn.

Dosiero → Reŝargi (F5)

  Reŝargas la aktivan dosieron de disko. Ĉi tiu komando estas utila se alia programo aŭ procezo ŝanĝis la dosieron dum vi havas ĝin malfermita en tiu ĉi aplikaĵo.

Dosiero → Reŝargi ĉion

  Reŝargas ĉiujn malfermitajn dosierojn..

Dosiero → Presi... (Ctrl+P)

  Malfermas simplan presan dialogon permesantan al la uzanto specifi kion, kie kaj kiel presi.

Dosiero → Eksporti kiel HTML

  Konservu la nuntempe malfermitan dokumenton kiel HTML-dosiero, kiu estos formatita per la nuna sintaksa reliefigo kaj kolorskemo-agordoj.

Dosiero → Fermi (Ctrl+W)

  Fermu la aktivan dosieron per ĉi tiu komando. Se vi faris nekonservitajn ŝanĝojn, oni petos vin konservi la dosieron antaŭ Kate fermas ĝin.

Dosiero → Fermi Aliajn

  Fermu aliajn malfermitajn dokumentojn.

Dosiero → Fermi ĉion

  Ĉi tiu komando fermas ĉiujn dosierojn, kiujn vi havas malfermitaj en Kate.

Dosiero → Fermi Orfon

  Fermu ĉiujn dokumentojn en la dosierlisto, kiuj ne eblis remalfermi dum lanĉo, ĉar ili ne plu estas alireblaj.

Dosiero → Eliri (Ctrl+Q)

  Ĉi tiu komando fermas Kate kaj iujn ajn dosierojn, kiujn vi redaktis. Se vi faris nekonservitajn ŝanĝojn al iu el la dosieroj, kiujn vi redaktis, oni petos vin konservi ilin.

La Redakta Menuo
La Redakta Menuo

## La Redakta Menuo

Redakti → Malfari (Ctrl+Z)

  Malfaru la lastan redaktan komandon (tajpi, kopii, tranĉi ktp.)

  ### Rimarko

  Ĉi tio povas malfari plurajn redaktajn komandojn de la sama tipo, kiel tajpi signojn.

Redakti → Refari (Ctrl+Majuskligo+Z)

  Ĉi tio inversigos la plej lastatempan ŝanĝon (se ekzistas) faritan per Malfari.

Redakti → Tranĉi (Ctrl+X)

  Ĉi tiu komando forigas la nunan elekton kaj metas ĝin en la tondujo. La tondujo funkcias nevideble kaj provizas manieron transdoni datumojn inter aplikaĵoj.

Redakti → Kopii (Ctrl+C)

  Ĉi tio kopias la aktuale elektitan tekston al la tondujo por ke ĝi estu algluita aliloke. La tondujo funkcias nevideble kaj provizas manieron transdoni datumojn inter aplikaĵoj.

Redakti → Alglui (Ctrl+V)

  Ĉi tio enigos la unuan eron en la tondujo ĉe la kursora pozicio. La tondujo funkcias nevideble kaj provizas manieron transdoni datumojn inter aplikaĵoj.

  ### Rimarko

  Se Anstataŭigi Elekton estas ebligita, la algluita teksto anstataŭigos la elekton, se ekzistas.

Redakti → Alglui elekton (Ctrl+Majuskligo+Ins)

  Ĉi tio algluos la enhavon de muselekto, kiuj antaŭe estis elektitaj. Marku iun tekston per la musmontrilo por alglui ĝin en la nun malfermitan dosieron uzante ĉi tiun menueron.

Redakti → Interŝanĝi kun enhavo de tondujo

  Ĉi tio interŝanĝos la elektitan tekston kun la enhavo de clipboard.

Redakti → Historio de la tondujo

  Ĉi tiu submenuo montros la komencon de partoj de teksto lastatempe kopiitaj al la tondujo. Elektu eron el ĉi tiu menuo por alglui ĝin en la nun malfermitan dosieron.

Redakti → Kopii kiel HTML

  Kopiu la elekton kiel HTML, formatitan per la nuna sintaksa reliefigo kaj kolorskemo agordojn.

Redakti → Elektu ĉion (Ctrl+A)

  Ĉi tio elektos la tutan dokumenton. Ĉi tio povus esti tre utila por kopii la tutan dosieron al alia aplikaĵo.

Redakti → Malelekto (Ctrl+Majuskligo+A)

  Malelektas la elektitan tekston en la redaktilo se ekzistas.

Redakti → Bloki Elektan Reĝimon (Ctrl+Majuskligo+B)

  Ŝaltas Elektan Reĝimon. Kiam la Elekta Reĝimo estas BLOKI, la statusbreto enhavas la ĉenon [BLOKI] kaj vi povas fari vertikalajn elektojn, ekz. elektu kolumnon 5 ĝis 10 en linioj 9 ĝis 15.

Redakti → Enigareĝimoj

  Ŝanĝu inter normala kaj vi-simila, modala redakta reĝimo. La vi-eniga reĝimo subtenas la plej uzatajn komandojn kaj movojn de la normala kaj vida reĝimo de vim kaj havas laŭvolan vi-reĝiman statusbreton. Ĉi tiu statusbreto montras komandojn dum ili estas enigitaj, eligo de komandoj kaj la nuna reĝimo. La konduto de ĉi tiu reĝimo povas esti agordita en la sekcio Vi Enigo de la paĝo Redaktado en la agorda dialogo de tiu ĉi aplikaĵo.

Redakti → Anstataŭigi reĝimon (Ins)

  Ŝaltas la Enmeti/Anstataŭigi reĝimojn. Kiam la reĝimo estas INS, vi enmetas signojn kie estas la kursoro. Kiam la reĝimo estas OVR, skribi signojn anstataŭigos la nunajn signojn se via kursoro estas poziciigita antaŭ iu signo. La statusbreto montras la nunan staton de la Anstataŭiga Reĝimo, ĉu INS aŭ OVR.

Redakti → Trovi... (Ctrl+F)

  Ĉi tio malfermas la pliigan serĉbreton ĉe la malsupro de la redaktila fenestro. Sur la maldekstra flanko de la breto estas butono kun piktogramo por fermi la breton, sekvita de malgranda tekstujo por enigi la serĉan ŝablonon.

  Kiam vi komencas enigi signojn de via serĉŝablono, la serĉo komenciĝas tuj. Se estas kongruo en la teksto, ĉi tio estas emfazita kaj la fonkoloro de la enirkampo ŝanĝiĝas al helverda. Se la serĉŝablono ne kongruas kun iu ajn ĉeno en la teksto, tio estas indikita per helruĝa fonkoloro de la enirkampo.

  Uzu la aŭ butono por salti al la sekva aŭ antaŭa kongruo en la dokumento.

  Kongruoj en la dokumento estas emfazitaj eĉ kiam vi fermas la serĉbreton. Por forigi ĉi tiun reliefigon, premu la Esc-klavon.

  Vi povas elekti ĉu la serĉo distingu usklecon. Elektante limigos trovaĵojn al enskriboj kiuj kongruas kun la uskleco (majuskla aŭ minuskla) de ĉiu el la signoj en la serĉŝablono.

  Alklaku la butonon ĉe la dekstra flanko de la pliiga serĉo stango por ŝanĝi al la potenca serĉo kaj anstataŭigi stango.

Redakti → Trovi Variaĵojn → Trovi Sekva (F3)

  Ĉi tio ripetas la lastan trovoperacion, se ekzistas, sen voki la pliigan serĉbreton, kaj serĉante antaŭen tra la dokumento komencante de la kursora pozicio.

Redakti → Trovi Variaĵojn → Trovi Antaŭan (Majuskligo+F3)

  Ĉi tio ripetas la lastan trovan operacion, se ekzistas, sen voki la pliigan serĉbreton, kaj serĉante malantaŭen anstataŭ antaŭen tra la dokumento.

Redakti → Trovi Variaĵojn → Trovi Elektitajn (Ctrl+H)

  Trovas sekvan aperon de elektita teksto.

Redakti → Trovi Variaĵojn → Trovi Elektitajn Malantaŭen (Ctrl+Majuskligo+H)

  Trovas antaŭan aperon de elektita teksto.

Redakti → Anstataŭigi... (Ctrl+R)

  Ĉi tiu komando malfermas la elektran serĉon kaj anstataŭigon. Sur la supra maldekstra flanko de la breto estas butono kun piktogramo por fermi la breton, sekvata de malgranda tekstujo por enigi la serĉan ŝablonon.

  Vi povas kontroli la serĉreĝimon elektante Plan tekston, Tutaj vortoj, Eskapaj sekvencoj aŭ Regula esprimo el la guto malsupren skatolo.

  Se estas elektitaj Eskapaj sekvencoj aŭ Regula esprimo, la menuero Aldoni... ĉe la malsupro de la kunteksta menuo de la tekstkestoj estos ebligita. kaj permesas al vi aldoni eskapsekvencojn aŭ regulajn esprimojn al la serĉo aŭ anstataŭigi ŝablonon el antaŭdifinitaj listoj.

  Uzu la aŭ butono por salti al la sekva aŭ antaŭa kongruo en la dokumento.

  Enigu la tekston por anstataŭigi en la tekstujon kun la etikedo Anstataŭigi kaj alklaku la butonon Anstataŭigi por anstataŭigi nur la emfazitan tekston aŭ la butonon Anstataŭigi Ĉion por anstataŭigu la serĉtekston en la tuta dokumento.

  Vi povas modifi la serĉon kaj anstataŭigi konduton elektante malsamajn opciojn ĉe la malsupro de la stango. Elektante limigos trovaĵojn al enskriboj kiuj kongruas kun la majusklo. (supra aŭ malsupra) de ĉiu el la signoj en la serĉŝablono. serĉos kaj anstataŭigos nur ene de la nuna elekto. La butono Trovi Ĉiujn elstarigas ĉiujn kongruojn en la dokumento kaj montras la nombron da trovitaj kongruoj en malgranda ŝprucfenestro.

  Alklaku la butonon ĉe la dekstra flanko de la potenca serĉo kaj anstataŭigu breton por ŝanĝi al la pliiga serĉbreto.

Redakti → Iri Al → Iri al Kongrua Krampo (Ctrl+6)

  Movi la kursoron al la rilata malferma aŭ ferma krampo.

Redakti → Iri al → Elekti ĝis Kongrua Krampo (Ctrl+Majuskligo+6)

  Elektas la tekston inter rilataj malfermaj kaj fermaj krampoj.

Redakti → Iri Al → Iri al Antaŭa Modifita Linio

  Linioj kiuj estis ŝanĝitaj ekde la malfermo de la dosiero estas nomitaj modifitaj linioj. Ĉi tiu ago saltas la antaŭan modifitan linion.

Redakti → Iri Al → Iri al Sekva Modifita Linio

  Linioj kiuj estis ŝanĝitaj ekde la malfermo de la dosiero estas nomitaj modifitaj linioj. Ĉi tiu ago saltas la sekvan modifitan linion.

Redakti → Iri Al → Iri al Linio... (Ctrl+G)

  Ĉi tio malfermas la goto-linibreton ĉe la fundo de la fenestro, kiu estas uzata por ke la kursoro saltu al aparta linio (specifita per nombro) en la dokumento. La linionumero povas esti enigita rekte en la tekstkeston aŭ grafike alklakante la supren aŭ malsupren-spinajn kontrolojn ĉe la flanko de la tekstkesto. La eta sago supren pliigos la linionumeron kaj la malsupren sago malpliigos ĝin. Fermu la breton per klako sur la butono kun piktogramo sur la maldekstra flanko de la breto.

La Vida Menuo
La Vida Menuo

## La Vida Menuo

Vido → Nova Fenestro

  Malfermas alian ekzemplon de Kate. La nova kazo estos identa al via antaŭa kazo.

Vido → Sekva langeto (Alt+Right)

  Aktivigas la sekvan langeton en la langeto.

Vido → Antaŭa langeto (Alt+Left)

  Aktivigas la antaŭan langeton en la langeto.

Vido → Rapida Malfermo (Ctrl+Alt+O)

  Montri serĉkampon kaj liston de malfermitaj dosieroj en la redaktilo. Dum enigo de teksto en la serĉkampo la dokumentoj nomoj kaj dokumentoj estas serĉataj por kongrua teksto. Dum enigo de teksto en la serĉkampo vi povas uzi la kursorajn klavojn Up kaj Down por navigi en la listvido. Premante la Enigu klavo aŭ duobla klako sur ero en la listo ŝanĝas la vidon al la dokumento elektita en la listo. Ĉi tio faciligas ŝanĝi inter dokumentoj, se estas multaj malfermitaj.

  Ĉi tiu ago disponeblas ankaŭ per la piktogramo supre dekstre de la redaktilo fenestro.

Vido → Dividi Vidon → Antaŭa Split View (Majuskligo+F8)

  Fokusi la antaŭan dokumentan vidon, se vi dividis la redaktan areon en pliaj vidoj.

Vido → Dividita Vido → Sekva Divida Vido (F8)

  Fokusi la sekvan dokumentan vidon, se vi dividis la redaktan areon en pliaj vidoj.

Vido → Dividita vido → Maldekstre dividita vido

  Fokusi la disigitan vidon intuicie maldekstre, uzante la kursoron por malambiguigi se necese.

Vido → Divida vido → Dekstra divida vido

  Foku la dividitan vidon intuicie dekstren, uzante la kursoran pozicion por malambiguigi se necese.

Vido → Divida Vido → Suprena Divida Vido

  Fokusi la dividitan vidon intuicie supren, uzante la kursoran pozicion por malambiguigi se necese.

Vido → Dividita vido → Malsupren dividita vido

  Fokusi la dividitan vidon intuicie malsupren, uzante la kursoran pozicion por malambiguigi se necese.

Vido → Dividi Vidon → Disigi Vertikalon (Ctrl+Majuskligo+L)

  Ĉi tio dividos la kadron (kiu povas esti la ĉefa redakta areo) en du samgrandaj kadroj, la nova maldekstre de la nuna. La nova kadro ricevas la fokuson, kaj montros la saman dokumenton kiel la malnova.

  Vidu ankaŭ Laborado kun la Kate MDI.

Vido → Dividi Vidon → Disigi Horizontale (Ctrl+Majuskligo+T)

  Dividas la nunan kadron (kiu povas esti la ĉefa redakta areo) en du samgrandaj kadroj, la nova sub la nuna. La nova kadro ricevas la fokuson, kaj montras la saman dokumenton kiel la malnova.

  Vidu ankaŭ Laborado kun la Kate MDI

Vido → Dividi Vidon → Movi Dokumenton al Nova Vertikala Divido

  Ĉi tio dividos la nuntempe aktivan vidon vertikale en du vidojn kaj movos la nuntempe aktivan dokumenton al dekstra vido.

  Vidu ankaŭ Laborado kun la Kate MDI.

Vido → Dividi Vidon → Movi Dokumenton al Nova Horizontala Divido

  Ĉi tio dividos la nuntempe aktivan vidon horizontale en du vidojn kaj movos la nuntempe aktivan dokumenton por vidi sube.

  Vidu ankaŭ Laborado kun la Kate MDI

Vido → Dividi Vidon → Ŝalti orientiĝon

  Ŝalti inter horizontala kaj vertikala disigo.

Vido → Dividi Vidon → Fermi Aktualan Vidon (Ctrl+Majuskligo+R)

  Fermas la aktivan kadron, kiu povas esti identigita kiel tiu montranta palpebruman kursoron. Ĉi tio estas malŝaltita, se estas nur unu kadro (la ĉefa redakta areo).

  Neniuj dokumentoj estas fermitaj per fermo de kadro – ili ankoraŭ estos disponeblaj en la Vido Menuo same kiel en la Dosiera Listo.

  Vidu ankaŭ Laborado kun la Kate MDI

Vido → Dividi Vidon → Fermi Neaktivajn Vidojn

  Fermas ĉiujn kadrojn krom la aktiva kadro (tiu kun palpebruma kursoro). Ĉi tio estas malŝaltita, se estas nur unu kadro (la ĉefa redakta areo).

  Neniuj dokumentoj estas fermitaj per fermo de kadro – ili ankoraŭ estos disponeblaj en la Vido Menuo same kiel en la Dosiera Listo.

Vido → Dividi Vidon → Kaŝi Neaktivajn Vidojn

  Ĉi tio kaŝas ĉiujn dividitajn vidojn krom la nuntempe aktiva.

Vido → Dividi Vidon → Movi disigilon maldekstren

  Kiam Split View estas ebligita, ĉi tio movos la bordon inter du vertikale dividitaj dokumentoj pli maldekstren.

Vido → Dividita vido → Movi disigilon dekstren

  Kiam Split View estas ebligita, ĉi tio movos la bordon inter du vertikale dividitaj dokumentoj pli dekstren.

Vido → Dividita Vidon → Movi disigilon supren

  Kiam Split View estas ebligita, ĉi tio movos la bordon inter du horizontale dividitaj dokumentoj pli supre.

Vido → Dividita vido → Movi disigilon malsupren

  Kiam Split View estas ebligita, ĉi tio movos la bordon inter du horizontale dividitaj dokumentoj pli sube.

### Rimarko

Iuj oftaj agoj en la menuo Vido Dividita estas disponeblaj uzante la butono ĉe la supra dekstra angulo de la fenestro de la redaktilo

Vido → Vidoj de iloj
  Vido → Ilaj Vidoj → Montri Flankmenuojn (Ctrl+Alt+Majuskligo+F)

    Ŝaltas la ekranon de la flankaj butonvicoj. Ĉi tiu komando ne influas la montradon de la flankaj enhavaj fenestraĵoj, ajna flanka kolumno kiu estas videbla restos videbla, kaj se vi asignis ŝparvojojn al la subaj komandoj, tiuj kompreneble daŭre funkcios.

  Vido → Vidoj de iloj → Montri `Aldonaĵo`

    Listo de ĉiuj ebligitaj kromprogramoj. Uzu la markobutonon antaŭ ĉiu elemento por ŝanĝi la ekranon de la ila vido.

Vido → Ŝanĝi al komandlinio (F7)

  Ĉi tiu komando malŝaltos la montradon de la enkonstruita komandlinio.

Vido → Pligrandigi tiparon (Ctrl++)

  Ĉi tio pliigas la montran tiparon.

Vido → Malgrandigi tiparon (Ctrl+-)

  Ĉi tio malpliigas la montran tiparon.

Vido → Skemo

  Ĉi tiu menuo listigas la disponeblajn kolorskemojn. Vi povas ŝanĝi la skemon por la nuna vido ĉi tie, por ŝanĝi la defaŭltan skemon vi devas uzi la Tiparoj & Koloroj paĝo de la agorda dialogo.

Vido → Vortvolvaĵo → Dinamika Vortvolvaĵo (F10)

  Ŝaltas dinamikan vortvolvaĵon en la nuna vido. Dinamika vortvolvado igas la tutan tekston en vido videbla sen la bezono de horizontala movo per bildigo de unu reala linio sur pli vidaj linioj laŭbezone.

Vido → Vortvolvaĵo → Dinamikaj Vortvolvaĵo-Indikiloj

  Elektu kiam kaj kiel la dinamikaj vortvolvaj indikiloj estu montrataj. Ĉi tio disponeblas nur se la opcio Dinamika Vortvolviĝo estas markita.

Vido → Vortvolvaĵo → Montri Senmovan Vortvolvaĵmarkon

  Ŝaltas la montradon de vertikala linio indikanta la pozicion de la envolvaĵlarĝo kiel agordita en la agorda dialogo. Ĉi tiu funkcio postulas, ke vi uzu veran fikslarĝan tiparon.

Vido → Borderoj → Montri Piktograman Borderon (F6)

  Ĉi tio estas baskulo. Agordi ĝin ĉe markita faros la Piktograman Borderon videbla en la maldekstra flanko de la aktiva redaktilo, kaj inverse. La Piktograma Bordero indikas la poziciojn de la markitaj linioj en la redaktilo.

Vido → Borderoj → Montri Linionombrojn (F11)

  Ĉi tio estas ŝaltilo. Agordi ĝin ĉe markita igos panelon montrantan la linionumeroj de la dokumento videblaj en la maldekstra rando de la aktiva redaktilo, kaj inverse.

Vido → Borderoj → Montri Rulumbretajn Markilojn

  Baskuligas la bildigon de legosignoj (kaj aliaj markoj) sur la vertikala rulumbreto. Kiam ĝi estas ebligita, marko estas reprezentita per maldika linio en la markokoloro ĉe la rulumbreto, alklakante la musbutono meza sur la linio rulumos la vidon al pozicio proksime de la marko.

Vido → Borderoj → Montri Rulumbretan Mini-Mapon

  Ĉi tio anstataŭigos la rulumbreton per bildigo de la nuna dokumento. Por pliaj informoj pri la rulumbrea minimapo, vidu la sekcion Scrollbar Minimap de la KatePart Manlibro.

Vido → Kodfaldado

  Ĉi tiuj opcioj rilatas al kodfaldado:

  Montri faldeblajn markilojn (F9)

    Ŝaltas la ekranon de la faldebla markilo en la maldekstra flanko de la vido.

  Faldi Aktualan Nodon

    Malvastigi la regionon, kiu enhavas la kursoron.

  Malfaldi Nuna Nodo

    Vastigi la regionon, kiu enhavas la kursoron.

  Faldi Supranivelajn Nodojn (Ctrl+Majuskligo+-)

    Malvastigi ĉiujn altnivelajn regionojn en la dokumento. Klaku sur la dekstra indika triangulo por vastigi ĉiujn altnivelajn regionojn.

  Disfaldi Supranivelajn Nodojn (Ctrl+Majuskligo++)

    Vastigi ĉiujn altnivelajn regionojn en la dokumento.

Montri Ne-Preseblajn Spacojn

  Montri/kaŝi limkeston ĉirkaŭ nepreseblaj spacoj.

La Legosignoj-Menuo
La Legosignoj-Menuo

## La Legosignoj-Menuo

Sub la enskriboj priskribitaj ĉi tie, unu enskribo por ĉiu legosigno en la aktiva dokumento estos disponebla. La teksto estos la unuaj vortoj de la markita linio. Elektu eron por movi la kursoron al la komenco de tiu linio. La redaktilo rulumos laŭbezone por ke tiu linio videbla.

Legosignoj → Meti Legosignon (Ctrl+B)

  Agordas aŭ forigas legosignon en la nuna linio de la aktiva dokumento. (Se ĝi estas tie, ĝi estas forigita, alie unu estas starigita.)

Legosignoj → Forviŝi ĉiujn legosignojn

  Ĉi tiu komando forigos ĉiujn markilojn de la dokumento kaj ankaŭ la liston de markiloj, kiu estas almetita ĉe la malsupro de ĉi tiu menuero.

Legosignoj → Antaŭa (Alt+PgUp)

  Ĉi tio movos la kursoron al la komenco de la unua supra linio kun legosigno. La menuero teksto inkluzivos la linionumeron kaj la unuan pecon de teksto sur la linio. Ĉi tiu ero disponeblas nur kiam estas legosigno en linio super la kursoro.

Legosignoj → Sekva (Alt+PgDn)

  Ĉi tio movos la kursoron al la komenco de la sekva linio kun legosigno. La menuero teksto inkluzivos la linionumeron kaj la unuan pecon de teksto sur la linio. Ĉi tiu aĵo disponeblas nur kiam estas legosigno en linio sub la kursoro.

La Seancoj-Menuo
La Seancoj-Menuo

## La Seancoj-Menuo

Ĉi tiu menuo enhavas enskribojn por uzi kaj administri Kate seancoj. Por pliaj informoj, legu Uzado de Seancoj.

Seancoj → Novaj

  Kreas novan malplenan seancon. Ĉiuj nuntempe malfermitaj dosieroj estos fermitaj.

Seancoj → Malfermi Seancon...

  Malfermi ekzistantan seancon. La dialogo de Seanca Elektilo montriĝas por permesi al vi elekti unu.

Seancoj → Rapida Malferma Seanco

  Ĉi tiu submenuo permesas malfermi ekzistantan seancon.

Seancoj → Konservi seancon

  Konservi la nunan seancon. Se la seanco estas anonima, oni petos vin pri seanconomo.

Seancoj → Konservi Seancon kiel...

  Konservi la nunan seancon sub nova nomo. Oni petas vin pri nomo por uzi.

Seancoj → Administri Seancojn...

  Montras la dialogon de Seanca Administranto, kiu ebligas al vi renomi kaj forigi seancojn.

La Iloj-Menuo
La Iloj-Menuo

## La Iloj-Menuo

Iloj → Nurlega reĝimo

  Agordi la nunan dokumenton al Nurlega reĝimo. Ĉi tio malhelpas ajnan tekston aldonon kaj ajnajn ŝanĝojn en la dokumentformatado.

Iloj → Reĝimo

  Elektu la dosiertipskemon, kiun vi preferas por la aktiva dokumento. Ĉi tio anstataŭigas la ĉiean dosiertipo reĝimon fiksitan en Agordoj → Agordi Kate... en la langeto Dosiertipoj nur por via nuna dokumento.

Iloj → Elstarigado

  Elektu la Substrekigan skemon, kiun vi preferas por la aktiva dokumento. Ĉi tio anstataŭigas la ĉiean emfazan reĝimon fiksitan en Agordoj → Agordi Redaktilon... nur por via nuna dokumento.

Iloj → Indentaĵo

  Elektu la stilon de indentaĵo, kiun vi volas por via aktiva dokumento. Ĉi tio anstataŭigas la ĉiean indentreĝimon fiksitan en Agordoj → Agordi Redaktilon... nur por via nuna dokumento.

Iloj → Kodigo

  Vi povas anstataŭigi la defaŭltan kodigon en Agordoj → Agordi Redaktilon... en la paĝo Malfermu/Konservi por agordi malsama kodigo por via nuna dokumento. La kodado, kiun vi starigis ĉi tie, validos nur por via nuna dokumento.

Iloj → Fino de linio

  Elekti vian preferatan linioreĝimon por via aktiva dokumento. Ĉi tio anstataŭigas la ĉiean finlinian reĝimon fiksitan en Agordoj → Agordi Redaktilon... nur por via nuna dokumento.

Iloj → Aldoni Byte Mark Order (BOM)

  Kontrolante ĉi tiun agon, vi povas eksplicite aldoni bajtan ordomarkon por unikodaj koditaj dokumentoj. La bajta ordomarko (BOM) estas Unikoda signo uzata por signali la endianecon (bajto-ordo) de tekstdosiero aŭ fluo, por pliaj informoj vidu Byte Order Mark.

Iloj → Skriptoj

  Ĉi tiu submenuo enhavas liston de ĉiuj skribitaj agoj. La listo povas esti facile modifita per verkante viajn proprajn skriptojn. Tiel, Kate povas esti etendita per uzant-difinitaj iloj.

  Estas kompleta listo de skriptoj en la KatePart dokumentado.

Iloj → Alvoki Kodkompletigon (Ctrl+Spaceto)

  Mane alvoku komandkompletigon, kutime uzante mallongvojon ligitan al ĉi tiu ago.

Iloj → Vortkompletigo

  Reuzo Vorto Malsupre (Ctrl+9) kaj Reuzo Vorto Supre (Ctrl+8) kompletigas la nun tajpitan tekston serĉante similajn vortojn malantaŭen aŭ antaŭen de la nuna kursora pozicio. Ŝela Kompletigo ekaperas kompletigan skatolon kun kongruaj enskriboj.

Iloj → Literumo → Aŭtomata Literuma Kontrolo (Ctrl+Majuskligo+O)

  Kiam Aŭtomata Literuma Kontrolo estas ebligita, malĝuste literumita teksto estas substrekita en la dokumento tuj.

Iloj → Literumo → Literumo...

  Ĉi tio iniciatas la ortkontrolan programon - programon dizajnitan por helpi la uzanton kapti kaj korekti iujn ajn literumajn erarojn.

  Por pliaj informoj pri kiel uzi la KDE literuma programo, vidu la sekcion Kontroli Literumadon de la KDE Fundamentoj dokumentado.

Iloj → Literumo → Literumo (de kursoro)...

  Ĉi tio komencas la ortkontrolan programon sed ĝi komenciĝas kie estas via kursoro anstataŭ ĉe la komenco de la dokumento.

Iloj → Literumo → Literumokontrola Elekto...

  Literumkontrolas la nunan elekton.

Iloj → Literumo → Ŝanĝi Vortaron

  Montras falkeston kun ĉiuj disponeblaj vortaroj por literumkontrolo ĉe la malsupro de la redaktila fenestro. Tio ebligas facilan ŝanĝadon de la ortkontrola vortaro ekz. por aŭtomata literumkontrolo de teksto en diversaj lingvoj.

La Agordoj kaj Helpo-Menuo
La Agordoj kaj Helpo-Menuo

## La Agordoj kaj Helpo-Menuo

Kate havas la komunajn KDE Agordoj kaj Helpo menuerojn, por pliaj informoj legu la sekciojn pri la Agordoj Menuo kaj Helpo-Menuo de la KDE Fundamentoj kun ĉi tiuj kromaj enskriboj:

Agordoj → Kolora etoso

  Uzi malsaman kolorskemon de la ĉieaj kolorskemoj de la sistemo priskribitaj en la Sistemargordoj modulo Koloroj.

Agordoj → Montri langetojn

  Langetoj estas moveblaj uzante la musbutono maldekstra kaj havu agojn en la kunteksta menuo por fermi dokumentojn, kopii la vojon al la tondujo aŭ malfermi la dosierujon de la dokumento en la dosieradministranto. Uzante la Rapida Malfermo -butono faciligas ŝanĝi inter dokumentoj. Alklaku la per la butono musbutono maldekstra malfermi menuon kun agoj el la menuo Vido Dividi Vidon.

Agordoj → Montri Vojon en Titolobreto

  Se ebligita la plena vojo de la aktiva dokumento montriĝas, alie nur la dosiernomo. Ĉi tio estas utila se vi redaktas plurajn dosierojn kun la sama dosiernomo por distingi ilin.

Ĉapitro 9. Agordante Kate
Agordante Kate

# Ĉapitro 9. Agordante Kate

Anders Lund `<anders@alweb.dk>`

Translation: Oliver Kellogg

## Superrigardo

Kate proponas plurajn rimedojn por ĝustigi la aplikaĵon por konduti laŭdezire. La plej gravaj estas:

La Agorda Dialogo

  La ĉefa agorda ilo, permesanta al vi agordi la Kate aplikaĵo, la redaktilo-komponento kaj la uzado de kromaĵoj.

La menuo Agordoj

  Ebligas al vi ŝanĝi ofte uzatajn agordojn, kaj lanĉi la agordajn dialogojn.

La menuo Vidi

  Ebligas al vi disigi la nunan kadron, kaj ankaŭ montri la piktogramojn kaj linionumerfenestron por la nuntempe redaktita dokumento.

La enigita terminalo uzas la agordon difinitan en la Sistemargordoj, kaj ankaŭ povas esti agordita klakante la musbutono dekstra por montri kuntekstan menuon.

La Ĉefa Agorda Dialogo
La Ĉefa Agorda Dialogo

## La Ĉefa Agorda Dialogo

La Kate agorda dialogo montras arbon de temoj maldekstre, kaj agordan paĝon respondan al la elektita temo dekstre.

La agordo estas dividita en du grupojn, nome:

- Aplika agordo

- Agordo de komponantoj de la redaktilo

La Kate Aplika Agordo
La Kate Aplika Agordo

## La Kate Aplika Agordo

Ĉi tiu grupo enhavas paĝojn por agordi la ĉefan Kate aplikaĵo

### Ĝeneralo

Ĉi tiu sekcio enhavas kelkajn ĉieajn eblojn por Kate

Konduto
  Malfermi ĉiun dokumenton en sia propra fenestro

    Se ĝi estas ebligita, ĉiu dokumento estos malfermita en sia propra fenestro. Se ne estas ebligita, ĉiu dokumento estos malfermita en nova langeto en la nuna fenestro.

  Ŝalti al eligvido laŭ mesaĝtipo

    Ĉi tiu opcio permesas agordi kiam Kate devus montri eligpanelon depende de la speco de agoproduktaĵo.

    Eblas elekti inter Neniam, Eraro (pro eraro), Averto (pri averto aŭ supre), Informo (pri info aŭ supre), kaj Protokolo (sur protokolo aŭ supre).

  Uzi apartan dialogon por trakti ekstere modifitajn dosierojn

    Kiam estas ebligita, Kate sciigos vin per modala dialogo pri ĉiuj dosieroj modifitaj de ekster la aplikaĵo kiam ajn la ĉefa fenestro ricevas enigfokuson. Vi povos trakti plurajn modifitajn dosierojn samtempe, vi povas reŝargi, konservi aŭ forĵeti ŝanĝitajn dosierojn en grupoj.

    Se ne estas ebligita, Kate individue demandos vin kion fari por ĉiu modifita dosiero nur kiam la vido de tiu dosiero ricevas fokuson.

Rapida Malfermo
  Kongrua Reĝimo

    Agordu la listreĝimon por la ilo Rapida Malfermo. La dosieroj povas esti egalitaj laŭ sia nomo aŭ laŭ sia vojo.

  Listo-Reĝimo

    Agordu la listreĝimon por la ilo Rapida Malfermo. Eblas elekti el Nuntempaj Projektaj Dosieroj kaj Ĉiuj Projektaj Dosieroj.

Langetoj
  Limigi nombron da langetoj

    Agordu la maksimuman nombron da langetoj. Elektu Senlima se vi ne volas limigi ĉi tiun numeron.

  Aŭtomate kaŝi langetojn

    Kiam kontrolitaj langetoj estos kaŝitaj se nur unu dokumento estas malfermita.

  Montri fermbutonon

    Kiam estas kontrolita, ĉiu langeto montros fermbutonon.

  Vastigi langetojn

    Kiam kontrolitaj langetoj prenas tiom da grandeco kiel eble.

  Duobla klako malfermas novan dokumenton

    Se kontrolita duobla klako malfermas novan dokumenton.

  Meza klako fermas dokumenton

    Se kontrolite mezklako fermas dokumenton.

  Permesi langeton movi

    Kiam ĝi estas markita, ĉi tio permesos rulumi en langetobreto kiam nombro da langetoj estas granda.

  Preterlasi langetotekston

    Kiam ĝi estas kontrolita, klapeta teksto povus esti forigita se ĝi estas tro longa.

Langetoj
  Malantaŭen butono premita

    Permesas elekti la musan malantaŭan butonan agon inter la Antaŭa langeto kaj la eroj Historio reen.

  Antaŭen butonon premita

    Permesas elekti la butonan agon de muso antaŭen inter la Sekva langeto kaj la eroj Historio antaŭen.

### Seanco

Ĉi tiu sekcio enhavas opciojn rilate al uzado de seancoj.

Aplika Komenca Konduto

  Elektu kiel vi volas ke Kate kondutu ĉe ekfunkciigo. Ĉi tiu agordo povas esti anstataŭita specifante kion fari sur la komandlinio.

  Komenci novan sesion

    Kun ĉi tiu opcio, Kate komencos novan, nenomitan seancon kiam vi komencos la aplikaĵon.

  Ŝargi la laste uzatan seancon

    Kate uzos la plej lastatempe malfermitan seancon ĉe ekfunkciigo. Ĉi tio estas bona se vi volas uzi la saman seancon ĉiam aŭ ŝanĝi malofte.

  Mane elekti seancon

    Kate montros malgrandan dialogon, kiu ebligas al vi elekti vian preferatan seancon, aŭ ŝargi la defaŭltan seancon se neniu estis konservita. Ĉi tiu estas la defaŭlta konduto. Bone se vi uzas multajn malsamajn seancojn ofte.

Konduto de Ekfunkciigo/Ĉaltiga aplikaĵo

  Elektu kiel vi volas ke Kate kondutu ĉe ĉesigo. Eblas difini kion Kate devus Aŭtomate konservi kaj restarigi.

  Lastatempe kreitaj nekonservitaj dosieroj

    Kun ĉi tiu ero kontrolita, Kate aŭtomate konservos ĉiujn ĵus kreitajn nekonservitajn dosierojn.

  Dosieroj kun nekonservitaj ŝanĝoj

    Ĉi tiu ero permesas agordi Kate por aŭtomate konservi ĉiujn dosierojn kun nekonservitaj ŝanĝoj ĉe malŝalto.

  Fermi Kate tute kiam la lasta dosiero estas fermita

    Se ebligita, Kate fermiĝos kiam la lasta redaktita dosiero estas fermita, alie malplena paĝo malfermos por ke vi povu komenci novan dosieron.

Seancaj Elementoj
  Inkluzivi fenestran agordon

    Se ebligita, Kate konservos la fenestran agordon kun ĉiu seanco.

Konservi meta-informojn preter seancoj

  Kiam estas ebligita, Kate konservos metadatumojn kiel legosignojn kaj seancan agordon eĉ kiam vi fermas viajn dokumentojn. La datumoj estos uzataj se la dokumento estas senŝanĝa kiam remalfermita.

Forigi neuzatajn metainformojn poste

  Agordu la maksimuman nombron da tagoj por konservi metainformojn por antaŭe malfermitaj dosieroj. Ĉi tio helpas konservi la datumbazon de metainformoj racie grandeco.

Ĉiuj ŝanĝoj al la seancaj datumoj (malfermitaj dosieroj kaj, se ebligita, fenestra agordo) ĉiam estos konservita.

### Kromaĵoj

Ĉi tiu paĝo provizas liston de instalitaj kromprogramoj por la Kate aplikaĵo. Ĉiu kromaĵo estas reprezentita per sia nomo kaj mallonga priskribo. Vi povas marki la markobutonon kun ero por ebligi la kromprogramon, kiun ĝi reprezentas.

Se kromaĵo disponigas agordajn opciojn, sekcio por aliri tiujn aperos kiel infano de ĉi tiu paĝo.

Por pliaj informoj pri la disponeblaj aldonaĵoj, vidu Ĉapitro 4, Laborante kun Kromaĵoj.

### La Redaktora Komponenta Agordo

Por informoj pri ĉi tiu sekcio de la agorda dialogo, vidu la sekcion Redaktila Komponenta Agordo de la KatePart Manlibro.

### Agordo kun Dokumentaj Variabloj

Por informoj pri uzado de dokumentvariabloj kun Kate, vidu la sekcion Agordo per Dokumentvariabloj de la KatePart Manlibro.

Ĉapitro 10. Agnoskoj kaj Permesilo
Agnoskoj kaj Permesilo

# Ĉapitro 10. Agnoskoj kaj Permesilo

Kate. Programo kopirajto 2000, 2001, 2002 - 2005 de la Kate teamo de programistoj.

La Kate teamo:

Christoph Cullmann `(cullmann AT kde.org)`

  Projektestro & Kerna Programisto

Anders Lund `(anders AT alweb.dk)`

  Kerna Programisto, Perl-sintakso reliefigo, dokumentado

Joseph Wenninger `(kde AT jowenn.at)`

  Kerna Programisto, sintaksa reliefigo

Michael Bartl `(michael.bartl1 AT chello.at)`

  Kerna Programisto

Phlip `(phlip_cpp AT my-deja.com)`

  La projekta kompililo

Waldo Bastian `(bastian AT kde.org)`

  La mojosa bufrosistemo

Matt Newell `(newellm AT proaxis.com)`

  Testante...

Michael McCallum `(gholam AT xtra.co.nz)`

  Kerna Programisto

Jochen Wilhemly `(digisnap AT cs.tu-berlin.de)`

  Aŭtoro de KWrite

Michael Koch `(koch AT kde.org)`

  KWrite portado al KParts

Christian Gebauer `(gebauer AT bigfoot.com)`

  Nespecifita

Simon Hausmann `(hausmann AT kde.org)`

  Nespecifita

Glen Parker `(glenebob AT nwlink.com)`

  KWrite Malfar-Historio, KSpell-integriĝo

Scott Manson `(sdmanson AT alltel.net)`

  KWrite subteno por XML-sintaksreliefigo

John Firebaugh `(jfirebaugh AT kde.org)`

  Diversaj Flikoj

Dominik Haumann `(dhdev AT gmx.de)`

  Ellaboranto, Reliefiga sorĉisto

Multaj aliaj homoj kontribuis:

Matteo Merli `(merlim AT libero.it)`

  Reliefigo por RPM Spec-dosieroj, Diff kaj pli

Rocky Scaletta `(rocky AT purdue.edu)`

  Reliefigo por VHDL

Jurij Lebedev

  Reliefigo por SQL

Chris Ross

  Reliefigo por Ferite

Nick Roux

  Reliefigo por ILERPG

John Firebaugh

  Reliefigo por Java™, kaj multe pli

Carsten Niehaus

  Reliefigo por LATEX

Laŭ Wigren

  Reliefigo por Makefiles, Python

Jan Fritz

  Reliefigo por Python

Daniel Naber

  Malgrandaj erarkorektoj, XML-kromprogramo

Dokumentado kopirajto 2000,2001 Seth Rothberg `(sethmr AT bellatlantic.org)`

Dokumentado kopirajto 2002, 2003, 2005 Anders Lund `(anders AT alweb.dk)`

Translation Oliver Kellogg `(okellogg AT users.sf.net)`

Ĉi tiu dokumentaro estas licencata sub la kondiĉoj de la Permesilo de Dokumentado Libera GNU.

Ĉi tiu programo estas licencata sub la kondiĉoj de la GNUa Ĝenerala Publika Licenco.

Apendico A. Regulaj Esprimoj
Regulaj Esprimoj

# Apendico A. Regulaj Esprimoj

Por informoj pri uzado de regulaj esprimoj en Kate, vidu la apendicon de Regulaj esprimoj al la KatePart Manlibro.