# Il Manuale di &kwrite;

&Thad.McGinnis; &Thad.McGinnis.mail;
&Christoph.Cullmann; &Christoph.Cullmann.mail;
&Lauri.Watts; &Lauri.Watts.mail;
Samuele
Kaplun

    kaplun@aliceposta.it

2000
2001
&Thad.McGinnis;
&FDLNotice;
2001-06-13
2.00.00

&kwrite; è un editor di testo per &kde;

KDE
KWrite
testo
editor

## Introduzione

&kwrite; è più di un editor di testo per il Desktop &kde;. È pensato per essere un un editor per programmatori, e potrebbe essere considerato almeno 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 mai 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 qualche sito &FTP; remoto aperto in una delle finestre di &konqueror;.

### Opzioni della Linea di Comando

Anche se &kwrite; può essere spesso fatto partire 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 un po' di utili opzioni che sono disponibili quando si fa così.

#### 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 potrebbe sembrare come la seguente:

    % 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``

  Questo elenca le opzioni di base disponibili alla linea di comando.

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

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

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

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

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

  Questo 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 per mezzo del 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. La modalità sovrascrivi causa l'ingresso di ogni carattere di eliminare il carattere immediatamente alla destra del cursore testo.
Freccia Sinistra | Muove il cursore di un carattere a sinistra
Freccia Destra | Muove il cursore di un carattere a destra
Freccia Su | Muove il cursore in su di una linea
Freccia Giù | Muove il cursore in giù di una linea
Pag Su | Muove il cursore in su di una pagina
Pag Giù | Muove il cursore in giù di una pagina
Backspace | Cancella il carattere a sinistra del cursore
Home | Muove il cursore all'inizio della linea
Fine | Muove il cursore alla fine della linea
Cancella | Cancella il carattere alla destra del cursore (o qualsiasi testo selezionato)
&Shift;Freccia Sinistra | Seleziona il testo per un carattere a sinistra
&Shift;Freccia Destra | Seleziona il testo per un carattere a destra
F1 | Aiuto
&Shift;F1 | Che cos'è?
&Ctrl;F | Trova
F3 | Trova successivo
&Ctrl;C | Copia il testo selezionato nel blocconote
&Ctrl;M | 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

  Questo inizia un nuovo Documento nell'editor. Se c'è un documento corrente con cambiamenti non salvati è data all'utente la possibilità di salvarlo.

&Ctrl;O File Apri...

  Questo comando apre un file. Fa questo per mezzo di una finestra di dialogo che permette all'utente di navigare il file system. La finestra funziona come un piccolo file manager. Cliccando sulle cartelle nella finestra centrale si comanda alla finestra di entrare quella cartella - mostrandone il contenuto. C'è un elemento/tendina che può essere usato per digitare direttamente la locazione e il nome del file o cliccando la freccia a lato scegliere da una lista a tendina di locazioni usate di recente. Sotto a questo c'è un filtro in cui similmente si può inserire dati direttamente o scegliere da una lista a tendina di tipi di filtri recenti. La facility del filtro permette solo ai file che corrispondono alle specifiche di essere mostrati nella finestra centrale. Se il filtro contenesse del testo come`*.txt` gli unici file con l'estensione `txt` sarebbero visibili nella finestra di selezione. Sotto al filtro c'è una barra di stato che dà informazioni riguardo al numero di file e alle sotto-cartelle all'interno della cartella attuale.

  La barra degli strumenti, che si trova in cima alla finestra, ha i bottoni 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 bottone con la piccola casa porta l'utente alla sua cartella home e quello con le due frecce curve su sé 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 di quelle precedentemente impostate

  L'ultimo bottone sulla barra degli strumenti ti permette di creare una nuova cartella e cambiare addirittura alcune impostazioni basilari per la finestra di dialogo, e infine c'è un menu a tendina con una lista di alcune delle cartelle più visitate.

File Apri recenti

  Questa è una scorciatoia per aprire i documenti salvati recentemente. Cliccando su queste elemento si apre una lista a lato del menu con diversi dei file salvati più di recente. Cliccando 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 c'è già un salvataggio del documento allora questo sovrascriverà il file precedentemente salvato 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. Ciò per mezzo della 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

File Nuova Vista

  Crea una nuova vista del documento corrente, &ie;, una nuova istanza di &kwrite; (come spiegato nel punto precedente= ma che contiene lo stesso documento.

&Ctrl;Q File Esci

  Chiude la finestra dell'editor, se hai più di una istanza di &kwrite; in esecuzione, 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 costituisce detta azione può essere meglio compreso riferendosi alla porzione di questo file di guida su Gruppi di Annulla.

&Ctrl;&Shift;Z Modifica Rifai

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

Modifica Cronologia Annulla/Rifai

  Richiama una finestra di dialogo che mostra una lista delle azioni più recenti sulla sinistra e un'altra lista delle azioni che sono state annullate sulla destra. Ci sono anche tre pulsanti sulla destra della finestra etichettati come Annulla Rifai e Chiudi. Fare clic sul pulsante Annulla causerà l'inversione dell'azione in cima alla lista-Annulla, ponendola in cima alla lista-Rifai. Analogamente, fare clic sul pulsante Rifai ripristinerà l'azione annullata e la sposterà in cima alla lista-Annulla. Fare clic su un elemento al di sotto di quello in cima in entrambe le liste selezionerà tutti gli elementi dalla cima giù fino a quella posizione. Un successivo clic sul corrispondente pulsante causerà l'annullamento o il ripristino di tutte le azioni. Ciò è particolarmente utile quando l'utente conosce precisamente il punto da cui lei o lui vuole procedere - rendendo non necessario muoversi attraverso una serie di singole azioni Annulla o Rifai.

&Ctrl;X Modifica Taglia

  Questo comando cancella la selezione correte e la mette nella clipboard. La clipboard è una funzionalità di KDE che funziona in maniere invisibile offrendo 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 lavora in modo invisibile offrendo 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 funziona in modo invisibile offrendo 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.

Modifica Inverti Selezione

  Seleziona qualsiasi testo non selezionato deselezionando qualsiasi testo selezionato - inverte efficacemente lo stato corrente della selezione.

&Ctrl; G Trova Vai a linea

  Apre la finestra di dialogo vai alla linea che è usata 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 di spin control 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 slide control 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. ed

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, a 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. Oltre alle caratteristiche della finestra di dialogo trova, contenente una casella/menu a cascata di testo Sostituisci con: . Usando la finestra di dialogo l'utente può specificare sia il testo che deve essere cercato che il testo 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.

&Ctrl; M Modifica Modifica Comando

  Ancora da scrivere

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

  Comincia il programma di controllo ortografico - un programma dedicato ad aiutare l'utente a scovare e correggere qualsiasi errore di scrittura. Cliccando su questo elemento comincerà il controllo e

  Parola sbagliata:

    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 ognuna presente nell'editor.

  Sostituzione:

    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. Cliccando su qualsiasi suggerimento questo va a sostituire la parola nella casella Sostituzioni:, in alto.

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

  Sostituisci

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

  Sostituisci Tutto

    Questo pulsante fa si 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 tutti

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

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

  Aggiungi

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

  Interrompi

    Questo pulsante ferma il processo di correzione.

  Localizzata orizzontalmente lungo la base della finestra di dialogo del controllo ortografico c'è una barra di avanzamento. Con l'avanzare del processo di controllo la barra si riempirà da sinistra a destra fornendo una rappresentazione grafica di quale posizione nel documento ha raggiunto il processo. Inoltre, l'avanzare è rappresentato numericamente nel centro della barra di avanzamento.

  Una visualizzazione numerica del processo di correzione è visualizzata nella barra di stato dell'editor. La Barra di Stato è una striscia orizzontale in basso all'editor, appena fuori dell'area di immissione del testo.

  Altri due pulsanti sono localizzati al di sotto della barra di avanzamento. Essi sono:

  Aiuto

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

  Annulla

    Questo pulsante ferma il processo di correzione.

  Strumenti Indenta

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

  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

  Strumenti Commento

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

  Strumenti

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

&Ctrl; I Strumenti Indenta

  Ancora da scrivere

&Ctrl; Strumenti Annulla indentazione

  Ancora da scrivere

Strumenti Pulisci Indentazione

  Ancora da scrivere

&Ctrl; Strumenti Commento

  Ancora da scrivere

&Ctrl;&Shift; Strumenti

  Ancora da scrivere

### Il menu Impostazioni

Impostazioni Mostra la barra degli strumenti

  Quando è selezionato, visualizza una barra degli strumenti spostabile, contenente 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 Tasto

  Questo comando apre una finestra di dialogo dove le Scorciatoie possono essere cambiate. Una finestra display in cima alla finestra di dialogo mostra la lista dei comandi (azioni) che possono avere una scorciatoia di tastiera. Al di sotto del display 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 solo uno degli elementi offerti - nel modo in cui l'autoradio di un automobile permette solo la selezione di una 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 casella 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 tiene premuti i pulsanti &Ctrl; e Alt e si preme K (mentre si usa &kwrite;) sarebbe 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. Una finestra di display sulla sinistra elenca i comandi disponibili da mettere nella barra degli strumenti. Un display sulla destra elenca quei comandi che sono già nella barra degli strumenti. Un insieme di quattro pulsanti freccia tra i due display manipolano le selezioni. La freccia che punta a destra dispone qualsiasi comando selezionato nel pannello di sinistra nel pannello di destra, i.e., li aggiunge nella barra degli strumenti. La freccia a sinistra fa l'esatto contrario, rimuovendo qualsiasi azione selezionata nella finestra a destra dalla barra degli strumenti. Le frecce che puntano in su e in giù cambiano la posizione di una azione selezionata nella finestra a destra il che cambia la posizione dei suoi pulsanti nella barra degli strumenti.

Impostazioni Configura Editor

  Questa voce del menu apre una finestra dove diverse impostazioni possono essere modificate.

Impostazioni Mostra Icona Bordo

  Alterna la visualizzazione di un bordo sulla sinistra della finestra di editing dove i segnalibri sono visualizzati accanto alla linea a cui sono abbinati.

F4 Impostazioni Verticale Selezione

  Questo è utilizzato per attivare o disattivare la funzionalità di selezione verticale. La selezione verticale permette di selezionare il testo per colonne così come per righe. In altre parole con questa funzionalità l'utente è in grado di selezionare il testo contenuto solo particolari colonne e righe contigue. Praticamente l'utente può selezionare un'area rettangolare di testo ovunque nel documento.

Impostazioni Evidenziazione Modalità

  Permette all'utente di scegliere lo stile del colore di evidenziazione che l'editor utilizza per visualizzare il testo. Gli stili solo selezionabili per linguaggio di programmazione. L'informazione sul carattere/colore non è memorizzata nel documento.

Impostazioni Fine di Linea

  Apre un sotto-menu dal quale l'utente può selezionare il tipo di codice di fine di linea per &kwrite; da utilizzare, cioè gli standard accettati utilizzati dai sistemi &UNIX;, &Mac; o MSDOS/&Windows;.

### Il menu Aiuto

&help.menu.documentation;

## Configura &kwrite;

Selezionare Impostazioni Configura Editor dal menu 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.

Ella o egli 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 descritti 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 suo 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 utilizzata per cambiare l'impostazione.

La finestra di dialogo del colore fornisce un conveniente e visuale modo 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 display 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 per specificare il particolare colore visualizzato in codice 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 visualizzata sul desktop o in un altro programma. Facendo clic sul pulsante con il l'icona del contagocce (situata sul lato destro della finestra di dialogo) cambia la forma del cursore del mouse in un mirino. Facendo clic di nuovo si selezioneranno gli attributi di colore 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 il display quadrato). Ciò aggiunge il colore corrente alla tavolozza dei colori personalizzati. Questa tavolozza e qualsiasi altra tavolozza disponibile può essere visualizzata usando la casella di selezione a comparsa collocata direttamente al di sopra del display 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

  Previene 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 di ingresso di non caratteri allora un clic sul pulsante di annulla eliminerebbe tutto ciò che è stato digitato dall'ultima operazione non di input. 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 l'operazione avviene, rimarrà lì (eccetto quando si raggiunge l'inizio o la fine). Quando questa opzione è selezionato, 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;