# Els fonaments

Si alguna vegada heu emprat un editor de text, no hauríeu de tenir cap problema en usar &kate;. En les següents dues seccions, Iniciar el &kate; i en Treballar amb el &kate;, us mostrarà tot el que necessiteu per a posar-vos en marxa ràpidament.

## Iniciar el &kate;

Podeu iniciar el &kate; des del &kmenu; o des de la línia d'ordres.

### Des del menú

Obriu el menú de programes del &kde; fent clic a sobre de la icona amb una K majúscula que hi ha a la barra d'eines a la part inferior esquerra de la vostra pantalla. En fer-ho apareixerà un menú. Moveu el cursor fins a l'element del menú Aplicacions Utilitats Editor avançat de text &kate;.

### Des de la línia d'ordres

Podeu iniciar el &kate; introduint el seu nom a la línia d'ordres. Si indiqueu un nom de fitxer, com a l'exemple de a sota, s'obrirà o crearà dit fitxer.

    %kate fitxer.txt

Si disposeu d'una connexió activa, i de permís, podreu beneficiar-vos de la transparència a xarxa del &kde; per obrir fitxers en Internet.

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

#### Opcions de la línia d'ordres

&kate; accepta les següents opcions de la línia d'ordres:

``kate` `--help``

- Aquesta llistarà les opcions disponibles més bàsiques a la mateixa línia d'ordres.

``kate` `--help-qt``

- Aquesta llistarà les opcions disponibles per a canviar la manera en la que &kate; interactua amb &Qt;.

``kate` `--help-kde``

- Aquesta llistarà les opcions disponibles per a canviar la manera en la que &kate; interactua amb el &kde;.

``kate` `-s` `--start` `nom``

- Inicia kate amb la sessió `nom`. Es crea una sessió si encara no existeix. Si existeix una instància de &kate; per a la sessió especificada, els fitxers especificats seran carregats en aquesta instància. Quan s'usi l'opció `--use`, també s'usarà la instància que estigui executant aquesta sessió.

``kate` `-u` `--use` `URL``

- Causa que el &kate; utilitzi una instància existent, si n'hi ha. Aquest és el comportament per omissió, però aquesta opció es manté per compatibilitat.

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

- Tan sols torna a usar una instància amb el PID especificat (ID del procés). S'usa junt amb l'opció `--use`.

``kate` `-e` `--encoding` `codificació` `URL``

- Usa la codificació especificada per al document.

``kate` `-l` `--line` `línia` `URL``

- Es desplaça a la línia especificada després d'obrir el document.

``kate` `-c` `--column` `columna` `URL``

- Es desplaça a la columna especificada després d'obrir el document.

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

- Llegeix el contingut del document des de l'entrada estàndard. És similar a l'opció `-` usada en molts programes de línia d'ordres, i us permet redirigir la sortida de les ordres a &kate;.

``kate` `--startanon``

- Inicia el &kate; amb una nova sessio anònima, implica l'argument `-n`.

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

- Força l'inici d'una nova instància del &kate; (s'ignora si s'ha usat `start` i una altra instància del &kate; ja té la sessió indicada oberta), forçada si no se li proporcionen paràmetres ni URL.

``kate` `-b` `--block``

- Si s'està usant una instància del &kate; en execució, la bloqueja fins que sortiu, si se li han proporcionat URL a obrir.

  Podeu utilitzar aquesta opció amb &kate; com a editor per a escriure missatges de confirmació per als sistemes de control de versions com Git o Subversion. Aquests sistemes esperen bloquejar l'editor fins que s'ha entrat en el missatge, atès que a continuació obren el fitxer temporal, el qual resta buit si kate torna immediatament a la crida.

  Aquesta opció també és necessària amb KIO (l'entrada/sortida del &kde;), si obriu un fitxer remot (que s'ha descarregat a un de temporal) i l'heu de tornar a pujar, després de desar-lo.

``kate` `--tempfile``

- Des de &kate; 2.5.1 està suportada aquesta opció estàndard del &kde;. Quan s'utilitza, els fitxers especificats es tractaran com si fossin fitxers temporals i s'esborraran (si són fitxers locals i teniu els permisos suficients per a fer-ho) al tancar-la, llevat que s'hagin modificat una vegada oberts.

``kate` `--help-all``

- Llista totes les opcions de la línia d'ordres.

``kate` `--author``

- Llista als autors del &kate; a la finestra de terminal.

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

- Llista la informació de la versió per a &Qt;, &kde; i &kate;.

``kate` `--license``

- Mostra informació sobre la llicència.

### Arrossegar i deixar

&kate; usa el protocol arrossega i deixa del &kde;. Els fitxers es poden arrossegar i deixar dins del &kate; des de l'escriptori, el gestor de fitxers &dolphin; o algun servidor remot d'ftp obert en una de les finestres del &dolphin;.

## Treballar amb el &kate;

Inici ràpid us mostrarà com canviar quatre simples opcions que us permetran configurar algunes de les característiques més potents del &kate;. Dreceres mostra algunes de les dreceres de teclat per omissió per aquells que no poden o no volen emprar un ratolí.

### Inici ràpid

Aquesta secció descriu alguns dels elements en el menú Visualitza de manera que podreu configurar ràpidament el &kate; per a que funcioni com voleu.

Quan inicieu el &kate; per primera vegada veureu dues finestres amb fons blanc. Per sobre de les finestres hi ha una barra d'eines amb les icones usualment anomenades com de costum. I per sobre d'aquesta, una barra de menús.

A mà esquerra de la finestra es troba una barra lateral. Combina les finestres Documents i Navegador del sistema de fitxers. Canvieu entre els dos fent clic a sobre de les pestanyes a la part superior de la finestra.

Si heu iniciat el &kate; amb un fitxer, la finestra de la dreta el mostrarà per a editar-lo i el Documents en la barra lateral us en mostrarà el nom. Empreu la finestra Navegador del sistema de fitxers per a obrir-los.

Podeu activar o desactivar les finestres Documents i Navegador del sistema de fitxers des del menú Visualitza Vistes d'eina. Aquest menú us deixa entreveure la potència i la flexibilitat de &kate;. En aquesta secció veurem l'arbre d'elements:

Mostra Documents

- Alterna l'activació o desactivació de Documents.

### Dreceres

Moltes de les ordres a les tecles (dreceres de teclat) del &kate; són configurables a través del menú Arranjament. Per omissió, el &kate; observa les següents associacions de tecles.

Insereix | Canvia entre els modes Insereix i Sobreescriu. Quan està en el mode d'inserció l'editor afegirà qualsevol caràcter introduït al text i empenyerà als caràcters prèviament introduïts cap a la dreta del cursor de text. El mode de sobreescriptura causa que l'entrada de cada caràcter elimini el caràcter immediatament a la dreta del cursor de text.
Cursor esquerre | Mou el cursor un caràcter cap a l'esquerra.
Cursor dret | Mou el cursor un caràcter cap a la dreta.
Fletxa amunt | Mou el cursor una línia cap amunt.
Fletxa avall | Mou el cursor una línia cap avall.
Pàg. amunt | Mou el cursor una pàgina cap amunt.
Pàg. avall | Mou el cursor una pàgina cap avall.
&Retro; | Esborra el caràcter a l'esquerra del cursor.
Inici | Mou el cursor cap al començament de la línia.
Fi | Mou el cursor cap al final de la línia.
Esborra | Esborra el caràcter a la dreta del cursor (o qualsevol text seleccionat).
&Maj;&Intro; | Insereix una nova línia incloent caràcters principals de la línia actual, que no són lletres o números. És útil, &pex;, per escriure comentaris en el codi: Al final de la línia «// algun text» premeu aquesta drecera i la següent línia ja començarà amb «//». De manera que no haureu d'introduir els caràcters de comentari al començament de cada nova línia amb els comentaris.
&Maj;Cursor esquerre | Marca el text un caràcter cap a l'esquerra.
&Maj;Cursor dret | Marca el text un caràcter cap a la dreta.
F1 | Ajuda
&Maj;F1 | Què és això?
&Ctrl;F | Cerca
F3 | Repeteix la cerca
&Ctrl;B | Estableix un punt.
&Ctrl;C | Copia el text marcat al porta-retalls
&Ctrl;N | Nou document.
&Ctrl;P | Imprimeix
&Ctrl;Q | Surt - tanca la còpia activa de l'editor.
&Ctrl;R | Substitueix
&Ctrl;S | Desa el vostre fitxer
&Ctrl;V | Enganxa
&Ctrl;X | Esborra el text marcat i el copia al porta-retalls
&Ctrl;Z | Desfés
&Ctrl;&Maj;Z | Refés

## Treballar amb el MDI del &kate;

### Vista general

Finestra, Vista, Document, Marc, Editor... Què signifiquen en la terminologia del &kate; i com extreure'n el màxim rendiment? Aquest capítol explicarà tot això i algunes coses més.

#### La finestra principal

La finestra principal de &kate; és una finestra d'aplicació estàndard de &kde;, amb l'afegit de subfinestres ancorables o vistes d'eina. Teniu una barra de menús amb tots els menús comuns i algun més, i una barra d'eines que proveeix accés a les ordres usades amb més freqüència.

La part més important de la finestra és l'àrea d'edició, que per omissió mostra un únic component d'edició de text, en el qual podreu treballar amb els vostres documents.

L'habilitat d'acoblar de la finestra s'usa per a les finestres d'eines:

- La llista de documents

- El navegador del sistema de fitxers

- L'emulador de terminal encastat

I possiblement d'altres vistes d'eina, per exemple les que són proveïdes pels connectors.

Les vistes d'eines es poden situar en qualsevol barra lateral, per a moure una eina feu clic dret a sobre seu i seleccioneu-la des del menú del &BDR;

Una vista d'eines es pot marcar com a persistent en el menú del &BDR; per al seu botó en la barra lateral. La barra lateral pot contenir més eines alhora, de manera que mentre una eina sigui persistent es poden mostrar altres eines de manera simultània.

### L'àrea de l'editor

&kate; és capaç de tenir més d'un document obert alhora i també de dividir l'àrea d'edició en qualsevol nombre de marcs, de forma similar a com ho fan, per exemple, el &konqueror; o el popular editor de texts emacs. D'aquesta manera podreu veure diversos documents alhora o fins i tot diverses sessions del mateix document, el qual és d'utilitat, per exemple, si el vostre document conté definicions al principi i a les que us aneu referint habitualment al llarg del text. O podeu veure el codi font d'un programa en un marc, mentre editeu el fitxer d'implementació en un altre.

Quan un document està disponible en més d'un editor, els canvis realitzats en un d'ells seran reflectits en els altres de forma immediata. Això inclou tant el canvi de text, com la seva selecció. Les operacions de cerca o de moviment del cursor, només es reflecteixen en l'editor actual.

En aquest moment no és possible tenir obertes diverses sessions d'un mateix document amb la intenció que els canvis que es produeixin en una no afectin a les demés.

En dividir un editor en dos marcs, aquest es divideix en dos marcs de la mateixa grandària i ambdós mostraran el document que s'està editant. El nou marc estarà a la part inferior (en el cas d'una divisió horitzontal) o a la part dreta (si la divisió és vertical). El nou marc obtindrà el focus, el qual es representa visualment per l'activació de la barra d'estat verd i el ressaltat del marc mateix.

### La llista Documents

La llista Documents mostra una llista de tots els documents actualment oberts en el &kate;. Els fitxers modificats tindran una petita icona d'un disquet a la seva esquerra per a indicar el seu estat.

Per omissió, la llista de documents apareix en el Mode d'arbre, que mostra l'estructura de les carpetes envoltant tots els documents oberts. També està disponible el Mode de llista, que mostra una llista simple de tots els documents oberts. Podeu canviar els modes fent clic dret sobre la llista i seleccionant-ho des del menú Mode de vista.

Si s'obren dos o més fitxers amb el mateix nom (localitzats en diferents carpetes) en el Mode llista, el nom del segon prendrà la forma (2) i així successivament. El consell d'eina per al fitxer mostrarà el seu nom complet incloent el camí, permetent-vos escollir el que vulgueu.

Per a mostrar un document en el marc actiu, feu clic al nom del document en la llista.

Podeu ordenar la llista de diferents formes fent clic amb el botó dret en la llista i seleccionant la desitjada des del menú Ordena per. Les opcions són:

Ordre d'obertura

- Llista els documents en l'ordre d'obertura.

Nom del document

- Llista els documents segons l'ordre alfabètic del seu nom.

Camí del document

- Llista els documents segons l'ordre alfabètic del seu camí.

La llista documents de forma predeterminada mostrarà el vostre historial ombrejant les entrades dels documents més recents amb un color de fons. Si el document fou editat, s'usarà una combinació de colors. Els documents més recents tindran colors més intensos, de forma que pugueu trobar amb més facilitat els documents amb els que esteu treballant. Aquesta característica es pot deshabilitar a la pàgina Documents del diàleg de configuració.

La localització per omissió de la llista Documents en la finestra del &kate; és a l'esquerra de l'àrea d'edició.

## Usar sessions

Les sessions són la manera en que &kate; us permetrà mantenir més d'una llista de fitxers i configuracions de la IGU. Podeu tenir tantes sessions com vulgueu, i podeu usar sessions amb nom o anònimes per als fitxers que tan sols vulgueu usar una vegada. En aquests moments el &kate; pot desar la llista de fitxers oberts, i la configuració de la finestra general en la sessió. En futures sessions de &kate; s'afegiran més característiques que es desaran en les sessions. Amb la introducció de les sessions, &kate; també permet obrir qualsevol nombre d'instàncies de l'aplicació en comptes de tan sols una tal com solia fer en el comportament per omissió.

Les sessions estan suportades en tres àrees:

- Opcions de la línia d'ordres permeten seleccionar i iniciar sessions quan inicieu kate des de la línia d'ordres.

- El menú Sessions permet canviar, desar, iniciar i gestionar les vostres sessions.

- Opcions de configuració permeten decidir com s'hauran de comportar generalment les sessions.

Quan s'inicia una nova sessió, es carrega la configuració de la IGU anomenada Sessió per omissió. Per a desar la configuració de la finestra com a sessió per omissió us caldrà desar la configuració de la finestra a la pàgina de configuració Sessions del diàleg de configuració, i a continuació carregar la sessió per omissió, podent configurar la finestra com vulgueu i desar la sessió una altra vegada.

Quan es carrega una sessió amb nom, &kate; mostrarà el nom de la sessió en el títol de la finestra, la qual tindrà la forma "`Nom de la sessió`: `Nom del document o &URL;` - &kate;".

Quan els fitxers oberts en la línia d'ordres amb `--start `nom`` o si una sessió se selecciona usant el selector de sessions, la sessió especificada abans que els fitxers especificats en la línia d'ordres. Per obrir fitxers des de la línia d'ordres en una nova sessió sense nom, configureu kate per a iniciar una nova sessió per omissió dintre de la pàgina Sessions del diàleg de configuració, o useu `-- start` amb una cadena buida: `''`.

Des de &kate; 2.5.1 el PID de la instància actual s'exportarà a la variable d'entorn `KATE_PID`. Quan obri fitxers des d'una terminal encastada en Kate seleccionarà automàticament la instància actual si no s'indica una altra cosa en la línia d'ordres.

### Restaurar el comportament a l'estil antic de &kate;

Amb la introducció a l'ús de les sessions esperem haver-vos ajudat proveint-vos d'una eina molt simple i eficaç per a treballar en diferents àrees. De tota manera, si preferiu l'antic comportament de &kate; (una instància per a obrir tots els fitxers), podeu usar aquesta simple estratègia:

- Feu que kate s'iniciï sempre amb el paràmetre `--use` afegint-lo a l'ordre de les preferències de l'aplicació, o usant un àlies d'intèrpret d'ordres.

- Configureu &kate; per a carregar l'última sessió usada a l'inici.

- Configureu &kate; per a desar la llista de fitxers quan tanqui una sessió.

- Carregueu la sessió per omissió una vegada.

## Obtenir ajuda

### Amb el &kate;

Aquest manual

- Ofereix documentació detallada sobre tots les ordres del menú, opcions de configuració, eines, diàlegs, connectors, &etc; així com descripcions de la finestra del &kate;, l'editor i diversos conceptes usats en l'aplicació.

  Per a veure aquest manual premeu F1 o useu el menú Ajuda Manual de &kate;.

Què és aquesta ajuda

- Què és això? Ofereix ajuda immediata amb els elements aïllats de les finestres gràfiques, tal com els botons o d'altres àrees de la finestra.

  Intentem proveir ajuda del tipus «Què és això?» per a qualsevol element en el que tingui sentit. Aquesta està disponible a través del diàleg de configuració i també a molts altres diàlegs.

  Per emprar l'ajuda «Què és això?», premeu &Maj;F1 o useu l'element del menú Ajuda Què és això per activar aquest mode. El cursor es transformarà en una fletxa amb un interrogant, i ara podreu fer clic en qualsevol element en la finestra per a llegir l'ajuda «Què és això?» per a dit element, si aquesta està disponible.

Botons d'ajuda en els diàlegs

- Alguns diàlegs tenen un botó Ajuda. Prement-lo s'iniciarà el &khelpcenter; i aquest obrirà la documentació corresponent.

### Amb els vostre fitxers de text

&kate; no proveeix (encara!) cap mitjà per a llegir documents relacionats amb la documentació. Depenent del fitxer que estigueu editant, podreu trobar ajuda en la Emulador de terminal encast, a on podreu veure les pàgines de manual de &UNIX; o de documentació info relacionades o per aquesta fi també podeu emprar el &konqueror;.

### Articles sobre &kate;

La pàgina principal de &kate; proveeix alguns Articles i Com es fa amb informació més enllà de l'abast d'aquest manual.