# Il Manuale di &kile;

Jonathan
Pechta

    jrpechta@yahoo.com

Federico
Zenith

    zenith@chemeng.ntnu.no

Jeroen
Wijnhout

    Jeroen.Wijnhout@kdemail.net

Federico
Zenith

     zenith@chemeng.ntnu.no

Traduzione della documentazione in italiano
2003
Jonathan Pechta
2003
Federico Zenith
2003-11-29
1.6
&FDLNotice;

&kile; è un editor di sorgenti &latex;, shell &tex; e interfaccia &gnuplot;.

KDE
kdenonbeta
Kile
LaTeX
TeX

## Prefazione

###

#### Requisiti

Per eseguire &kile;, ti sarà necessario avere i seguenti componenti installati sulla tua distribuzione Linux:

- Ambiente desktop &kde;: &kde; è un popolare ambiente desktop open source.

- Qt: Qt è uno strumento di sviluppo in C++ necessario per compilare &kile;.

- &latex;: programma tipografico di alta qualità. Quasi sicuramente avrai (o vorrai) il pacchetto &tetex;, visto che sei su un sistema di tipo Unix.

Pacchetto raccomandato:

- &kdvi;: anteprima DVI per &kde;.

Alcuni di questi elementi potrebbere essere inclusi nella tua distribuzione Linux; per piacere riferisciti alla documentazione della tua distribuzione, o riferisciti al tuo CD o DVD di installazione per aggiungere questi pacchetti sul tuo sistema.

Il progetto &kile; include diversi pacchetti di &kile; che possono essere facilmente installati e avviati senza bisogno di compilazione; controlla la homepage di &kile;.

Requisiti di sistema suggeriti:

- Processore compatibile Pentium o più veloce

- 128MB di RAM

- Da 400 MB a 4 GB di spazio su disco fisso, a seconda del numero di programmi installati

- Mouse e tastiera

#### Uditorio

Questo manuale può essere usato da chiunque, indipendentemente dalla sua esperienza con &latex;, &kde;, &kile; o Linux.

Gli utenti avanzati probabilmente non leggeranno questo manuale, ma tutti i suggerimenti sono ben accetti. Se volessi contribuire a questo progetto o alla documentazione, per piacere consulta la pagina web di &kile;. I commenti sulla documentazione possono essere inviati a jrpechta@yahoo.com.

Hai bisogno di risposte su &kile;? Sei bloccato con una compilazione? Vuoi una funzione nuova? Il modo migliore di fare domande tecniche o avviare una discussione è usare la nostra mailing list: kile-devel@lists.sourceforge.net.

#### Cosa c'è di nuovo in &kile;?

La versione attuale di &kile; è 1.6. Qui ci sono alcuni dei cambiamenti più significativi e funzionalità che sono state implementate rispetto all'ultima versione di &kile; (versione 1.5).

Nuove funzionalità:

- Gestione di progetti

- Un nuovo e più potente editor interno (katepart)

- Tutti gli strumenti standard sono configurabili

- File e progetti ripristinati all'avvio

- Migliore evidenziazione della sintassi

  - Incorpora ambienti verbatim

  - Evidenziazione all'interno di ambienti matematici

- Inserisci citazioni da bibliografie &bibtex; usando gBib o pyBliographer

- Conteggio delle parole

- Strumenti standard configurabili dall'utente

- Etichette configurabili dall'utente

Correzioni:

Correzioni minori in tutto il programma

#### Accordo di licenza

Se usi &kile;, accetti di essere vincolato dai termini dell'Accordo di Licenza Pubblica Generale GNU. I dettagli della GPL possono essere trovati su questa pagina web.

Per piacere leggi per maggiori informazioni.

## Introduzione

###

#### Informazioni su &kile;

&kile; è un ambiente &latex; integrato per il desktop &kde;. &kile; ti dà la possibilità di usare tutte le funzionalità di &latex; in un'interfaccia grafica, dandoti un accesso facile, immediato, e personalizzato a tutti i programmi per gli strumenti relativi a &latex; per la compilazione, il postprocessing, il debugging, la conversione e la visualizzazione; hai a disposizione anche degli assistenti molto comodi, un riferimento &latex;, interfacce con &gnuplot; e XFig, e la gestione dei progetti.

#### Cos'è &latex;

&latex; è un sistema di trattamento testi derivato da &tex;, un programma sviluppato originariamente nel 1977 per aiutare gli autori a presentare il loro lavoro professionalmente, ottenendo un lavoro simile a quello di un tipografo; il tipografo è colui che imposta l'aspetto di un documento a seconda delle specifiche del tipo di documento. &latex; è stato creato per dare agli autori un tipografo automatico, specialmente per quanto riguardava la costosa e complicata tipografia delle formule e delle espressioni matematiche, che assolutamente non per caso sono racchiuse da segni del dollaro in &latex;. Oggi, i programmi di trattamento testi permettono a ogni utente di essere il tipografo; ma ciò di cui tu hai bisogno è un bel documento, non uno su cui hai speso ore per renderlo bello. &latex; si fa carico di questo compito, e ti lascia pensare al documento, non alla tipografia. E, sì, sarà bello!

#### Come si pronuncia? Perché si scrive così strano?

C'è una buffa tradizione per la quale i pacchetti relativi a &tex; hanno la pronuncia e la grafia più strane possibile. Si suppone che &tex; sia arrivato dal greco τεχ, in lettere latine tech. Ci sono molte spiegazioni possibili sul perché, ma la più probabile è che &latex; fu originariamente concepito per i rapporti tecnici, e infatti la sua abilità principale era la scrittura facile e corretta delle formule matematiche, ai tempi un affare estremamente costoso, tedioso e frustrante.

La pronuncia dovrebbe essere come segue: TE come in italiano, e X come nel tedesco ich. Se non sai come suona ch, è più o meno come il suono di un gatto che soffia; il simbolo IPA è /ç/. Molte persone sostengono la diversa pronuncia di ach (simbolo IPA /x/), ma ho personalmente chiesto a dei greci, e posso confermare la prima versione. Dovresti sapere che molti pronunciano erroneamente /teks/ o /tek/.

Infine, in &latex; la parte LA è pronunciata come l'inglese lay ("profano"): l'idea è che, mentre il &tex; grezzo è difficile, anche un profano può usare le macro di &latex;. Adesso lo sai!

### Fondamenti di &latex;

Il sistema di tipografia di &latex; è simile ad altri linguaggi a marcatori come XML, usato per molti tipi di documenti (incluso quello che stai leggendo), o HTML, usato per le pagine web. L'idea generale è avere parole chiave impacchettate in modo particolare, dette tag, che dicono a un programma (un elaboratore di testi, un browser web, o il compilatore di &kile;) come presentare il testo.

Sebbene proveremo a darti una buona idea di cosa sia &latex;, questa non è La Bibbia Definitiva di &latex;. Se vuoi imparare &latex; bene, potresti prendere un libro nella tua biblioteca. L'autore ha avuto una buona esperienza con il testo A Guide to &latex;, di H. Kopka e P. W. Daly, e lo tiene ancora sullo scaffale.

Come altri linguaggi a marcatori, &latex; contiene un preambolo, che imposta i comandi globali, come la dimensione della carta, la numerazione delle pagine, le dimensioni del testo sulla pagina, e un corpo, che contiene il testo del documento; il preambolo contiene almeno il comando \documentclass, e precede il corpo, che inizia con il comando `\begin{document}`, ed è piuttosto prevedibilmente concluso dal comando `\end{document}`.

### Funzionalità principali di &kile;

#### Assistente dei documenti

L'assistente integrato di &kile; è una comoda funzione per farti iniziare a creare documenti con &kile;. Scegliendo l'assistente dalla barra delle applicazioni ti verranno offerte varie scelte per la creazione del tuo documento: articolo, libro, lettera, rapporto o vuoto; puoi anche specificare subito alcune opzioni relative al documento.

Opzioni dell'assistente:

- Tipo del documento: che tipo di documento stai creando? Articolo, lettera, rapporto, libro?

- Dimensione caratteri: che dimensione, in punti, stai usando?

- Dimensione carta: di quali dimensioni sarà la carta che userai per il tuo documento?

- Codifica: quale codifica userai per il file sorgente? Userai quasi sempre le codifiche Latin 1 o Utf-8, per poter scrivere parole come `così` direttamente, e non attraverso la conversione ASCII `cos\`\i`.

- Autore: metti il tuo nome qui.

- Titolo: aggiungi qui il titolo del tuo documento.

- Altre opzioni: questo ti permette di impostare altre opzioni per la stampa, le bozze, ecc.

#### Modelli predefiniti

I modelli predefiniti in &kile; sono:

- Documento vuoto: gli uomini veri partono da zero!

- Articolo: imposta il formato articolo, per un documento abbastanza breve da non aver bisogno di essere diviso in capitoli.

- Rapporto: imposta il formato rapporto, per documenti di media grandezza, con per esempio la numerazione delle pagine sul margine esterno.

- Libro: imposta il formato libro, una versione full optional, così potente da essere usata per scrivere molti testi universitari.

- Lettera: imposta il formato lettera, che può automaticamente sistemare quelle noiose indentazioni che nessuno riesce a ricordare.

I nuovi utenti non si devono preoccupare, queste sezioni sono solo una breve descrizione delle funzionalità, e maggiore attenzione sarà data al completamento nei dettagli di questi obiettivi nella sezione Avvio rapido.

#### Evidenziazione della sintassi

&kile; è simile ai programmi che lavorano con codice sorgente, ed evidenzierà automaticamente comandi, opzioni ed elementi, usati e abusati. &kile; rende così possibile avvistare facilmente i problemi: per esempio, se vedi grosse aree di testo verde, è probabile che tu abbia dimenticato di chiudere un ambiente matematico da qualche parte; te ne saresti accorto comunque da quanto scadente sarebbe stato il file di output, ma l'evidenziazione ti risparmia un bel po' di tempo e frustrazioni.

#### Autocompletamento degli ambienti

Di nuovo in questa versione di &kile; c'è l'autocompletamento degli ambienti; ciò significa che quando inizi un nuovo ambiente scrivendo `\begin{environment}`, &kile; aggiungerà automaticamente un comando `\end{environment}`, con una linea in mezzo per il tuo testo. Puoi ovviamente disattivarlo, se vuoi, in Impostazioni Configura &kile;...LaTeX.

#### Saltare agli elementi struttura

Tutti i documenti normalmente sono strutturati con una gerarchia di un certo tipo. &latex; ti permette di spezzare i documenti nella seguente gerarchia (part è l'elemento più alto della gerarchia, e subparagraph il più basso)

- \part

- \chapter

- \section

- \subsection

- \subsubsection

- \paragraph

- \subparagraph

Quando guardi un documento nella vista struttura, puoi saltare tra gli elementi facendo clic sull'elemento che vuoi vedere.

#### Ricerca all'indietro

Quando crei i tuoi file &latex;, la ricerca all'indietro può essere molto utile. Una volta che hai creato un file DVI (DeVice Independent File, file indipendente dal dispositivo), quando fai clic con il bottone centrale del mouse nel visualizzatore DVI, &kile; salterà alla linea corrispondente nel codice sorgente &latex;.

Definizione di DVI: un DVI è un tipo di file contenente una descrizione di un documento formattato, insieme ad altre informazioni, incluso il tipo di carattere, ed è l'output tipico di &tex;/&latex;. Esiste un certo numero di programmi per visualizzare e stampare file DVI su vari sistemi e dispositivi. Un file DVI è a volte anche noto come metafile.

#### Ricerca in avanti

Usando la ricerca all'indietro, la selezione di elementi nei file DVI è associata all'editor, così quando fai clic sul file DVI, la finestra principale salta alla sezione corrispondente di codice &latex; nell'editor. La ricerca in avanti ne è l'esatto opposto. La ricerca in avanti ti permetterà di fare clic su una sezione di testo specifica nel codice &latex;, e saltare alla posizione associata nella finestra del visualizzatore DVI.

### La barra degli strumenti: una guida di riferimento alle funzioni

- Nuovo: inizia un nuovo documento.

- Apri: apri un nuovo documento.

- Chiudi: chiudi il tuo documento.

- Definisci il documento come 'documento principale': questo si usa lavorando con file multipli. Avere un documento principale ti permetterà di includere altri file .tex nel tuo documento.

- Costruzione rapida: compila il tuo codice sorgente &latex; e mostrane i risultati automaticamente, a meno di avere errori nel codice.

- Sorveglia file: questa modalità "sorveglierà" eventuali cambiamenti del file DVI, e lo aggiornerà automaticamente senza dover riavviare &kdvi;

- Visualizza file di log: visualizza il file .log, in modo da poter vedere gli errori.

- Errore precedente: salta all'indietro nel file .log e evidenzia gli errori nel sorgente.

- Errore successivo: salta in avanti nel file .log e evidenzia gli errori nel sorgente.

- Ferma: ferma la funzione attuale.

- LaTeX: esegui &latex; sul documento attivo.

- Visualizza DVI: avvia il visualizzatore DVI.

- Da DVI a PS: converte un file DVI in un PostScript (PS).

- Visualizza PS: avvia il visualizzatore PostScript (PS).

- PDFLaTeX: crea un PDF dal sorgente &latex;, se hai un'intestazione &latex;.

- Visualizza PDF: visualizza il file PDF.

- Da DVI a PDF: converte un DVI in un PDF.

- Da PS a PDF: converte un PS in un PDF.

- Da LaTeX a HTML: crea codice HTML da sorgente &latex;.

- Visualizza HTML: visualizza l'HTML creato.

- Ricerca &kdvi; in avanti: salta alla pagina che corrisponde alla linea attuale nell'editor.

Se guardi la barra degli strumenti Modifica, noterai tre grandi menu a cascata. I menu a cascata sono stati progettati per farti rapidamente aggiungere funzionalità nel tuo documento. Il primo menu a cascata è usato per dividere rapidamente il tuo documento in parti, capitoli, sezioni, ecc.; i comandi disponibili per aggiungere elementi di segmentazione al tuo codice sorgente &latex; sono:

- part: Livello massimo di sezionamento per un documento.

- chapter: Inizia un nuovo capitolo.

- section: Crea una nuova sezione.

- subsection: Crea una nuova sottosezione.

- subsubsection: Una sezione secondaria tra sottosezione e paragrafo.

- paragraph: Crea un nuovo paragrafo.

- subparagraph: Crea un nuovo sottoparagrafo.

Il menu a cascata chiamato label è usato per inserire nel tuo documento elementi come indici, note a pie' di pagina, referenze. I comandi disponibili per aggiungere elementi al tuo codice sorgente &latex; sono:

- label: Comando che produce un un'etichetta per un livello.

- index: Crea una voce per l'indice con suffisso file .idx.

- footnote: Crea una nota a pie' di pagina nel tuo documento.

- ref: Usato per riferirsi a un'etichetta già definita, che scegli da una lista a cascata.

- pageref: Crea un numero di pagina nel tuo documento che corrisponda a un'etichetta.

- cite: Crea una citazione da una bibliografia nel tuo documento.

Il menu a cascata label
Il menu a cascata label
Selezione dell'etichetta di una referenza
Selezione dell'etichetta di una referenza

Usando cite, ti viene presentata una lista a cascata di bibitem, ma se stai usando &bibtex; questo sistema non funzionerà. Puoi in questo caso usare gBib o pyBliographer, o farlo a mano.

L'ultimo menu a cascata, etichettato tiny, è usato per impostare la dimensione del tuo testo. Hai la possibilità di impostare la dimensioni di testo, note a pie' di pagina, ecc.; i comandi disponibili per aggiungere una dimensione di testo al tuo codice sorgente &latex; sono:

- tiny: piccolissimo

- scriptsize: molto piccolo

- footnotesize: più piccolo

- small: piccolo

- normalsize: normale

- large: grande

- Large: più grande

- LARGE: ancora più grande

- huge: molto grande

- Huge: grandissimo

## Avvio rapido

### Stesura di un documento &latex; con &kile; per principianti

Ogni utente di &kile; ha due scelte quando comincia un nuovo documento: può usare l'assistente per cominciare un nuovo documento, selezionando il tipo di documento che vorrebbe creare, e opzioni come la dimensione dei caratteri, della carta, ecc.; l'altra possibilità è scrivere il codice a mano.

                    \documentclass[12pt]{article}
                    \begin{document}
                    Qui c'è un pacco di codice LaTeX.
                    \end{document}

Ogni documento in &latex; comincia con il comando `\documentclass{TipoDelDocumento}`, a meno che tu stia usando una versione obsoleta di &latex;; in quel caso il comando è `\documentstyle{TipoDelDocumento}`. Ci sono attualmente due versioni comuni di &latex; in cui potresti incappare: la versione 2.09, che usa `\documentstyle`, e la versione 2ε, che usa `\documentclass` per cominciare un documento. Il comando `\documentclass` segue sempre la sintassi `\documentclass[argomento opzionale]{classe}`.

Inserire l'esempio di codice della casella di testo sopra ti restituirà il seguente output:

                    Qui c'è un pacco di codice LaTeX.

Le parentesi quadre che vengono dopo il comando `\documentclass` denotano un'opzione per il commando. L'opzione `[12pt]` imposta la dimensione dei caratteri per il tuo articolo; se non imposti la dimensione dei caratteri all'inizio, la puoi impostare più avanti nel testo.

Una volta che hai inserito l'esempio di codice dalla casella sopra, dovrai compilare il tuo codice &latex;. Il modo più facile per compilare &latex; è usare il menu Costruzione, o usare il pulsante Costruzione rapida.

Alt2 è la scorciatoia da tastiera per compilare il tuo codice sorgente.

Devi salvare il tuo codice sorgente prima di poter compilare; &kile; lo farà automaticamente per te, ma solo per il documento principale; se hai documenti figli, devi salvarli a mano.

Se il tuo documento non è stato compilato correttamente, controlla se ci sono errori nel log. Usando il pulsante Costruzione rapida, il visualizzatore &kdvi; dovrebbe essere lanciato automaticamente, sennò, controlla se ci sono errori nel log.

### Ambienti

Un ambiente è un comando che ti permette di gestire un segmento di testo diversamente dal resto del tuo documento. Per esempio, crei un rapporto con dimensione dei caratteri pari a 12, ma hai bisogno di cambiare la dimensione dei caratteri per poche frasi. I comandi `\begin{ambiente}`, `\huge` and `\end{ambiente}` ti permetteranno di alterare temporaneamente il testo all'interno dei comandi ambiente affinché il testo sia di dimensione molto grande.

Insomma, i cambiamenti hanno effetto da `\begin{ambiente}` a `\end{ambiente}`. Non ci sono limiti a quanti cambiamenti puoi fare all'interno di un ambiente.

Ci sono molte funzioni che puoi aggiungere al tuo documento che lo renderanno più leggibile e semplice. Puoi aggiungere al tuo documento oggetti come tipi di carattere specifici, grassetto, corsivo, sottolineato, ecc., e questi comandi si concluderanno o con un comando `\end`, o alla fine del tuo ambiente.

- `\begin{emph}` o `\begin{em}`: questo comando scrive il testo in corsivo, ed è valido finché il codice non raggiunge un `\end{em}`, `\end{emph}`, o la fine dell'ambiente. Per rendere una parola in corsivo in una frase, puoi usare la sintassi: questa è la `\em{mia}` frase.

- `\bfseries{Sto scrivendo questo testo all'interno delle parentesi in grassetto}`: questo comando scrive il tuo testo in grassetto. Il comando grassetto continuerà finché non sarà trovata una graffa chiusa.

- `\quote`: per creare una citazione all'interno del tuo documento, inizia la tua citazione `\begin{quote}` e finiscila con `\end{quote}`.

- `\center`: centra il testo.

- `\verse`: crea un'indentazione adatta alla poesia.

- `\itemize`: fai una lista di oggetti.

### Uso di &kile;

Adesso che ti abbiamo dato un'infarinatura su come scrivere codice usando il linguaggio &latex;, ti mostreremo come creare un documento passo-passo usando &kile;.

1. Avvia &kile;.

2. Crea un nuovo documento, usando File Nuovo Documento vuoto.

3. Scegli Assistente Avvio rapido, quindi scegli un formato, e imposta le tue preferenze nell'assistente.

4. Una volta che l'assistente avrà inserito del testo, fai un po' di personalizzazione per rendere il documento più leggibile, aggiungi almeno una citazione, un grassetto, corsivi, e un verso per vedere le differenze tra i vari comandi.

5. Salva il tuo file, e dagli il nome `intro.tex`.

6. Compila il tuo file usando Alt 2, o il pulsante etichettato LaTeX.

7. Seleziona Visualizza DVI.

8. Controlla tutto il tuo testo nuovo.

9. Quando hai finito di guardare il documento, fai clic sul pulsante Vista editor per ritornare all'editor.

È tutto! Hai appena creato il tuo primo documento &latex;. Per poter modificare ulteriormente il file, vai a Visualizza Vista editor, e ritornerai all'editor di codice sorgente (se stavi usando il visualizzatore integrato).

Se costruisci il tuo documento, ma non vedi testo, controlla di aver impostato il tuo visualizzatore nell'angolo in alto a sinistra dello schermo. Quando compili il sorgente, la Costruzione rapida centrerà il tuo testo nel mezzo dello schermo, ma usare &latex; per costruire e poi Visualizza DVI non centrerà automaticamente il tuo testo sullo schermo.

Una volta che hai creato il tuo DVI, potrai stampare il tuo documento, o cambiarlo in un file postscript o PDF, se vuoi. Sperimenta e divertiti!

### File DVI

DVI significa file indipendente dal dispositivo (DeVice Independent). Questi file sono prodotti da &tex; o &latex; per essere letti da un driver sul tuo sistema. Ci sono molti tipi diversi di output a cui si può inviare un .dvi, come una stampante, un convertitore a file postscript o PDF, o lo schermo del tuo computer.

#### Visualizzare un DVI

Hai già visto come visualizzare un file DVI su schermo usando il pulsante Visualizza DVI nella barra degli strumenti.

#### Stampare un DVI

Per stampare un DVI, puoi usare lo stesso processo che hai usato per creare il tuo documento prima (vedi ). Al passo 7, dopo aver fatto clic su Visualizza DVI, seleziona File Stampa nel visualizzatore, e se hai configurato correttamente la tua stampante, il file DVI sarà stampato.

#### Stampare un DVI manualmente

Per stampare manualmente un DVI da Konsole, usa il comando Da DVI a PS nella barra degli strumenti, o scrivi `dvips intro.dvi`. Il comando convertirà il tuo DVI in un file postscript. Una volta che il tuo file è convertito, puoi stamparlo usando la voce menu File Stampa nel visualizzatore, o scrivendo in una console `lpr intro.ps`.

#### Esportare un DVI

La barra degli strumenti ti dà la possibilità di esportare un DVI a diversi formati. Una volta che hai creato un DVI dal tuo codice sorgente &latex;, dovresti poterlo esportare nel formato di tua scelta usando i pulsanti della barra degli strumenti.

### Ricerche in avanti e all'indietro

#### Ricerca in avanti

Il comando Ricerca in avanti usa &kdvi; e un file esterno (i file esterni sono chiamati pacchetti in &latex;) chiamato `srcltx.sty`. Dovrai fare una ricerca tra i tuoi file per controllare se la tua distribuzione include `scrltx.sty`. Se è incluso, devi impostare il comando seguente nel preambolo.

                    \documentstyle[12pt, a4paper]{book}
                    \usepackage[active]{scrltx}
                    \pagestyle{empty}
                    \renewcommand{\baselinestretch}{2}
                    \begin{document}
                    \begin{verse}
                    L'editor di codice sorgente \LaTeX\ &kile; per &kde; è il mio preferito.
                    \em{Perché} è facile da usare!
                    \end{verse}
                    \end{document}

Una volta che hai aggiunto il pacchetto `scrltx`, puoi lasciare &kdvi; aperto. La Ricerca in avanti ti permetterà di fare clic su una sezione di testo specifica nel codice &latex;, e saltare alla posizione associata nella finestra del visualizzatore DVI.

#### Ricerca all'indietro

La Ricerca all'indietro non può funzionare a meno che:

- La Ricerca in avanti sia attivata e funzionante.

- Il file sorgente sia già stato compilato.

- &kdvi; sa quale editor vorresti usare (vedi ).

Per usare la ricerca all'indietro, salva e compila il tuo sorgente &latex; e apri il visualizzatore DVI usando il pulsante Visualizzatore DVI nella barra degli strumenti.

Una volta che il visualizzatore DVI è aperto, fai clic con il pulsante centrale del tuo mouse su un segmento di testo, e dovresti essere rimandato nell'editor, alla sezione di codice sorgente su cui hai fatto clic centrale nel visualizzatore DVI.

Con questa funzionalità di &kdvi;, un clic sul pulsante centrale del mouse nel documento &DVI; farà aprire a &kile; il documento &tex; corrispondente gli farà cercare di raggiungere la linea corrispondente. Affinché questo funzioni, il documento &tex; deve essere già compilato, e la Ricerca in avanti &kdvi; deve essere in funzione.

#### Preferenze e impostazioni DVI

Per rendere &kile; il tuo editor predefinito in &kdvi;, inserisci il seguente comando nell'area della linea di comando:

`kile %f --line %l`; l'ultima opzione è una L minuscola, non un numero 1.

Configurazione di &kdvi;...
Configurazione di &kdvi;...

#### Risoluzione degli errori

Se stai cercando di usare la Costruzione rapida, e il visualizzatore DVI non si apre, è probabile che ci sia un errore. Se c'è un errore, è visibile nell'area dei messaggi e del file di log, e verrà presentato un riassunto degli errori.

Il file di log spiegherà l'origine dell'errore nel tuo codice. Nell'editor, puoi usare i pulsanti nella barra degli strumenti chiamati Errore LaTeX precedente e Errore LaTeX successivo per saltare avanti e indietro tra gli errori. Il file di log dichiara sempre in quale riga è occorso l'errore. Per vedere la riga dove è avvenuto l'errore, fai clic sull'errore nella finestra del log, e &kile; ti porterà sulla linea corrispondente all'errore.

## Iniziare un nuovo documento

###

####

Quando fai clic sul pulsante nella barra degli strumenti per cominciare un nuovo documento, appare una finestra di dialogo, che ti chiede quale tipo di modello vorresti usare per scrivere il tuo documento. Le tue scelte predefinite sono:

- Documento vuoto

- Lettera

- Libro

- Articolo

- Rapporto

Se hai selezionato un Documento vuoto, puoi iniziare a scrivere un documento da zero, o puoi usare l'assistente per iniziare rapidamente un nuovo documento (vedi )

#### Modelli

Gli utenti abituali di &latex; di solito usano lo stesso preambolo per quasi ogni documento che fanno. Normalmente aggiustano i parametri a loro piacimento. Iniziando un nuovo documento sarebbe comodo se &kile; partisse subito con questo documento definito dall'utente. I modelli ti permettono di ottenere questo; un qualsiasi utente &kile; che scriva continuamente lo stesso tipo di documento può avvantaggiarsi di questa capacità di &kile; di crearsi i propri modelli.

#### Crea un nuovo modello

Per creare un nuovo modello, devi prima o aprire un file &tex; / &latex;, o crearne uno da te. &kile; può generare un modello da un documento esistente aprendo il documento desiderato e selezionando File Crea modello da documento.

#### Configurazione delle sostituzioni automatiche

Nella creazione di un nuovo documento selezionando un modello da File Nuovo, certe combinazioni di caratteri saranno sostituite da dati come il tuo nome, o la codifica che stai usando. Queste variabili possono essere configurate in Impostazioni Configura &kile;. Modifica le Variabili dei modelli come vuoi.

Se stai ideando il tuo modello, è utile sapere quali combinazioni di caratteri sono sostituite da quali variabili dei modelli:

- `$$AUTHOR$$`: Questa stringa sarà rimpiazzata dalla variabile autore.

- `$$DOCUMENTCLASSOPTIONS$$`: Questa stringa sarà sostituita dalla variabile opzioni del tipo di documento. Tipicamente viene usato come di seguito: `\documentclass[$$DOCUMENTCLASSOPTIONS$$]{article}`.

- `$$INPUTENCODING$$`: Se la variabile codifica è impostata, per esempio, a `latin1` questa stringa è rimpiazzata da `\input[latin1]{inputenc}`.

#### Crea modelli con l'assistente

Il modo più semplice di creare modelli è partire con l'assistente, e poi aggiungere comandi all'editor sulla destra. Una volta che il documento è impostato come vuoi:

1. Salva il tuo file

2. Vai a File

3. Scegli Crea modello dal documento

4. Fai qualsiasi correzione necessaria al modello

5. Inserisci un nome per il tuo nuovo modello

6. Fai clic su OK per aggiungere il tuo modello al menu

La prossima volta che inizierai un documento, potrai scegliere il tuo modello personalizzato invece che i normali lettera, rapporto, libro, articolo o documento vuoto.

#### Creare un modello da un file qualsiasi

Un modello può essere creato da qualsiasi file. Se stai cercando un modo facile per configurare un modello, vai a cercarne uno che ti piaccia su Internet e segui gli stessi passi elencati in .

Per esempio, potresti voler creare un perfetto poster A0. Questi poster si vedonoregolarmente alle conferenze scientifiche, e &latex; ti aiuterà a fare un poster attraente e interessante. Puoi ottenere un modello per poster A0 alla home page di Lars Nummedal, purtroppo i commenti sono solo in norvegese. Ricorda che avrai bisogno del pacchetto `a0poster`, che normalmente non è incluso in un'installazione &tetex; standard.

#### Rimuovere un modello

Per rimuovere un modello da &kile;, vai a:

- Impostazioni Rimuovi modello...

- Apparirà una finestra di dialogo con elencati tutti i modelli

- Scegli un modello

- Fai clic su Rimuovi, e il tuo modello sarà rimosso

- I modelli segnati con un * non possono essere rimossi senza i permessi necessari.

## Modificare i documenti &latex;

L'editor interno che &kile; usa è Kate. Kate è un editor di testo creato per programmatori, che include la capacità di leggere ed evidenziare molti tipi diversi di file di testo, tra cui &latex; e &bibtex;.

Per saperne di più su Kate e sulle sue possibilità, vedi il manuale di Kate. Gli utenti di &kile; possono iniziare a leggere dal capitolo Lavorare con l'editor Kate.

###

#### Movimenti del cursore

Se vuoi selezionare del testo, hai le seguenti possibilità:

- Tieni premuto il pulsante sinistro del mouse, e trascina per evidenziare del testo

- Fai clic una volta su una parola per muovervi il cursore

- Fai clic due volte su una parola per selezionare l'intera parola

- Fai clic tre volte per selezionare l'intera frase

Mantenere premuto il pulsante sinistro del mouse, e trascinare sul testo che vuoi selezionare, copia automaticamente il testo selezionato negli appunti.

Mantere premuto shift e usare i tasti freccia ti permette di selezionare porzioni del codice sorgente nella finestra dell'editor.

#### Completamento e tracciamento delle parentesi

Il completamento delle parentesi è uno strumento visuale che la vista editor usa per indicare quali parentesi corrispondono a quali. Se apri un qualsiasi file .tex, e selezioni delle qualsiasi parentesi, siano esse tonde (), quadre [] o graffe {}, l'editor evidenzierà la parentesi e la sua corrispondente in giallo (questo colore predefinito può essere cambiato). Quindi, per esempio, puoi posizionare il cursore sulle graffe di `\section{Introduction}`, e vedresti `\section{Introduction}` nell'evidenziazione gialla predefinita, mostrandoti la posizione delle parentesi iniziale e finale.

#### Evidenziazione

&kile; ha la capacità di cercare ed evidenziare diversi tipi di codice. Per esempio, i comandi &latex; sono distinti dal testo normale, rendendoti facile distinguerli. Anche le formule sono evidenziate in un colore diverso.

#### Completamento automatico degli ambienti

Una novità in questa versione di &kile; è l'autocompletamento degli ambienti; quando inizi un ambiente, per esempio scrivendo `\begin{environment}`, &kile; aggiungerà automaticamente un comando `\end{environment}`, con in mezzo una riga per il tuo testo.

L'autocompletamento può essere disattivato nella sezione &latex; di Impostazioni Configura &kile;.

Completamento di un ambiente equazione
Completamento di un ambiente equazione

## Usare la libreria di etichette &latex;

&latex; ha centinaia di etichette che possono essere inserite per rappresentare simboli e caratteri speciali. Il modo più facile per inserire un carattere speciale è usare il menu tra il visualizzatore dell'albero dei file e la finestra del codice sorgente.

Il menu della barra laterale
Il menu della barra laterale

Per aggiungere un carattere speciale, fai clic sul tipo di carattere che vorresti aggiungere. Puoi aggiungere le seguenti categorie di caratteri:

- Simboli relazionali

- Lettere greche

- Frecce

- Delimitatori

- Simboli vari

- Caratteri stranieri

### Usare i bibitem

`\bibitem` è un comando usato per inserire una referenza in un ambiente `thebibliography` nel tuo documento. La sintassi per usare `\bibitem` è `\bibitem[etichetta]{chiave}`.

L'`[etichetta]` opzionale ti serve per aggiungere il tuo sistema di etichettamento per la voce della bibliografia. Se non viene impostata nessuna etichetta, le voci saranno poste in ordine numerico: [1], [2], [3], ecc.

L'argomento `{chiave}` è usato per referenziare e collegare i comandi `\bibitem` e `\cite` l'uno all'altro e le informazioni che essi contengono. Il comando `\cite` contiene l'etichetta associata al `\bibitem` desiderato, che è situato all'interno di un ambiente `thebibliography`, e contiene i dati della referenza. Sia `\bibitem` che il corrispondente `\cite` devono avere la stessa `{chiave}`; il modo più semplice per organizzare le chiavi è il cognome dell'autore. Le graffe secondarie in `{thebibliography}` indicano l'etichetta più lunga che puoi avere nella bibliografia. Quindi, inserire {pippo} indica che puoi avere qualsiasi etichetta più corta o lunga uguale all'espressione "pippo". Impostare male questo parametro potrebbe risultare in un'indentazione non troppo gradevole nella tua bibliografia.

La bibliografia è una sezione separata dal tuo documento principale, e un esempio di codice per la bibliografia è il seguente:

                    \begin{thebibliography}{50}
                    \bibitem{Simpson} Homer J. Simpson. \textsl{Mmmmm... ciambelle}.
                    Evergreen Terrace Printing Co., Springfield, DaqualchepartenegliUSA, 1998.
                    \end{thebibliography)

Poi, il tuo codice sorgente principale conterrebbe l'indirizzo dell'informazione relativa al `\bibitem` usando `\cite`. Quel codice sorgente assomiglierebbe a questo:

                    La mia tesi riguardo alla filosofia dei Simpson\copyright
                    viene dal mio libro preferito \cite{Simpson}.

Siccome spesso è difficile ricordarsi l'esatta chiave di citazione una volta che hai molte referenze, &kile; ti dà un modo semplice per inserire una citazione. Sulla barra degli strumenti Modifica, fai clic sul secondo menu a cascata (normalmente c'è scritto "label"), e seleziona "cite". Sarà mostrata una lista con tutte le chiavi di citazione, seleziona la referenza corretta e una citazione sarà inserita nel tuo documento. Per aggiornare la lista delle chiavi, salva il file, oppure scegli "Aggiorna struttura" dal menu Modifica.

Il prodotto finale nella bibliografia del tuo documento sarebbe più o meno come questo:

`[1] Homer J. Simpson. Mmmmm... ciambelle. Evergreen Terrace Printing Co., Springfield, DaqualchepartenegliUSA, 1998.`

Il modo più facile di lavorare con i `bibitem` e `cite` è usare l'opzione del menu a cascata chiamato cite. Quando selezioni una citazione da inserire, ti sarà data la lista dei `bibitem` che hai creato fino a quel momento, e potrai scegliere la referenza da quella lista. &kile; può ora lavorare insieme ad applicazioni editor di &bibtex;, come gBib e pyBliographer, per renderti più facile lavorare con le citazioni.

### Etichette utente

&kile; ti dà la possibilità di fare etichette per i tuoi documenti. Un'etichetta è simile a una scorciatoia che lancia i tuoi comandi o scrive del testo che usi spesso nei tuoi documenti. Per esempio, quando scrivo io uso spesso nei miei testi le frasi "Preferisco LaTeX a TeX" e "Cosa farei senza Linux?". Per farne delle etichette utente, dovrei:

- Selezionare Utente dal menu

- Selezionare Etichette utente

- Selezionare Modifica etichette utente

Questo mi porterà a una finestra di dialogo dove posso creare le mie etichette utente.

La finestra di dialogo Modifica etichette utente
La finestra di dialogo Modifica etichette utente
Chiamare un'etichetta utente
Chiamare un'etichetta utente

Nel creare le mie due etichette utente che uso spesso quando scrivo, darò loro un nome che le possa identificare chiaramente. Il nome che dai alla tua etichetta viene inserito nella sezione chiamata Elemento del menu, e il testo del comando che uso spesso sarebbe inserito nella sezione etichettata Valore. Una volta che li ho inseriti entrambi, posso usarli rapidamente nel mio testo usando la scorciatoia CtrlShift1 affinché la mia prima etichetta inserisca "Preferisco LaTeX a TeX" e CtrlShift2 per inserire "Cosa farei senza Linux?".

#### Caratteri univoci nelle etichette utente

Ci sono diversi caratteri univoci in &kile;; questi caratteri hanno un significato univoco nelle etichette utente, e sono %, %S, %M, %C e %env.

- `%`: un carattere usato per commentare il tuo codice sorgente.

- `%S`: sostituisce il nome del file sorgente.

- `%M`: questo sta per il testo evidenziato; il testo selezionato è inserito al suo posto quando si usano le etichette utente.

- `%C`: questo è dove il cursore sarà posizionato dopo aver usato un'etichetta utente.

Per mostrarti come funziona, diciamo per esempio che io abbia un'etichetta utente, che contenga il valore `\bfseries{%M}%C`, e abbia una selezione di testo evidenziata nel mio documento che voglia trasformare in grassetto. Quindi, evidenzio la frase `Adoro il venerdì`, applico la mia etichetta utente premendo CtrlShift1, e ottengo la frase `\bfseries{Adoro il venerdì}`, con il cursore posizionato alla fine dell'espressione.

## Usare gli strumenti di costruzione

###

#### Compilare &latex;, PDF&latex;

Per convertire il tuo documento a un altro formato, devi prima compilarne il sorgente dal tuo ambiente &latex;.

Per compilare il tuo codice sorgente per visualizzatori a schermo come &kdvi;, altri visualizzatori DVI o conversione a PostScript (PS), puoi usare la scorciatoia Alt2 o Strumenti LaTeX dal menu. Questo compila il sorgente per questi diversi formati, e poi avrai le opzioni di:

- Visualizzare il file DVI (userà il tuo visualizzatore predefinito); Alt3

- Convertire da DVI a PS; Alt4

- Visualizzare il file PS; Alt5

Ci sono diversi modi di compilare il tuo documento. Per esempio, se volessi compilare il tuo documento e trasformarlo direttamente in un PDF, dovresti eseguire PDF&latex; per compilare il tuo sorgente, che puoi dopo convertire a un file PDF. Ciò viene fatto usando la scorciatoia Alt6, o selezionando Strumenti PDF&latex; dal menu. Questo processo costruisce il tuo documento in modo che il tuo visualizzatore o altri programmi possano leggerlo.

- Visualizza il file PDF; Alt7

- Da PS a PDF; Alt8

- Da DVI a PDF; Alt9

#### Formati di file grafici

Nota come PDF&latex;, quando usato con i pacchetti `graphics` o `graphicx`, possa compilare correttamente i file PNG e JPG nel PDF, ma non è in grado di gestire i file EPS. Di converso, il processo di compilazione in DVI e conversione a PS e PDF supporta EPS, e non supporta PNG e JPG. Per superare questa impasse frustrante, nel caso che tu abbia sia file EPS che PNG o JPG, hai dei sistemi per aggirare il problema:

- Puoi convertire i file EPS a PNG o altri formati con applicazioni come Gimp, e quindi usare PDF&latex;.

- Puoi convertire nell'altro senso, e usare &latex; e la conversione PS-PDF; questo non è raccomandato perché l'incapsulazione EPS di file JPG o PNG produce file generalmente più grandi, che quindi producono documenti inutilmente grandi; questo però dipende dall'applicazione grafica che usi, perché EPS può incapsulare altri file grafici, ma non tutte le applicazioni supportano perfettamente questa possibilità; puoi per esempio usare il programma jpg2ps.

- Se hai bisogno di un file in formato PS, ma hai file grafici JPG o PNG, puoi semplicemente usare prima PDF&latex;, e poi usare l'istruzione da linea di comando pdftops, o, meglio ancora, implementare la tua etichetta utente (vedi ).

Usa il formato giusto per il grafico giusto!

- EPS è una specie di linguaggio script a vettori, che descrive tutte le linee e punti di cui un grafico è composto; non perde molto quando viene ingrandito, e si adatta al meglio ai diagrammi e alla grafica vettoriale prodotta nativamente in EPS. Puoi convertire file JPG con il programma jpg2ps, ma diventeranno un po' più grandi.

- PNG (o GIF) è un formato senza perdita, con buone compressione e qualità. È molto buono per diagrammi, scansioni di disegni, o qualsiasi cosa di cui vuoi mantenere la definizione. È a volte esagerato per le foto, e non può essere ingrandito a piacimento come EPS.

- JPG è un formato con perdita, che comprime i file meglio di PNG al prezzo di qualche perdita nei dettagli delle immagini. Questo è normalmente irrilevante per le foto, ma potrebbe causare una cattiva qualità per diagrammi e disegni, e potrebbe far sparire del tutto le linee più sottili; in questi casi usa EPS o PNG. I file JPG non possono essere ingranditi a piacimento come i file EPS:

Ma ricorda sempre il principio di conservazione della rumenta: nessuna conversione abbellirà una cattiva immagine.

#### Passare parametri di linea di comando

Forse vorresti passare alcuni parametri di linea di comando speciali agli strumenti per compilare e convertire i tuoi file. Gli strumenti standard possono essere configurati in Impostazioni Configura &kile;.

#### Documento principale

Definire il tuo documento come principale ti permette di lavorare con file separati, che vuol dire avere un documento principale e documenti figli che costituiscono un'opera completa. Dopo aver definito il tuo documento principale, tutti i comandi del menu Strumenti si applicheranno solo a questo documento, anche se starai lavorando sui documenti figli. Puoi anche chiudere il documento principale.

#### Gestione avanzata degli errori

Dopo aver eseguito &latex;, &kile; dà un'occhiata ai messaggi d'errore generati da &latex;. Se ci sono errori o avvertimenti, saranno riportati nella finestra Log/Messaggi. Si può dare un'occhiata alla finestra più da vicino selezionando Costruzione Visualizza log, o usando la scorciatoia da tastiera Alt0. Il log generato da &latex; è quindi mostrato nella vista Log/Messaggi; gli errori e gli avvertimenti sono evidenziati.

Visione del log...
Visione del log...

Puoi facilmente saltare da un messaggio all'altro nel file di log usando gli elementi del menu Costruzione Errore / Avvertimento LaTeX Successivo / Precedente, o usando i pulsanti corrispondenti nella barra degli strumenti.

Per saltare alla linea del codice &latex; dove è avvenuto l'errore, fai semplicemente clic sull'errore / avvertimento nella vista Log/Messaggi. &kile; ti porterà automaticamente alla linea incriminata.

#### Visualizzare il tuo documento

Per visualizzare il tuo documento una volta che hai compilato il sorgente usando &latex; o Alt2, puoi usare il tuo lettore DVI predefinito; usa il pulsante nella barra degli strumenti o Alt3.

#### Uso di Sorveglia file

1. Lancia il comando Costruzione rapida.

2. Lascia aperto &kdvi; e seleziona Sorveglia file per questo programma.

Ogni volta che avvii la Costruzione rapida, il documento DVI sarà aggiornato automaticamente, senza che &kdvi; venga riavviato.

Questa modalità funziona anche con KGhostView, ma non funzionerà con i visualizzatori integrati.

#### Convertire il tuo documento

Una volta che avrai compilato il tuo sorgente &latex; dall'editor, lo potrai convertire nel formato che ti fa più comodo.

##### Conversioni standard (`dvips`, `ps2pdf`, `dvipdf`, ecc.)

Selezionare gli strumenti di conversione dal menu, o usare le scorciatoie, ti permette di convertire il documento in una forma diversa. Le conversioni comuni sono verso i formati seguenti:

- DVI

- PS

- PDF

- HTML

Nota come PDF&latex; converta il tuo documento direttamente in PDF.

## Navigare nel sorgente &latex;

### Usare la vista struttura

La vista struttura mostra la gerarchia del documento creato in &kile;, e ti permette di navigare rapidamente nel documento, mostrandone la segmentazione. Per navigare nel tuo documento, tutto quello che devi fare è fare clic sinistro su un qualsiasi capitolo, sezione, sottosezione, etichetta, eccetera, e sarai portato all'inizio dell'area corrispondente.

#### Clic su etichette e sezioni

Usando la vista Struttura, puoi saltare facilmente tra etichette, sezioni e sottosezioni facendo clic sull'elemento nella vista Struttura, dopodiché sarai portato a quella sezione nella vista editor. Le sezioni e le sottosezioni sono chiaramente segnate con caratteri speciali che le rendono facili da identificare.

Uso della vista Struttura
Uso della vista Struttura

#### Doppio clic su input, include

Se includi un file nel tuo documento &latex; usando le etichette `\input` o `\include`, la vista Struttura conterrà un elemento che rappresenterà questo file. Fare doppio clic sul nome del file farà mostrare a &kile; questo file incluso.

#### Aggiornare la struttura

Per aggiornare la tua vista struttura puoi andare a Modifica Aggiorna struttura, e ciò aggiornerà la tua vista Struttura.

Dopo aver salvato il tuo documento, &kile; aggiornerà automaticamente la vista Struttura.

#### Segnalibri

I segnalibri sono il tuo riferimento a un segmento di testo o una linea all'interno di &kile;. Per usare un segnalibro, puoi selezionare una riga di testo specifica nel tuo documento alla quale vorresti tornare, quindi premi CtrlB, e &kile; aggiungerà automaticamente un segnalibro a quella riga. Alternativamente, puoi anche impostare un segnalibro evidenziando la riga alla quale vorresti tornare, e scegliere il menu chiamato Segnalibri.

Per rimuovere i tuoi segnalibri, seleziona Segnalibri Pulisci i segnalibri.

## Lavorare con i progetti

Quando lavori in &kile; hai la possibilità di creare e lavorare con file progetto. Un progetto è un gruppo di documenti &latex;, &tex;, o di altro tipo, che gestisce tutte le informazioni relative al tuo documento. Un esempio tipico dell'uso di un progetto sarebbe un documento costituito da diversi capitoli, scritti in diversi file `.tex`; tutti potrebbero essere inclusi in un progetto, per rendere più facile da gestire il documento complessivo. Puoi anche aggiungere file non sorgente come i file grafici. Le specificazioni del progetto sono conservate in un file speciale, con l'estensione .kilepr.

Un progetto aggiunge le seguenti funzionalità:

- Non devi impostare un documento principale, &kile; lo fa automaticamente;

- I file del progetto possono essere archiviati assieme;

- La vista File e progetti mostra le relazioni tra i file nella gerarchia del tuo documento;

- Dopo aver aperto un progetto, ogni file precedentemente aperto sarà ripristinato con la codifica e l'evidenziazione originali.

### Creare un progetto

Per creare un progetto, seleziona Progetto Nuovo progetto.... Ti saranno chieste le seguenti informazioni per creare il tuo progetto:

- Titolo del tuo progetto

- Nome del progetto con estensione .kilepr

- Nome file

- Tipo del file da creare: Documento vuoto, Articolo, Libro, Lettera, Rapporto

Quando crei un nuovo progetto, la casella di testo File del progetto è dove inserisci un nome per il tuo progetto con l'estensione .kilepr. Quando compili la sezione Nome file, devi includere un percorso per il tuo documento relativo a dove è tenuto il file di progetto .kilepr.

Un'installazione nuova di &kile; potrebbe non avere i pulsanti per creare, aprire, chiudere progetti direttamente nella barra degli strumenti. Puoi comunque aggiungerli alla barra andando a Impostazioni, Configura le barre degli strumenti.

### Uso della vista File e progetto

La vista File e progetto è un pulsante ordinato verticalmente che assomiglia a due fogli. Da questa vista, puoi vedere la struttura del tuo progetto, i file nel tuo progetto, e il nome del file .kilepr in cui sono salvate le informazioni del progetto. Dalla vista File e progetto si possono aggiungere, rimuovere o cambiare le opzioni del tuo progetto.

La vista File e progetto
La vista File e progetto

### Aggiunta e rimozione di file

Per aggiungere un file al tuo progetto, apri un qualsiasi file &tex;, fai clic destro sul suo nome nella vista File e progetto, e seleziona Aggiungi al progetto. Se hai più progetti aperti, una finestra di dialogo ti chiederà a quale progetto debba essere aggiunto.

Se hai più file da aggiungere a un progetto, puoi selezionare il progetto dalla vista File e progetto e fare clic destro, quindi selezionare Aggiungi file; potrai quindi selezionare i tuoi file in una finestra di dialogo.

Aggiunta di un file a un progetto
Aggiunta di un file a un progetto

Per rimuovere un file da un progetto, fai semplicemente clic destro su un file, seleziona Rimuovi dal progetto, e il tuo file sarà rimosso dal progetto. Questo non cancella il tuo file, ma lo rimuove soltanto dalla lista dei file contenuta nel file con estensione .kilepr.

### Cambiare le opzioni del tuo progetto

&kile; ha alcune opzioni relative al tuo progetto che possono essere impostate. Per cambiarle, fai clic destro sul titolo del tuo progetto e seleziona Opzioni progetto, e avrai la possibilità di cambiare:

- Il titolo del tuo progetto;

- Il comando di archiviazione;

- Le estensioni riconosciute per i file non sorgente;

- L'opzione di utilizzare le estensioni dei file come espressioni regolari.

#### Archiviazione del tuo progetto

&kile; ti permette di fare facilmente una copia di sicurezza del tuo progetto salvando tutti i file del progetto in un singolo archivio. Per archiviare il tuo progetto fai clic destro sul nome del progetto nella vista File e progetto, o seleziona Progetto Archivia.

Come impostazione predefinita, tutti i file di un progetto sono aggiunti all'archivio. Se non vuoi includere un certo file nell'archivio, fai clic destro su questo file nella vista File e progetto, e deseleziona l'opzione Includi in archivio.

I comandi di archiviazione sono comandi shell che vengono eseguiti dalla cartella del progetto (dove è situato il file .kilepr). I simboli speciali che possono essere usati scrivendo il comando sono:

- `%S`: questo è sostituito dal nome del tuo progetto senza l'estensione .kilepr.

- `%F`: questo comando è usato per sostituire la lista dei file inclusi nell'archivio.

#### Estensioni per i file non sorgente

I file non sorgente sono file come immagini, PDF, PostScript, ecc., che devono essere inclusi nel progetto, ma che non sono file sorgente con estensione .tex. Hai la possibilità di usare le tue espressioni regolari personalizzate per identificare i file non sorgente.

### Chiusura di un progetto

Per chiudere un progetto, seleziona la vista File e progetto dalla barra degli strumenti verticale, fai clic destro sul titolo del tuo progetto, e quindi seleziona Chiudi. Questo chiuderà il tuo progetto, tutti i file associati con il progetto, e inoltre ne aggiungerà il nome in Apri progetto recente... nel menu Progetto.

## Preparare un documento in una codifica alternativa

Uno dei grandi vantaggi nell'usare &kile; è la capacità di leggere, scrivere, convertire e impostare con facilità il testo nella codifica di cui hai bisogno. Questo ti permette di usare lettere e simboli non standard; puoi usare, per esempio, i caratteri accentati per l'italiano e il francese. La selezione della codifica può essere fatta in tre modi:

- Un modo di impostare la codifica è usare la casella Imposta codifica, situata in fondo alla vista Apri file.

- Un altro modo è usare il sottomenu Visualizza Imposta la codifica.

- Un secondo modo per impostare la codifica per un documento è impostarne l'opzione quando usi l'assistente per creare un nuovo documento.

C'è anche una codifica separata per il sistema tipografico &latex;. Tradizionalmente, &latex; capisce solo un insieme molto limitato di caratteri, quindi non avresti la possibilità di usare caratteri accentati direttamente. Per usare lettere accentate, &latex; ha creato una sintassi per aggirare il problema e includere queste lettere, per esempio `\"e` per `ë`. C'è un pacchetto per aiutarti in ciò, chiamato inputenc, ed è incluso nel preambolo usando `\usepackage[latin1]{inputenc}`, dove l'argomento opzionale è la codifica che vuoi usare (nella maggior parte dei casi `latin1`). Ciò dice a &latex; di tradurre tutte le `ë` nel tuo documento in `\"e`. Per piacere vedi direttamente la documentazione di inputenc per ulteriori informazioni. Ricordati di assicurarti che il file sia davvero codificato nella stessa codifica che hai indicato a inputenc!

Scelta della codifica del file sorgente
Scelta della codifica del file sorgente

La schiera di diversi caratteri ha creato problemi su molte applicazioni, e c'è accordo generale sul fatto che, prima o poi, tutti si sposteranno a Unicode. Ci sono molte implementazioni di Unicode, e utf-8 è la più popolare su Linux; Windows® si affida invece alla più ingombrante e meno flessibile ucs-2. Alcune distribuzioni, come RedHat, hanno già cominciato a impostare la loro codifica predefinita a utf-8, e quindi ti potrebbe interessare molto usare un argomento `utf-8` per il pacchetto `inputenc`.

La cattiva notizia è che non è ancora incluso in &tetex; al momento della scrittura di questo documento; la buona notizia è che c'è un pacchetto &latex; che può fare proprio quello, e lo puoi installare da te.

Vai alla home page di Supporto Unicode per &latex;, di Dominique Unruh dell'università di Karlsruhe. Segui le istruzioni lì presenti per installare il pacchetto e usarlo.

## Riconoscimenti e licenza

&kile; è un editor di codice sorgente &latex; e &tex; open source e facile da usare. Funzionerà sui sistemi con ambiente desktop &kde; installato. &kde; è disponibile per diverse architetture con Linux e altri sistemi simili a Unix. &kile; è anche parte del progetto Fink, il che vuol dire che puoi far funzionare &kile; anche su un Mac con OS-X!

Molti ringraziamenti sono dovuti a tutti coloro che lavorano per continuare il progetto &kile;, per le molte ore contribuite a sviluppare strumenti che possiamo usare tutti sotto la licenza GNU. Ecco una breve lista di programmatori, revisori, traduttori, scrittori, correttori, impacchettatori, sviluppatori Web e utenti che hanno reso possibile questo progetto.

Copyright del programma 2003 e responsabile attuale Jeroen Wijnhout Jeroen.Wijnhout@kdemail.net

Copyright del programma 2002-2003 Pascal Brachet

&kile; contiene codice sorgente dal programma libero (GPL) Xgfe (interfaccia GUI tra X Windows e Gnuplot), Copyright © 1998 David Ishee

Copyright della documentazione © 2003 Jonathan Pechta (bozza iniziale), Federico Zenith (rifiniture finali)

Contributi da: Rob Lensen, Roland Schulz, Michael Margraf

Traduttori: Thomas Basset (fr), Kris Luyten (nl), Alexander Hunziger (de), Stefan Asserhall (se), Alfredo Beaumont (eu), Leopold Palomo Avellaneda (ca), Federico Zenith (it), Quique (es), Maciej Woloszyn (pl).

Molte grazie e i migliori auguri a tutti coloro che sono stati coinvolti!

&underFDL; &underGPL;

&documentation.index;