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 codice sorgente per visori come o conversioni successive, puoi usare la scorciatoia 2. Poi puoi visualizzare il file con il visore predefinito con 3, convertire il in un file PS con 4, e visualizzare il file PS con 5.

BibTEX
Se usi BibTEX per le voci bibliografiche, normalmente devi seguire uno schema di compilazione speciale. Ciò vuol dire chiamare LATEX e poi BibTEX e poi di nuovo LATEX. Fortunatamente Kile è abbastanza intelligente da rilevare da solo se è necessario chiamare strumenti aggiuntivi come BibTEX, makeidx e Asymptote. Questa logica è attivata come impostazione predefinita, ma ciò può essere cambiato a Impostazioni Configura Kile Strumenti Costruzione nella scheda Generale negli strumenti LATEX e PDFLATEX.

MetaPost e Asymptote
Se vuoi compilare il documento con MetaPost o Asymptote, dei programmi di disegno, puoi farlo con Costruzione Compila Metapost, o Costruzione Compila Asymptote.

PDFLATEX
C'è anche un altro modo per compilare il documento, se vuoi un PDF: puoi eseguire PDFLATEX, che compilerà il sorgente direttamente in un file PDF, con 6: puoi quindi visualizzare il file premendo 7.
Alternativamente, puoi convertire un PS in un PDF con 8, o direttamente un in un PDF con 9.
Usare PDFLATEX invece di LATEX può essere solo una questione di semplicità o d'abitudine, ma a volte il comportamento dei due programmi può differire.

Da LATEX a Web
Infine, potresti voler pubblicare il 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 Web 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 da riga di comando
Se vuoi passare alcuni parametri da riga di comando specifici agli strumenti di compilazione, conversione e visualizzazione, puoi configurarne la chiamata in Impostazioni Configura Kile Strumenti Costruzione.

Anteprima veloce
Lavorando con LATEX, servirà sempre un po' di tempo per vedere il risultato. LATEX 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.
Anteprima rapida
Anteprima rapida
Tutte le impostazioni devono essere fatte in Impostazioni Configura Kile Strumenti Anteprima.
Configurazione dell'anteprima rapida
Configurazione dell'anteprima rapida

Modalità di selezione
L'utente deve selezionare una parte del documento. La voce del menu Costruzione Anteprima rapida Selezione o la scorciatoia da tastiera P,S avvierà i programmi selezionati. Kile prende il preambolo del testo originale, in modo che tutti i pacchetti e i comandi definiti dall'utente siano inclusi. L'utente può scegliere una configurazione tra otto predefinite:
LaTeX+ (visore incorporato)
LaTeX+ ()
LaTeX+PS (visore incorporato)
LaTeX+PS ()
PDFLaTeX+PDF (visore incorporato)
PDFLaTeX+PDF ()
XeLaTeX+PDF (visore incorporato)
XeLaTeX+PDF ()
Ciò dovrebbe bastare per tutte le situazioni per cui ci sia bisogno di una anteprima rapida.

Modalità ambientale
Molto spesso vorresti avere un'anteprima dell'ambiente attuale, e in particolare gli ambienti matematici, che a volte sono difficili da scrivere. Kile offre un modo molto veloce di farlo. Non c'è bisogno di selezionare, basta scegliere Costruzione Anteprima rapida Ambiente o la scorciatoia da tastiera P,E, e l'ambiente attuale sarà compilato e visualizzato.

Modalità sottodocumento
Se hai dei progetti con molti documenti, compilare tutto il progetto non è una buona idea, se hai fatto cambiamenti in un documento solo. Kile può compilare e mostrare un'anteprima del sottodocumento attuale. Prende il preambolo del documento principale e compila solo la parte attuale quando selezioni Costruzione Anteprima rapida Sottodocumento o la scorciatoia da tastiera P,D.

Modalità gruppo matematico
La modalità di anteprima del gruppo matematico permette di vedere il gruppo matematico che stai attualmente modificando. Kile prende il preambolo del documento principale e compila solo il gruppo matematico in cui il cursore si trova quando scegli Costruzione Anteprima rapida Gruppo matematico o la scorciatoia da tastiera P, M.

Anteprima rapida nella barra in basso
Invece di mostrare l'anteprima in un nuovo documento, Kile può anche essere configurato per usare la barra in basso per fare un'anteprima delle compilazioni. Puoi attivare questa funzionalità nel pannello di configurazione dell'anteprima rapida.

Formati di file grafici

LATEX e PDFLATEX
PDFLATEX, quando usato con i pacchetti graphics o graphicx, può compilare correttamente i file PNG e JPG nei e PDF, ma non è in grado di gestire i file EPS. Di converso, il processo di compilazione LATEX in e conversione a PS e infine PDF supporta EPS, ma non supporta PNG e JPG.
Molti utenti vogliono creare dei documenti PDF, ma vogliono anche usare l'ottimo pacchetto Pstricks per creare grafica , o vogliono usare i grafici prodotti da programmi matematici e scientifici come Mathematica, Maple o MuPAD. Questi utenti di LATEX devono prima compilare in , anche se vogliono creare documenti PDF, perché questi programmi producono del codice che non può essere gestito da PDFLATEX. Però non è così difficile, perché Kile può aiutare.

Conversione della grafica
Per superare questa impasse, quando vuoi includere sia codice che file PNG o JPG, hai a disposizione una serie di soluzioni:
Se hai bisogno di un file in formato PS, ma hai file grafici JPG o PNG, puoi semplicemente prima produrre un con PDFLATEX, e poi usare dvips per creare il file PS. PDFLATEX è un'ottima scelta, se il sorgente non contiene nessun codice .
Puoi convertire i file EPS a PNG o altri formati con applicazioni come Gimp o ImageMagick, e quindi usare PDFLATEX.
Un modo preferibile è convertire la grafica EPS in PDF con il comando epstopdf, presente in ogni distribuzione di TEX, e quindi usare PDFLATEX. Produce grafica di alta qualità, e puoi anche controllarne il risultato con alcune delle seguenti opzioni:

-dAutoFilterColorImages=false
        -dAutoFilterGrayImages=false
        -sColorImageFilter=FlateEncode
        -sGrayImageFilter=FlateEncode
        -dPDFSETTINGS=/prepress
        -dUseFlateCompression=true

Ancora meglio, se il sistema permette shell-escape, la conversione può essere fatta al volo. Tutto quello che devi fare è includere il pacchetto epstopdf, che fa parte delle distribuzioni TEX, con il comando \usepackage{epsdopdf}. Supponendo che il codice sia

        \includegraphics[width=5cm]{prova.eps}

Quando chiami PDFLATEX con l'opzione --shell-escape, il file grafico prova.eps viene convertito automaticamente in prova.pdf.
Questa conversione avverrà ogni volta che esegui PDFLATEX. Se il comando grafico viene dato implicitamente con:

        \includegraphics[width=5cm]{test}

epstopdf controllerà se c'è già un prova.pdf disponibile, in modo da poter saltare la conversione.
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 ricostruire l'immagine JPG con vettori e vari script, che risulterà in file giganteschi. La conversione di tutti i file grafici in EPS può essere fatta con ImageMagick. Un altro semplice programma che fa correttamente questo processo è jpg2ps.
Puoi anche usare una conversione automatica. Tutti i file grafici sono convertiti al volo in EPS, e inseriti nel documento PS. Questa è una modalità comoda, ma devi impostare correttamente il sistema. Ciò viene discusso nella sezione sulla grafica EPS.

Usa il formato giusto per la grafica giusta
EPS è una specie di linguaggio vettoriale, che descrive tutte le linee e punti di cui l'immagine è composta; 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 ) è 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.

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

LATEX e la grafica EPS
Se hai deciso di usare il classico LATEX per produrre file PS o PDF, probabilmente incorrerai in alcuni problemi con la grafica. Devi usare la grafica EPS (Encapsulated ), senza file JPEG o PNG. Non dovrebbe essere un problema, perché ci sono molti convertitori come convert dell'eccellente pacchetto ImageMagick. Però ci vuole un po' di tempo.
I file EPS vengono usati sia da LATEX che dai convertitori -PS:
LATEX scansiona il file EPS per trovare la linea del riquadro di delimitazione, che dice a LATEX quanto spazio riservare per la grafica.
Il convertitore -PS legge il file EPS e inserisce la grafica nel file PS.
Ciò comporta alcune conseguenze:
LATEX non legge mai il file EPS se i parametri del riquadro di delimitazione sono specificati nel comando di inserimento della grafica.
Siccome LATEX non può leggere file non ASCII, non può leggere le informazioni sul riquadro di delimitazione da file di grafica compressi o non EPS.
La grafica EPS non viene inclusa nel file . Siccome i file EPS devono essere presenti nella conversione del file in PS, i file EPS devono accompagnare i file ovunque.
Ora puoi chiamare LATEX e un convertitore -PS come dvips per creare il documento . Se l'obbiettivo è un documento PDF, dovresti eseguire dvips con l'opzione -Ppdf, e quindi chiamare ps2pdf. Troverai molti documenti che descrivono questo soluzione.

L'approccio a di Kile
Kile aiuta a ottenere le informazioni sul riquadro di delimitazione. Se hai installato il pacchetto ImageMagick, Kile estrarrà queste informazioni dal file EPS e le inserirà come opzioni. Ciò viene fatto automaticamente, quando selezioni il file di grafica. Ci sono due vantaggi in questa procedura:
L'informazione viene scansionata nella finestra, e non deve essere fatta da LATEX in seguito.
È ancora più importante che saranno calcolate la larghezza e l'altezza dell'immagine, quando ne sarà nota la risoluzione. Queste informazioni saranno mostrate in alto nella finestra, e potranno servire da suggerimento quando vorrai riscalare la grafica.
Kile può anche supportare i file EPS compressi con zip o gzip, che sono molto più piccoli dei file EPS non compressi. Però questa funzionalità può essere usata solo con una particolare configurazione di sistema, come descritto nella sezione sulla grafica bitmap.

L'approccio a e la grafica bitmap
Se il sistema permette shell-escape, Kile supporta anche un modo semplice di includere la grafica bitmap, se hai impostato correttamente il sistema TEX. Non è necessario convertire la grafica JPEG o PNG, si può fare automaticamente quando il file viene convertito in PS.
LATEX ha bisogno di alcune informazioni sui suffissi dei file. Il pacchetto graphicx cerca un file graphics.cfg, che deve essere da qualche parte nel percorso di ricerca per i documenti LATEX. Cerca voci come:

\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}{}%

e sostituisci queste righe con:

\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

Potrai trovare questo file, per esempio in Debian, in /etc/texmf/latex/graphics.cfg. Il modo migliore di procedere è copiare questo file nel percorso TEX locale, e poi cambiare la copia. Vedi il manuale della distribuzione di TEX per sapere come ottenere un elenco delle cartelle di TEX.
Con questo file di configurazione puoi inserire grafica bitmap e file EPS compressi con zip o gzip in LATEX. Il comando per la conversione è dato da dvips. Quando guardi al comando di conversione vedrai che non viene creato nessun file aggiuntivo. Il risultato di questo processo di conversione viene incanalato direttamente nel file PS. L'unica cosa che LATEX deve sapere è la dimensione della grafica, e quindi abbiamo bisogno del riquadro di delimitazione, che viene fornito da Kile.
Alcuni dicono che questo modo non è sicuro, devi decidere tu in che modo lavorare. In ogni caso non hai bisogno di un riquadro di delimitazione, perché Kile estrarrà questa informazione da tutti i tipi di grafica.

PDFLATEX e la grafica EPS
Come già notato, PDFLATEX non è in grado di gestire i file di grafica EPS, ma i convertitori come epstopdf saranno d'aiuto. Il modo migliore è includere il pacchetto epstopdf, che deve seguire il pacchetto graphicx.

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

Adesso puoi già includere la grafica EPS, se esegui pdflatex con l'opzione --shell-escape, ma possiamo ancora migliorare le cose e gestire anche i file EPS compressi con zip o gzip. Di nuovo, dobbiamo cambiare il file di configurazione grafica graphics.cfg, come sopra. Questa volta cerchiamo:

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

e aggiungiamo alcune righe:

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

Con queste righe, PDFLATEX è in grado di gestire i file EPS, e ciò dovrebbe risolvere tutte le questioni di grafica.

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

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 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 0. Il registro generato è quindi mostrato nella vista Registro e messaggi; gli errori e gli avvertimenti sono evidenziati.
Visualizzazione del registro
Visualizzazione del registro
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 LATEX 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.

La modalità Sorveglia file
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.