# Treballar amb l'editor del &kate;

## Vista general

L'editor de &kate; és l'àrea d'edició de la finestra del &kate;. Aquest editor també és utilitzat pel &kwrite; i es pot usar en el &konqueror; per a mostrar fitxers de text des del vostre ordinador local o des de la xarxa.

L'editor és compon dels següents components:

L'àrea d'edició

- Aquest és el lloc a on es localitza el text del vostre document.

Les barres de desplaçament

- Les barres de desplaçament indiquen la posició de la part visible del document de text i es poden usar per a moure's a través del document. El arrossegar les barres de desplaçament no causarà el moviment del cursor d'inserció.

  Les barres de desplaçament es mostren i oculten en ser requerit.

La vora de la icona

- La vora de la icona és un petit plafó en el costat esquerra de l'editor, que mostra una petita icona propera a les línies marcades.

  Podeu establir o eliminar un punt en una línia visible fent clic amb el &BER; en la vora de la icona propera a aquesta línia.

  La vora de la icona es pot mostrar/ocultar usant l'ítem del menú Visualitza Mostra la vora de la icona

El plafó dels números de línia

- El plafó dels números de línia mostra els números de línia de totes les línies visibles en el document.

  El plafó dels números de línia es pot mostrar/ocultar usant l'ítem del menú Visualitza Mostra números de línia.

El plafó de plegat

- El plafó de plegat us permet contraure o expandir els bloques de línies plegables. El calcul de les regions plegables es realitza d'acord amb les regles de definició de sintaxi de ressaltat per al document.

## També en aquest capítol:

- Navegar pel text

- Treballar amb la selecció

- Copiar i enganxar text

- Cercar i substituir text

- Usar els punts

- Ajustar el text automàticament

- Usar el sagnat automàtic

## Navegar pel text

Moure's pel text en &kate; es fa de forma similar a la resta d'editors gràfics. Podeu desplaçar el cursor usant les tecles del cursor i les tecles RePàg, AvPàg, Inici i Fi en combinació amb els modificadors &Ctrl; i &Maj;. La tecla &Maj; sempre s'usa per a generar una selecció, mentre que la tecla &Ctrl; te diferents efectes sobre tecles diferents:

- Per a les tecles Amunt i Avall vol dir desplaçament i no moviment del cursor.

- Per a les tecles Esquerra i Dreta vol dir deixar paraules en comptes de caràcters.

- Per a les tecles RePàg i AvPàg vol dir moure's a la vora visible de la vista i no del selector.

- Per a les tecles Inici i Fi vol dir moure's fins al principi o final del document en comptes de fins al començament i al final de la línia.

&kate; també us proveeix una manera d'anar ràpidament fins la parella d'un claudàtor o parèntesi: Situeu el cursor dintre del grup de parèntesis o claudàtors, i premeu &Ctrl;6 per anar fins al parèntesi o claudàtor amb que s'emparella.

A més podeu usar punts per a saltar ràpidament fins a posicions que heu definit.

## Treballar amb la selecció

Hi ha dos modes bàsics de seleccionar text en el &kate;: usant el ratolí i usant el teclat.

Per a seleccionar usant el ratolí, mantingueu premut el &BER; mentre arrossegueu el cursor del ratolí des d'on tingui que començar la selecció, fins al marcador que desitgeu. El text s'anirà seleccionant a mesura que aneu arrossegant.

Doble clic a sobre d'una paraula, seleccionarà dita paraula.

Triple clic sobre una línia, la seleccionarà tota.

Si es manté premuda la tecla &Maj; mentre es fa clic, es seleccionarà el text:

- Si no hi ha res seleccionat, des de la posició del cursor fins a la posició del cursor del ratolí.

- Si hi ha una selecció, des de i incloguen aquesta selecció fins a la posició del cursor del ratolí.

Mentre se selecciona text arrossegant el ratolí, el text seleccionat es copia al portapapers i es pot enganxar a l'editor fent clic en el &BMR;, o en qualsevol altra aplicació en la que es vulgui enganxar el text.

Per a seleccionar usant el teclat, mantingueu premuda la tecla &Maj; mentre useu les tecles de navegació (les tecles de fletxes, Av. Pàg., Re. Pàg, Inici i Fi, possiblement en combinació amb &Ctrl; per a estendre el moviment del cursor de text).

Consulteu també la secció Navegar pel text en aquest capítol.

Per a copiar la selecció actual, useu l'ítem del menú Edita Copia o les dreceres de teclat (per omissió &Ctrl;C).

Per a deseleccionar la selecció actual, useu l'ítem del menú Edita Deselecciona o les dreceres de teclat (per omissió &Ctrl;&Maj;A), o feu clic amb el &BER; en l'editor.

### Usar la selecció en bloc

Quan la selecció en bloc estigui habilitada, podreu realitzar seleccions verticals en el text, el qual vol dir que podeu seleccionar un nombre determinat de columnes en diverses línies a la vegada. Això és útil, per exemple, si treballeu amb línies separades per tabuladors.

La selecció en bloc es pot activar/desactivar en l'ítem del menú Edita Mode de selecció per blocs. La drecera de teclat per omissió és F4

### Usar el mode sobreescriure

Si l'opció Mode sobreescriure està habilitat, en escriure o enganxar text a sobre d'una selecció, aquesta serà substituïda. Si no està habilitada, el text nou serà afegit en la posició del cursor de text.

El mode sobreescriptura està habilitat per omissió.

Per a canviar aquesta opció, useu la pàgina Selecció del Diàleg de configuració.

### Usar les seleccions persistents

Si les seleccions persistents estan habilitades, escriure caràcters o moure el cursor no causarà que desaparegui la selecció. Això vol dir que podeu moure el cursor a fora de la selecció i escriure.

Les seleccions persistents estan deshabilitades per omissió.

Les seleccions persistents es poden habilitar en la pàgina Selecció del Diàleg de configuració.

Si està habilitada tan les seleccions persistents com el mode sobreescriure, escriure o enganxar text quan el cursor es troba a dins de la selecció causarà que aquesta sigui substituïda i deseleccionada.

## Copiar i enganxar text

Per a copiar text, seleccioneu-lo i useu l'ítem del menú Edita Copia. De manera addicional, el fet de seleccionar text amb el ratolí causarà que aquest sigui copiat a la selecció de X.

Per enganxar el text que es troba en el portapapers, useu l'ítem del menú Edita Enganxa.

De forma addicional, el text seleccionat amb el ratolí es pot enganxar fent clic amb el &BMR; en la posició desitjada.

Si esteu usant l'escriptori &kde;, podeu recuperar el text que s'ha copiat des de qualsevol aplicació usant la icona &klipper;, que es troba a la safata d'icones en el &kicker;.

## Cercar i substituir text

### Els diàlegs Cerca text i Substitueix text

Els diàlegs de recerca i substitució de text del &kate; són molt similars, a excepció de que en el de substitució de text s'inclou l'opció d'introduir una cadena per a substituir a la cercada junt amb unes poques opcions extra.

Els diàlegs contenen les següents opcions comuns:

Text a cercar

- Aquí és a on s'introdueix la cadena de recerca. La interpretació de la mateixa dependrà d'algunes de les opcions descrites tot seguit.

Expressió regular

- Si està marcada, la cadena de recerca s'interpretarà com una expressió regular. S'habilitarà un botó per usar una eina gràfica de construcció o modificació de l'expressió regular.

  Veure expressions regulars per obtenir més informació al respecte.

Sensible a caixa

- Si està habilitada, la recerca distingirà entre majúscules i minúscules.

Només paraules senceres

- Si està marcada, la recerca tan sols coincidirà si hi ha un límit de paraula en ambdós extrems de la cadena coincident, no sent aquest límit un caràcter alfanumèric, sinó un altre caràcter visible o un fi de línia.

Des del cursor

- Si està marcada, la recerca començarà a la posició del cursor, d'altra manera ho farà des de la primera línia en el document.

Busca enrere

- Si està marcada, la recerca començarà per sobre del punt d'inici, ja sigui la posició del cursor o el principi del document, si l'opció Des del principi està habilitada.

El diàleg Substitueix text ofereix algunes opcions addicionals:

Substitueix amb

- Aquest és a on s'introdueix la cadena de substitució.

Text seleccionat

- Aquesta opció està inhabilitada sinó hi ha text seleccionat o si l'opció Pregunta en substituir està habilitada. Si ho està, totes les coincidències dins del text de la cadena de recerca seran substituïdes per la cadena de substitució.

Pregunta en substituir

- Si està marcada, cada vegada que es trobi una coincidència apareixerà un diàleg preguntant l'acció a prendre. Aquest oferirà les següents opcions:

  Sí

- Amb aquesta opció es substitueix el text coincident (el qual apareix seleccionat en l'editor).

No

- Amb aquesta opció s'omet la substitució i continua la recerca.

Totes

- Amb aquesta opció el programa deixa de preguntar què fer i realitza totes les substitucions.

Tanca

- Amb aquesta opció s'omet la coincidència actual i finalitza la recerca.

En aquest moment no hi ha forma d'usar coincidències mínimes quan es cerca amb expressions regulars. Aquesta característica s'afegirà en una futura versió del &kate;.

### Cercar text

Per a cercar text, llanceu el diàleg Cerca text amb &Ctrl;F o des de l'ítem del menú Edita Cerca..., introduïu una cadena de recerca, establiu les opcions desitjades i premeu a Bé. Si no es troba cap coincidència entre el punt d'inici per a la recerca i el final (o principi si era recerca enrere) del document, se us demanarà permís per a continuar.

Si es troba una coincidència aquest serà seleccionat i el diàleg Cerca text romandrà ocult, però estigueu atents, perquè realitzar les següents recerques és molt fàcil:

Per a cercar la següent coincidència en la direcció de la recerca, useu el comandament Edita Cerca següent o premeu F3.

Per a cercar la següent coincidència en la direcció oposada, useu el comandament Edita Cerca anterior o premeu &Maj;F3.

Si no es troba cap coincidència en arribar al final del document (o principi si esteu cercant enrere), se us demanarà permís per a continuar.

### Substitució de text

Per a substituir text, llanceu el diàleg Substitueix text usant el comandament Edita Substitueix o la drecera &Ctrl;R, introduïu una cadena de recerca i de forma opcional una de substitució (si la cadena de substitució està buida, les coincidències seran esborrades), establiu les opcions desitjades i premeu el botó Bé.

Si esteu usant una expressió regular per a cercar el text a substituir, podreu emprar referències enrere per a tornar a usar text en subpatrons entre parèntesis de l'expressió.

Veure regular-expressions per a més informació.

Podeu usar `find`, `replace` i `ifind` (recerca incremental) des de la línia de comandaments.

## Usar els punts

La característica dels punts us permet marcar certes línies i poder tronar a les mateixes d'una forma fàcil.

Podeu establir o eliminar un punt d'una línia de dues maneres:

- Movent el cursor cap aquesta línia i activant el comandament Punts Neteja tots els (&Ctrl;B).

- Fent clic en la vora de la icona al costat de la línia.

Els punts estan disponibles en el menú Punts. Els punts individuals estan disponibles com a ítems del menú, etiquetats amb el número de línia del punt o els primers caràcters del text en la línia. Per a moure el cursor d'inserció cap al principi d'una línia marcada, obriu el menú i seleccioneu el punt.

Per a moure's ràpidament entre punts o per anar cap al següent/anterior punt, useu Punts Següent (&Ctrl;AvPàg) o Punts Anterior (&Ctrl;RePàg ).

## Ajust automàtic del text

Aquesta opció us permet donar un format simple al text: el text serà tallat, de manera que cap línia excedeixi un cert nombre de caràcters, a menys que hi hagi una cadena més llarga que no contingui espais en blanc.

Per habilitar/deshabilitar aquesta opció, marqueu/desmarqueu la caixa de selecció Ajust de línia en la pàgina Edició del Diàleg de configuració.

Per establir l'amplada màxima de la línia (màxim nombre de caràcters per línia), useu l'opció Ajusta línia a en la pàgina Edició del diàleg de configuració.

Si està habilitat, tindrà els següents efectes:

- En escriure l'editor inserirà automàticament un salt de línia després de l'últim caràcter d'espai en una posició anterior a la que abasti l'amplada màxima de línia.

- Mentre es carrega un document, l'editor en processarà el text d'una manera similar, així cap línia superarà en longitud el màxim establert, sempre que contingui un espai en blanc que ho permeti.

En aquest moment no hi ha forma d'establir l'ajust de línia només per alguns tipus de documents en concret o habilitar/deshabilitar aquesta característica en un punt del document. Aquest problema serà solucionat en futures versions del &kate;.

## Usar el sagnat automàtic

L'editor &kate; suporta una variació dels modes de sagnat automàtic, dissenyada per a diferents formats de text. Podeu seleccionar un dels modes disponibles usant el menú Eines Sagnat. El mòdul de sagnat automàtic també proveeix la funció Eines Alínia que tornarà a calcular el sagnat del text seleccionat o de la línia actual. D'aquesta manera podreu tornar a establir el sagnat sencer al vostre document seleccionant tot el text i activant aquesta acció.

Tots els modes de sagnat usen es preferències de sagnat per al document actiu.

Podeu configurar l'ordenació de totes les variables de configuració, incloses les relatives a l'ús de sagnat usant les Variables de document i Tipus de fitxer.

## Modes de sagnat automàtic disponibles

Cap

- Seleccionant aquest mode es desactiva per complet el sagnat automàtic.

Normal

- Aquest sagnat simplement manté un sagnat similar al de la línia anterior amb qualsevol contingut diferent a un espai en blanc. Podeu combinar aquest amb les accions sagna i sense sagnar segons els vostres gustos.

Estil C

- Un sagnat per als llenguatges C i similars, com C++, C#, java, javascript i més. Aquest sagnat no funcionarà amb llenguatges d'script com Perl o PHP.

Estil C SS

- Un sagnat alternatiu per als llenguatges C i similars, amb les mateixes restriccions.

Estil Python

- Un sagnat especial per al llenguatge d'script Python.

XML

- Un bonic sagnat automàtic per a XML. Tot i que és temptador, no intenteu usar-lo amb HTML o XHTML, atès que falla amb les etiquetes HTML d'estil antic (etiquetes d'obertura, per exemple <br>)

Sagnat basat en variables

- El sagnat basat en variables és experimental, i podeu canviar el seu comportament o en properes versions desapareixerà.

  El sagnat basat en variables és especial i es pot configurar usant variables en el document (o en un fitxer de configuració). Es llegiran les següents variables:

  var-indent-indent-after

- Una expressió regular que provocarà que una línia sigui sagnada en una unitat, si la primera línia non-whitespace-only a sobre coincideix. var-indent-indent: Una expressió regular, que farà que la línia que coincideixi sigui sagnada en una unitat.

var-indent-unindent

- Una expressió regular que provocarà que s'elimini en una unitat el sagnat de la línia si existeix coincidència.

var-indent-triggerchars

- Una llista de caràcters que provocaran que el sagnat sigui tornat a calcular mentre s'escriu.

var-indent-handle-couples

- Una llista de configuració de la gestió de parèntesis. Qualsevol combinació de 'parèntesis', 'claudàtors' i 'claus'. Cada conjunt es gestiona de la següent manera: Si hi ha cap instància d'obertura i sense parella a la línia superior, s'afegeix una unitat de sagnat. Si hi ha cap instància de tanca i sense la seva parella a la línia actual, s'elimina una unitat de sagnat.

`var-indent-couple-attribute`

- Quan es cerquen parelles d'obertura/tanca sense parella, tan sols es tenen en consideració els atributs amb aquest caràcter. El valor hauria de ser el nom de l'atribut del fitxer de sintaxi xml, per exemple "Symbol". Si no s'especifica, s'usarà l'atribut 0 (usualment 'Text normal').