&Anders.Lund; &Anders.Lund.mail;
&Dominik.Haumann; &Dominik.Haumann.mail;
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 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 &i18n-powermode;

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

&kappname; 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 &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à 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 &i18n-powermode;

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

&kappname; 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.

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 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, l'elemento Aggiungi sarà abilitato in fondo al menu contestuale delle caselle di testo, il quale 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. L'elemento Aggiungi sarà abilitato in fondo al menu contestuale delle caselle di testo 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.

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, 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 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.

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

Puoi scegliere se la ricerca debba distinguere tra maiuscole e minuscole. Selezionare Distingui le maiuscole limiterà la ricerca alle corrispondenze con le stesse maiuscole e minuscole dello schema di ricerca.

Fare clic sul pulsante con la freccia verde 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, o con la scorciatoria &Ctrl;R.

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

Puoi modificare il comportamento di ricerca e sostituzione selezionando le varie opzioni in fondo alla barra. Selezionare Distingui le maiuscole restringerà i risultati a quelli che corrispondono alle maiuscole e minuscole di ogni carattere dello schema di ricerca. Solo la selezione effettuerà 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 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 la sezione Espressioni regolari per maggiori informazioni.

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

## Usare i segnalibri &i18n-powermode;

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 &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 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 &kappname;.

## Usare il rientro automatico &i18n-powermode;

Il componente editor di &kappname; supporta differenti modalità di autorientro progettate per differenti formati di testo. Puoi scegliere tra le modalità disponibili tramite la voce di menu Strumenti Rientro. Il modulo di autorientro 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 autorientro disponibili

Nessuno

  Questa modalità disabilita completamente il rientro.

Normale

  Questa modalità si limita a mantenere il rientro simile a quella 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 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, o puoi disattivare del tutto questa funzionalità nella scheda Bordi del pannello di configurazione Aspetto.

## La minimappa di scorrimento

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

La minimappa di scorrimento mostra un'anteprima del codice sorgente di &kate;.

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