# Manuale di &kwrite;

## Introduzione

&kwrite; è più di un editor di testo per il Desktop &kde;. È pensato per essere un editor per programmatori e potrebbe essere considerato come una parziale alternativa ad editor molto più potenti. Può essere meglio utilizzato in congiunzione con &konqueror; per navigare tra i file sorgenti di differenti linguaggi. &kwrite; funziona molto bene come semplice editor di testo. Una delle principali funzionalità di &kwrite; è la colorazione della sintassi, personalizzata per tanti diversi linguaggi di programmazione quali: C/C++, &Java;, Python, Perl, Bash, Modula 2, HTML, e Ada.

## Alcune cose Fondamentali

&kwrite; è molto semplice da utilizzare. Chiunque abbia già utilizzato un editor di testo non dovrebbe incontrare problemi.

### Drag and Drop (Trascinamento)

&kwrite; usa il protocollo Drag and Drop di &kde;. I file possono essere trascinati e rilasciati su &kwrite; dal Desktop, &konqueror; o da qualche sito &FTP; remoto aperto in una delle finestre di &konqueror;.

### Opzioni della Linea di Comando

Anche se la maggior parte delle volte si lancia &kwrite; dal menu dei programmi di KDE, o da un'icona del desktop, può anche essere aperto al prompt della linea di comando o in una finestra di terminale. Ci sono diverse opzioni utili disponibili in questa modalità.

#### Specifica un File

Specificando il percorso e il nome di un particolare file l'utente può far si che &kwrite; apra (o crei) quel file immediatamente all'avvio. Questa opzione può assomigliare a questa:

    % kwrite
    /home/miahome/docs/miofile.txt

#### Specifica un file su internet

Il metodo sopra menzionato può essere usato per aprire file su internet (se l'utente ha una connessione attiva in quel momento.) Un esempio di questo può essere il seguente:

    % kwrite
    ftp://ftp.kde.org/pub/kde/Benvenuto.msg

#### Altre Opzioni della Linea di Comando

Sono disponibili le seguenti opzioni di aiuto della linea di comando

``kwrite` `--help``

- Elenca le opzioni di base disponibili alla linea di comando.

``kwrite` `--help-qt``

- Elenca le opzioni disponibili per cambiare il modo in cui &kwrite; interagisce con &Qt;.

``kwrite` `--help-kde``

- Elenca le opzioni disponibili per cambiare il modo in cui &kwrite; interagisce con &kde;.

``kwrite` `--help-all``

- Elenca tutte le opzioni della linea di comando.

``kwrite` `--author``

- Elenca gli autori di &kwrite; nella finestra del terminale

``kwrite` `--version``

- Elenca le informazioni di versione per &Qt;, &kde; e &kwrite;. Disponibili inoltre attraverso ``kwrite` `-V``

### Associazioni di tasti

Molte delle combinazioni di tastiera (scorciatoie) sono configurabili attraverso il menu Configura l'editor. Per default &kwrite; onora le seguenti combinazioni di tastiera.

Inserisci | Alterna tra la modalità Inserisci e Sovrascrivi. Quando si è in modalità inserisci l'editor aggiungerà qualsiasi carattere digitato al prossimo mentre spinge via qualsiasi dato alla destra del cursore testo. Con la modalità sovrascrivi ogni ingresso di un carattere elimina quello immediatamente alla destra del cursore testo.
Freccia Sinistra | Sposta il cursore di un carattere a sinistra
Freccia Destra | Sposta il cursore di un carattere a destra
Freccia Su | Sposta il cursore in su di una linea
Freccia Giù | Sposta il cursore in giù di una linea
Pag Su | Sposta il cursore in su di una pagina
Pag Giù | Sposta il cursore in giù di una pagina
Backspace | Cancella il carattere a sinistra del cursore
Home | Sposta il cursore all'inizio della linea
Fine | Sposta il cursore alla fine della linea
Cancella | Cancella il carattere alla destra del cursore (o qualsiasi testo selezionato)
&Shift;Freccia Sinistra | Seleziona il testo a sinistra di un carattere
&Shift;Freccia Destra | Seleziona il testo a destra di un carattere
F1 | Aiuto
&Shift;F1 | Che cos'è?
&Ctrl;F | Trova
F3 | Trova successivo
&Ctrl;C | Copia il testo selezionato nel blocconote.
&Ctrl;B | Aggiungi un segna-libro
&Ctrl;N | Nuovo documento
&Ctrl;P | Stampa
&Ctrl;Q | Esci - chiude la copia attiva dell'editor
&Ctrl;R | Sostituisci
&Ctrl;S | Invoca il comando Salva.
&Ctrl;V | Incolla il testo del blocco-note nella linea di edit.
&Ctrl;X | Cancella il testo selezionato e lo copia nel blocco-note.
&Ctrl;Z | Annulla
&Ctrl;&Shift;Z | Rifai

## Gli Elementi del Menu

### Il Menu File

&Ctrl;N File Nuovo

- Inizia un nuovo Documento nell'editor. Se c'è un documento corrente le cui modifiche non sono state memorizzate viene data all'utente la possibilità di salvarlo.

&Ctrl;O File Apri...

- Questo comando apre un file attraverso una finestra di dialogo che permette all'utente di navigare il file system. La finestra funziona come un piccolo file manager. Facendo clic sulle cartelle nella finestra centrale si comanda alla finestra di entrare in quella cartella - mostrandone il contenuto. C'è una casella a cascata che permette di digitare direttamente la locazione e il nome del file o, facendo clic sulla freccia a lato, di scegliere da una lista a comparsa di locazioni usate di recente. Sotto a questo c'è un filtro in cui, analogamente, si può inserire dati direttamente o scegliere da una lista a comparsa i tipi di filtri recenti. Il filtro permette solo ai file che corrispondono alle specifiche di essere mostrati nella finestra centrale. Se il filtro contenesse del testo come`*.txt` sarebbero visibili unicamente i file con l'estensione `txt` nella finestra di selezione. Sotto al filtro c'è una barra di stato che dà informazioni riguardo al numero di file e di sotto-cartelle all'interno della cartella attuale.

  La barra degli strumenti, che si trova in cima alla finestra, ha i pulsanti-freccia destra e sinistra che permettono all'utente di muoversi avanti e indietro attraverso le cartelle precedentemente selezionate così come una freccia su per muoversi in su nell'albero delle cartelle. Il pulsante con la piccola casa porta l'utente alla sua cartella home e quello con le due frecce curve su loro stesse aggiorna la vista della cartella corrente. Il bottone con la bandiera permette all'utente di impostare un nuovo segna-libro alla cartella corrente o di andare a una precedentemente impostata.

  L'ultimo pulsante sulla barra degli strumenti permette di creare una nuova cartella e cambiare addirittura alcune impostazioni di base della finestra di dialogo e, infine, c'è un menu a comparsa con una lista di alcune delle cartelle più visitate.

File Apri recenti

- Questa è una scorciatoia per aprire i documenti salvati recentemente. Facendo clic su questo elemento si apre una lista a lato del menu rappresentante i diversi file salvati di recente. Facendo clic su uno specifico file questo si aprirà in &kwrite; - se il file risiede ancora nella stessa posizione.

&Ctrl;S File Salva

- Questo salva il documento corrente. Se il documento è già stato precedentemente salvato ne verrà sovrascritta la copia senza chiedere il consenso dell'utente. Se questa è la prima volta che si salva un nuovo documento sarà richiamata la finestra di dialogo salva con nome (descritta sotto).

File Salva con nome...

- Permette ad un documento di essere salvato con un nuovo nome. Questo attraverso la finestra di dialogo descritta sopra nella sezione Apri di questo file di guida.

&Ctrl;P File Stampa...

- Apre una semplice finestra di dialogo di stampa che permette all'utente di specificare cosa, dove e come stampare

&Ctrl;Q File Esci

- Chiude la finestra dell'editor. Se hai più di una istanza di &kwrite; in esecuzione, aperta attraverso gli elementi del menu Nuova Vista o Nuova Finestra, queste istanze non saranno chiuse.

### Il Menu Modifica

&Ctrl;Z Modifica Annulla

- Usato per eliminare o annullare l'azione o l'operazione più recente dell'utente. Quello che avviene con questa azione può essere meglio compreso riferendosi alla sezione di questo manuale su Gruppi di Annulla.

&Ctrl;&Shift;Z Modifica Rifai

- Questo annullerà la modifica più recente (se c'è) fatta usando Annulla

&Ctrl;X Modifica Taglia

- Questo comando cancella la selezione corrente e la mette nella clipboard. La clipboard è una funzionalità di KDE che, in maniera invisibile, offre un modo per trasferire dati tra le applicazioni.

&Ctrl;C Modifica Copia

- Copia la selezione corrente nella clipboard così che possa essere incollata da qualche altra parte. La clipboard è una funzionalità di KDE che, in maniera invisibile, offre un modo per trasferire dati tra le applicazioni.

&Ctrl;V Modifica Incolla

- Inserisce il contenuto della clipboard alla posizione del cursore. La clipboard è una funzionalità di KDE che, in maniera invisibile, offre un modo per trasferire dati tra le applicazioni.

&Ctrl;A Modifica Seleziona tutto

- Seleziona l'intero documento. Ciò potrebbe essere molto utile per copiare l'intero file in un'altra applicazione.

&Ctrl;G Modifica Vai a linea

- Apre la finestra di dialogo vai alla linea, per far saltare il cursore ad una particolare linea (specificata da un numero) nel documento. Il numero della linea può essere inserito direttamente nella casella di testo o graficamente, facendo clic sulle frecce direzionali su o giù, a lato della casella di testo. La piccola freccia su incrementerà il numero della linea e la freccia giù lo decrementerà. C'è anche uno controllo di scorrimento a destra della casella di testo che permette all'utente di muovere il punto di "vai alla linea" in maniera analoga.

&Ctrl; F Modifica Trova

- Apre la finestra di dialogo trova che è usata per specificare il Testo da Cercare nel documento. C'è una piccola casella di testo per inserire lo schema di ricerca che è anche rappresentato da una box a comparsa. Fare clic sulla freccia della box a comparsa al lato della box rende disponibili altri recenti schemi di ricerca. Altri parametri sono inclusi per rendere la ricerca più efficiente. Selezionando Distingui Maiuscole le voci ritrovate saranno limitate a quelle corrispondenti carattere per carattere allo "schema di ricerca" considerando la distinzione tra maiuscolo e minuscolo. Trova all'Indietro impone la ricerca verso l'alto. L'opzione Testo Selezionato effettua la ricerca solo sul testo correntemente selezionato. Facendo clic su Solo Parole Intere si previene che la ricerca si interrompa su parole che contengano al loro interno il pattern di ricerca. L'opzione Dal Cursore comincia la ricerca dalla posizione corrente del cursore all'interno del documento invece che dal suo inizio.

F3 Modifica Trova successivo

- Ripete l'ultima operazione di ricerca, senza usare di nuovo la finestra Trova.

&Shift; Modifica Trova Precedente

- Ripete l'ultima ricerca, se c'è, senza richiamare la finestra di dialogo trova, e cercando indietro invece che in avanti attraverso il documento.

&Ctrl; R Modifica Sostituisci

- Questo comando apre la finestra di dialogo sostituisci. La finestra di dialogo sostituisci è quasi identica alla sopra-menzionata finestra di dialogo trova. In aggiunta alle caratteristiche della finestra di dialogo trova, c'è una casella di testo con menu a cascata chiamata Sostituisci con: . Usando questa finestra di dialogo l'utente può specificare sia il testo che deve essere cercato sia quello con cui sarà sostituito. L'opzione aggiuntiva Chiedi prima di sostituire permette all'utente di avere la richiesta di conferma da parte di &kwrite; prima di ogni sostituzione.

### Il menu Segnalibri

&Ctrl; B Segnalibri Cambia Segnalibro

- Ancora da scrivere

Segnalibri Pulisci

- Questo comando rimuoverà tutti i segnalibri dal documento così come la lista dei segnalibri che si trova alla base di questo elemento di menu.

Alla base di questo menu, appare una lista di segnalibri se è disponibile qualche segnalibro per questa finestra.

### Il menu Strumenti

Strumenti Ortografia...

- Lancia il programma di controllo ortografico - un programma dedicato ad aiutare l'utente a scovare e correggere qualsiasi errore di scrittura. Facendo clic su questa voce comincerà il controllo e verrà aperta la finestra di dialogo del correttore, attraverso la quale l'utente può controllare il processo. Ci sono quattro impostazioni allineate verticalmente al centro della finestra con alla loro sinistra l'etichetta corrispondente. A partire dall'alto abbiamo:

  Parola sconosciuta:

- Qui, il controllo ortografia indica la parola sotto esame. Questo accade quando si incontra una parola non contenuta nel dizionario - un file che contiene una lista di parole corrette ortograficamente che vengono comparate con tutte quelle presenti nell'editor.

Sostituisci con:

- Se il controllo ha qualche parola simile nel suo dizionario, la prima viene inclusa qui. L'utente può accettare il suggerimento, scrivere la propria correzione, o scegliere un differente suggerimento dalla prossima casella.

Suggerimenti:

- Il controllo può inserire qui una lista di possibili sostituzioni per la parola presa in considerazione. Facendo clic su qualsiasi suggerimento questo va a sostituire la parola nella casella Sostituzioni:, in alto.

Lingua:

- Se hai installato diversi dizionari, qui puoi scegliere quale dizionario/lingua debba essere usato.

Sul lato destro della finestra di dialogo ci sono cinque pulsanti che permettono all'utente di controllare il processo di controllo ortografico. Questi sono:

Aggiungi al Dizionario

- Premendo questo pulsante si aggiungerà la Parola Sbagliata: nel dizionario del correttore. Questo significa che in futuro il controllo considererà questa parola ortograficamente corretta.

Sostituisci

- Questo pulsante ha il compito di sostituire la parola sotto esame nel documento con la parola nella casella Sostituzioni:.

Sostituisci Tutto

- Questo pulsante fa sì che il controllo rimpiazzi non solo la corrente Parola Scorretta: ma automaticamente faccia la stessa sostituzione per ogni altra occorrenza di questa Parola Scorretta: nel documento.

Ignora

- Attivando questo pulsante il controllo proseguirà oltre senza applicare cambiamenti.

Ignora sempre

- Questo pulsante comunica al controllo di ignorare questa Parola sconosciuta ed andare oltre senza considerare altre eventuali occorrenze della stessa parola.

  Questo è applicato solo al controllo corrente. Se il controllo sarà riavviato in un secondo momento, si fermerà su questa stessa parola.

Altri tre pulsanti sono localizzati lungo la base della finestra del controllo ortografico. Essi sono:

Aiuto

- Apre il sistema di guida di KDE cominciando dalle pagine di aiuto di &kwrite; (questo documento).

Finito

- Questo pulsante ferma il processo di correzione e ritorna al documento.

Annulla

- Questo pulsante annulla il processo di controllo ortografico; tutte le modifiche sono annullate e si ritornerà al proprio documento.

&Ctrl;I Strumenti Indenta

- Incrementa l'indentazione del paragrafo di un passo. La dimensione del passo dipende dall'impostazione di indentazione.

&Ctrl;&Shift;I Strumenti Annulla Indentazione

- Riduce l'indentazione del paragrafo di un passo. La dimensione del passo dipende dall'impostazione di indentazione.

Strumenti Pulisci Indentazione

- Non ancora implementato

&Ctrl;D Strumenti Commenta

- Aggiunge uno spazio all'inizio della linea dove è posizionato il cursore testo o all'inizio di qualsiasi linea selezionata.

&Ctrl;&Shift;D Strumenti Decommenta

- Rimuove uno spazio (se esiste) dall'inizio della linea dove è posizionato il cursore testo o dall'inizio di qualsiasi linea selezionata.

### Il menu Impostazioni

Impostazioni Mostra la barra degli strumenti

- Quando è selezionato, visualizza una barra degli strumenti spostabile, contenente i pulsanti utilizzati per iniziare comandi usati di frequente. Quando non è selezionata la barra degli strumenti è nascosta.

Impostazioni Mostra la barra di stato

- Quando è attivata, visualizza una piccola barra alla base dell'editor contenente informazioni sullo stato del documento corrente. Quando non è attivata la barra di stato è nascosta.

Impostazioni Mostra Percorso

- Quando è attivata, visualizza nella barra del titolo il percorso (la sua locazione nel file system) del documento corrente. Quando non è attivata il percorso è nascosto.

Impostazioni Configura Editor

- Questa voce del menu apre una finestra dove è possibile modificare diverse impostazioni.

Impostazioni Configura le scorciatoie...

- Questo comando apre una finestra di dialogo dove le Scorciatoie possono essere cambiate. Un riquadro in cima alla finestra di dialogo mostra la lista dei comandi (azioni) che possono avere una scorciatoia di tastiera. Al di sotto del riquadro ci sono tre pulsanti radio. L'utente può scegliere tra Nessun tasto, Tasto Predefinito e Tasto Personalizzato. (Nota che un insieme di pulsanti radio permette la selezione di uno solo degli elementi offerti - allo stesso modo in cui l'autoradio di un automobile permette la selezione di una sola delle stazioni preimpostate. Inoltre la selezione Tasto Predefinito è disponibile solo per quei comandi che hanno attualmente una scorciatoia 'predefinita'). Selezionando l'opzione Tasto Personalizzato si attivano le tre caselle di selezione e il pulsante tasto alla base della finestra. L'utente può allora selezionare una combinazione di tasti per il comando in questione per mezzo delle caselle di selezione e del pulsante tasto. Per esempio, con il comando Informazioni su KDE selezionato nel display, l'utente può selezionare &Ctrl; e Alt. fare clic sul pulsante tasto, e poi premere il tasto K sulla tastiera. Questo significherebbe che ogni volta che si tengono premuti i pulsanti &Ctrl; e Alt e si preme K (mentre si usa &kwrite;) verrebbe richiamata la finestra di dialogo Informazioni su KDE.

Impostazioni Configura le barre degli strumenti...

- Apre una finestra di dialogo in cui la configurazione della barra degli strumenti può essere modificata. L'utente può scegliere quali pulsanti di scorciatoia debbano apparire sulla barra degli strumenti. Un riquadro sulla sinistra elenca i comandi disponibili da mettere nella barra degli strumenti. Un riquadro sulla destra elenca quei comandi che sono già nella barra degli strumenti. Un insieme di quattro pulsanti freccia tra i due riquadri manipolano le selezioni. La freccia che punta a destra dispone qualsiasi comando selezionato nel pannello di sinistra nel pannello di destra, cioè li aggiunge nella barra degli strumenti. La freccia a sinistra fa l'esatto contrario, rimuovendo qualsiasi azione selezionata nel riquadro a destra dalla barra degli strumenti. Le frecce che puntano in su e in giù cambiano la posizione di una azione selezionata nel riquadro a destra, modificando così l'ordine dei suoi pulsanti nella barra degli strumenti.

### Il menu Aiuto

&help.menu.documentation;

## Configura &kwrite;

Selezionando Impostazioni Configura Editor dal menu, si apre la finestra di dialogo Configura Editor. Questa finestra di dialogo può essere utilizzata per modificare diverse impostazioni. Le impostazioni disponibili da cambiare variano a seconda di quale categoria l'utente scelga dalla lista verticale sul lato sinistro della finestra. Per mezzo di tre pulsanti lungo la base della finestra l'utente può controllare il processo.

Si può invocare il sistema di Aiuto, accettare le impostazioni correnti e chiudere la finestra di dialogo per mezzo del pulsante OK o, con Annulla, annullare il processo. Le categorie Colori, Tipo di carattere, Indentazione, Selezione, Modifica, Controllo ortografico, Evidenziazione sono descritte sotto.

### Colori

Questa sezione fornisce l'accesso a due differenti impostazioni di colore, descritte sotto. Ognuna di queste impostazioni può essere cambiata facendo clic sul pulsante corrispondente. Questi sono larghi pulsanti speciali che rappresentano il colore dell'impostazione corrente. Facendo clic su uno dei pulsanti si apre una finestra di dialogo per cambiare l'impostazione.

La finestra di dialogo del colore fornisce un modo conveniente e visivo per selezionare un colore. In alto a sinistra nella finestra c'è un rettangolo che visualizza uno spettro di colori. Sulla sua immediata destra c'è una barra verticale che visualizza un intervallo di intensità, dalla più scura in basso, alla più chiara in alto. L'utente può selezionare e modificare un colore facendo clic su uno di questi strumenti. Facendo clic sul riquadro rettangolare si seleziona un mix particolare dei colori rosso, verde e blu e sulla barra verticale si seleziona un livello (valore) di intensità. I vari attributi di colore sono visualizzati in forma numerica in piccole caselle di testo localizzate direttamente sotto al rettangolo dello spettro e l'utente può vederle cambiare mentre il colore viene regolato. Questi attributi includono il mix delle componenti di base del colore (rosso, verde e blu) così come i livelli di tonalità e di saturazione. Alternativamente l'utente può inserire i numeri direttamente in queste caselle. C'è anche un quadrato in basso al centro della finestra di dialogo che visualizza il colore che è considerato in qualsiasi momento. Alla destra di questo display c'è un altra casella di testo etichettata HTML:. Questa mostra all'utente il codice di colore che sarebbe utilizzato in HTML che è ampiamente usato nelle pagine web.

In aggiunta a quanto detto sopra, la finestra di dialogo colore permette la cattura di qualsiasi colore correntemente visualizzato sul desktop o in un altro programma. Facendo clic sul pulsante con l'icona del contagocce (situata sul lato destro della finestra di dialogo) la forma del cursore del mouse si trasforma in un mirino. Facendo clic di nuovo si selezioneranno gli attributi di qualsiasi colore sia visualizzato sotto del mirino.

Inoltre l'utente ha la possibilità di aggiungere qualsiasi colore ad una tavolozza personale di Colori Personalizzati facendo clic sul largo pulsante etichettato Aggiungi ai Colori Personalizzati (che si trova direttamente al di sopra del riquadro). Ciò aggiunge il colore corrente alla tavolozza dei colori personalizzati. Questa tavolozza, come qualsiasi altra tavolozza disponibile, può essere visualizzata usando la casella di selezione a comparsa collocata direttamente al di sopra del riquadro della tavolozza in alto a destra nella finestra di dialogo. A parte i colori personalizzati, l'utente può accedere a diverse tavolozze preimpostate.

Sfondo

- Qui l'utente può specificare il colore per lo sfondo generico di &kwrite;.

Selezionato

- Permette all'utente di selezionare un colore da usare per indicare (o evidenziare) la porzione selezionata del documento.

### Tipi di carattere

Qui puoi scegliere il carattere di default per &kwrite;. Puoi scegliere tra tutti i caratteri disponibili sul tuo sistema e impostare una dimensione e una codifica di default. Un testo di esempio è mostrato alla base della finestra di dialogo, così che tu possa vedere gli effetti delle tue scelte.

### Indenta

Indentazione automatica

- Fa in modo che le nuove linee inizino con lo stesso livello di indentazione della linea precedente.

Indenta Con Spazi

- Sostituisce le tabulazioni con un numero di spazi selezionato nella finestra Larghezza Tabulazioni nella sezione Modifica della finestra di dialogo delle preferenze.

Il Tasto Backspace Indenta

- Permette di usare il tasto backspace per indentare.

Il Tasto Tab Indenta

- Permette di usare il tasto tab per indentare.

Conserva gli Spazi Extra

- Le indentazioni maggiori del numero di spazi selezionato non saranno accorciate.

### Seleziona

Selezione Permanente

- Impedisce che l'inserimento o il movimento del cursore per mezzo dei tasti di direzione causi l'eliminazione del testo selezionato.

  (Nota: Se l'opzione di Selezione con Sovrascrittura è attivata allora qualsiasi carattere digitato in ingresso o operazione di incolla sostituirà il testo selezionato.)

Selezioni con sovrascrittura

- Qualsiasi carattere digitato in input o operazione di incolla sostituirà il testo selezionato.

Mouse Autocopia

- Qualsiasi testo selezionato con il mouse sarà automaticamente copiato negli appunti.

Selezione Singola come in X11

- Non ancora implementato.

Selezione Verticale

- Attiva l'opzione di Selezione Verticale.

Alterna Vecchio Selezione

- Non ancora implementato

### Modifica

A capo automatico

- L'a capo automatico è una funzionalità che fa iniziare automaticamente all'editor una nuova linea di testo e sposta il cursore all'inizio di quella nuova linea. &kwrite; comincerà automaticamente una nuova linea di testo quando la linea corrente raggiungerà la lunghezza specificata dall'opzione Colonna a cui Andare a Capo.

Colonna a cui Andare a Capo:

- Se l'opzione A Capo Automatico è selezionata questa casella determina la lunghezza (in caratteri) arrivata alla quale l'editor comincerà automaticamente una nuova linea.

Usa gli Spazi invece delle Tabulazioni

- &kwrite; sostituirà qualsiasi tabulazione con il numero di spazi indicato nella casella Numero di spazi.

Numero di Spazi

- Se l'opzione Usa gli Spazi invece delle Tabulazioni è selezionata questa voce determina il numero di spazi con i quali l'editor rimpiazzerà automaticamente i tab.

Rimuovi gli spazi extra

- &kwrite; eliminerà automaticamente gli spazi extra alla fine delle linee di testo.

Parentesi Automatiche

- Quando l'utente digita una parentesi destra ([, ( o {) &kwrite; automaticamente inserirà la parentesi destra (}, ) o ]) alla destra del cursore.

Raggruppa Annulla

- Gruppi di azioni simili sono considerati come un unico passo di Annulla da &kwrite;. In altre parole, una serie di tasti premuti (parole o espressioni) sono considerati un unico passo e perciò eliminati da una singola operazione di annulla. Se la serie di ingressi di caratteri fosse interrotta da un operazione di non ingresso di caratteri (come un backspace), richiamando annulla rimuoverebbe solamente gli ingressi fatti da quella operazione in avanti. La successiva operazione di annulla annullerebbe quell'operazione e così via.

  Quando questa opzione non è selezionata &kwrite; considera ogni tasto premuto come un singolo passo. Così se l'utente (quando questa opzione è attiva) dovesse digitare diverse parole o addirittura frasi senza dover fare correzioni o taglia e incolla o altre operazioni che non riguardino l'ingresso di caratteri allora un clic sul pulsante di annulla eliminerebbe tutto ciò che è stato digitato dall'ultima operazione che non fosse di ingresso. Un secondo clic eliminerebbe quella operazione ed un terzo qualsiasi altra operazione o serie di ingressi che sono occorsi prima dell'operazione e così via. Quando non è selezionata tre clic del pulsante annulla rimuoverebbero solamente le ultime tre lettere digitate, o le ultime tre operazioni.

Mostra le Tabulazioni

- L'editor mostrerà un simbolo per indicare la presenza di una tabulazione nel testo.

Home Intelligente

- Non ancora implementato

PaginaSu/PaginaGiù Sposta il Cursore

- Questa opzione cambia il comportamento del cursore quando l'utente preme il tasto PaginaSu o il tasto PaginaGiù. Se non è selezionato il cursore del testo manterrà la sua posizione relativamente al testo visibile in &kwrite;, quando del nuovo testo diventerà visibile come risultato dell'operazione. Così se il cursore è al centro del testo visibile, quando avviene l'operazione, rimarrà lì (eccetto quando si raggiunge l'inizio o la fine). Quando questa opzione è selezionata, il primo tasto premuto causerà lo spostamento del cursore alla cima o alla base del testo visibile non appena si visualizza una nuova pagina di testo.

Cursore a Capo

- Quando si sceglie questa opzione, muovendo il cursore con i tasti freccia oltre la fine di una linea (a destra) lo si farà saltare all'inizio della prossima linea. Allo stesso modo quando il cursore è mosso indietro oltre l'inizio di una linea (a sinistra) salterà alla fine della linea precedente. Quando questa opzione non è selezionata, spostare il cursore a destra dopo la fine della linea, lo farà soltanto continuare orizzontalmente sulla stessa linea e cercare di muoverlo a sinistra dell'inizio della linea non farà nulla.

  Quando si sceglie questa opzione, fare clic con il mouse dopo la fine di una linea di testo porrà il cursore di inserimento alla fine della linea di testo, e non nel punto dove si fa clic. Ciò impedisce di aggiungere accidentalmente spazi in mezzo al testo, ed è il comportamento predefinito di molti editor.

Annulla azioni:

- Qui l'utente può specificare il numero di azioni che &kwrite; terrà in memoria allo scopo di azioni di annulla. Ciò significa che più alto è il numero di azioni, più memoria &kwrite; userà per questo. Impostare questa voce a 10 significherebbe che l'utente sarebbe in grado di revocare le ultime dieci operazioni, cioè facendo clic 10 volte sul pulsante di annulla e ottenendo i risultati.

Codifica

- Imposta la codifica dei caratteri per il tuo file.

### Ortografia

Un correttore ortografico è un programma designato per aiutare l'utente a trovare e correggere qualsiasi errore di ortografia. Questa sezione della finestra di dialogo delle preferenze permette di impostare alcune importanti preferenze al riguardo.

Crea combinazioni radici/affissi non nel dizionario

- Selezionare questa opzione permette al correttore ortografico di registrare come 'corrette' combinazioni di parole radice con suffissi o prefissi anche se una particolare combinazione non è elencata nel proprio dizionario di parole di base.

Considera le parole attaccate come errori di ortografia

- Selezionare questo farà registrare al correttore ortografico come 'scorrette' due o più parole correttamente digitate che sono 'attaccate', cioè che non ci sono spazi a separarle.

Dizionario:

- A seconda dell'installazione dell'utente saranno disponibili uno o più dizionari di ortografia di diversi linguaggi. Questa casella a comparsa permette all'utente di scegliere quale linguaggio debba utilizzare il correttore ortografico.

Codifica:

- Ci sono differenti sistemi di codifica usati per associare particolari codici con altrettanti caratteri e simboli. Se l'utente conosce quale codifica sta utilizzando questa casella permette di sceglierla così che il correttore ortografico possa compiere correttamente il proprio lavoro.

Client:

- Dato che &kwrite; non contiene il proprio correttore ortografico, deve essere scelto uno esterno. Qui l'utente può specificare quale programma di controllo ortografico utilizzare.

## Evidenziazione

La finestra di dialogo Configura l'Evidenziazione consiste di due pagine, Default e Modalità di Evidenziazione. L'utente può selezionare quale pagina vedere facendo clic sulla linguetta appropriata in cima alla finestra

Gli elementi disponibili nella pagina di Default sono i seguenti:

Stile degli elementi di default

- L'utente può configurare l'apparenza di default di elementi particolari. Ciò permette ad un programmatore di identificare più facilmente elementi (tipi ingressi) differenti nel suo codice.

  Elemento

- Questa lista a comparsa offre una varietà di voci che l'utente potrebbe volere evidenziare. Sono incluse Normale per il testo che non rientra in nessuna delle altre categorie, Commento, Stringa, Parola chiave e molte altre. Non tutte queste categorie hanno bisogno di essere configurate per ogni linguaggio e così possono essere selezionate a seconda del bisogno. Le opzioni nel resto di questa sezione si riferiscono alla voce selezionata in questa box.

Normale

- Permette all'utente di scegliere il colore normale (non selezionato) di un elemento. Questo per mezzo di una finestra di dialogo di selezione del colore, una spiegazione ulteriore della quale può essere trovata nella sezione Colori di Configurare KWrite.

Grassetto

- Questa opzione determina se la voce selezionata debba essere visualizzata in grassetto o no.

Corsivo

- Questa opzione determina se la voce selezionata debba essere visualizzata in corsivo o no.

Selezionato

- Permette all'utente di scegliere il colore normale (non selezionato) di un elemento. Questo per mezzo di una finestra di dialogo di selezione del colore, una spiegazione ulteriore della quale può essere trovata nella sezione Colori di Configurare KWrite.

Gli elementi nella pagina degli Stili di Evidenziazione permette all'utente di definire stili di evidenziazione più specifici dipendenti dallo stile del linguaggio.

Non c'è bisogno di impostare ogni possibile opzione, gli elementi non configurati espressamente utilizzeranno una configurazione predefinita nella precedente pagina Default.

Selezione Configurazione

- Questo gruppo di opzioni è usato per personalizzare gli stili di evidenziazione per ogni tipo di linguaggio di programmazione. Qualsiasi cambiamento fatto in altre altre aree di questa finestra di dialogo si applica solamente a questo tipo.

  Evidenziazione

- È usato per scegliere il tipo di linguaggio da configurare

Elemento

- Questo è per scegliere l'elemento di sintassi da configurare. Ricorda ciò configura solo questo elemento per questo linguaggio.

Come esempio, se l'utente volesse configurare l'apparenza dei commenti mentre sta scrivendo in C++, può scegliere C++ nella lista a comparsa Evidenziazione e poi scegliere Commenti nella lista a comparsa Elementi. Per far sì che che i commenti abbiano lo stesso aspetto tra tutti i linguaggi l'utente avrebbe bisogno di configurare ciò nella pagina Default di questa finestra di dialogo lasciando commenti non configurato all'interno della più specifica pagina Stili di Evidenziazione.

Stile dell'elemento

- Qui l'utente può configurare l'aspetto generale degli elementi selezionati sopra. Selezionando la casella Default viene selezionato lo stile di default configurato nella pagina precedente, o l'aspetto può essere configurato direttamente. Le opzioni disponibili sono le stesse che nella pagina Default: Normale, Selezionato, Grassetto e Corsivo.

Auto Seleziona Evidenziazione

- &kwrite; può applicare l'evidenziazione della sintassi automaticamente, in dipendenza dell'estensione o del tipo-mime del file aperto. Quelle predefinite sono abbastanza complete, ma gli utenti che regolarmente modificano i file con estensioni non standard possono aggiungerle qui. I caratteri jolly sono permessi nella casella di testo Estensione di File. Per esempio, l'impostazione di default per il linguaggio C++ è `*.cpp;*.cc;*.C;*.h`. Aprendo un file chiamato `foo.h` applicherebbe automaticamente lo stile C++ ad esso.

Carattere dell'elemento

- Qui l'utente può scegliere il carattere per l'elemento selezionato.

  Si può applicare lo stile predefinito attivando la casella Default o l'utente può scegliere una specifica Famiglia, Dimensione e Codifica di carattere. Le opzioni disponibili sono le stesse di quelle nella pagina Default.

## Riconoscimenti e licenza

&kwrite; Copyright 2001 by the &kate; team.

Basato sull'originale &kwrite;, che era Copyright 2000 by Jochen Wilhelmy digisnap@cs.tu-berlin.de

Contributi:

- &Christoph.Cullmann; &Christoph.Cullmann.mail;

- Michael Bartl michael.bartl1@chello.at

- Phlip phlip_cpp@my-deja.com

- &Anders.Lund; &Anders.Lund.mail;

- Matt Newell newellm@proaxis.com

- &Joseph.Wenninger; &Joseph.Wenninger.mail;

- Jochen Wilhely digisnap@cs.tu-berlin.de

- &Michael.Koch; &Michael.Koch.mail;

- &Christian.Gebauer; &Christian.Gebauer.mail;

- &Simon.Hausmann; &Simon.Hausmann.mail;

- Glen Parker glenebob@nwlink.com

- Scott Manson sdmanson@altel.net

- &John.Firebaugh; &John.Firebaugh.mail;

Documentazione originale di &Thad.McGinnis; &Thad.McGinnis.mail;

Questa versione del Manuale di &kwrite; è basata sull'originale di &Cristian.Tibirna; &Cristian.Tibirna.mail;

Convertita in docbook/proofreading da &Lauri.Watts; &Lauri.Watts.mail;

Samuele Kaplunkaplun@aliceposta.it

&underFDL; &underGPL;
&documentation.index;