# Manuale di &kwrite;

## Introduzione

&kwrite; è più di un editor di testo della comunità &kde;. È pensato per essere un editor per programmatori e potrebbe essere considerato come una parziale alternativa a editor più potenti. Può essere meglio utilizzato insieme a &konqueror; o &dolphin; per navigare tra i file sorgenti di differenti linguaggi. &kwrite; funziona molto bene anche come semplice editor di testo. Una delle principali funzionalità di &kwrite; è la colorazione della sintassi, personalizzata per diversi linguaggi di programmazione quali: C/C++, &Java;, Python, Perl, Bash, Modula 2, &HTML; e Ada. &kwrite; ha un'interfaccia a documento singolo (SDI) che permette di redigere un file alla volta in ogni finestra.

&kwrite; è una semplice interfaccia al componente &katepart; usato anche da &kate;, &kdevelop; e altre applicazioni di &kde; che richiedono capacità avanzate di redazione di testi. Perciò, la documentazione completa di tutte le funzionalità di &kwrite; è reperibile nel manuale di &katepart;.

## Opzioni dalla linea di comando

Anche se la maggior parte delle volte si lancia &kwrite; dall'avviatore dei programmi di &plasma; o da un'icona del desktop, può anche essere aperto dalla riga di comando in una finestra del terminale. Ci sono diverse opzioni utili disponibili in questa modalità.

Molte altre applicazioni che usano &katepart; offrono delle opzioni da riga di comando simili.

### Specifica un file

Specificando il percorso e il nome di un particolare file l'utente può far sì che &kwrite; apra (o crei) quel file immediatamente all'avvio. Quest'opzione potrebbe assomigliare alla seguente:

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

### Specifica un file su Internet

Il metodo sopra menzionato può essere usato anche per aprire file su Internet (se l'utente ha una connessione attiva in quel momento). Ad esempio:

    % kwrite
    ftp://ftp.kde.org/pub/kde/README

### Altre opzioni dalla linea di comando

Sono disponibili le seguenti opzioni di aiuto dalla riga di comando

``kwrite` `--help``

- Elenca le opzioni di base disponibili dalla riga di comando.

``kwrite` `--author``

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

``kwrite` `-v`, `--version``

- Elenca le informazioni sulla versione dell'applicazione.

``kwrite` `--license``

- Visualizza le informazioni di licenza.

``kwrite` `--desktopfile` `nome_file``

- Il nome file della voce del desktop per questa applicazione.

  Questo è particolarmente utile per applicazioni contenitore e per quelle che hanno in generale più file desktop. In questo modo ogni file desktop può avere la sua riga di comando per la voce `Exec`.

``kwrite` `-e`, `--encoding` `codifica``

- Fa sì che &kwrite; utilizzi la codifica specificata per il documento.

``kwrite` `-l`, `--line` `riga``

- Si posiziona sulla riga specificata dopo aver aperto il documento.

``kwrite` `-c`, `--column` `colonna``

- Si posiziona sulla colonna specificata dopo aver aperto il documento.

``kwrite` `-i`, `--stdin``

- Fa sì che &kwrite; legga il contenuto del documento dallo STDIN. Ciò è simile all'opzione `-` utilizzata comunemente in molti programmi a riga di comando e permette di redirigere l'output di un comando in &kwrite;.

## Riconoscimenti e licenza

&kwrite; Copyright 2001-2014 della squadra di &kate;.

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 Wilhelmy 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;

Traduzione in italiano di Federico Zenith federico.zenith@member.fsf.org, Marco Poletti, Samuele Kaplun e Luigi Toscano.

&underFDL; &underGPL;