Les eines de construcció

Compilar, convertir i visualitzar
Per a veure el resultat del vostre treball, primer haureu de compilar el codi font. Totes les eines de construcció s'agrupen en els menús Construeix Compila, Construeix Converteix, i Construeix Visualitza.
Per compilar el vostre codi font per als visors en pantalla com l' o d'altres, podeu utilitzar la drecera 2. Després podeu visualitzar el fitxer utilitzant el vostre visor predeterminat amb 3, convertir el a un fitxer PS amb 4, i visualitzar el fitxer PS amb 5.

BibTEX
Si utilitzeu BibTEX per a les vostres entrades bibliogràfiques, en general haureu de seguir un esquema de compilació especial. Això implica cridar a LATEX, després a BibTEX i després a LATEX una altra vegada. Afortunadament el Kile és prou intel·ligent per a detectar automàticament si cal cridar a eines addicionals com BibTEX, makeidx i Asymptote. Aquesta lògica s'activa per omissió i es pot canviar a Arranjament Configura el Kile... Eines Construeix a la pestanya General de les eines LATEX i PDFLATEX.

MetaPost i Asymptote
Si voleu compilar el vostre document amb MetaPost o Asymptote -els programes de dibuix d'imatges-, podeu fer-ho amb Construeix Compila Metapost o Construeix Compila Asymptote.

PDFLATEX
També hi ha una altra manera de compilar el vostre document, si voleu un PDF: podeu executar el PDFLATEX, que compilarà la font directament a un fitxer PDF, amb 6: podreu visualitzar el fitxer compilat prement 7.
De manera alternativa, podeu convertir un PS a un PDF amb 8, o directament un a un PDF amb 9.
Utilitzant el PDFLATEX en lloc de LATEX es pot deure a una qüestió de simplicitat o de costum, però de vegades el comportament dels dos programes pot ser diferent.

LATEX per a la web
Finalment, possiblement voldreu publicar el vostre treball a la web i no sols en paper. A continuació, podreu utilitzar el programa latex2html, que es pot cridar des del menú del Kile Construeix Converteix LaTeX a la web. El resultat serà col·locat en una subcarpeta de la carpeta de treball, i sereu capaç de veure el resultat de la conversió escollint l'element de menú Construeix Visualitza View.

Passar paràmetres a la línia d'ordres
Per passar alguns paràmetres específics de línia d'ordres a les eines de compilació, conversió o visualització, podeu configurar la seva crida a Arranjament Configura el Kile... Eines Construeix.

Vista prèvia ràpida
Quan treballeu amb LATEX sempre necessitareu algun temps per a veure el resultat. LATEX ha de compilar el codi font i cridar al visor. Això pot ser molest si sols es canvien algunes lletres en una equació difícil de compondre. El Kile ofereix una manera Vista prèvia ràpida, on podreu compilar sols una part d'un document i estalviat molt de temps. És compatible amb quatre modes diferents, que es poden combinar amb set configuracions.
Vista prèvia ràpida
Vista prèvia ràpida
Tots els ajustaments s'han de fer a Arranjament Configura el Kile... Eines Vista prèvia.
Configuració de la vista prèvia ràpida
Configuració de la vista prèvia ràpida

Mode de selecció
L'usuari ha de seleccionar una part del document. L'entrada de menú Construeix Vista prèvia ràpida Selecció o la drecera de teclat P,S iniciaran els programes seleccionats. El Kile prendrà el preàmbul del text original, de manera que s'incloguin tots els paquets i ordres definits per l'usuari. L'usuari pot triar una de les vuit configuracions predefinides:
LaTeX+ (visor incrustat)
LaTeX+ ()
LaTeX+PS (visor incrustat)
LaTeX+PS ()
PDFLaTeX+PDF (visor incrustat)
PDFLaTeX+PDF ()
XeLaTeX+PDF (visor incrustat)
XeLaTeX+PDF ()
Això hauria de ser suficient per a totes les situacions per a les quals es requereixi una vista prèvia ràpida.

Mode entorn
Molt sovint voleu previsualitzar l'entorn actual, i especialment els entorns matemàtics, que de vegades poden ser difícils d'escriure. El Kile ofereix una manera molt ràpida de fer això. La selecció no és necessària, simplement seleccioneu Construcció Vista prèvia ràpida Entorn o la drecera de teclat P, E i es compilarà i mostrarà l'entorn actual.

Mode subdocument
Si teniu un projecte gran amb un munt de documents, compilar tot el projecte no serà una gran idea, si heu realitzat canvis sols en un únic document. El Kile és capaç de compilar i mostrar una vista prèvia del subdocument actual. Pren el preàmbul del document mestre i sols compilarà la part actual quan escolliu Construeix Vista prèvia ràpida Subdocument o la drecera de teclat P,D.

Mode grup matemàtic
El mode de vista prèvia del grup matemàtic permet la vista prèvia del grup matemàtic que esteu editant. El Kile pren el preàmbul del document mestre i sols compilarà el grup matemàtic on es trobi el cursor quan escolliu Construeix Vista prèvia ràpida Grup matemàtic o la drecera de teclat P,M.

Vista prèvia ràpida en la barra inferior
En lloc de mostrar la vista prèvia d'un document nou, també es pot configurar el Kile per utilitzar la barra inferior per a les compilacions de vista prèvia. Podeu activar aquesta característica en el plafó de configuració de la vista prèvia ràpida.

Formats de fitxers gràfics

LATEX i PDFLATEX
El PDFLATEX, quan s'utilitza amb els paquets graphics o graphicx, pot compilar correctament fitxers PNG i JPG en un o PDF, però no és capaç de manejar fitxers EPS. Per contra, el procés de compilació de LATEX a i conversió a PS i potser a PDF sí que suporta EPS, però no suporta PNG i JPG.
Molts usuaris volen crear documents PDF, però també volen utilitzar l'excel·lent paquet Pstricks per a crear gràfics , o volen utilitzar la sortida de programari matemàtic i científic com Mathematica, Maple o MuPAD. Aquests usuaris de LATEX primer han de compilar en , encara que vulguin crear documents PDF, ja que aquests programes generen codi , el qual no pot ser manejat pel PDFLATEX. Tanmateix, no és tan difícil com pot semblar, ja que el Kile us ajudarà.

Conversió de gràfics
Per a superar aquest frustrant bucle, quan vulgueu incloure tant codi com fitxers PNG o JPG, disposareu d'un nombre de solucions:
Si necessiteu un fitxer en format PS, però té gràfics JPG o PNG, també podeu simplement utilitzar el PDFLATEX amb sortida primer, i després executar dvips per a crear el fitxer PS. Podeu veure que el PDFLATEX és una molt bona opció, si la vostra font no conté codi .
Podeu convertir el fitxer EPS a PNG o altres formats amb utilitats com el Gimp o ImageMagick i utilitzar el PDFLATEX.
Una manera preferida és la de convertir els gràfics EPS a PDF amb epstopdf, el qual ve amb totes les distribucions de TEX i aleshores utilitzar el PDFLATEX. Aquest produeix gràfics d'alta qualitat, fins i tot podeu controlar el resultat amb alguna de les següents opcions:

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

Millor encara: si el vostre sistema permet shell-escape, la conversió es pot fer sobre la marxa. Tot el que heu de fer és incloure el paquet epstopdf, el qual forma part de totes les distribucions de TEX, amb l'ordre \usepackage{epstopdf}. Assumint que el codi és

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

On podreu cridar al PDFLATEX amb l'opció --shell-escape, el gràfic prova.eps es convertirà automàticament en prova.pdf.
Aquesta conversió es durà a terme cada vegada que executeu el PDFLATEX. Si doneu de forma implícita l'ordre de gràfics

        \includegraphics[width=5cm]{prova}

epstopdf comprovarà si ja està disponible prova.pdf, per a saltar el pas de la conversió.
Podeu convertir en l'altre sentit, i utilitzar LATEX i la conversió PS-PDF. Això no sempre és una bona idea, ja que l'encapsulació EPS de JPG o PNG pot produir fitxers més grans, que al seu torn produeixen documents innecessàriament grans. Tot i que això depèn en gran mesura de la utilitat gràfica que utilitzeu, ja que EPS pot encapsular altres gràfics, però no totes les aplicacions ho implementen correctament. Algunes podrien intentar construir la vostra imatge JPG amb vectors i els diversos scripts creats, el qual resultarà en fitxers gegantins. La conversió de tots els formats gràfics a EPS la podeu fer amb ImageMagick. Un altre programa senzill que fa aquest procés correctament és jpg2ps.
També podeu utilitzar una conversió automàtica. Tots els fitxers gràfics seran convertits a l'instant a EPS, i s'inseriran al document PS. Aquesta és una forma còmoda, però haureu de configurar el sistema correctament. Això es discuteix a la secció Gràfics EPS.

Utilitzar el fitxer adequat per a cada gràfic
EPS és un tipus de llenguatge per a la creació de scripts de vectors gràfics, que descriu totes les línies i punts que conformen el gràfic. Es veu bé fins i tot quan s'augmenta més enllà de la seva mida per omissió, i concorda millor amb diagrames i gràfics vectorials produïts de forma nativa en PS, els quals es veuen molt nets i clars mantenint una mida molt petita de bytes.
PNG (o el en desús) és un format de fitxer sense pèrdua, amb una bona compressió i qualitat. És molt bo per als diagrames, escanejats de dibuixos, o qualsevol cosa de la que vulgueu conservar la nitidesa. De vegades no funciona bé quan s'utilitza per a fotografies.
JPG és un format amb pèrdua, que comprimeix millor els fitxers PNG a costa d'alguna pèrdua en el detall de la imatge. Això sol ser irrellevant per a les fotografies, però pot causar una mala qualitat per als diagrames, dibuixos, i pot fer que desapareguin algunes línies fines. En aquests casos utilitzeu EPS o PNG.
Però recordeu sempre: si entreu brossa, traureu brossa! Cap conversió farà bona una mala imatge.

Gràfics EPS
Els fitxers gràfics EPS són la forma tradicional d'inserir fitxers gràfics en documents LATEX Com les llistes de correu són plenes de preguntes sobre gràfics EPS, debatrem sobre alguns aspectes importants i demostrarem com els implementa el Kile.

LATEX i els gràfics EPS
Si decidiu utilitzar el LATEX tradicional per presentar una sortida PS o PDF, probablement us trobareu amb alguns problemes amb els gràfics. Haureu d'utilitzar gràfics EPS ( encapsulat). No fitxers JPEG o PNG. Això no hauria de ser un problema, ja que hi ha una gran quantitat de convertidors com convert de l'excel·lent paquet ImageMagick. Però, per descomptat, això porta el seu temps.
Els fitxers EPS són utilitzats tant per LATEX com pel convertidor -PS:
LATEX escaneja el fitxer EPS per a determinar la línia del contenidor, el qual indicarà a LATEX quant espai reservar per als gràfics.
El convertidor -PS llegirà a continuació el fitxer EPS i inserirà el gràfic al fitxer PS.
Això té algunes implicacions:
LATEX mai llegirà el fitxer EPS si s'han especificat els paràmetres relatius al contenidor en l'ordre d'inserció dels gràfics.
Com LATEX no pot llegir els fitxers que no són ASCII, no podrà llegir la informació sobre el contenidor a partir de fitxers comprimits o gràfics no EPS.
Els gràfics EPS no seran inclosos en el fitxer . Atès que els fitxers EPS han d'estar presents quan el fitxer es converteix a PS, els fitxers EPS s'han d'acompanyar dels fitxers cada vegada que es mouen.
Ara podreu cridar a LATEX, i un convertidor -PS com dvips per crear el vostre document . Si el vostre objectiu és un document PDF, l'haureu d'executar amb l'opció -Ppdf i després cridar a ps2pdf. Vostè trobarà una gran quantitat de documents que descriuen aquesta solució.

La manera del Kile
El Kile us ajudarà a obtenir la informació sobre el contenidor. Si teniu instal·lat el paquet ImageMagick, el Kile extraurà aquesta informació del fitxer EPS i la inserirà com una opció. Això es fa automàticament quan seleccioneu el fitxer de gràfics. Hi ha dos avantatges per a procedir d'aquesta manera:
La informació apareixerà en el diàleg, i no l'haurà d'obtenir LATEX.
Encara més important és que quan es coneix la seva resolució es poden calcular l'amplada i l'alçada de la imatge. Aquesta informació apareixerà a la part superior del diàleg, i pot servir com una pista quan es volen escalar els gràfics.
El Kile també suporta fitxers EPS comprimits amb GZIP, que són molt més petits que els fitxers EPS sense comprimir. Tanmateix, aquesta característica sols es pot utilitzar amb una configuració especial del sistema i un canvi de la configuració gràfica local, com es descriu a la secció Gràfics de mapa de bits.

La manera i els gràfics de mapa de bits
Si el vostre sistema permet shell-escape, el Kile també implementa una manera fàcil d'incloure gràfics de mapes de bits, si configureu el sistema de TEX correctament. No hi ha necessitat de convertir gràfics JPEG o PNG, això es pot fer automàticament quan el fitxer es converteix a PS.
LATEX necessita una mica d'informació sobre els sufixos dels fitxers. El paquet graphicx cerca un fitxer graphics.cfg, que ha d'estar en algun lloc en el vostre camí de cerca per a documents de LATEX. Cerqueu entrades de la següent manera:

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

i substituïu aquestes línies amb:

\DeclareGraphicsRule{.pz}{eps}{.bb}{}%
   \DeclareGraphicsRule{.eps.Z}{eps}{.eps.bb}{}%
   \DeclareGraphicsRule{.ps.Z}{eps}{.ps.bb}{}%
   \DeclareGraphicsRule{.ps.gz}{eps}{.ps.bb}{}%
   % changed or new graphic rules
   \DeclareGraphicsRule{.eps.zip}{eps}{.eps.bb}{`unzip -p #1}%   zipped EPS
   \DeclareGraphicsRule{.eps.gz}{eps}{.eps.bb}{`gunzip -c #1}%   gzipped EPS
   \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:-}%      PDF-graphics

Trobareu aquest fitxer, per exemple en Debian, a /etc/texmf/latex/graphics.cfg. La millor manera de procedir és copiar aquest fitxer al vostre camí local de TEX (texpath) i després canviar aquesta còpia. Vegeu el manual de TEX de la vostra distribució per a saber com obtenir una llista de les vostres carpetes de TEX.
Amb aquest fitxer de configuració sereu capaços d'inserir gràfics de mapa de bits o fitxers EPS comprimits amb ZIP i GZIP a LATEX. L'ordre per a la conversió ve donada per dvips. Quan us fixeu en l'ordre de conversió veureu que no es crea cap fitxer extra. El resultat del procés de conversió es dirigeix directament al fitxer PS. L'únic que ha de saber LATEX és la mida dels gràfics, i per tant necessitem el contenidor, el qual és proporcionat pel Kile.
Hi ha que diu que aquest camí no és segur, haureu de decidir sobre com treballar. En qualsevol cas, no necessitareu cap contenidor, ja que el Kile extraurà aquesta informació de tots els tipus de gràfics.

El PDFLATEX i els gràfics EPS
Com ja s'ha indicat, el PDFLATEX no és capaç de manejar fitxers gràfics EPS, però convertidors com epstopdf us ajudaran. La millor manera de fer-ho és incloure el paquet epstopdf, al que seguirà el paquet graphicx.

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

Ara ja pots incloure els gràfics EPS, si executeu pdflatex amb l'opció --shell-escape, però podem fer-ho encara millor manejant fitxers EPS comprimits amb ZIP o GZIP. Una vegada més hem de canviar el fitxer de configuració de gràfics graphics.cfg com anteriorment. Aquesta vegada buscarem:

% pdfTeX executant-se en mode PDF
   \ExecuteOptions{pdftex}%

i afegirem algunes línies:

% pdfTeX executant-se en mode PDF
   \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}}%
   }%

Amb aquestes línies, el PDFLATEX serà capaç de manejar fitxers EPS, i esperem que no tingueu més problemes amb els gràfics.

Document mestre
Definir el vostre document com un mestre us permetrà treballar amb fitxers separats, el que us donarà un document de nivell superior (o document mestre) i documents fills que compondran una obra completa. Una vegada definit el document mestre, amb l'ordre corresponent al menú Arranjament, totes les ordres del menú Eines sols seran d'aplicació a aquest document, fins i tot quan esteu treballant en els documents fills. Encara podreu tancar el document mestre.

Gestió d'errors
Després de compilar alguna cosa, el Kile dóna un cop d'ull als missatges d'error que s'han generat. Si hi ha algun error o avís, se us informarà breument a la finestra Registre i missatges. Podeu profunditzar en els missatges seleccionant Construeix Mostra el fitxer del registre, o utilitzant la drecera de teclat 0. El registre generat es mostrarà a la vista Registre i missatges. Els errors i els avisos seran ressaltats.
Veure el registre
Veure el registre
Veure el registre
Podeu saltar d'un missatge al fitxer de registre a un altre utilitzant els elements de menú Build Següent / Anterior error/avís de LaTeX, o utilitzant els botons de la barra d'eines corresponent.
Per saltar a la línia en el codi font LATEX font on s'ha produït l'error o avís, feu clic sobre l'error o l'avís a la vista Registre i missatges. El Kile us portarà automàticament a la línia en qüestió.

El mode vigilància del fitxer
Quan llanceu l'ordre Creació ràpida, normalment s'invocarà un visor d'algun tipus després de la compilació. Si no teniu un visor incrustat, cada vegada s'obrirà una nova finestra.
Si voleu ajustar l'aspecte del vostre document, possiblement llançareu Creació ràpida molt sovint, i tindreu moltes finestres del visor obertes a l'escriptori. Per evitar aquesta confusió, podeu activar el mode Vigilància de fitxer, evitant que la Creació ràpida llanci un visor.
Aquest mode manca d'utilitat amb els visors incrustats, ja que cal tancar-los per tornar a editar i compilar el document.