&Anders.Lund; &Anders.Lund.mail;
Luigi
Toscano
Traduzione
Federico
Zenith

    federico.zenith@member.fsf.org

Manutenzione della documentazione

# 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 e i tasti Pag↑, Pag↓, 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 ↑ e ↓ significa scorrimento della pagina invece di spostamento del cursore.

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

- Per i tasti Pag↑ e Pag↓ 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 a una parentesi corrispondente: metti il cursore all'interno di una parentesi e premi &Ctrl;6 per saltare alla parentesi corrispondente.

Inoltre puoi usare 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 con la tastiera, tieni premuto il tasto &Shift; mentre utilizzi i tasti di navigazione (i tasti freccia, Pag↑, Pag↓, Home e Fine, anche 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 è &Ctrl;&Shift;B.

### 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 cursore e 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 cursore e 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 recuperare da una qualsiasi applicazione il testo copiato precedentemente tramite l'icona di &klipper; nel vassoio di sistema.

## Trovare e sostituire testo

### Le barre di ricerca e sostituzione

&kate; ha una barra di ricerca incrementale e una barra di ricerca e sostituzione potenziata che permette di inserire una stringa di sostituzione, oltre ad alcune altre opzioni.

Le barre presentano le seguenti opzioni comuni:

Trova

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

Evidenzia tutto

  Se abilitato, evidenzia tutte le corrispondenze nell'intero documento.

Distingui le maiuscole

  Se abilitato, la ricerca sarà limitata alle corrispondenze con le stesse maiuscole nello schema di ricerca.

Dal cursore

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

La barra potenziata di ricerca e sostituzione mette a disposizione alcune altre opzioni:

Testo semplice

  Cerca corrispondenze letterali della stringa di ricerca.

Parole intere

  Se selezionato, la ricerca avrà successo solo se c'è un delimitatore di parola ad entrambi gli estremi della stringa trovata, cioè un carattere non alfanumerico: qualche altro carattere visibile o un fine riga.

Sequenze di escape

  Se selezionato, sarà abilitato il pulsante Aggiungi, che permette di aggiungere sequenze di escape nello schema di ricerca da un elenco predefinito.

Espressione regolare

  Se selezionato, la stringa di ricerca viene interpretata come un'espressione regolare. Verrà attivato il pulsante Aggiungi per aggiungere elementi dell'espressione regolare allo schema di ricerca da un elenco predefinito.

  Vedi la sezione Espressioni regolari per maggiori informazioni.

Solo la selezione

  Se abilitato, la ricerca e la sostituzione saranno effettuate solo nel testo selezionato.

### Trovare del testo

Per trovare del, avvia la barra di ricerca incrementare con &Ctrl;F o dall'elemento del menu Modifica Trova....

Ciò apre la barra di ricerca incrementale nella parte bassa della finestra dell'editor. Nella parte sinistra della barra c'è un'icona per chiuderla, seguita da una piccola casella di testo per inserire la chiave di ricerca.

Quando si inizia ad inserire la chiave di ricerca, la ricerca inizia immediatamente. Se c'è una corrispondenza nel testo, questa viene evidenziata e lo sfondo della casella di testo diventa verde chiaro. Se la ricerca non dà risultati, lo sfondo della casella di testo diventa rosso chiaro e nella parte destra della barra viene visualizzato Non trovato.

Si usano i pulsanti Successivo o Precedente per andare alla corrispondenza precedente o successiva nel documento della chiave di ricerca.

Puoi modificare il comportamento della ricerca selezionando le diverse Opzioni descritte sopra.

Fare clic sulla freccia verde nella parte destra della barra di ricerca incrementale per usare la barra potenziata di ricerca e sostituisci.

Per ripetere l'ultima operazione di ricerca, se ce n'è una, senza richiamare la barra di ricerca incrementale, usa F3 Modifica Trova successivo o &Shift;F3 Modifica Trova precedente.

### Sostituire il testo

Per sostituire il testo, avvia la barra di ricerca e sostituzione potenziata con Modifica Sostituisci, o con la scorciatoria &Ctrl;R.

In alto a sinistra nella barra c'è un'icona per chiuderla, seguita da una casella di testo per inserire lo schema di ricerca.

Puoi controllare la modalità di ricerca selezionando le opzioni Testo semplice, Parole intere, Sequenze di escape o Espressione regolare, come descritto sopra.

Si usano i pulsanti Successivo o Precedente per andare alla corrispondenza precedente o successiva nel documento della chiave di ricerca.

Inserisci il testo da sostituire nella casella di testo indicata con Sostituisci e premi il pulsante Sostituisci per sostituire solo il testo evidenziato, o il pulsante Sostituisci tutto per sostituire il testo cercato in tutto il documento. Se l'opzione Usa segnaposti è attivata, puoi aggiungere degli elementi speciali nel testo da sostituire facendo clic sul pulsante Aggiungi.

Puoi modificare il comportamento di ricerca e sostituzione selezionando le diverse opzioni sul lato destro della barra.

Fai clic sull'icona con la freccia verde sul lato destro della barra potenziata di ricerca e sostituzione per passare alla barra di ricerca incrementale.

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

Vedi 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 alla riga e attivando 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 o precedente, usa i comandi &Ctrl;Pag↓Segnalibri Successivo o &Ctrl;Pag↑Segnalibri Precedente.

## 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 o disattivarla, attiva o disattiva la casella Abilita a capo automatico statico nella pagina di modifica della finestra di configurazione.

Per impostare la larghezza massima di una riga (il numero massimo di caratteri) 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, con 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é non funziona 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 con delle variabili nel documento (o in una configurazione del tipo di file). Vengono lette le seguenti variabili:

  var-indent-indent-after

    Un'espressione regolare che fa indentare una riga di un'unità, se la prima riga non di soli spazi precedente corrisponde.

  var-indent-indent

    Un'espressione regolare che fa indentare una riga corrispondente 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. Qualsiasi combinazione di parentesi tonde, quadre o graffe. Ogni tipo di insieme viene gestito così: 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').