# Lavorare con l'editor &kate;

## Panoramica

L'editor &kate; è l'area modificabile della finestra di &kate;. Questo editor è utilizzato anche da &kwrite; e può essere usato in &konqueror; per mostrare file di testo presenti nel tuo computer o in rete.

L'editor è costituito dai seguenti componenti:

L'area di modifica

- Qui si trova il testo del documento.

Le barre di scorrimento

- Le barre di scorrimento indicano la posizione della parte visibile del testo del documento e possono essere utilizzate per spostarsi nel documento. L'operazione di trascinamento delle barre di scorrimento non modifica la posizione del cursore di inserimento.

  Le barre di scorrimento sono mostrate e nascoste secondo necessità.

Il bordo per le icone

- Il bordo per le icone è un piccolo pannello alla sinistra dell'editor che mostra una piccola icona in corrispondenza delle righe marcate.

  Puoi impostare o rimuovere un segnalibro in una riga visibile facendo clic con il &LMB; nel bordo per le icone in corrispondenza di tale riga.

  La visualizzazione del bordo per le icone può essere attivata o disattivata tramite la voce di menu Visualizza Mostra bordo per le icone.

Il pannello per numeri di riga

- Il pannello per i numeri di riga mostra i numeri di riga di tutte le righe visibili nel documento.

  La visualizzazione del pannello per i numeri di riga può essere attivata o disattivata tramite la voce di menu Visualizza Mostra i numeri di riga.

Il pannello di raggruppamento

- Il pannello di raggruppamento ti consente di richiudere o espandere i blocchi raggruppabili di righe. Le regioni richiudibile vengono determinate in base alle regole specificate nelle definizioni di evidenziazione della sintassi per il documento.

## Altri argomenti in questo capitolo:

- Navigare nel testo

- Lavorare con la selezione

- Copiare ed incollare testo

- Trovare e sostituire testo

- Usare i segnalibri

- Andare a capo automaticamente

- Usare l'indentazione automatica

## Navigare nel testo

Lo spostamento nel testo in &kate; avviene come nella maggior parte degli editor di testo grafici. Puoi spostare il cursore tramite i tasti freccia ed i tasti Pag Su, Pag Giù, Home e Fine in combinazione con i modificatori Ctrl e Shift. Il tasto Shift viene sempre utilizzato per generare una selezione, mentre Ctrl provoca effetti diversi a seconda del tasto:

- Per i tasti Su e Giù significa scorrimento invece di spostamento del cursore.

- Per i tasti Sinistra e Destra significa saltare parole invece di caratteri.

- Per i tasti Freccia Su e Frecci Giù significa spostare il cursore ai limiti della vista invece di navigare nel testo.

- Per i tasti Home e Fine significa spostare il cursore all'inizio o alla fine del documento invece che all'inizio o alla fine della riga.

&kate; mette anche a disposizione un modo per saltare rapidamente alla parentesi corrispondente: posiziona il cursore all'interno di una parentesi e premi Ctrl 6 per saltare alla parentesi corrispondente.

Inoltre puoi utilizzare i segnalibri per saltare rapidamente a delle posizioni che puoi definire a tua scelta.

## Lavorare con la selezione

Ci sono due metodi di base per selezionare del testo in &kate;: tramite l'uso rispettivamente del mouse e della tastiera.

Per selezionare usando il mouse, tieni premuto il &LMB; mentre trascini il cursore del mouse dal punto iniziale della selezione fino al punto finale. Il testo sarà selezionato mentre trascini.

Facendo doppio clic su una parola, questa verrà selezionata.

Facendo clic triplo su una riga, questa verrà interamente selezionata.

Se il tasto &Shift; viene tenuto premuto mentre si fa clic, il testo sarà selezionato:

- Se non è stato ancora selezionato alcun testo, dalla posizione del cursore del testo alla posizione del cursore del mouse.

- Se è già attiva una selezione, a partire e includendo tale selezione fino alla posizione del cursore del mouse

Quando selezioni il testo tramite trascinamento del mouse, il testo selezionato viene copiato negli appunti e può essere incollato tramite un clic del pulsante centrale del mouse nell'editor o in qualunque altra applicazione in cui vuoi incollarlo.

Per selezionare usando la tastiera, tieni premuto il tasto &Shift; mentre utilizzi i tasti di navigazione (i tasti freccia, Pag Su, Pag Giù, Home e Fine, possibilmente in combinazione con &Ctrl; per estendere il movimento del cursore di testo).

Vedi anche la sezione Navigare nel testo in questo capitolo.

Per Copiare la selezione corrente usa la voce di menu Modifica Copia o la scorciatoia di tastiera (quella predefinita è &Ctrl;C).

Per deselezionare la selezione corrente usa la voce di menu Modifica Deseleziona, o la scorciatoia di tastiera (quella predefinita è &Ctrl;&Shift;A), o fai clic con il &LMB; nell'editor.

### Usare la selezione a blocchi

Quando la selezione a blocchi è attiva puoi effettuare selezioni verticali nel testo, cioé selezionare colonne ben definite da righe differenti. Questo è comodo ad esempio per lavorare con righe con dati separati da tabulazioni.

La selezione a blocchi può essere attivata o disattivata tramite la voce di menu Modifica Modalità selezione a blocchi. La scorciatoia di tastiera predefinita è F4

### Usare l'opzione Sovrascrivi selezione

Se l'opzione Sovrascrivi selezione è attiva, il testo presente nella selezione verrà sostituito se si scrive o si incolla del testo nella selezione. Se non è attiva il nuovo testo verrà aggiunto alla posizione del cursore di testo.

L'opzione Sovrascrivi selezione è attiva come impostazione predefinita.

Per cambiare l'impostazione di questa opzione, usa la pagina di selezione della finestra di configurazione.

### Usare la selezione permanente

Quando la selezione permanente è attiva, la selezione corrente non verrà annullata se si digitano caratteri o si muove il cursore. Questo vuol dire che puoi spostare il cursore dalla selezione e continuare a digitare.

La selezione permanente è disattivata come impostazione predefinita.

La selezione permanente può essere abilitata tramite la pagina di selezione della finestra di configurazione.

Se la selezione permanente e Sovrascrivi selezione sono entrambe attive, digitare o incollare del testo quando il cursore di testo è all'interno della selezione farà sì che questa venga annullata e il testo contenuto sostituito.

## Copiare ed incollare testo

Per copiare del testo, selezionalo ed usa la voce di menu Modifica Copia.Inoltre, se si seleziona del testo con il mouse, questo verrà copiato nella selezione di X.

Per incollare il testo presente negli appunti, usa la voce di menu Modifica Incolla.

Inoltre il testo selezionato tramite il mouse può essere incollato facendo clic con il pulsante centrale del mouse nella posizione desiderata.

Se utilizzi l'ambiente desktop &kde;, puoi riprendere da una qualsiasi applicazione il testo copiato precedentemente tramite l'icona di &klipper; presente nel vassoio di sistema di &kicker;.

## Trovare e sostituire testo

### Le finestre di dialogo Trova testo e Sostituisci testo

Le finestre di dialogo Trova e Sostituisci testo sono molto simili, con la differenza che quella di sostituzione dà la possibilità di inserire la nuova stringa insieme ad alcune opzioni aggiuntive.

Le finestre di dialogo presentano le seguenti opzioni comuni:

Testo da trovare

- Qui va inserita la stringa di ricerca. L'interpretazione della stringa dipende da alcune delle opzioni descritte più avanti.

Espressione regolare

- Se marcata, la stringa da cercare viene interpretata come un'espressione regolare. Verrà attivato un pulsante per lanciare uno strumento grafico per creare o modificare l'espressione.

  Vedi la sezione Espressioni regolari per maggiori informazioni.

Ignora maiuscole/minuscole

- Se attivo, la ricerca non terrà conto della distinzione tra maiuscole e minuscole.

Solo parole intere

- Se marcata, la ricerca avrà successo solo se c'è un delimitatore di parola ad entrambi gli estremi della stringa trovata, intendendo con questo non un carattere alfanumerico - né un carattere visualizzabile o un fine riga.

Dal cursore

- Se marcata, la ricerca partirà dalla posizione del cursore, altrimenti partirà dall'inizio della prima riga del documento.

Trova all'indietro

- Se marcata, la ricerca controllerà la prima corrispondenza sopra il punto di partenza, sia esso la posizione del cursore o l'inizio del documento se l'opzione Dall'inizio è attiva.

La finestra di dialogo Sostituisci testo mette a disposizione alcune opzioni addizionali:

Sostituisci con

- Qui va inserita la stringa di sostituzione.

Testo selezionato

- Questa opzione è disabilitata se non è stato selezionato alcun testo o se l'opzione Chiedi prima di sostituire è attiva. Se marcata, tutte le corrispondenze della stringa di ricerca con il testo selezionato verranno rimpiazzate dalla stringa di sostituzione.

Chiedi prima di sostituire

- Se marcata, una piccola finestra di dialogo ti chiederà cosa fare ogni volta che viene trovata una corrispondenza. Mette a disposizione le seguenti opzioni:

  Sì

- Attiva questa per rimpiazzare la corrispondenza corrente (selezionata nell'editor).

No

- Attivare per saltare la corrispondenza corrente e cercarne un'altra.

Tutti

- Attivare per non chiedere ulteriormente e sostituire tutte le corrispondenze.

Chiudi

- Attiva questa per saltare la corrispondenza corrente e terminare la ricerca.

Al momento non è possibile impostare una corrispondenza minimale quando si utilizza un'espressione regolare per cercare. Questa funzione verrà aggiunta nelle versioni future di &kate;

### Trovare del testo

Per trovare del testo, lancia la finestra di dialogo Trova testo con &Ctrl;F oppure tramite la voce di menu Modifica Trova..., inserisci la stringa di ricerca, imposta le opzioni come preferisci e premi Ok. Se la ricerca è partita dalla posizione del cursore e non è stata trovata alcuna corrispondenza prima della fine del documento (o dell'inizio se è una ricerca inversa), ti verrà richiesto se ricercare da capo (o dal fondo).

Se viene trovata una corrispondenza, questa verrà selezionata e la finestra di dialogo Trova testo nascosta, ma niente paura, è facile trovare ulteriori corrispondenze:

Per cercare la successiva occorrenza nella direzione impostata per la ricerca, utilizza il comando Modifica Trova successivo o premi F3.

Per cercare la successiva occorrenza nella direzione opposta, utilizza il comando Modifica Trova precedente o premi &Shift;F3.

Se non è stata trovata alcuna corrispondenza prima della fine del documento (o dell'inizio se è una ricerca inversa), ti verrà richiesto se ricercare da capo (o dal fondo).

### Sostituire il testo

Per sostituire del testo, lancia la finestra di dialogo Sostituisci testo tramite il comando Modifica Sostituisci... oppure tramite la scorciatoia di tastiera &Ctrl;R, inserisci la stringa di ricerca e opzionalmente una stringa di sostituzione (se questa è vuota, il testo di ogni corrispondenza sarà cancellato), imposta le opzioni come preferisci e premi Ok.

Se usi un'espressione regolare per trovare il testo da sostituire puoi utilizzare i riferimenti all'indietro per riutilizzare il testo catturato tra parentesi nel sottomodello dell'espressione.

Vedi regular-expressions per maggiori informazioni sull'argomento.

Puoi usare i comandi `find`, `replace` e `ifind` (ricerca incrementale) dalla riga di comando.

## Usare i segnalibri

I segnalibri ti consentono di marcare alcune riga per poterle ritrovare successivamente in modo semplice.

Puoi impostare o rimuovere un segnalibro in una riga in due modi:

- spostando il cursore di inserimento nella riga e usando il comando Segnalibri Metti segnalibro (&Ctrl;B).

- facendo clic sul bordo per le icone in corrispondenza della riga.

I segnalibri sono raggiungibili dal menu Segnalibri.Ognuno di essi è disponibile come voce di menu, etichettata con il numero di riga a cui è associato il segnalibro e i primi caratteri del testo di tale riga. Per spostare il cursore di inserimento all'inizio di una riga con segnalibro, apri il menu e seleziona il segnalibro.

Per spostarti rapidamente tra i segnalibri o andare al segnalibro successivo/precedente, usa rispettivamente le voci di menu Segnalibri Successivo (Ctrl Pag Giù) o Segnalibri Precedente (Ctrl Pag Su ).

## Andare a capo automaticamente

Questa funzione ti consente di formattare il testo in modo semplice: il testo andrà a capo automaticamente in modo che nessuna riga possa contenere più di un determinato numero di caratteri, a meno che non ci sia una stringa più lunga senza spazi.

Per attivarla/disattivarla, marca/smarca la casella A capo automatico nella pagina di modifica della finestra di configurazione.

Per impostare la lunghezza massima di una riga (numero massimo di caratteri per riga) usa l'opzione Colonna a cui andare a capo: nella pagina di modifica della finestra di configurazione.

Se attivo ha i seguenti effetti:

- Mentre digiti l'editor automaticamente interrompe la riga dopo l'ultimo carattere separatore presente in posizione precedente al raggiungimento della dimensione massima per la riga.

- In fase di caricamento di un documento, l'editor manderà a capo il testo in modo analogo, facendo sì che non ci siano righe più lunghe della massima dimensione consentita se contengono dei caratteri separatori che lo consentono.

Non c'è modo al momento di impostare l'a capo automatico per tipo di documento, e neppure di abilitarlo o disabilitarlo a livello di documento. Questo problema sarà risolto in una futura versione di &kate;

## Usare l'indentazione automatica

Il componente editor di &kate; supporta differenti modalità di autoindentazione progettate per differenti formati di testo. Puoi scegliere tra le modalità disponibili tramite la voce di menu Strumenti Indentazione. Il modulo di autoindentazione mette a disposizione la funzione Strumenti Allinea che ricalcola l'indentazione della riga selezionata o di quella corrente. In questo modo puoi indentare nuovamente il documento selezionando tutto il testo e attivando tale azione.

Tutte le modalità di indentazione usano le impostazioni relative all'indentazione per il documento corrente.

Puoi impostare tutti i tipi di variabili di configurazione, comprese quelle relative all'indentazione, tramite le variabili dei documenti e i tipi di file.

## Modalità di autoindentazione disponibili

Nessuno

- Questa modalità disabilita completamente l'indentazione.

Normale

- Questa modalità si limita a mantenere l'indentazione simile a quella della riga precedente con contenuto diverso da spazi e separatori. Puoi combinarne l'utilizzo con quello delle azioni di indentazione e di rimozione dell'indentazione per indentare come meglio credi.

Stile C

- Un sistema d'indentazione per il linguaggio C ed altri linguaggi analoghi come C++, C#, Java, JavaScript e così via. Questo sistema non funziona per linguaggi di scripting come Perl o PHP.

Stile C SS

- Un sistema d'indentazione alternativo per il linguaggio C ed altri linguaggi simili, con gli stessi vincoli.

Stile Python

- Un sistema d'indentazione specifico per il linguaggio di scripting Python.

XML

- Un indentatore automatico molto interessante per XML. Per quanto sia allettante, non cercare di utilizzarlo con dialetti HTML diversi da XHTML, perché fallisce con i tag HTML vecchio stile (tag aperti come ad esempio <br>)

Indentatore variabile

- L'indentatore variabile è sperimentale, e potrebbe cambiare il suo comportamento o sparire in una prossima versione.

  L'indentatore variabile è speciale nel senso che può essere configurato tramite le variabili del documento (o la configurazione del tipo di file). Vengono lette le seguenti variabili:

  var-indent-indent-after

- Un'espressione regolare che fa sì che una riga sia indentata di una unità, se la prima riga tra le successive non composta di soli spazi bianchi e separatori corrisponde. var-indent-indent: Un'espressione regolare che fa sì che la riga che corrisponde sia indentata di una unità.

var-indent-unindent

- Un'espressione regolare che fa sì che venga tolta l'indentazione di una unità dalla riga che corrisponde.

var-indent-triggerchars

- Una lista di caratteri che, se digitati, causa il ricalcolo immediato dell'indentazione.

var-indent-handle-couples

- Una lista di insiemi di parentesi da gestire. Ogni combinazione di parentesi tonde, quadre o graffe. Ogni tipo di insieme è gestito nel seguente modo: se ve ne sono istanze aperte non corrispondenti nella riga precedente, viene aggiunta un'unità di indentazione; se vi sono delle istanze chiuse non corrispondenti nella riga corrente, viene rimossa un'unità di indentazione.

`var-indent-couple-attribute`

- Quando vengono cercate coppie aperte/chiuse non corrispondenti, sono considerati solo i caratteri con questo attributo. Il valore deve essere il nome dell'attributo del file di sintassi xml, ad esempio "Symbol". Se non è specificato, verrà usato l'attributo 0 (normalmente 'Normal Text').