&Anders.Lund; &Anders.Lund.mail;
&Dominik.Haumann; &Dominik.Haumann.mail;
Zamponi

    zapaolo@email.it

Aggiornamento
Luigi
Toscano
Traduzione
Federico
Zenith

    federico.zenith@member.fsf.org

Manutenzione della documentazione

# Lavorare con l'editor &kappname;

## Panoramica

L'editor &kappname; è l'area modificabile della finestra di &kappname;. Questo editor è condiviso tra &kate; e &kwrite;, e può essere usato anche da &konqueror; per mostrare i 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 le 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 i 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 di espandere i blocchi raggruppabili di righe. Le regioni richiudibili 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 il testo

- Trovare e sostituire il testo

- Usare i segnalibri

- Andare a capo automaticamente

- Usare il rientro automatico

## Navigare nel testo

Lo spostamento nel testo in &kappname; 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 lo scorrimento della pagina invece dello spostamento del cursore.

- Per i tasti Sinistra e Destra significa saltare le parole invece dei 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.

&kappname; ti mette anche a disposizione un modo per saltare rapidamente ad 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 &kappname;: 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à selezionata interamente.

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 il 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 dei 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 il testo

Per copiare del testo selezionalo, ed usa la voce di menu Modifica Copia. Inoltre, se selezioni 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 il testo copiato precedentemente da una qualsiasi applicazione tramite l'icona di &klipper; nel vassoio di sistema.

## Trovare e sostituire il testo

### Le barre di ricerca e di sostituzione

&kappname; ha una barra di ricerca incrementale ed una barra di ricerca e di 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.

Distingui le maiuscole

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

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

Testo semplice

  Cerca le 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 l'elemento Aggiungi sarà abilitato in fondo al menu contestuale delle caselle di testo, così potrai aggiungere le 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. L'elemento Aggiungi sarà abilitato in fondo al menu contestuale delle caselle di testo, così potrai aggiungere un'espressione regolare allo schema di ricerca da un elenco predefinito.

  Vedi la sezione Espressioni regolari per maggiori informazioni.

Cerca solo all'interno della selezione

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

Trova tutti

  Fare clic su questo pulsante evidenzia tutte le corrispondenze nel documento, e ne mostra il numero in una finestrella a comparsa.

### Trovare del testo

Per trovare del testo 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 pulsante con un'icona per chiudere la barra, seguito da una piccola casella di testo per inserire la chiave di ricerca.

Quando inizi 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.

Usa il pulsante oppure per andare alla corrispondenza precedente o successiva nel documento.

Le corrispondenze nel documento sono evidenziate anche quando chiudi la barra di ricerca; premi il tasto &Esc; per togliere questa evidenziazione.

Puoi scegliere se la ricerca debba distinguere tra maiuscole e minuscole: selezionando limiterai la ricerca alle corrispondenze con le stesse maiuscole e minuscole dello schema di ricerca.

Fai clic sul pulsante nella parte destra della barra di ricerca incrementale per usare la barra potenziata di ricerca e sostituzione.

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, oppure con la scorciatoia &Ctrl;R.

In alto a sinistra nella barra c'è un pulsante con un'icona per chiudere la barra, seguito 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 dal menu a discesa.

Se sono selezionate Sequenze di escape o Espressione regolare, l'elemento di menu Aggiungi... in fondo al menu contestuale delle caselle di testo sarà abilitato, e ti permetterà di aggiungere delle sequenze di escape o delle espressioni regolari per cercare o sostituire dei modelli da liste predefinite.

Usa il pulsante oppure per andare alla corrispondenza precedente o successiva nel documento.

Inserisci il testo da sostituire nella casella di testo indicata con Sostituisci, e premi il pulsante Sostituisci per sostituire solo il testo evidenziato; premi il pulsante Sostituisci tutto per sostituire il testo cercato in tutto il documento.

Puoi modificare il comportamento di ricerca e sostituzione selezionando opzioni diverse in fondo alla barra. Selezionando restringerai i risultati a quelli che corrispondono alle maiuscole e minuscole di ogni carattere dello schema di ricerca, mentre con effettuerai la ricerca e la sostituzione solo all'interno della selezione attuale. Il pulsante Trova tutti evidenzia tutte le corrispondenze nel documento, e ne mostra il numero in una finestrella a comparsa.

Fai clic sul pulsante 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 nei sottoschemi tra parentesi dell'espressione.

Vedi la sezione Espressioni regolari per maggiori informazioni.

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

## Usare i segnalibri

I segnalibri ti consentono di marcare alcune righe 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 &Alt;Pag↓Segnalibri Successivo o &Alt;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 interrompe automaticamente 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 dimensione massima 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 per ogni singolo documento. Questo problema sarà risolto in una futura versione di &kappname;.

## Usare il rientro automatico

Il componente editor di &kappname; supporta differenti modalità di auto-rientro progettate per differenti formati di testo. Puoi scegliere tra le modalità disponibili tramite la voce di menu Strumenti Rientro. Il modulo di auto-rientro mette a disposizione la funzione Strumenti Allinea che ricalcola il rientro della riga selezionata o di quella corrente. In questo modo puoi far rientrare nuovamente il documento selezionando tutto il testo e attivando tale azione.

Tutte le modalità di rientro usano le impostazioni relative al rientro per il documento corrente.

Puoi impostare tutti i tipi di variabili di configurazione, comprese quelle relative al rientro, con le variabili dei documenti e i tipi di file.

### Modalità di auto-rientro disponibili

Nessuno

  Questa modalità disabilita completamente il rientro.

Normale

  Questa modalità si limita a mantenere il rientro simile a quello della riga precedente con contenuto diverso da spazi e separatori. Puoi combinarne l'utilizzo con quello delle azioni di rientro e di rimozione del rientro per far rientrare come meglio credi.

Stile C

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

Haskell

  Un sistema di rientro specifico per il linguaggio di programmazione funzionale Haskell.

Lilypond

  Un sistema di rientro specifico per il linguaggio di notazione musicale Lilypond.

Lisp

  Un sistema di rientro specifico per il linguaggio di scripting Lisp e i suoi dialetti.

Python

  Un sistema di rientro specifico per il linguaggio di scripting Python.

Stile XML

  Un sistema di rientro specifico i linguaggi simili a XML.

## Indicatori di modifica delle righe

Gli indicatori di modifica delle righe di &kappname; permettono di vedere immediatamente cosa è stato appena modificato in un file. Come impostazione predefinita le modifiche salvate vengono indicate da una barra verde a sinistra del documento, mentre quelle non salvate sono indicate in arancione.

Gli indicatori di modifica delle righe in azione.

Puoi cambiare i colori usati nel pannello di configurazione Caratteri e colori, oppure puoi disattivare del tutto questa funzionalità nella scheda Bordi del pannello di configurazione Aspetto.

## La mini-mappa di scorrimento

La mini-mappa di scorrimento di &kappname; mostra un'anteprima dei documenti al posto della barra di scorrimento. La porzione attualmente visibile del documento viene evidenziata.

La mini-mappa di scorrimento mostra un'anteprima del codice sorgente di &kate;.

Puoi abilitare o disabilitare temporaneamente la mini-mappa selezionando Visualizza Mostra mini-mappa di scorrimento o impostarla permanentemente nella sezione Aspetto della configurazione di &kappname;.