# La Fundamentoj

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 &kde-ftp;LEGUMIN

Por ŝanĝi la dosierujon por provizoraj dosieroj, kiu defaŭlte estas `/tmp` agordu la mediovariablon `TMPDIR` antaŭ ol komenci &kate;, ⪚

    %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;

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;&Shift;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 &LMB; 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
&Shift;F1 | Kio estas tio?
&Ctrl;N | Nova dokumento
&Ctrl;L | Konservi Ĉion
&Ctrl;O | Malfermi dokumenton
&Ctrl;&Alt;O | Rapida Malfermo
&Ctrl;&Shift;F | Plena Ekrana Reĝimo
&Ctrl;&Shift;, | Agordi &kate;
&Ctrl;W / &Ctrl;&Esc; | Fermi
&Ctrl;Q | Quit - fermi aktivan kopion de redaktilo
&Ctrl;&Alt;&Shift;F | Montri Flankmenuojn
&Ctrl;&Shift;T | Split Horizontala
&Ctrl;&Shift;L | Split Vertikala
F8 | Sekva Split View
&Shift;F8 / &Ctrl;&Esc; | Antaŭa Split View
&Ctrl;&Shift;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

### 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 &RMB; menuo

Ila vido povas esti markita kiel persistenta en la &RMB; 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

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

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 &Enter; 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 &Enter; kaj ĝi kondukos vin al tiu dokumento.

### Agordo Rapida Malfermo

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

### Kun &kate;

Ĉi tiu manlibro

- Proponas detalan dokumentadon pri ĉiuj menukomandoj, agordaj opcioj, iloj, dialogoj, kromprogramoj &etc; 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 &Shift;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.