# Manuale di &kile;

Jonathan
Pechta
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
2005
Federico Zenith
2005-01-18
1.7
&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 tuo sistema:

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

Pacchetti opzionali:

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

- &gnuplot;: pacchetto di grafica scientifica.

- &xfig;: programma di disegno per X window.

Alcuni di questi elementi potrebbero 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 binari di &kile; per diverse distribuzioni che possono essere facilmente installati e avviati senza bisogno di compilazione; controlla la homepage di &kile;.

### Uditorio

Questo manuale è pensato per chiunque, indipendentemente dalla sua esperienza con &latex;, &kde;, &kile; o Linux.

Gli utenti avanzati probabilmente non leggeranno questo manuale, ma tutti i suggerimenti saranno presi in considerazione. 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 zenith@chemeng.ntnu.no.

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.

## Introduzione

### Fatti di base

#### 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 da Donald Knuth 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 da Leslie Lamport 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;. Una spiegazione meno suggestiva ma più realistica è che venga dal cognome di Leslie Lamport, il creatore di &latex;. Adesso lo sai!

### Fondamenti di &latex;

Il sistema di tipografia di &latex; è simile ad altri linguaggi a marcatori come l'XML, usato per molti tipi di documenti (incluso quello che stai leggendo), o l'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. &kile; ti offre un buon numero di questi tag nel menu LaTeX nella barra dei menu.

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 di avvio rapido

L'assistente integrato in &kile; è una utile funzione per iniziare rapidamente a creare documenti con &kile;. Scegliendo l'assistente dalla barra dei menu 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: scegli il tipo di documento che vuoi creare: articolo, lettera, rapporto, libro, o un altro tipo personalizzato.

- Dimensione caratteri: dì a &kile; quale dimensione dei caratteri vuoi usare.

- Dimensione carta: scegli le dimensioni o lo stile della carta.

- Codifica: 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`; tuttavia, sono disponibili molte altre opzioni, come il Latin 5 per il turco.

- Autore: metti il tuo nome qui.

- Titolo: aggiungi qui il titolo del tuo documento.

- Altre opzioni: questo ti permette di impostare ulteriori opzioni per la stampa, le bozze, e altro.

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

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

L'autocompletamento degli ambienti significa che quando inizi un nuovo ambiente scrivendo `\begin{ambiente}`, &kile; aggiungerà automaticamente un comando `\end{ambiente}`, 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 qualche tipo. &latex; ti permette di spezzare i documenti nella gerarchia seguente (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;.

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à lavorare più facilmente con altri file .tex inclusi nel tuo documento.

- Costruzione rapida: compila il tuo codice sorgente &latex; e ne mostra i risultati automaticamente, a meno che ci siano errori nel codice.

- Sorveglia file: questa modalità "sorveglierà" eventuali cambiamenti del file DVI, e non avvierà una nuova finestra di &kdvi; dopo una Costruzione rapida.

- Visualizza file di log: visualizza il file .log, per avvistare gli errori.

- Errore precedente: salta all'indietro nel file .log ed 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 riga 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 certe funzionalità comuni nel tuo documento. Il primo menu a cascata è usato per dividere rapidamente il tuo documento in parti, capitoli, sezioni, e così via; i comandi disponibili per aggiungere segmenti 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 sono:

- label: un comando che produce un un'etichetta per un capitolo, una figura o altro elemento.

- index: crea una voce per l'indice.

- 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: proprio come ref, ma si riferisce a una pagina invece che a un elemento della struttura.

- cite: crea un riferimento con dati da una bibliografia.

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; ciò funzionerà solo se il file appartiene a un progetto. Puoi anche usare 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, e così via; i comandi disponibili 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

Gli utenti di &kile; hanno due scelte quando cominciano un nuovo documento: possono usare l'Assistente per cominciare un nuovo documento, selezionando il tipo di documento che vorrebbero creare, e opzioni come la dimensione dei caratteri, della carta, e così via; altrimenti, possono 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` contengono le opzioni del 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.

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 avviato automaticamente; altrimenti, controlla il log.

### Ambienti

Un ambiente è un segmento di testo gestito 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.

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 un altro 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, del testo in grassetto, corsivi, e un verso per vedere le differenze tra i 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 se stai usando il visualizzatore integrato, o chiudi la finestra del visualizzatore se stai usandone uno separato.

Ecco fatto! Hai appena creato il tuo primo documento &latex;!

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, potrai stampare il file DVI.

#### Stampare un DVI manualmente da una console

Per stampare manualmente un DVI da una console, usa per prima cosa il comando `dvips intro.dvi`. Il comando convertirà il tuo DVI in un file postscript. Una volta che il tuo file è convertito, puoi stamparlo usando il comando `lpr intro.ps`.

#### Esportare un DVI

La barra degli strumenti dà la possibilità di esportare un DVI ad altri formati. Una volta che hai creato un DVI dal tuo codice sorgente &latex;, potrai esportarlo in un formato di tua scelta usando i pulsanti della barra degli strumenti.

### Ricerche in avanti e all'indietro tra &kile; e &kdvi;

#### 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 `srcltx.sty`. Se non è incluso, puoi scaricarlo; copialo in una cartella di &tex;, per esempio `/usr/share/texmf/tex/latex/srcltx/`, ed esegui ``texhash`` in modo che &latex; sia al corrente della sua esistenza. Quindi devi impostare il seguente comando nel preambolo:

                    \documentstyle[12pt, a4paper]{book}
                    \usepackage[active]{srcltx}
                    \usepackage[latin1]{inputenc}
                    \pagestyle{empty}
                    \renewcommand{\baselinestretch}{2}
                    \begin{document}
                    \begin{verse}
                    L'editor di codice sorgente \LaTeX\ &kile; per KDE è il mio preferito.

                    \emph{Perché} è facile da usare!
                    \end{verse}
                    \end{document}

Una volta che hai aggiunto il pacchetto `srcltx`, puoi lasciare &kdvi; aperto. Per eseguire una ricerca in avanti, posiziona il cursore su una riga di codice sorgente, e fai clic su Ricerca in avanti di Kdvi per saltare alla posizione associata nella finestra del visualizzatore DVI.

#### Ricerca all'indietro

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

- `srcltx.sty` sia in uso.

- Il file sorgente sia stato compilato con successo.

- &kdvi; sappia quale editor vuoi usare.

Con questa funzionalità di &kdvi;, un clic sul pulsante centrale del mouse nel documento &DVI; farà aprire a &kile; il documento &tex; corrispondente e gli farà cercare di raggiungere la linea corrispondente. Ricordati di dire a &kdvi; di usare &kile; come editor di testo, nell'elemento del menu Impostazioni Opzioni DVI....

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 etichettati 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à alla sua riga.

## 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 scelte predefinite sono:

- Documento vuoto

- Lettera

- Libro

- Articolo

- Rapporto

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

### Modelli

Gli utenti frequenti di &latex; usano tipicamente lo stesso preambolo per quasi ogni documento che usano. Si possono creare, salvare e caricare modelli all'interno di &kile; per facilitare l'inizio di un nuovo documento.

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

Nella stesura del 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 un nuovo modello è partire con l'assistente, e poi aggiungere comandi nell'editor. 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 dei predefiniti.

#### Creare un modello da un file qualsiasi

Un modello può essere creato da qualsiasi file &latex;. 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 vedono regolarmente alle conferenze scientifiche, e &latex; ti aiuterà a fare un poster accattivante e interessante. Puoi ottenere un modello per poster A0 alla home page di Jonathan Marchini, ma ce ne sono molti altri disponibili. Ricorda che avrai bisogno del pacchetto `a0poster`, che normalmente non è incluso in un'installazione &tetex; standard, quindi dovrai scaricarlo, copiarlo a una cartella &tex;, per esempio `/usr/share/texmf/tex/latex/a0poster/`, ed eseguire ``texhash`` in modo che &latex; sappia che esiste.

#### Rimuovere un modello

Per rimuovere un modello da &kile;, fai come segue:

1. Vai a Impostazioni Rimuovi modello...;

2. Apparirà una finestra di dialogo con elencati tutti i modelli: seleziona un modello;

3. Fai clic su OK, e il tuo modello sarà rimosso.

I modelli segnati con un asterisco (*) non possono essere rimossi senza i permessi appropriati.

## 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;; puoi accedere a molte opzioni di &kate; direttamente dal menu Strumenti di &kile;.

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.

### Il riferimento &latex;

&kile; include un riferimento &latex; molto pratico, cui puoi accedere attraverso Aiuto Riferimento LaTeX. Contiene una descrizione completa di quasi tutti i comandi che userai in &latex; e la loro sintassi.

### Movimenti del cursore

Per 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 corrispondenza 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, se posizionassi il cursore sulle graffe di `\section{Introduzione}`, vedresti `\section{Introduzione}` 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, e anche le formule sono evidenziate in un colore diverso.

### Completamento automatico degli ambienti

Quandi inizi un nuovo ambiente, scrivendo `\begin{ambiente}`, &kile; aggiungerà automaticamente un comando `\end{ambiente}`, 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

### Assistenza per le matrici

Uno dei lavori più noiosi che si possano fare in &latex; è scrivere una matrice o un ambiente tabella. Si deve tener conto di tutti gli elementi, assicurarsi che l'ambiente sia ben formato, e che tutte le cose siano dove devono essere. Una buona indentazione aiuta, ma c'è un modo più semplice: usare il menu Assistente di &kile;. Oltre all'opzione Avvio rapido, contiene Tabella e Matrice (usato negli ambienti matematici). Apparirà quindi uno schema a forma di matrice che puoi facilmente riempire con le tue voci. L'opzione Tabulazione farà apparire un menu più semplice per impostare un ambiente di tabulazione. In tutti questi ambienti, puoi facilmente impostare il numero di righe e colonne, insieme ad altri parametri specifici.

Inserimento di un ambiente matrice
Inserimento di un ambiente matrice

## Tag speciali in &latex;

### Usare la libreria di etichette &latex;

&latex; ha centinaia di etichette per simboli e caratteri speciali. Il modo più facile per inserire caratteri speciali è usare il menu della barra laterale, a sinistra della finestra dell'editor.

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 i seguenti tipi 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 ti aspetti di 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 o scegli Modifica Aggiorna Struttura.

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ò anche lavorare insieme ad applicazioni &bibtex;, come &gbib; e &pybliographer;, per renderti le citazioni più facili.

### Etichette utente

&kile; ti dà la possibilità di fare le tue etichette. Un'etichetta è simile a una scorciatoia che avvia qualche comando o scrive del testo frequentemente usato. Per esempio, Pinco Pallino usa spesso le frasi `Preferisco \LaTeX a \TeX` e `Cosa farei senza Linux?`. Per creare etichette utente per scrivere queste frasi, dovrebbe andare a Utente Etichette utente Modifica etichette utente; ciò farà apparire una finestra di dialogo dove potrà creare le sue etichette utente.

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

Probabilmente darebbe a ogni etichetta un nome che la possa identificare chiaramente. Il nome che dài alla tua etichetta viene inserito nella sezione chiamata Elemento del menu, e il testo del comando dovrebbe essere inserito nella sezione etichettata Valore. Una volta che i comandi sono inseriti, li può usare rapidamente usando la scorciatoia CtrlShift1 affinché la mia prima etichetta inserisca `Preferisco \LaTeX a \TeX` e CtrlShift2 per inserire `Cosa farei senza Linux?`.

#### Segnaposti nelle etichette utente

Ci sono alcuni segnaposti che puoi usare nelle etichette utente: sono `%S`, `%M`, e `%`.

- `%S`: sarà sostituito 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 di avere un'etichetta utente che contenga il valore `\bfseries{%M}%C`, e di avere una selezione di testo evidenziata nel nostro documento che vogliamo trasformare in grassetto. Quindi, evidenziamo la frase `Adoro i venerdì`, applichiamo la nostra etichetta utente premendo CtrlShift1, e otteniamo il testo `\bfseries{Adoro i venerdì}`, con il cursore posizionato alla fine dell'espressione.

## Usare gli strumenti di costruzione

### Compilazione, conversione e visualizzazione

Per visualizzare il risultato del tuo lavoro, devi prima compilarne il sorgente. Tutti gli strumenti di costruzione sono raggruppati nei menu Costruzione Compila, Costruzione Converti, e Costruzione Visualizza.

Per compilare il tuo codice sorgente per visualizzatori a schermo come &kdvi;, altri visualizzatori DVI o conversioni successive, puoi usare la scorciatoia Alt2. Poi puoi visualizzare il file DVI usando il tuo visualizzatore predefinito con Alt3, convertire il DVI a un file PS con Alt4, e visualizzare il file PS con Alt5.

#### &bibtex;

Se stai usando &bibtex; per le voci della tua bibliografia, dovrai seguire uno schema di compilazione speciale.

1. Avvia &latex; con Alt2.

2. Avvia &bibtex; conAlt-: ciò compilerà il file della bibliografia.

3. Avvia di nuovo due volte &latex;, per incorporare le informazioni della bibliografia, e aggiustare le citazioni e i riferimenti incrociati.

Puoi anche visualizzare il file &bibtex; con il tuo editor &bibtex; preferito (per esempio &gbib;) scegliendo Costruzione Visualizza Visualizza Bibtex; puoi cambiare il visualizzatore &bibtex; predefinito a Strumenti Configura Kile...Strumenti.

#### MakeIndex

Se stai usando il pacchetto &makeidx; per fare un indice analitico finale per il tuo documento, devi anche seguire un certo schema di compilazione.

1. Avvia &latex; con Alt2.

2. Fai l'indice con Alt=: questo compilerà il file dell'indice.

3. Esegui &latex; di nuovo, per incorporare le informazioni dell'indice compilate.

#### MetaPost

Se vuoi compilare il tuo documento con MetaPost, un programma di disegno, puoi farlo con Costruzione Compila Mpost.

#### PDF&latex;

C'è anche un altro modo per compilare il tuo documento, se vuoi un PDF: puoi eseguire PDF&latex;, che compilerà il sorgente direttamente in un file PDF, con Alt6: puoi quindi visualizzare il file premendo Alt7.

Alternativamente, puoi convertire un PS in un PDF con Alt8, o un DVI direttamente in un PDF con Alt9.

Usare PDF&latex; invece di &latex; può essere solo una questione di semplicità o d'abitudine, ma a volte il comportamento dei due programmi può differire.

#### &latex;2HTML

Infine, potresti voler pubblicare il tuo lavoro sul Web, e non solo su carta. Puoi allora usare il programma latex2html, che può essere chiamato dal menu Costruzione Converti Da LaTeX a HTML di &kile;. Il risultato sarà posizionato in una sottocartella della cartella di lavoro, e potrai vedere il risultato della conversione scegliendo l'elemento Costruzione Visualizza Visualizza HTML.

#### Passare parametri di linea di comando

Se vuoi passare alcuni parametri di linea di comando specifici agli strumenti di compilazione, conversione e visualizzazione, puoi configurarne la chiamata in Impostazioni Configura Kile...Strumenti.

### Formati di file grafici

PDF&latex;, quando usato con i pacchetti `graphics` o `graphicx`, può 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 infine PDF supporta EPS, ma non supporta PNG e JPG. Per superare questa impasse frustrante, nel caso che tu abbia sia file EPS che PNG o JPG, ci sono 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; questa non è sempre una buona idea, perché l'incapsulazione EPS di file JPG o PNG può produrre file più grandi, che a loro volta producono documenti inutilmente grandi; questo però dipende molto dall'applicazione grafica che usi, perché EPS può incapsulare altri file grafici, ma non tutte le applicazioni supportano perfettamente questa possibilità; alcune potrebbero anche cercare di costruire la tua immagine JPG con vettori e vari script, che risulterà in file giganteschi. Un semplice programma che fa correttamente questo processo è 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 il grafico è composto; non perde molto quando viene ingrandito oltre la sua dimensione predefinita, e si adatta al meglio ai diagrammi e alla grafica vettoriale prodotta nativamente in EPS, che hanno un aspetto chiaro e netto pur mantenendo una dimensione molto ridotta.

- PNG (o lo sconsigliato 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.

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

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

### 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 degli errori

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

Visualizzazione del log
Visualizzazione 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 o l'avvertimento, fai clic sull'errore o avvertimento nella vista Log/Messaggi. &kile; ti porterà automaticamente alla linea incriminata.

### Uso della modalità Sorveglia file

Quando avvii il comando Costruzione rapida, un visualizzatore di qualche tipo sarà chiamato dopo la compilazione. Se non stai usando un visualizzatore integrato, ogni volta sarà aperta una nuova finestra.

Se stai sistemando l'aspetto del tuo documento, potresti avviare Costruzione rapida molto spesso, e avere molte finestre di visualizzatori aperte sul tuo desktop; per evitare questa confusione, puoi attivare la modalità Sorveglia file, che impedirà a Costruzione rapida di avviare un visualizzatore.

Al momento, &kdvi; supporta l'aggiornamento continuo del file DVI visualizzato, ma &kghostview; non è altrettanto perfetto: per aggiornare il documento dopo la compilazione, dovrai cambiare pagina, e il numero di pagine non sarà cambiato nella visualizzazione di &kghostview;.

Questa modalità è ovviamente inutile con i visualizzatori integrati, perché devi chiuderli comunque per tornare a modificare il documento e ricompilare.

## Navigare nel sorgente &latex;

### Uso della vista Struttura

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

Se includi un file separato nel tuo sorgente &latex; usando le etichette `\input` o `\include`, questi file saranno rappresentati nella vista Struttura; fare doppio clic sui loro nomi farà mostrare a &kile; il file incluso nella finestra dell'editor.

L'albero di gerarchia ha anche un ramo a parte per le etichette di riferimento usate nel testo.

Uso della vista Struttura
Uso della vista Struttura

#### Aggiornare la vista struttura

Per aggiornare la tua vista struttura puoi andare a Modifica Aggiorna Struttura, o puoi salvare il tuo documento, che farà aggiornare a &kile; la sua vista Struttura.

### Segnalibri

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

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

## Progetti

### Lavorare con i progetti

In &kile; puoi creare e lavorare con progetti. Un progetto è un gruppo di documenti &latex;, &tex;, o di altro tipo, che contengono tutte le informazioni relative al tuo documento completo. Un progetto tipico 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 nel progetto file non sorgente come i file grafici. Le specificazioni del progetto sono conservate in un file speciale, con estensione .kilepr.

Un progetto aggiunge le seguenti funzionalità:

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

- I file del progetto possono facilmente essere archiviati assieme.

- La vista File e progetto mostra quali file sono inclusi nel tuo progetto.

- 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 file progetto con estensione .kilepr.

- Nome file.

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

Quando riempi la casella Nome file, devi includere un percorso relativo da dove il file progetto .kilepr è conservato al file.

### Uso della vista File e progetto

La vista File e progetto è un pulsante della barra laterale. Da questa vista, puoi vedere la struttura del tuo progetto, i suoi file, e il nome del file .kilepr in cui sono salvate le informazioni del progetto. Aggiunta, rimozione o cambiamento delle opzioni del tuo progetto si fanno attraverso la vista File e 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.

Puoi anche fare clic destro sul nome del progetto nella vista File e progetto, e selezionare Aggiungi file... per far apparire una finestra di selezione file.

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

Per rimuovere un file da un progetto, fai clic destro su di esso e seleziona Rimuovi dal progetto. Ciò non elimina 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 salvandone tutti i file in un singolo archivio (spesso conosciuto come tarball). 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 di esso nella vista File e progetto, e deseleziona l'opzione Includi in archivio.

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

- `%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, file PDF o PostScript, eccetera, 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.

## Impostare la codifica del documento

L'editor &kile; ti permette di leggere, convertire e impostare il testo nella codifica che serve al tuo documento. 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 combinata Imposta codifica, situata in fondo alla vista Apri file della barra laterale.

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

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

&latex; di per sé capisce solo ASCII, un insieme molto limitato di caratteri, quindi non potresti usare caratteri accentati o speciali direttamente. Per usare lettere accentate, è stata creata una sintassi speciale: come 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 `ë` che hai scritto in `\"e` prima di compilare. Per piacere riferisciti direttamente la documentazione di inputenc per ulteriori informazioni. In ultimo, ma non certo per importanza: 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 diverse codifiche di caratteri ha creato problemi su molte applicazioni: per esempio, non puoi scrivere un corso di turco in francese senza perdere i caratteri speciali di una lingua. 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.

### Il pacchetto &ucs;

Puoi ottenere il pacchetto &ucs; dalla pagina Web per il supporto Unicode per &latex;, di Dominique Unruh dell'università di Karlsruhe.

Per installarlo, scompatta i file scaricati e sposta i contenuti scompattati in una cartella che &tex; possa vedere; potresti usare per esempio `/usr/share/texmf/tex/latex/ucs/` (assicurati che questo sia davvero il tuo percorso $`TEXMF`, perché a volte cambia a seconda della distribuzione che usi!). Rendi la cartella leggibile globalmente se non lo è già, e le sottocartelle eseguibili, usando `chmod`. Dovrai effettuare tutte queste operazioni come root, quindi fai attenzione.

Quando hai finito, avvia il comando `texhash` per far rileggere a &tex; i suoi file, e si spera fargli trovare il nuovo pacchetto. Riferisciti alla documentazione del pacchetto per i dettagli, ma in generale ti servirà poco più che impostare ciò che segue nel tuo preambolo:

                    \usepackage{ucs}
                    \usepackage[utf8x]{inputenc}

### Supporto per cinese, giapponese e coreano (&cjk;)

Aggiungere il supporto per le lingue ideografiche è piuttosto complicato. Tuttavia, una volta che hai finito, funzionerà piuttosto bene. Oltre a installare dei pacchetti, c'è da fare del lavoro di configurazione aggiuntivo.

La tua distribuzione Linux potrebbe già avere un pacchetto &cjk; pronto per te, quindi ti potresti risparmiare la fatica di installare tutto a mano. Controlla prima di andare avanti!

C'è la possibilità di usare il pacchetto &ucs; per scrivere brevi inserti di testo &cjk;, ma quell'opzione è seriamente limitata perché non gestisce, tra l'altro, i ritorni a capo. Noi invece installeremo il pacchetto &cjk;-&latex; completo e lo faremo funzionare sia per &latex; che per PDF&latex;. Molto di questo materiale è stato ispirato alla pagina Web su come configurare PDF&latex; di Pai H. Chou.

1. Scarica il pacchetto &cjk;. Copiane i file scompattati in una sottocartella appropriata di $`TEXMF`, come hai fatto prima per il pacchetto &ucs; (vedi ). I file saranno scompattati in una cartella `CJK/X_Y.Z`, non è fondamentale che li estrai, anche se ti sarà poi più facile mantenerli.

2. Adesso devi scaricare un tipo di carattere che supporti tutti i caratteri &cjk; di cui hai bisogno. Puoi scegliere qualsiasi file `*.ttf` che li contenga, ma in questa guida useremo Cyberbit. Scompatta il file e rinomina `Cyberbit.ttf` in `cyberbit.ttf`, perché le maiuscole potrebbero confondere il tuo sistema.

   Posiziona `cyberbit.ttf` in una cartella insieme a `Unicode.sfd`, e genera i file `*.tfm` e `*.enc` con il comando `$ ttf2tfm cyberbit.ttf -w cyberbit@Unicode@`. Per qualche motivo, a volte questo non produce le centinaia di file che dovrebbe. Se fosse il tuo caso, puoi scaricare sia i file `*.tfm` che `*.enc`.

   Posiziona i file `*.tfm` in una cartella appropriata, diciamo `$TEXMF/fonts/tfm/bitstream/cyberbit/`; i file `*.enc` possono essere installati in `$TEXMF/pdftex/enc/cyberbit/`.

3. Adesso abbiamo bisogno di un file di mappatura per connettere i file `*.enc` al tipo di carattere. Scarica `cyberbit.map` e installalo in `$TEXMF/pdftex/config/`.

4. Scarica un altro file, `c70cyberbit.fd`, e posizionalo in una cartella appropriata. Puoi scegliere, per esempio, `$TEXMF/tex/misc/`.

5. L'ultimo file che dobbiamo generare è un tipo di carattere PostScript Type 1, necessario per leggere i file DVI generati con &latex;. Esegui il comando `$ ttf2pfb cyberbit.ttf -o cyberbit.pfb`, e copia il file risultante `cyberbit.pfb` in una cartella come `$TEXMF/fonts/type1/cyberbit/`.

6. Ora mettiamo `cyberbit.ttf` tra i tipi di carattere dove &latex; lo può trovare. Puoi posizionarlo in una cartella di nome `$TEXMF/fonts/truetype/`.

7. Controlla il file di configurazione che trovi a `$TEXMF/web2c/texmf.cnf`, e assicurati che la riga contenente `TTFONTS` non sia commentata e punti alla cartella dove hai salvato `cyberbit.ttf`.

8. Per fare sì che PDF&latex; usi i tuoi caratteri &cjk;, è necessario che aggiungi una riga nel file di configurazione `$TEXMF/pdftex/config/pdftex.cfg`. Aggiungi `map +cyberbit.map` nel file per completare la configurazione di PDF&latex;.

9. Per configurare &latex; in modo da poter produrre file DVI con caratteri &cjk;, devi aggiungere una riga nel file `ttfonts.map`. Il file potrebbe essere in una cartella di nome `$TEXMF/ttf2pk/`, ma probabilmente dovrai cercarlo. Aggiungici la riga `cyberbit@Unicode@ cyberbit.ttf`.

10. Adesso, devi solo eseguire `texhash` e il sistema dovrebbe essere pronto.

Per controllare se la tua configurazione è corretta, puoi provare a compilare questo file di testo.

#### Risoluzione dei problemi con &cjk;

Ci sono molte cose che possono andare storte quando si imposta il supporto &cjk; manualmente. Se qualcosa sembra non funzionare, l'elenco seguente ti potrebbe aiutare.

- Ovviamente, siccome usi &latex; come utente e non come root, devi permettere agli utenti normali di accedere ai nuovi file. Assicurati che tutte le cartelle e i file siano accessibili usando il comando `chmod`.

- Se &latex; scrive un DVI senza problemi, ma non può visualizzarlo, è quasi sicuramente a causa di problemi nella generazione automatica dei caratteri `*.pk`. Dovrebbero essere generati al volo quando si visualizza un file DVI, ma ciò potrebbe non riuscire per vari motivi: per prima cosa ricontrolla accuratamente di aver inserito la nuova riga in `ttfonts.map`. Tuttavia, potrebbe capitare che il tuo comando `ttf2pk`, che è normalmente chiamato dal visualizzatore DVI, sia stato compilato senza supporto per le librerie kpathsea. Se è questo il caso, `$ ttf2pk --version` non nominerà kpathsea. Siccome il supporto di queste librerie è necessario, potresti dover trovare un nuovo pacchetto, o ricompilare da te FreeType 1.

#### Come scrivo &cjk; in Unicode?

Ci sono una serie di diversi motori di inserimento, e la scelta può dipendere anche dai gusti personali. L'autore usa Skim, un trasferimento su &kde; del motore Scim. Riferisciti alla documentazione della tua distribuzione per sapere come installare questi programmi. Anche la configurazione di questi programmi può essere difficile, nel caso di Skim dovrai definire una variabile d'ambiente `XMODIFIERS="@im=SCIM"` prima di avviare X.

## 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, 2003-2005 Federico Zenith

Contributi da: Rob Lensen, Roland Schulz, Michael Margraf

Molte grazie a tutti i partecipanti!

&underFDL; &underGPL;

&documentation.index;