Questo manuale è pensato per chiunque, indipendentemente dalla sua esperienza con L^AT_EX, 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, consulta la pagina Web di Kile.

Hai bisogno di risposte su Kile? Sei bloccato con una compilazione? Vuoi una nuova funzionalità? Il modo migliore di fare domande tecniche o avviare una discussione è usare la nostra mailing list: (kile-devel AT lists.sourceforge.net).

Il sistema di tipografia di L^AT_EX è simile ad altri linguaggi a marcatori come XML, usato in molti tipi di documenti (incluso quello che stai leggendo), o l'HTML, usato per le pagine Web. L'idea generale dei linguaggi a marcatori è avere parole chiave speciali dette tag, che dicono a un programma (un elaboratore di testi, un browser Web, o il compilatore di L^AT_EX) come interpretare il testo tra i tag. Kile offre un buon numero di questi tag nel menu LaTeX nella barra dei menu.

Sebbene proveremo a darti una buona idea di cosa sia L^AT_EX, questo documento non è ovviamente La Bibbia Definitiva di L^AT_EX. Se vuoi imparare L^AT_EX bene, potresti prendere un libro da una biblioteca.

Come per altri linguaggi a marcatori, i documenti L^AT_EX contengono un preambolo, che definiscono le proprietà globali, come la dimensione della carta, la numerazione delle pagine, le dimensioni del testo sulla pagina, e un corpo del documento, che ne contiene il testo; il preambolo contiene almeno il comando \documentclass, e precede il corpo, che inizia con il comando \begin{document} e si conclude con il comando \end{document}.

Se guardi la barra degli strumenti Modifica, noterai tre grandi menu a cascata. I menu a cascata sono stati progettati per poter aggiungere rapidamente certe funzionalità comuni nel documento. Il primo menu a cascata è usato per dividere rapidamente il documento in parti, capitoli, sezioni, e così via; i comandi disponibili per aggiungere segmenti al codice sorgente L^AT_EX sono:

Il menu a cascata chiamato Altro è usato per inserire nel documento elementi come indici, note a piè di pagina, referenze. I comandi disponibili sono:

Il menu a cascata Altro

Selezione dell'etichetta di un riferimento

Usando cite, viene presentata una lista a cascata di bibitem, ma se stai usando BibT_EX ciò funzionerà solo se il file appartiene a un progetto. Per modificare i file BibT_EX si raccomanda l'uso di un programma apposito. L'autore ha avuto buoni risultati con KBibT_EX. Ovviamente puoi anche scrivere i file BibT_EX a mano all'interno di Kile.

L'ultimo menu a cascata, indicato con tiny, è usato per impostare la dimensione del testo. Hai la possibilità di impostare le dimensioni di testo, note a piè di pagina, e così via; i comandi disponibili sono:

Un ambiente è un segmento di testo gestito diversamente dal resto del 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} 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 documento che lo renderanno più leggibile e semplice. Puoi aggiungere cose come tipi di carattere particolari, grassetto, corsivo, sottolineato, eccetera, e questi comandi si concluderanno o con un comando \end, o alla fine dell'ambiente.

Adesso che abbiamo dato un'infarinatura su come scrivere codice usando il linguaggio L^AT_EX, mostreremo come creare un documento passo-passo usando Kile.

Ecco fatto! Hai appena creato il tuo primo documento L^AT_EX!

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

DVI significa file indipendente dal dispositivo (DeVice Independent). Questi file sono prodotti da T_EX o L^AT_EX per essere letti da un driver sul sistema. Ci sono molte destinazioni a cui si può inviare un .dvi, come una stampante, un convertitore in file PostScript® o PDF, o il monitor.

Le funzioni di ricerca in avanti permettono di passare direttamente dall'editor alla posizione associata del file DVI o PDF.

Kile offre di configurare questa opzione per tutti i file binari L^AT_EX. Vai a Impostazioni → Configura Kile → Strumenti+Costruzione e scegli sempre la configurazione Moderna.

Per eseguire una ricerca in avanti, metti il cursore su una riga di codice sorgente, e fai clic su Ricerca in avanti per saltare alla posizione associata nella finestra del visore DVI o PDF.

La ricerca inversa è una funzionalità utile quando scrivi un documento L^AT_EX. Se tutto è a posto, puoi fare clic nella finestra di Okular con il tasto sinistro del mouse tenendo premuto Shift. Dopodiché, Kile caricherà il file sorgente L^AT_EX e salterà al paragrafo giusto. Per usare la ricerca all'indietro, devi compilare il file di L^AT_EX con la configurazione Moderna.

La ricerca inversa non può funzionare a meno che:

Con questa funzionalità di Okular, un clic sul tasto sinistro del mouse tenendo premuto Shift nel documento DVI o PDF farà aprire a Kile il documento L^AT_EX corrispondente, e gli farà cercare di raggiungere la riga corrispondente. Ricordati di dire a Okular di usare Kile come editor di testo, usando l'elemento del menu di Okular Impostazioni → Configura Okular... (sulla pagina Editor).

Configurare Okular

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

Il registro spiegherà l'origine dell'errore nel codice. Nell'editor, puoi usare i pulsanti nella barra degli strumenti indicati come Errore LaTeX precedente e Errore LaTeX successivo per saltare avanti e indietro tra gli errori. Il registro dichiara sempre in quale riga è occorso l'errore. Per vedere la riga dove è avvenuto l'errore, fai clic sull'errore nella finestra del registro, e Kile ti porterà alla riga dell'errore.

Per selezionare del testo, hai le seguenti possibilità:

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

Tenere premuto Shift e usare i tasti freccia permette di selezionare porzioni del codice sorgente nella finestra dell'editor.

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.

Kile ha la capacità di cercare ed evidenziare diversi tipi di codice. Per esempio, i comandi L^AT_EX sono distinti dal testo normale, e anche le formule matematiche sono evidenziate in un colore diverso.

Molti assistenti possono inserire punti facoltativi, una specie di segnalibro nel testo. Le voci del menu Modifica → Punti, o le scorciatoie da tastiera corrispondenti, permetteranno di saltare al punto successivo o al precedente. Ciò evidenzierà il punto, in modo che sia eliminato automaticamente quando inserisci la prima lettera.

Scrivere è ovviamente uno degli aspetti principali quando si usa un programma come Kile. Sebbene Kate abbia già grandi capacità, Kile aggiunge alcune importanti funzionalità, che sono particolarmente utili quando si scrive un sorgente L^AT_EX. L^AT_EX ha sempre bisogno di molti ambienti e gruppi, perciò Kile supporta comandi molto speciali per selezionarli. Sotto Modifica → Seleziona troverai i seguenti comandi per selezionare il testo.

testo \bfseries\itshape altro testo

Per eliminare alcune parti di un documento puoi, ovviamente, selezionarle e usare il tasto Canc. Kate ha anche il comando Ctrl+K, che cancella tutta la riga. Però Kile ha un modo più veloce con i suoi comandi di eliminazione. Sotto Modifica → Elimina troverai i seguenti comandi per eliminare il testo.

È già stato detto che gli ambienti sono un punto centrale di L^AT_EX. Perciò Kile offre altri cinque comandi per rendere il lavoro con L^AT_EX il più facile possibile nei sottomenu Modifica → Ambiente.

Kile offre anche alcuni comandi speciali per i gruppi L^AT_EX, che sono indicati dalle parentesi graffe {...}. Nel sottomenu Modifica → Gruppo TeX troverai alcuni comandi importanti, che corrispondono a quelli di Modifica → Ambiente.

In L^AT_EX, due virgolette singole vengono interpretate come virgolette doppie. Per aiutarti a inserirle efficientemente, Kile permette di premere " per inserire due virgolette singole di apertura. Inoltre, se vuoi chiudere una citazione, dovrai premere ". Kile sarà abbastanza intelligente da riconoscere questa situazione e inserire due virgolette di chiusura per L^AT_EX.

Per avere un carattere di virgolette doppie sull'altro lato, premi due volte ".

Puoi abilitare o disabilitare questo inserimento automatico dell'apertura e della chiusura delle virgolette doppie nella sezione Impostazioni → Configura Kile → LaTeX.

Se includi anche opzioni specifiche per la lingua come ngerman o french, potrai anche usare le virgolette doppie tedesche o francesi. Sono disponibili molte altre lingue.

Se premi Ctrl+Invio, Kile inserisce un ritorno a capo intelligente. Se la tua posizione attuale è in un ambiente a elenco come enumerate o itemize, Kile non solo inserirà un ritorno a capo, ma aggiungerà anche un comando \item.

Se sei all'interno di un ambiente tabulare, Kile finirà la riga attuale con \\, seguito da un ritorno a capo.

Se sei all'interno di un commento L^AT_EX, Kile comincerà la prossima riga con %.

Inoltre, Kile è abbastanza intelligente da supportare ambienti L^AT_EX predefiniti e definiti dall'utente, che possono essere aggiunti nella sezione Impostazioni → Configura Kile → LaTeX.

Alcuni utenti preferiscono ordinare le colonne degli ambienti tabulari e mettere tutti i caratteri ampersand & uno sotto l'altro. Kile prova ad aiutarli. Se premi Alt+Shift+&, Kile cercherà il prossimo tabulatore nella riga sopra. Sebbene possa non essere il tabulatore corrispondente, Kile aggiungerà dello spazio per regolare la posizione della colonna con il tabulatore attuale.

Quando scrivi alcune lettere, puoi attivare questa modalità di autocompletamento per i comandi L^AT_EX e le parole normali con Modifica → Completa → Comando (La)TeX o con la scorciatoia Ctrl+Shift+Spazio. Kile prima legge le lettere dalla posizione attuale del cursore a sinistra, e si ferma al primo carattere non letterale o sbarra inversa. Kile entrerà nella modalità di autocompletamento per i comandi T_EX o L^AT_EX. Altrimenti entra nella modalità di dizionario normale, dove non troverai nessun comando L^AT_EX. A seconda della modalità scelta, sarà aperto un riquadro di completamento. Vedrai tutti i comandi o parole il cui inizio coincide con lo schema selezionato. Puoi navigare l'elenco con i tasti cursore, e selezionare una voce con il tasto Invio o fare doppio clic con il mouse.

Quando premi il tasto Backspace, l'ultima lettera dello schema sarà eliminata, e l'elenco di completamento potrebbe aumentare. D'altro canto, se scrivi un'altra lettera, lo schema si allungherà e l'elenco potrebbe ridursi.

Se decidi di non selezionare nessuno dei suggerimenti, puoi abbandonare questa finestra premendo Esc.

Vedrai che tutti i comandi sono scritti con delle brevi descrizioni dei loro parametri. Queste descrizioni sono ovviamente rimosse quando selezioni un comando. A scelta puoi lasciare che Kile inserisce dei punti al loro posto, in modo da poter passare facilmente a queste posizioni con Modifica → Punti → Punto successivo e inserire il parametro che vuoi.

Vai a Impostazioni → Configura Kile → Kile+Completa per configurare uno o più di questi elenchi. Puoi scegliere diversi elenchi di comandi T_EX e L^AT_EX e diverse modalità dizionario per le parole normali.

Se scegli l'opzione Mostra comandi LaTeX, le voci di tutti i file di elenchi compressi di parole (Compressed Word Lists, o CWL) selezionati per il completamento dei comandi L^AT_EX vengono mostrate in una vista separata della barra laterale di Kile. Vedrai i comandi disponibili e quali parametri e opzioni devono o possono essere dati per un completamento. Puoi anche selezionare una voce con un clic del mouse e verrà inserita nel documento, dopo aver rimosso tutti i parametri e le opzioni con nome.

Siccome ogni elenco di parole sarà mostrato in una vista a parte, ce ne potrebbero essere troppe, al punto che la finestra principale di Kile potrebbe diventare troppo grande per un piccolo schermo. Visto che ciò non è pratico, Kile opera con un numero massimo di viste permesse, preimpostato a 10. Se questo valore è troppo elevato per il tuo schermo, riducilo.

La modalità comando non serve a completare gli ambienti. Devi sempre scrivere alcune lettere di \begin, e invocare la modalità di completamento risulterà in un grande elenco di tag di ambienti. D'altro canto, gli ambienti sono usati così spesso che Kile offre una modalità particolare di completamento degli ambienti. Lascia stare l'apertura e scrivi, per esempio, al.

Quando chiami la modalità di completamento con Modifica → Completa → Ambiente o la scorciatoia da tastiera Alt+Shift+Spazio, il tag di apertura viene inserito automaticamente, e vedrai \begin{al}. Dopo questa modifica, l'elenco di completamento è molto meno affollato.

Adesso seleziona un ambiente e vedrai che viene anche chiuso automaticamente. Inoltre, se Kile lo riconosce come ambiente elenco, inserirà anche un primo tag \item.

Vai a Impostazioni → Configura Kile → Kile+Completa per configurare uno o più di questi elenchi. Questa modalità usa gli stessi elenchi di parole della modalità di completamento dei comandi T_EX e L^AT_EX.

Kile supporta gli elenchi di abbreviazioni definite dagli utenti, che sono sostituite a richiesta da stringhe di testo più lunghe. Vedi Impostazioni → Configura Kile → Kile+Completa per configurare uno o più di questi elenchi. Nell'esempio qui riportato, deve essere scelto l'elenco di abbreviazioni example.cwl. In questo file troverai, per esempio, la voce L=\LaTeX.

Per esempio, scrivi solo la lettera L. Adesso chiama la modalità abbreviazione del completamento delle parole con Modifica → Completa → Abbreviazione, o la scorciatoia Ctrl+Alt+Spazio, e la lettera L verrà sostituita dalla stringa \LaTeX.

Il completamento delle abbreviazioni supporta anche il ritorno a capo %n e %C per posizionare il cursore, se questi caratteri sono presenti nel testo di espansione. Quindi se hai la voce:

en1=\begin{enumerate}%n\item %C%n\end{enumerate}%n

nel file di completamento, e usi il completamento delle abbreviazioni, l'espansione sarà come sotto, dove x indica la posizione finale del cursore.

\begin{enumerate}
        \item x
\end{enumerate}

L'ultima specifica del formato dei file di completamento può essere trovata nella specifica del formato CWL.

I file di completamento possono essere installati nella cartella Home di un utente nella cartella ~/.kde/share/apps/kile/complete/<modalità>/, dove <modalità> sta per abbreviation, dictionary o tex.

La finestra Includi grafica rende il più semplice possibile l'inserimento di elementi grafici. La puoi raggiungere dalla barra dei menu con LaTeX → Inserimento di immagini. Dài un'occhiata alFormati di file grafici e alGrafica EPS per avere una panoramica di alcuni concetti fondamentali sui formati grafici.

Uno dei lavori più noiosi che si possano fare in L^AT_EX è scrivere una matrice o un ambiente tabulare. 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 le voci del menu Assistente → Matrice e Assistente → Tabella di Kile. Apparirà quindi uno schema a forma di matrice che puoi facilmente riempire con delle voci. Questa finestra offre anche alcune opzioni per impostare il tipo di carattere degli elementi della tabella.

Usando la barra degli strumenti in cima alla finestra puoi impostare l'allineamento di una cella, definire lo stile del testo, unire e dividere le celle, scegliere un bordo, e specificare i colori di sfondo e del testo. In fondo a destra c'è un pulsante Incolla, con il quale puoi inserire una tabella dagli appunti; questo permette, per esempio, di copiare e incollare tabelle da un foglio di calcolo.

Sotto puoi scegliere quante righe e colonne vuoi, e puoi regolare altri dettagli della matrice:

L'opzione Assistente → Tabulazione farà apparire una finestra più semplice per configurare un ambiente di tabulazione. Permette di specificare facilmente il numero di righe e colonne e la spaziatura desiderata.

Kile aiuta a inserire gli elementi flottanti. Con l'assistente disponibile da Assistente → Flottanti è molto facile creare un nuovo ambiente per figure o tabelle.

Per inserire un nuovo ambiente flottante basta seguire questi passi:

Ricordarsi come funzionano tutti i vari ambienti matematici può essere una seccatura. Ovviamente Kile può aiutarti anche in questo: Assistente → Matematica.

Opzioni:

I file PS non sono popolari come i PDF, ma sono un ottimo punto di partenza per le manipolazioni e i riordinamenti delle pagine. Se vuoi un file PDF, puoi riordinare le pagine con dei programmi PostScript®, e poi convertire in PDF con ps2pdf.

L'Assistente PostScript® sotto Assistente → Strumenti PostScript suggerirà gli ordinamenti più comuni. Il lavoro viene fatto dai programmi pstops e psselect, che si trovano nella maggior parte delle distribuzioni nel pacchetto psutils. Se uno di questi programmi non è disponibile, l'elemento corrispondente non sarà visibile.

Per prima cosa scegli il file di ingresso. Se Kile trova un file PS corrispondente al documento principale attuale, questo verrà suggerito come file di ingresso, ma sei libero di sceglierne un altro. Quindi, scegli un file risultante e seleziona uno dei compiti. Infine devi decidere se vuoi solo la conversione o se vuoi anche chiamare Okular per visualizzare il risultato.

Molti pensano che i PDF siano file immutabili; esistono invece degli ottimi programmi per:

di un documento PDF.

L'Assistente PDF di Kile sotto Assistente → Strumenti PDF usa due diversi metodi per manipolare e ridisporre i documenti PDF:

Se uno di questi assistenti, pdfpages o pdftk, manca sul tuo sistema, i suoi elementi corrispondenti non saranno visibili. Inoltre, ricorda che solo pdftk può lavorare con i file cifrati.

Ridisposizioni

Quando viene chiamato l'assistente PDF di Kile, si avvia con la scheda di registrazione delle Ridisposizioni.

Per prima cosa scegli il file di ingresso. Se Kile trova un file PDF corrispondente al documento principale attuale, questo verrà suggerito come file di ingresso, ma sei libero di sceglierne un altro. Quindi, scegli un file risultante o di sovrascrivere il file esistente, e seleziona uno dei compiti. Infine devi decidere se vuoi solo la conversione o se vuoi anche chiamare il visore (per esempio Okular) per visualizzare il documento risultante.

Se il file PDF è cifrato, funzionerà solo pdftk, e devi dare la password del documento per eseguire i compiti.

1 pagina + pagina vuota → A4

Metti insieme una pagina con una pagina vuota su una pagina A4. Ogni volta che due pagine A5 sono messe insieme, sono ruotate di 90 gradi e posizionate orizzontalmente su una pagina A4.

Ogni volta che due pagine A4 sono messe insieme, sono riscalate, ruotate di 90 gradi e posizionate orizzontalmente su una pagina A4.

1 pagina + duplicato → A4

Metti insieme una pagina e una sua copia su una pagina A4.

Se la pagina da duplicare ha dimensioni A4, sarà riscalata per adattarsi alla pagina.

2 pagine → A4

Metti insieme due pagine consecutive su una pagina A4. Ogni volta che due pagine A5 sono messe insieme, sono ruotate di 90 gradi e posizionate orizzontalmente su una pagina A4.

Ogni volta che due pagine A4 sono messe insieme, sono riscalate, ruotate di 90 gradi e posizionate orizzontalmente su una pagina A4.

2 pagine (orizzontali) → A4

Metti insieme due pagine orizzontali consecutive su una pagina A4.

4 pagine → A4

Metti insieme quattro pagine consecutive su una pagina A4. Le pagine devono essere riscalate per adattarsi alla pagina.

4 pagine (orizzontali) → A4

Metti insieme quattro pagine orizzontali consecutive su una pagina A4. Le pagine devono essere riscalate per adattarsi alla pagina.

seleziona pagine pari

Seleziona tutte le pagine pari di un documento.

seleziona pagine dispari

Seleziona tutte le pagine dispari di un documento.

seleziona pagine pari (ordine inverso)

Seleziona tutte le pagine pari di un documento e invertine l'ordine.

seleziona pagine dispari (ordine inverso)

Seleziona tutte le pagine dispari di un documento e invertine l'ordine.

inverti tutte le pagine

Inverti tutte le pagine di un documento.

decifra un file

Se il PDF è cifrato, lo puoi decifrare.

seleziona pagine

Aggiungi un elenco separato da virgole delle pagine o dei loro intervalli, per esempio 1,4-7,9. Appariranno solo queste pagine nel file PDF prodotto.

elimina pagine

Aggiungi un elenco separato da virgole delle pagine o dei loro intervalli da rimuovere dal file PDF.

applica una filigrana di sfondo

Applica una filigrana PDF allo sfondo di un singolo PDF di ingresso. L'assistente usa solo la prima pagina dal PDF di sfondo e la applica a ogni pagina del PDF di ingresso. Questa pagina viene riscalata e ruotata come necessario per adattarsi alla pagina di ingresso.

applica un colore di sfondo

Applica un colore di sfondo a tutte le pagine del documento attuale. Si può fare una volta sola, perché il secondo colore sarà dietro al primo e quindi non sarà visibile.

applica un timbro in primo piano

Applica un timbro in primo piano sopra le pagine del documento PDF di ingresso. L'assistente usa solo la prima pagina del PDF del timbro e la applica a ogni pagina del PDF di ingresso. Questa pagina viene riscalata e ruotata come necessario per adattarsi alla pagina in ingresso. Funziona al meglio se la pagina del PDF timbro ha uno sfondo trasparente.

pdftk: scegli parametro

Puoi chiamare pdftk con un'opzione di tua scelta. Riferisciti al manuale per tutte le opzioni possibili.

pdfpages: scegli parametro

Puoi chiamare pdfpages con un'opzione di tua scelta. Riferisciti al manuale per tutte le opzioni possibili.

Proprietà

L'impostazione, la modifica e la rimozione delle proprietà saranno possibili solo se pdftk è installato e se inoltre Kile è stato compilato con la libreria libpoppler.

I metadati tradizionali dei PDF includono il titolo, l'autore, l'oggetto, le parole chiave, il creatore, il produttore e le date di creazione e ultima modifica del documento.

Permessi

Inoltre, l'impostazione, la modifica e la rimozione dei permessi saranno possibili solo se pdftk è installato.

È necessaria una password per impostare o cambiare queste impostazioni del documento. La cifratura PDF è effettuata per bloccare i contenuti del file dietro a questa password, o per imporre certe restrizioni decise dall'autore. L'autore può permettere o proibire:

• la stampa delle pagine

• la modifica delle pagine

• la copia del testo e della grafica dalle pagine

• la modifica o l'aggiunta di annotazioni

• la compilazione dei moduli con dati.

La modifica dei permessi impone sempre la cifratura associata alla sicurezza a 128 bit di Acrobat 5 e 6, e richiede anch'essa una password.

Tieni sempre presente: la cifratura e una password non danno nessuna reale sicurezza per il file PDF. Il contenuto è cifrato, ma la chiave è nota. Dovresti considerarla come una richiesta, cortese ma decisa, di rispettare i desideri dell'autore.

La finestra delle statistiche sotto File → Statistiche presenta una panoramica statistica di una selezione, un documento o un intero progetto. Include il numero di parole, comandi e ambienti L^AT_EX, e anche il numero di caratteri di ciascun tipo.

Le statistiche ottenute possono essere copiate negli appunti come testo o come una tabella L^AT_EX ben formattata.

Quando selezioni del testo e apri la finestra delle statistiche, ottieni le statistiche del testo attualmente selezionato. Se apri la finestra senza aver selezionato del testo, vengono mostrate le statistiche di tutti i file aperti. Se vuoi le statistiche di tutto il progetto, puoi usare Progetto → Apri tutti i file del progetto per aprire facilmente tutti i file sorgente del progetto.

Si deve fare attenzione all'accuratezza dei numeri. Abbiamo incluso della logica per avere una buona stima, per esempio K\"uhler risulta in una parola e un comando con rispettivamente sei e due caratteri. Però ci sono altre combinazioni in cui parte dei comandi viene contata come parola e viceversa. Nota che l'algoritmo è stato sviluppato e provato per le lingue simili all'inglese o al tedesco, quindi non considerare i numeri perfetti. Se devi scrivere un rapporto la cui lunghezza deve avere un certo numero di parole o caratteri, fai prima delle prove per verificare se l'accuratezza di Kile è adatta a te.

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

L'[etichetta] facoltativa 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], eccetera.

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 del riferimento. 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 bibliografia.

La bibliografia è una sezione separata dal 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 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 molti riferimenti, Kile dà un modo semplice per inserire una citazione. Usando LaTeX → Riferimenti → Cita appare un elenco con tutte le citazioni. Seleziona il riferimento giusto, e una citazione sarà inserita nel documento. Per aggiornare la lista delle chiavi, salva il file, o seleziona Modifica → Aggiorna Struttura, o premi F12. Quando il completamento del codice è abilitato, Kile mostrerà un elenco delle etichette bibitem non appena apri un comando \cite.

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

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

Kile può anche lavorare assieme a editor di file BibT_EX, come KBibT_EX, per facilitare l'inserimento di citazioni. Quando si aggiunge un file BibT_EX al progetto, Kile aiuterà a completare i comandi di citazione, come descritto sopra.

Puoi creare nuovi menu o cambiare gli attuali con un comodo assistente di configurazione dei menu dell'utente, accessibile da Assistente → Modifica il menu dell'utente.

Sul lato sinistro vedrai l'albero del menu attuale. Come per un normale menu, sono disponibili tre tipi di elementi:

Per modificare questo menu, usa i sei pulsanti sul lato sinistro. Altre azioni sono disponibili nel menu contestuale degli elementi preesistenti.

Ogni elemento normale del menu è assegnato a uno tra tre tipi di azione, dove ognuno ha diversi attributi impostabili:

Se mancano delle informazioni importanti per un'azione, gli elementi del menu sono colorati in rosso. Questo potrebbe indicare un file mancante.

o un titolo mancante per una voce del menu, che verrà mostrata con dei punti interrogativi, come ???.

Se apri il menu contestuale di un elemento così colorato in rosso, otterrai un'opzione aggiuntiva riguardo a questo errore.

Maggiori informazioni potrebbero essere disponibili con la funzionalità Che cos'è? della maggior parte degli oggetti.

La maggior parte delle voci dei menu hanno altri parametri che si spiegano da sé che possono essere selezionati. Se alcuni di questi parametri non sono disponibili per qualche tipo di azione, vengono disabilitati.

Ecco un esempio di esecuzione di un programma esterno:

Puoi vedere che viene richiamato uno script Perl, che dovrebbe lavorare con la selezione attuale. Il parametro È necessario avere selezionato del testo è spuntato per assicurare la presenza di una selezione. Il risultato di questo script verrà inserito (Inserisci il risultato del programma scelto) e sostituirà la selezione attuale (Sostituisci il testo selezionato, ma non verrà selezionato.

Naturalmente puoi anche chiamare il tuo programma o il tuo script. Per esempio, seleziona una lista di numeri separati da spazi, e chiama uno script o un programma in Perl che trasformi questa selezione in un codice L^AT_EX per una matrice. Qualunque possano essere le tue idee, puoi realizzarle utilizzando la seguente voce di menu dell'utente.

Puoi installare diversi menu durante l'esecuzione per diversi compiti. Quando richiami l'assistente dei menu dell'utente, viene caricato l'attuale file di definizione dei menu. Se lo modifichi e chiudi la finestra con OK, le tue modifiche verranno salvate e installate come il nuovo menu dell'utente. Chiudere la finestra con Annulla scarterà le modifiche.

Sei anche libero di salvare il file modificato nella cartella dei menu dell'utente o caricare un altro file di definizione dei menu e installarlo. Tutti i file di definizione dei menu dell'utente vanno salvati nella cartella locale dei menu dell'utente di Kile: KILE_APP_DIR/usermenu/.

Guarda il file di definizione dei menu d'esempio example.xml per vedere altre voci del menu coi loro parametri.

Lavorando con L^AT_EX, servirà sempre un po' di tempo per vedere il risultato. L^AT_EX deve compilare il sorgente, e deve essere avviato il visore. Ciò potrebbe essere fastidioso se hai solo cambiato qualche lettera in un'equazione difficile da scrivere. Kile offre una modalità di Anteprima rapida, dove puoi compilare solo parte del documento e risparmiare molto tempo. Supporta quattro diverse modalità, che possono essere combinate con sette configurazioni.

Tutte le impostazioni devono essere fatte in Impostazioni → Configura Kile → Strumenti+Anteprima.

I file grafici EPS sono il modo tradizionale di inserire i file grafici nei documenti L^AT_EX. Siccome le mailing list sono piene di domande sulla grafica EPS, discuteremo alcuni aspetti importanti e dimostreremo come Kile li supporta.

\DeclareGraphicsRule{.pz}{eps}{.bb}{}%
   \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}%
   \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}%
   \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}%
   \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{}%

\DeclareGraphicsRule{.pz}{eps}{.bb}{}%
   \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}%
   \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}%
   \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}%
   % regole cambiate o nuove
   \DeclareGraphicsRule{.eps.zip}{eps}{.eps.bb}{`unzip -p #1}%   EPS zip
   \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1}%   EPS gzip
   \DeclareGraphicsRule{.jpg}{eps}{}{`convert #1 eps:-}%         JPEG
   \DeclareGraphicsRule{.gif}{eps}{.bb}{`convert #1 eps:-}%      GIF
   \DeclareGraphicsRule{.png}{eps}{.bb}{`convert #1 eps:-}%      PNG
   \DeclareGraphicsRule{.tif}{eps}{.bb}{`convert #1 eps:-}%      TIFF
   \DeclareGraphicsRule{.pdf}{eps}{.bb}{`convert #1 eps:-}%      grafica PDF

\usepackage[pdftex]{graphicx}
   \usepackage{epstopdf}

% pdfTeX is running in pdf mode
   \ExecuteOptions{pdftex}%

% pdfTeX is running in pdf mode
   \ExecuteOptions{pdftex}%
   \AtEndOfPackage{%
      \g@addto@macro\Gin@extensions{.eps.gz,.eps.zip}%
      \@namedef{Gin@rule@.eps.gz}#1{{pdf}{.pdf}{`gunzip -c #1 | epstopdf -f 
>\Gin@base.pdf}}%
      \@namedef{Gin@rule@.eps.zip}#1{{pdf}{.pdf}{`unzip -p #1 | epstopdf -f 
>\Gin@base.pdf}}%
   }%

Definire il documento come principale 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 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.

Dopo aver compilato qualcosa, Kile dà un'occhiata ai messaggi d'errore che sono stati generati. Se ci sono errori o avvertimenti, saranno riportati brevemente nella finestra Registro e messaggi. Si può dare un'occhiata ai messaggi più da vicino selezionando Costruzione → Visualizza registro, o usando la scorciatoia da tastiera Alt+0. Il registro generato è quindi mostrato nella vista Registro e messaggi; gli errori e gli avvertimenti sono evidenziati.

Visualizzazione del registro

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

Per saltare alla riga del codice L^AT_EX dove è avvenuto l'errore o l'avvertimento, fai clic sull'errore o avvertimento nella vista Registro e messaggi. Kile ti porterà automaticamente alla riga incriminata.

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

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

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

I segnalibri sono riferimenti 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 documento alla quale vorresti tornare, quindi premi Ctrl+B, e Kile ci aggiungerà un segnalibro. Alternativamente, puoi anche impostare un segnalibro evidenziando la riga alla quale vorresti tornare, e scegliere il menu chiamato Segnalibri → Imposta segnalibro.

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

Per creare un progetto, seleziona Progetto → Nuovo progetto.

Saranno chieste le seguenti informazioni per creare il progetto:

La vista File e progetti è un pulsante della barra laterale. Da questa vista, puoi vedere la struttura del 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 progetto si fanno attraverso la vista File e progetti.

La vista File e progetti

Per aggiungere un file al progetto, apri un qualsiasi file T_EX, fai clic destro sul suo nome nella vista File e progetti, e seleziona Aggiungi al progetto. Se hai aperto più progetti, apparirà una finestra in cui puoi specificare a quale progetto aggiungerlo.

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

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 file (e nemmeno lo chiude), ma lo rimuove soltanto dalla lista dei file contenuta nel file con estensione .kilepr.