# Treballar amb l'editor &kappname;

## Vista general

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

L'editor es compon dels següents components:

L'àrea d'edició

- Aquest és el lloc a on s'ubica 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 utilitzar per a moure's a través del document. 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 una petita subfinestra al costat esquerre 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 utilitzant l'element Visualitza Mostra la vora per a les icones del menú.

La subfinestra dels números de les línies

- La subfinestra dels números de les línies mostra els números de línia de totes les línies visibles en el document.

  La subfinestra dels números de les línies es pot mostrar/ocultar utilitzant l'element Visualitza Mostra els números de les línies del menú.

La subfinestra de plegat

- La subfinestra de plegat us permet contraure o expandir els blocs plegables de línies. El càlcul de les regions plegables es realitza d'acord amb les regles en la definició de ressaltat de la sintaxi 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 la &kappname; és similar a la resta d'editors gràfics. Podeu desplaçar el cursor utilitzant les tecles del cursor i les tecles &PgUp;, &PgDn;, &Home; i &End; en combinació amb els modificadors &Ctrl; i &Maj;. La tecla &Maj; sempre s'utilitza per a generar una selecció, mentre que la tecla &Ctrl; té diferents efectes sobre tecles diferents:

- Per a les tecles &Up; i &Down; vol dir desplaçament i no moviment del cursor.

- Per a les tecles &Left; i &Right; vol dir deixar paraules en comptes de caràcters.

- Per a les tecles &PgUp; i &PgDn; vol dir moure's a la vora visible de la vora en comptes de navegar.

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

La &kappname; també proveeix una manera d'anar ràpidament fins a la parella d'una clau o un parèntesi: situeu el cursor en un caràcter de parèntesi o clau, i premeu &Ctrl;6 per a anar fins al parèntesi o clau amb què s'aparella.

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

## Treballar amb la selecció

Hi ha dues maneres bàsiques de seleccionar text en la &kappname;: utilitzant el ratolí i utilitzant el teclat.

Per a seleccionar utilitzant el ratolí, manteniu premut el &BER; mentre arrossegueu el cursor del ratolí des d'on calgui 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à aquesta paraula.

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

Si es manté premuda la tecla &Maj; mentre es fa clic, se 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 incloent aquesta selecció fins a la posició del cursor del ratolí.

Mentre se selecciona text arrossegant el ratolí, el text seleccionat es copiarà al porta-retalls i es podrà enganxar a l'editor fent clic amb el &BMR;, o en qualsevol altra aplicació en què es vulgui enganxar el text.

Per a seleccionar utilitzant el teclat, manteniu premuda la tecla &Maj; mentre empreu les tecles de navegació (les tecles de fletxa, &PgUp;, &PgDn;, &Home; i &End;, 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, utilitzeu l'element Edita Copia del menú o la drecera de teclat (la predeterminada &Ctrl;C).

Per a desseleccionar la selecció actual, utilitzeu l'element Edita Desselecciona del menú, la drecera de teclat (predeterminada &Ctrl;&Maj;A) o feu clic amb el &BER; a l'editor.

### Usar la selecció en bloc

Quan la selecció en bloc estigui activada, 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 tabulacions.

La selecció en bloc es pot activar/desactivar en l'element Edita Mode de selecció per blocs del menú. La drecera de teclat predeterminada és &Ctrl;&Maj;B .

### Usar el mode sobreescriure

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

El mode sobreescriure està activat de manera predeterminada.

Per a canviar la configuració d'aquesta opció, utilitzeu la pàgina Cursor i selecció del diàleg de configuració.

### Usar les seleccions persistents

Si les seleccions persistents estan activades, 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 desactivades de manera predeterminada.

Les seleccions persistents es poden activar a la pàgina Cursor i selecció del diàleg de configuració.

Si està activada, tant 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 desseleccionada.

## Copiar i enganxar text

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

Per a enganxar el text que es troba en el porta-retalls, utilitzeu l'element Edita Enganxa del menú.

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

Si esteu utilitzant l'escriptori &kde;, podeu recuperar el text que s'ha copiat des de qualsevol aplicació utilitzant la icona del &klipper;, que es troba a la safata del sistema.

## Cercar i substituir text

### Les barres de cerca i substitueix

La &kappname; té una barra de cerca incremental i una barra de cerca i substitució potent, la qual ofereix l'opció d'introduir una cadena de substitució amb algunes opcions extra.

Les barres ofereixen les següents opcions comunes:

Cerca

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

Fes concordar les majúscules

- Si s'activa, la cerca es limitarà a les entrades que coincideixin amb (majúscules o minúscules) cadascun dels caràcters en el patró de cerca.

Les poderoses barres de cerca i substitució ofereixen algunes opcions addicionals:

Text net

- Coincideix literalment amb qualsevol ocurrència de la cadena de cerca.

Paraules completes

- Si està marcada, la cerca 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.

Seqüències d'escapada

- Si està marcada, serà activat l'element Afegeix del menú a la part inferior del menú contextual dels quadres de text i us permetrà afegir seqüències d'escapament per al patró de cerca a partir d'una llista predefinida.

Expressió regular

- Si està marcada, la cadena de cerca s'interpretarà com una expressió regular. S'activarà l'element Afegeix del menú, a la part inferior del menú contextual dels quadres de text i us permetrà afegir elements d'expressions regulars a la cadena de cerca a partir d'una llista predefinida.

  Per a obtenir més informació referent a això, vegeu expressions regulars.

Cerca només en la selecció

- Si està marcada, la cerca i substitució només es durà a terme dins del text seleccionat.

Cerca-ho tot

- En fer clic en aquest botó es ressaltaran totes les coincidències en el document i se'n mostra el nombre en una petita finestra emergent.

### Cercar text

Per a cercar text, obriu la barra de cerca incremental amb &Ctrl;F o des de l'element Edita Cerca... del menú.

Això obre la barra de cerca incremental a la part inferior de la finestra de l'editor. En el costat esquerre de la barra hi ha un botó amb una icona per a tancar la barra, seguit d'un petit quadre de text per a introduir el patró de cerca.

Quan comenceu a escriure els caràcters del patró de cerca, aquesta s'iniciarà immediatament. Si hi ha una coincidència en el text, aquest serà ressaltat i el color de fons del camp d'entrada canviarà a una llum verda. Si el patró de cerca no coincideix amb cap cadena en el text, això s'indicarà per un color de fons de llum vermella en el camp d'entrada i No s'ha trobat es mostrarà al costat dret de la barra.

Empreu el botó o per a saltar a la següent o anterior coincidència en el document.

Les coincidències en el document seran ressaltades, fins i tot quan tanqueu la barra de cerca. Per a netejar el ressaltat, premeu la tecla &Esc;.

Podeu decidir si la cerca ha de ser amb majúscules i minúscules. Seleccionant es limitarà la cerca d'entrades amb el cas (majúscules i minúscules) de cadascun dels caràcters en el patró de cerca.

Feu clic sobre el botó al costat dret de la barra de cerca incremental per a canviar entre la cerca i substitució.

Repeteix l'última operació de cerca, si n'hi ha cap, sense cridar la barra de cerca incremental, utilitzeu F3 Edita Cerca la següent o &Maj;F3 Edita Cerca l'anterior.

### Substituir text

Per a substituir text, llanceu potent la barra de cerca i substitució utilitzant l'ordre Edita Substitueix o la drecera &Ctrl;R.

A la part superior esquerra de la barra hi ha un botó amb una icona per a tancar la barra, seguit d'un petit quadre combinat per a introduir el patró de cerca. El quadre recordarà els patrons emprats recentment.

Podeu controlar el mode de cerca seleccionant les opcions Text net, Paraules completes, Seqüències d'escapada o Expressions regulars des de la llista desplegable.

Si s'ha marcat Seqüències d'escapada o Expressions regulars, l'element Afegeix del menú, a la part inferior del menú contextual dels quadres de text i us permetrà afegir elements d'expressió regular al patró de cerca o substitució a partir d'una llista predefinida.

Empreu el botó o per a saltar a la següent o anterior coincidència en el document.

Introduïu el text a substituir en el quadre de text Substitueix i feu clic al botó Substitueix per a substituir només el text seleccionat o el botó Substitueix-ho tot per a substituir el text de cerca en tot el document.

Podeu modificar el comportament de cerca i substitueix seleccionant les diferents opcions a la part inferior de la barra. Seleccionant es trobaran les entrades que coincideixin amb (majúscules o minúscules) cadascun dels caràcters en el patró de cerca., només cercarà i substituirà dins de la selecció actual. El botó Cerca-ho tot ressaltarà totes les coincidències en el document i en mostrarà el nombre en una petita finestra emergent.

Feu clic al botó a la part dreta de la barra de cerca i substitueix per a veure la barra de cerca incremental.

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

Per a obtenir més informació referent a això, vegeu expressions regulars.

Podeu utilitzar les ordres `find`, `replace` i `ifind` (cerca incremental) des de la línia d'ordres.

## Ús dels punts

La característica dels punts us permet marcar certes línies i poder tornar-hi 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 l'ordre Punts Defineix un punt (&Ctrl;B).

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

Els punts estan disponibles en el menú Punts. Els punts individuals estan disponibles com a elements 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 començament d'una línia marcada, obriu el menú i seleccioneu el punt.

Per a moure-us ràpidament entre els punts o per a anar cap al següent/anterior punt, utilitzeu les ordres Punts Següent (&Alt;&PgDn;) o Punts Anterior (&Alt;&PgUp;).

## Ajust automàtic del text

Aquesta característica 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 a activar/desactivar aquesta opció, marqueu/desmarqueu la casella de selecció Ajust de línia a la pàgina Edició del diàleg de configuració.

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

Si està activada, 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ó abans d'abastar l'amplada màxima de la 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 a alguns tipus de documents en concret o activar/desactivar aquesta característica en un punt del document. Aquest problema serà solucionat en futures versions de la &kappname;.

## Usar el sagnat automàtic

L'editor &kappname; suporta una varietat dels modes de sagnat automàtic, ha estat dissenyada per a diferents formats de text. Podeu seleccionar un dels modes disponibles usant l'element Eines Sagnat del menú. El mòdul de sagnat automàtic també proveeix la funció Eines Format del sagnat 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 utilitzen la configuració de sagnat al document actiu.

Podeu configurar l'ordenació de totes les variables de configuració, incloses les relatives a l'ús del sagnat utilitzant les Variables de document i els 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 d'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 per a la creació de scripts com Perl o PHP.

Haskell

- Un sagnat per al funcional llenguatge de programació Haskell.

Lilypond

- Un sagnat especial per al llenguatge de notació Lilypond, per a música.

Lisp

- Un sagnat especial per al llenguatge Lisp i els seus dialectes per a la creació de scripts.

Python

- Un sagnat especial per al llenguatge Python per a la creació de scripts.

Estil XML

- Un sagnat especial per als llenguatges com XML.

## Indicadors de modificació de línia

Els indicadors de modificació de línia de la &kappname; permeten veure amb facilitat el que heu canviat recentment en un fitxer. De manera predeterminada, els canvis desats s'indiquen mitjançant una barra verda a l'esquerra d'un document, mentre que els canvis sense desar s'indiquen amb una barra taronja.

Els indicadors de modificació de línia en acció.

Podeu canviar els colors utilitzats des del plafó de configuració Lletres i colors, o podeu desactivar completament aquesta característica a la pestanya Vores del plafó de configuració Aparença.

## El mapa en miniatura a la barra de desplaçament

El mapa en miniatura a la barra de desplaçament de la &kappname; mostra una vista prèvia del document en lloc de la barra de desplaçament. La porció actualment visible del document està ressaltada.

El mapa en miniatura a la barra de desplaçament mostra una vista prèvia del codi font del &kate;.

Podeu activar o desactivar temporalment el mapa en miniatura seleccionant Visualitza Mostra un mapa en miniatura a la barra de desplaçament o permanentment a la secció Aparença de la configuració de la &kappname;.

## Cursors múltiples

La implementació dels cursors múltiples es va introduir amb la versió 5.93 de la «katepart».

### Creació de cursors múltiples

- Per a crear-los a través del ratolí, useu &Alt; + &BER;. El modificador és configurable, vegeu Configuració del modificador de multicursor

- Per a crear-los a través del teclat, premeu &Ctrl;&Alt;&Up; per a crear un cursor sobre el cursor primari i &Ctrl;&Alt;&Down; per a crear el cursor a sota. Aquestes dreceres també són configurables.

- Per a crear cursors fora d'una selecció, primer seleccioneu un text i després premeu &Maj;&Alt;I. Això crearà un cursor al final de cada línia de la selecció.

- Useu &Alt;J per a cercar l'ocurrència següent de la paraula sota el cursor i seleccionar/la + crear un cursor. Si voleu ometre la paraula actual sota el cursor, premeu &Alt;K i es marcarà la paraula actualment seleccionada com a omesa. Quan torneu a prémer &Alt;J la paraula actual es desseleccionarà i anirà a la paraula següent.

- Useu &Ctrl;&Alt;&Maj;J per a cercar totes les ocurrències de la paraula sota el cursor i seleccionar-les amb un cursor al final de cada selecció. Podeu usar &Alt;J per a circular a través de les paraules seleccionades i usar &Alt;K per a desseleccionar qualsevol paraula com es menciona en el paràgraf anterior.

### Treballar amb cursors múltiples

Una vegada hàgiu creat alguns cursors, podreu realitzar la majoria de les operacions d'edició sobre ells com ho faríeu en un cursor sol. Per exemple, teclejar una lletra l'escriurà per a cada cursor. De la mateixa manera podeu realitzar transformacions de text, &pex;, posar en majúscules totes les posicions o seleccions.

A vegades voldreu eliminar cursors. Per a fer-ho, podeu fer &Alt; + &BER; al cursor que voleu eliminar. Si només voleu eliminar els cursors en línies que estan buides, hi ha una acció preparada ho farà. Per a invocar l'acció, obriu la barra d'ordres utilitzant &Ctrl;&Alt;I i cerqueu Elimina els cursors de les línies buides i premeu &Intro;. També podeu configurar una drecera per a aquesta acció.