# Napredna orodja za urejanje

## Komentiraj/Odkomentiraj

Ukaza Komentiraj in Odkomentiraj, ki sta na voljo v meniju Orodja, omogočata dodajanje ali odstranjevanje označevalcev komentarjev izboru ali trenutni vrstici, če ni besedilo je izbrano, če format besedila, ki ga urejate, podpira komentarje.

Pravila za komentiranje so opredeljena v definicijah sintakse, tako da, če označevanje sintakse ni uporabljeno, komentiranje/odkomentiranje ni mogoče.

Nekateri formati določajo enovrstične oznake komentarjev, nekateri večvrstične oznake, nekateri pa oboje. Če večvrstični označevalniki niso na voljo, komentiranje izbora, ki ne vključuje v celoti zadnje vrstice, ni mogoče.

Če je na voljo oznaka ene vrstice, je zaželeno komentiranje posameznih vrstic, kjer je to primerno, saj se tako izognete težavam z ugnezdenimi komentarji.

Pri odstranjevanju označevalcev komentarjev ne sme biti izbrano nekomentirano besedilo. Pri odstranjevanju oznak za večvrstične komentarje iz izbora se vsak presledek zunaj oznak za komentarje prezre.

Če želite postaviti oznake komentarjev, uporabite menijski element Orodja Komentar ali povezano zaporedje bližnjic na tipkovnici, privzeto je &Ctrl;D.

Če želite odstraniti oznake komentarjev, uporabite menijski element Orodja Odkomentiraj ali povezano bližnjico na tipkovnici, privzeto je &Ctrl;&Shift;D.

## Ukazna vrstica komponente urejevalnika

Komponenta urejevalnika &kappname; ima notranjo ukazno vrstico, ki vam omogoča izvajanje različnih dejanj iz minimalnega &GUI;. Ukazna vrstica je vnos besedila na dnu območja urejevalnika; za prikaz izberite Pogled Preklopi na ukazno vrstico ali uporabite bližnjico (privzeto je F7). Urejevalnik ponuja nabor ukazov, kot je dokumentirano spodaj, dodatne ukaze pa lahko zagotovijo vtičniki.

Če želite izvesti ukaz, vnesite ukaz in pritisnite tipko return. V ukazni vrstici bo prikazano, ali je uspelo, in morebiti prikazano sporočilo. Če ste vstopili v ukazno vrstico s pritiskom F7, se bo po nekaj sekundah samodejno skrila. Če želite počistiti sporočilo in vnesti nov ukaz, znova pritisnite F7.

Ukazna vrstica ima vgrajen sistem pomoči; izdajte ukaz `pomoč`, da začnete. Če si želite ogledati seznam vseh razpoložljivih ukazov, izdajte `seznam pomoči`; če si želite ogledati pomoč za določen ukaz, naredite `pomoč `ukaz``.

Ukazna vrstica ima vgrajeno zgodovino, tako da lahko ponovno uporabite že vnesene ukaze. Za krmarjenje po zgodovini uporabite &Up; in &Down; ključi. Pri prikazu zgodovinskih ukazov bo izbran del ukaza z argumenti, kar vam omogoča enostavno prepisovanje argumentov.

### Standardni ukazi ukazne vrstice

### Vrste argumentov

BOOLEAN

- To se uporablja z ukazi, ki vklopijo ali izklopijo stvari. Pravne vrednosti so `on`, `off`, `true`, `false`, `1` ali `0`.

INTEGER

- Celo število.

STRING

- Niz, obdan z enojnimi narekovaji (') ali dvojnimi narekovaji ("), če vsebuje presledke.

#### Ukazi za konfiguracijo urejevalnika

Te ukaze zagotavlja komponenta urejevalnika in vam omogočajo, da konfigurirate samo aktivni dokument in pogled. To je priročno, če želite uporabiti nastavitev, ki se razlikuje od privzetih nastavitev, na primer za zamik.

    nastavite-širino-zavihkaINTEGER širina

- Nastavi širino zavihka na število `širina`.

    nastavite-širino-zamikaINTEGER širine

- Nastavi širino zamika na število `širina`. Uporablja se samo, če zamikate s presledki.

    nastavite-stolpec-za-prelom-besedINTEGER širina

- Nastavi širino črte za trdo previjanje na `širino`. To se uporablja, če imate samodejno prelom besedila.

    nastavi-okvir-ikoneBOOLEAN omogoči

- Nastavi vidnost obrobe ikone.

    nastavite-zložljive-oznakeBOOLEAN omogoči

- Nastavi vidnost podokna z zgibnimi oznakami.

    nastavite-številke-vrsticeBOOLEAN omogoči

- Nastavi vidnost podokna s številkami vrstic.

    nastavi-zamenjaj-zavihkeBOOLEAN omogoči

- Če je omogočeno, se tabulatorji med tipkanjem zamenjajo s presledki.

    nastavite-odstranite-končni-presledekBOOLEAN omogoči

- Če je omogočeno, se končni presledek odstrani vsakič, ko kazalec zapusti črto.

    nastavite-prikaz-zavihkovBOOLEAN omogoči

- Če je omogočeno, bodo znaki TAB in presledki na koncu prikazani z majhno piko.

    nastavite-prikaz-zamikaBOOLEAN omogoči

- Če je omogočeno, bo zamik prikazan z navpično pikčasto črto.

    nastavite-presledke-za-zamikeBOOLEAN omogoči

- Če je omogočeno, bo urejevalnik zamaknil s presledki `indent-width` za vsako raven zamika namesto z enim znakom TAB.

    nastavite-mešani-zamikBOOLEAN omogoči

- Če je omogočeno, &kappname; bo za zamik uporabil kombinacijo TAB in presledkov. Vsaka raven zamika bo široka `širina-zamika`, več ravni zamika pa bo optimiziranih za uporabo čim več znakov TAB.

  Ko se ta ukaz izvede, bo dodatno omogočen zamik presledka in če širina zamika ni določena, bo nastavljena na polovico `širine zavihka` za dokument v času izvajanja.

    nastavite-prelom-besedBOOLEAN omogoči

- Omogoči dinamično prelivanje besed glede na `omogoči`.

    nastavi zamenjaj zavihke shraniBOOLEAN omogoči

- Ko je omogočeno, bodo zavihki zamenjani s presledki vsakič, ko je dokument shranjen.

    nastavitev-odstrani-končni-prostor-prihraniOmogoči BOOLEAN

- Ko je omogočeno, bo končni presledek odstranjen iz vsake vrstice vsakič, ko je dokument shranjen.

    nastavite-način-zamikaSTRING ime

- Nastavi način samodejnega zamika na `ime`. Če `ime` ni znano, je način nastavljen na 'brez'. Veljavni načini so 'none', 'normal', 'cstyle', 'haskell', 'lilypond', 'lisp', 'python', 'ruby' in 'xml'.

    nastavite-samodejni-identifikatorBOOLEAN skript

- Omogoči ali onemogoči samodejni zamik.

    nastavite-poudarekoznačba STRING

- Nastavi sistem označevanja sintakse za dokument. Argument mora biti veljavno ime osvetlitve, kot je prikazano v meniju Orodja Označevanje. Ta ukaz ponuja seznam samodokončanja za svoj argument.

    reload-scripts

- Ponovno naloži vse &javascript; skripti, ki jih uporablja &kate;, vključno z zamiki in skripti ukazne vrstice.

    nastavljeni-načinSTRING način

- Izberite shemo vrste datoteke za trenutni dokument.

    nn[oremap]STRING original STRING preslikan

- Preslikaj zaporedje tipk `original` v `preslikan`.

#### Ukazi za urejanje

Ti ukazi spremenijo trenutni dokument.

    indent

- Zamakne izbrane vrstice ali trenutno vrstico.

    unindent

- Razveljavi zamik izbranih vrstic ali trenutne vrstice.

    cleanindent

- Počisti zamik izbranih vrstic ali trenutne vrstice glede na nastavitve zamika v dokumentu.

    comment

- Vstavi označevalce komentarjev, da izbor ali izbrane vrstice ali trenutna vrstica postanejo komentar v skladu z obliko besedila, kot je določeno z definicijo poudarjanja sintakse za dokument.

    uncomment

- Odstrani označevalce komentarjev iz izbire ali izbranih vrstic ali trenutne vrstice v skladu z obliko besedila, kot je določeno z definicijo poudarjanja sintakse za dokument.

    kill-line

- Izbriše trenutno vrstico.

    zamenjaj STRING vzorec STRING zamenjava

- Zamenja besedilo, ki se ujema z `vzorcem` z `zamenjavo`. Če želite v `vzorec` vključiti presledek, morate tako `vzorec` kot `zamenjavo` dati v enojne ali dvojne narekovaje. Če argumenti niso v narekovajih, se prva beseda uporabi kot `vzorec`, ostala beseda pa za `zamenjava`. Če je `zamenjava` prazna, je vsak pojav `vzorca` odstranjen.

  Zastavice lahko nastavite za konfiguracijo iskanja tako, da dodate dvopičje, ki mu sledi ena ali več črk, od katerih vsaka predstavlja konfiguracijo, kar daje obliko `zamenjaj: možnosti zamenjava vzorca`. Razpoložljive možnosti so:

  `b`

- Išči nazaj.

`c`

- Išči od položaja kazalca.

`e`

- Išči samo v izboru.

`r`

- Izvedite iskanje po regularnem izrazu. Če je nastavljeno, lahko uporabite `\IN`, kjer je N število, ki predstavlja zajeme v nadomestnem nizu.

`s`

- Iskanje razlikuje med velikimi in malimi črkami.

`p`

- Poziv za dovoljenje za zamenjavo naslednjega pojava.

`w`

- Ujemaj samo cele besede.

    datumOblika STRING

- Vstavi niz datuma/časa, kot ga definira podani `format`, ali format llll-MM-dd hh:mm:ss, če noben ni določen. Pri interpretaciji `formata` se izvajajo naslednji prevodi:

  `d` | Dan kot številka brez začetne ničle (1-31).
  `dd` | Dan kot številka z ničlo na začetku (01-31).
  `ddd` | Skrajšano lokalizirano ime dneva (⪚ 'pon'..'ned').
  `dddd` | Dolgo lokalizirano ime dneva (⪚ 'ponedeljek'..'nedelja').
  `M` | Mesec kot številka brez začetne ničle (1-12).
  `MM` | Mesec kot številka z ničlo na začetku (01-12).
  `MMMM` | Dolgo lokalizirano ime meseca (⪚ 'januar'..'december').
  `MMM` | Skrajšano lokalizirano ime meseca (⪚ 'Jan'..'Dec').
  `yy` | Leto kot dvomestno število (00-99).
  `yyyy` | Leto kot štirimestno število (1752-8000).
  `h` | Ura brez vodilne ničle (0..23 ali 1..12, če je prikazan AM/PM).
  `hh` | Ura z vodilno ničlo (00..23 ali 01..12, če je prikazan AM/PM).
  `m` | Minuta brez vodilne ničle (0..59).
  `mm` | Minuta z vodilno ničlo (00..59).
  `s` | Druga brez vodilne ničle (0..59).
  `ss` | Drugi z vodilno ničlo (00..59).
  `z` | Milisekunde brez začetnih ničel (0..999).
  `zzz` | Milisekunde z začetnimi ničlami ​​(000..999).
  `AP` | Uporabite prikaz AM/PM. AP bo nadomeščen z "AM" ali "PM".
  `ap` | Uporabite prikaz zjutraj/popoldne. ap bo nadomeščen z "am" ali "pm".

    charidentifikator STRING

- Ta ukaz vam omogoča vstavljanje dobesednih znakov glede na njihov numerični identifikator v decimalni, osmiški ali šestnajstiški obliki. Če ga želite uporabiti, odprite pogovorno okno Ukaz za urejanje in v polje za vnos vnesite `char: [number]`, nato pritisnite V redu.

  ##### `char` primeri

  Vnos: `char:234`

  Izhod: `ê`

  Vnos: `char:0x1234`

  Izhod: `in#x1234;`

`s///[ig]` `%s///[ig]`

- Ta ukaz izvede operacijo iskanja/zamenjave, podobno sed-u, v trenutni vrstici ali v celotni datoteki (`%s///`).

  Skratka, v besedilu se išče besedilo, ki se ujema z iskalnim vzorcem, regularnim izrazom med prvo in drugo poševnico, in ko se najde ujemanje, se ujemajoči del besedila nadomesti z izrazom med drugo in zadnjo poševnico. Oklepaji v iskalnem vzorcu ustvarijo povratne reference, to pomeni, da si ukaz zapomni, kateri del niza se ujema v oklepajih; te nize je mogoče ponovno uporabiti v vzorcu zamenjave, imenovanem `\1` za prvi niz oklepajev, `\2` za drugega in tako naprej.

  Če želite poiskati literal `(` ali `)`, ga morate ubežati s poševnico nazaj: `\(\)`

  Če na koncu izraza postavite `i`, ujemanje ne bo razlikovalo med velikimi in malimi črkami. Če na koncu vstavite `g`, bodo zamenjane vse pojavitve vzorca, sicer bo zamenjana samo prva pojavitev.

  ##### Zamenjava besedila v trenutni vrstici

  Vaš prijazen prevajalnik se je pravkar ustavil in vam povedal, da razred `myClass`, omenjen v vrstici 3902 v vaši izvorni datoteki, ni definiran.

  "Zaponka!" mislite, da je to seveda `MyClass`. Pojdite v vrstico 3902 in namesto da bi poskušali najti besedo v besedilu, zaženete pogovorno okno ukazov za urejanje, vnesete `s/myclass/MyClass/i`, pritisnete OK, shranite datoteko in prevedite – uspešno brez napake.

  ##### Zamenjava besedila v celotni datoteki

  Predstavljajte si, da imate datoteko, v kateri večkrat omenjate gospodično Jensen, ko pride nekdo in vam pove, da se je pravkar poročila z gospodom Jonesom. Seveda želite vsako ponovitev gdč. Jensen zamenjati z gdč. Jones.

  Vnesite ukazno vrstico in izdajte ukaz `%s/Miss Jensen/Ms Jones/` in pritisnite return, končali ste.

  ##### Naprednejši primer

  Ta primer uporablja povratne reference kot tudi razred znakov (če ne veste, kaj je to, si oglejte povezano dokumentacijo, omenjeno spodaj).

  Recimo, da imate naslednjo vrstico:

      void MyClass::DoStringOps( String &foo, String &bar, String *p, int &a, int &b )

  Zdaj se zavedate, da to ni lepa koda, in se odločite, da želite uporabiti ključno besedo `const` za vse argumente naslov, tiste, ki jih označuje & operator pred imenom argumenta. Prav tako bi želeli poenostaviti prazen prostor, tako da bo med vsako besedo samo en presledek.

  Zaženite pogovorno okno ukazov za urejanje in vnesite: `s/\s+(\w+)\s+(&)/ const \1 \2/g` in pritisnite gumb V redu . `g` na koncu izraza povzroči, da se regularni izraz znova prevede za vsako ujemanje, da se shranijo povratne reference.

  Izhod: `void MyClass::DoStringOps( const String &foo, const String &bar, String *p, const int &a, const int &b )`

  Misija končana! Zdaj, kaj se je zgodilo? No, iskali smo nekaj presledka (`\s+`), ki mu sledi ena ali več abecednih znakov (`\w+`), čemur sledi še nekaj presledka (`\s+`), ki mu sledi ampersand, in pri tem shranil abecedni kos in ampersand za ponovno uporabo v operaciji zamenjave. Nato smo ujemajoči se del naše vrstice zamenjali z enim presledkom, ki mu je sledil const, ki mu je sledil en presledek, ki mu je sledil naš shranjeni abecedni del (`\1`), ki mu je sledil en presledek, ki mu je sledil naš shranjen ampersand (`\2`)

  Zdaj je bil v nekaterih primerih abecedni kos String, v nekaterih int, torej z uporabo razreda znakov `\w` in `+` kvantifikator se je izkazal za dragoceno sredstvo.

    sort

- Razvrsti izbrano besedilo ali celoten dokument.

    natsort

- Naravno razvrstite izbrane vrstice ali celoten dokument.

  ##### `uredi` proti `naturedi`

  ``uredi`(a10, a1, a2)` rezultira v `a1, a10, a2`

  ``natsort`(a10, a1, a2)` povzroči `a1, a2, a10`

    moveLinesDown

- Premakni izbrane vrstice navzdol.

    moveLinesUp

- Premakni izbrane vrstice navzgor.

    uniq

- Odstranite podvojene vrstice iz izbranega besedila ali celotnega dokumenta.

    rtrim

- Odstranite končni presledek iz izbranega besedila ali celotnega dokumenta.

    ltrim

- Odstranite začetni presledek iz izbranega besedila ali celotnega dokumenta.

    združiLočilo STRING

- Združi izbrane vrstice ali celoten dokument. Izbirno sprejme parameter, ki določa ločilo, na primer: ``join` ', '`

    rmblank

- Odstranite vse prazne prostore iz izbranega besedila ali celotnega dokumenta.

    alignon

- Ta ukaz poravna vrstice v izbranem bloku ali celotnem dokumentu na stolpec, ki ga poda regularni izraz, podan kot argument.

  Če podate prazen vzorec, se bo privzeto poravnal s prvim znakom, ki ni prazen.

  Če ima vzorec zajem, se bo zajeto ujemanje zamaknilo.

  Primeri:

  `alignon -` bo vstavil presledke pred prvi '-' vsake vrstice, da jih vse poravna v isti stolpec.

  `alignon :\\s (.)` bo vstavil presledke pred prvi neprazen znak, ki se pojavi za dvopičjem, da jih vse poravna v isti stolpec.

    unwrap

- Odvijte izbrano besedilo ali celoten dokument.

    vsakSTRING skript

- Glede na &javascript; funkcijo kot argument, pokličite to za seznam izbranih vrstic in jih nadomestite s povratno vrednostjo tega povratnega klica.

  ##### Združi izbrane vrstice

  ``vsak` 'function(lines){return lines.join(", ")}'`

  Ali bolj na kratko:

  ``vsak` 'lines.join(", ")'`

    filterSkript STRING

- Glede na &javascript; funkcijo kot argument, pokličite to za seznam izbranih vrstic in odstranite tiste, kjer povratni klic vrne false.

  ##### Odstranite prazne vrstice

  ``filter` 'function(1){return 1.length > 0;}'`

  Ali bolj na kratko:

  ``filter` 'line.length > 0'`

    mapaSkript STRING

- Glede na &javascript; funkcijo kot argument, jo pokličite za seznam izbranih vrstic in zamenjajte vrstico z vrednostjo povratnega klica.

  ##### Odstranite prazne vrstice

  ``mapa` 'function(line){return line.replace(/^s+/,"");}'`

  Ali bolj na kratko:

  ``mapa` 'line.replace(/^s+/,"")'`

    duplicateLinesUp

- Podvoji izbrane vrstice nad trenutno izbiro.

    duplicateLinesDown

- Podvoji izbrane vrstice pod trenutno izbiro.

#### Ukazi za navigacijo

    gotoINT line

- Ta ukaz vodi do navedene vrstice.

    grep STRING vzorec

- V dokumentu poiščite regularni izraz `vzorec`. Za več informacij glejte regular-expressions.

    najdiSTRING vzorec

- Ta ukaz se pomakne do prve pojavitve `vzorca` glede na konfiguracijo. Naslednje pojavitve lahko najdete z Uredi Najdi naprej (privzeta bližnjica je F3).

  Ukaz za iskanje je mogoče konfigurirati tako, da dodate dvopičje, ki mu sledi ena ali več možnosti, oblika je `find:options pattern`. Podprte so naslednje možnosti:

  `b`

- Išči nazaj.

`c`

- Išči od položaja kazalca.

`e`

- Išči samo v izboru.

`r`

- Izvedite iskanje po regularnem izrazu. Če je nastavljeno, lahko uporabite `\IN`, kjer je N število, ki predstavlja zajeme v nadomestnem nizu.

`s`

- Iskanje razlikuje med velikimi in malimi črkami.

`w`

- Ujemaj samo cele besede.

    inajdiSTRING vzorec

- Ta ukaz omogoča iskanje med tipkanjem. Obnašanje iskanja lahko konfigurirate tako, da dodate dvopičje, ki mu sledi ena ali več možnosti, na primer: `ifind:options pattern`. Dovoljene možnosti so:

  `b`

- Išči nazaj.

`r`

- Izvedite iskanje po regularnem izrazu.

`s`

- Iskanje razlikuje med velikimi in malimi črkami.

`c`

- Išči od položaja kazalca.

#### Ukazi za osnovne funkcije urejevalnika (ti so odvisni od aplikacije, v kateri se uporablja komponenta urejevalnika)

    w

- Shranite trenutni dokument.

    wa

- Shrani vse trenutno odprte dokumente.

    q

- Zapri trenutni dokument.

    qa

- Zapri vse odprte dokumente.

    wq

- Shranite in zaprite trenutni dokument.

    wqa

- Shranite in zaprite vse trenutno odprte dokumente.

    x

- Shrani in zapri trenutni dokument samo, če je bil spremenjen.

    x

- Shranite in zaprite vse trenutno odprte dokumente le, če so bili spremenjeni.

    bp

- Pojdite na prejšnji dokument na seznamu dokumentov.

    bn

- Pojdite na naslednji dokument na seznamu dokumentov.

    new

- Odprite nov dokument v horizontalno razdeljenem pogledu.

    vnew

- Odprite nov dokument v navpičnem razdeljenem pogledu.

    e

- Znova naloži trenutni dokument, če se je spremenil na disku.

    enew

- Uredite nov dokument.

    print

- Odprite pogovorno okno Natisni, da natisnete trenutni dokument.

## Uporaba zgibanja kode

Zgibanje kode vam omogoča, da skrijete dele dokumenta v urejevalniku, kar olajša pregledovanje velikih dokumentov. V &kappname; prepogljiva območja so izračunana z uporabo pravil, določenih v definicijah osvetlitve sintakse, zato je na voljo le v nekaterih formatih - običajno izvorna koda programa, oznaka XML in podobno. Večina definicij poudarkov, ki podpirajo zlaganje kode, vam omogoča tudi ročno definiranje prepogljivih območij, običajno z uporabo ključnih besed `BEGIN` in `END`.

Če želite uporabiti funkcijo zgibanja kode, aktivirajte oznake za zlaganje z menijsko postavko Pogled Pokaži oznake za zlaganje, če še niso vidne. Podokno z označevalniki za zlaganje na levi strani zaslona prikazuje grafični pogled prepogljivih območij s trikotnimi simboli, ki označujejo možno delovanje na danem območju: trikotnik zgoraj navzdol pomeni, da je območje razširjeno, s klikom nanj se bo območje strnilo namesto tega bo prikazan desno usmerjen trikotnik.

Na voljo so trije ukazi za manipulacijo stanja zgibnih območij, glejte dokumentacijo menija.

Prepognjene črte se zapomnijo, ko je datoteka zaprta, tako da bodo prepognjena vozlišča še vedno prepognjena, ko znova odprete datoteko. To velja tudi za operacije ponovnega nalaganja.

Če ne želite uporabljati funkcije zgibanja kode, lahko onemogočite možnost Pokaži oznake za zlaganje (če so na voljo) na strani Videz urejevalnika konfiguracijo.