Les outils de compilation

Compiler, convertir, afficher
Pour afficher le résultat de votre travail, vous devez d'abord compiler le source. Tous les outils de compilation sont groupés dans les menus Compilation Compiler, Compilation Convertir et Compilation Afficher.
Pour compiler votre code source pour un affichage à l'écran avec ou pour d'autres conversions, vous pouvez utiliser le raccourci 2. Vous pouvez alors voir le fichier en utilisant votre afficheur par défaut avec 3, convertir le en fichier PS avec 4, et voir le fichier PS avec 5.

BibTEX
Si vous utilisez BibTEX pour vos éléments de bibliographie, vous devez souvent suivre un processus de compilation spécial : appeler LATEX, puis BibTEX, et encore LATEX deux fois. Heureusement, Kile est suffisamment intelligent pour détecter automatiquement s'il est nécessaire d'appeler des outils supplémentaires comme BibTEX, makeidx et Asymptote. Cette logique est activée par défaut, et ceci peut être modifié dans Configuration Configurer Kile... Outils Compilation dans l'onglet Général des outils LATEX et PDFLATEX.

MetaPost et Asymptote
Si vous souhaitez compiler votre document avec MetaPost ou Asymptote, des programmes de dessin, vous pouvez le faire avec Compilation Compiler Metapost ou Compilation Compiler Asymptote.

PDFLATEX
Il y a un autre moyen de compiler votre document, si vous voulez un PDF : vous pouvez exécuter PDFLATEX, qui compilera le source pour générer directement un fichier PDF, avec 6. Vous pouvez ensuite voir le fichier compilé en appuyant sur 7.
Vous pouvez également convertir un fichier PS en PDF avec 8, ou directement un fichier en PDF avec 9.
Utiliser PDFLATEX plutôt que LATEX peut être juste une question de simplicité ou d'habitude, mais quelquefois, le comportement des deux programmes peut différer.

LATEX vers le Web
Enfin, vous pouvez publier votre travail sur le web, et pas uniquement sur papier. Vous pouvez alors utiliser pour cela le programme latex2html, qui peut être appelé depuis le menu de Kile Compilation Compiler LaTeX to Web. Le résultat sera placé dans un sous-dossier du dossier de travail, et vous pourrez voir le résultat de la conversion en choisissant l'élément de menu Compilation Afficher View .

Passer des arguments en ligne de commande
Si vous souhaitez passer des arguments spécifiques en ligne de commande pour les outils de compilation, de conversion ou d'affichage, vous pouvez configurer leurs appels dans Configuration Configurer Kile... Outils Compilation.

Prévisualisation rapide
Vous aurez toujours besoin de voir le résultat lorsque vous travaillez avec LATEX. LATEX doit compiler le source, et l'afficheur doit ensuite être appelé. Ceci peut être ennuyant si vous n'avez modifié que quelques lettres dans une équation difficile à saisir. Kile offre un mode Prévisualisation rapide, dans lequel vous pouvez ne compiler qu'une partie du document et gagner ainsi beaucoup de temps. Il gère quatre modes différents, qui peuvent être combinés avec sept configurations.
Prévisualisation rapide
Prévisualisation rapide
Tous les réglages doivent être faits dans Configuration Configurer Kile... Outils Prévisualisation.
Configuration de la prévisualisation rapide
Configuration de la prévisualisation rapide

Mode sélection
L'utilisateur doit choisir une partie du document. L'élément de menu Compiler Prévisualisation rapide Sélection ou le raccourci clavier P, S démarrera les programmes choisis. Kile prend le préambule du texte original, afin que tous les paquets et les commandes définies par l'utilisateur soient incluses. L'utilisateur peut choisir une des huit configurations prédéfinies :
LaTeX+ (afficheur embarqué),
LaTeX+ (),
LaTeX+PS (afficheur embarqué),
LaTeX+PS (),
PDFLaTeX+PDF (afficheur embarqué),
PDFLaTeX+PDF (),
XeLaTeX+PDF (afficheur embarqué),
XeLaTeX+PDF ().
Cela devrait être suffisant pour toutes les situations dans lesquelles la prévisualisation est nécessaire.

Mode environnement
Souvent, vous souhaitez prévisualiser l'environnement courant, tout particulièrement dans les environnements mathématiques, qui sont parfois difficiles à écrire. Kile vous offre un moyen très rapide de faire cela. Aucune sélection n'est nécessaire, choisissez juste Compilation Prévisualisation rapide Environnement ou le raccourci clavier P, E et l'environnement courant sera compilé et affiché.

Mode sous-document
Si vous avez un gros projet avec beaucoup de documents, la compilation de l'ensemble du projet n'est pas une bonne idée si vous n'avez fait de changements que sur un document. Kile est capable de compiler et afficher le sous-document en cours. Il prend le préambule du document maître, et ne compile que la partie actuelle lorsque vous choisissez Compilation Prévisualisation rapide Sous-document ou le raccourci clavier P, D.

Mode groupe mathématiques
Le mode de prévisualisation groupe mathématique vous permet d'avoir un aperçu du groupe mathématique sur lequel vous travaillez actuellement. Kile prend le préambule du document maître, et ne compile que le groupe mathématique dans lequel se trouve le curseur lorsque vous choisissez Compilation Prévisualisation rapide Groupe mathématiques ou le raccourci clavier P, M.

Prévisualisation rapide dans la barre du bas
Au lieu d'afficher l'aperçu dans un nouveau document, Kile peut également être configuré pour utiliser la barre du bas pour les compilations des aperçus. Vous pouvez activer cette caractéristique dans le panneau de configuration de la prévisualisation rapide.

Formats de fichiers graphiques

LATEX et PDFLATEX
PDFLATEX, lorsqu'il est utilisés avec les paquets graphics ou graphicx, peut compiler correctement des fichiers PNG et JPG en ou PDF, mais ne peut pas gérer les fichiers EPS. Inversement, la compilation avec LATEX pour produire un , puis le convertir en PS et éventuellement en PDF prend en charge les EPS, mais ne reconnaît pas les PNG et JPG.
Beaucoup d'utilisateurs souhaitent créer des documents PDF, mais veulent également utiliser l'excellent paquet Pstricks pour créer des graphiques , ou veulent utiliser la sortie de logiciels mathématiques ou scientifiques comme Mathematica, Maple ou MuPAD. Ces utilisateurs de LATEX doivent d'abord compiler en , même s'ils souhaitent créer un document PDF, parce que ces programmes produisent du code qui ne peut pas être géré par PDFLATEX. Cependant, ce n'est pas si compliqué que ça parce que Kile vous aidera.

Conversion de graphiques
Pour régler ce problème, lorsque vous souhaiterez inclure à la fois du code et des fichiers PNG ou JPG, vous avez plusieurs solutions :
Si vous avez besoin d'un fichier au format PS, mais avez des images en JPG ou PNG, vous pouvez également utiliser PDFLATEX avec la sortie d'abord, puis ensuite exécuter dvips pour créer le fichier PS. Vous voyez que PDFLATEX est un très bon choix, si votre source ne contient aucun code .
Vous pouvez convertir les fichiers EPS en PNG ou autres formats avec des utilitaires comme Gimp ou ImageMagick et utiliser PDFLATEX.
Un des meilleurs moyens est de convertir les graphiques EPS en graphiques PDF avec eps2pdf, qui est fourni avec toutes les distributions TEX, et ensuite utiliser PDFLATEX. Il produit des graphiques de grande qualité, et vous pouvez même contrôler le résultat avec quelques unes des options suivantes :

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

Encore mieux : si votre système permet les shell-escape, la conversion peut se faire à la volée. Tout ce que vous avez à faire est d'inclure le paquet epstopdf, qui fait partie de toutes les distributions TEX, avec la commande \usepackage{epstopdf}. Supposons que votre code est :

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

Lorsque vous appellerez PDFLATEX avec l'option --shell-escape, le graphique test.eps sera automatiquement converti en test.pdf.
Cette conversion aura lieu chaque fois que vous exécutez PDFLATEX. Si votre commande d'inclusion de graphique est implicite :

        \includegraphics[width=5cm]{test}

epstopdf vérifie si test.pdf est déjà disponible, de façon à ne pas refaire la conversion.
Vous pouvez convertir d'autres manières, et utiliser LATEX et les conversions PS-PDF. Ce n'est pas toujours une bonne idée, puisque l'encapsulation EPS de JPG ou de PNG ne gère pas les gros fichiers, qui en revanche mènent à des documents inutilement gros. Ceci dépend cependant grandement de l'utilitaire graphique que vous avez utilisé, puisque l'EPS peut encapsuler d'autres graphiques, mais toutes les applications ne gèrent pas ça parfaitement. Certaines tenteront de construire votre image JPG avec des vecteurs et des scripts divers, ce qui résultera en un fichier gigantesque. La conversion de tous les formats graphiques en EPS peut être réalisée par ImageMagick. Un autre programme simple qui fait cela correctement est jpg2ps.
Vous pouvez également utiliser une conversion automatique. Tous les fichiers graphiques sont convertis à la volée en EPS, et insérés dans le document PS. C'est un moyen confortable mais vous devez configurer votre environnement correctement. Ceci est discuté dans la section graphiques EPS.

Utiliser le bon fichier pour le bon graphique
EPS est une sorte de langage de script vectoriel graphique, décrivant toutes les lignes et les points constituant le graphique. Le graphique reste correct même si vous augmentez ses dimensions, et convient le mieux pour les diagrammes et les graphiques vectoriels produits nativement en EPS, qui sont très propres et nets tout en conservant une taille réduite.
PNG (ou l'ancien ) est un format de fichier sans pertes, avec une bonne compression et une bonne qualité. Il est très bon pour les diagrammes, les dessins numérisés. Il est parfois contreproductif lorsqu'utilisé pour des photos.
JPG est un format avec pertes, qui compresse mieux les fichiers que le format PNG, au prix d'une baisse de qualité dans les détails de l'image. C'est la plupart du temps négligeable pour les photos, mais peut entraîner une mauvaise qualité d'image pour les diagrammes, les dessins, et peut même faire disparaître directement les lignes fines. Dans ce cas, utilisez EPS ou PNG.
Mais souvenez-vous, mauvaises données à l'entrée, mauvais résultats à la sortie. Aucune conversion ne rendra belle une image de mauvaise qualité.

Graphiques EPS
Les fichiers graphiques EPS sont le moyen traditionnel d'insérer des fichiers graphiques dans des documents LATEX. Comme les listes de discussions sont pleines de questions concernant les graphiques EPS, vous discuterons des aspects importants et montreront comment Kile les gère.

LATEX et les graphiques EPS
Si vous avez décidé d'utiliser le traditionnel LATEX pour produire une sortie PS ou PDF, vous rencontrerez probablement des problèmes avec les graphiques. Vous devez utiliser les graphiques EPS ( encapsulé ; pas de fichiers JPEG ou PNG. Ce ne devrait pas être un problème, puisqu'il y a beaucoup de convertisseurs, comme convert de l'excellent paquet ImageMagick. Mais cela demande du temps, bien sûr.
Les fichiers EPS sont utilisés à la fois par LATEX et par le convertisseur -PS :
LATEX balaye le fichier EPS à la recherche des bords de l'image, qui lui indiquent l'espace à réserver au graphique.
Le convertisseur -PS lit alors le fichier EPS et insère le graphique dans le fichier PS.
Ceci a quelques implications :
LATEX ne lit jamais les fichiers EPS si les paramètres des bords sont spécifiés dans la commande d'insertion des graphiques.
Comme LATEX ne peut pas lire les fichiers non ASCII, il ne peut pas lire les informations sur les bords de l'image dans des fichiers graphiques compressés ou non EPS.
Les fichiers graphiques EPS ne sont pas inclus dans le fichier . Comme les fichiers EPS doivent être présent lorsque le fichier est converti en PS, les fichiers EPS doivent accompagner les fichiers lorsqu'ils sont déplacés.
Maintenant vous pouvez appeler LATEX et un convertisseur -PS comme dvips pour créer votre document . Si vous souhaitez produire au final un document PDF, vous devrez exécuter dvips avec l'option -Ppdf et ensuite appeler ps2pdf. Vous trouverez beaucoup de documents décrivant cette solution.

Gestion du par Kile
Kile vous aide à obtenir les informations sur les dimensions de l'image. Si vous avez installé le paquet ImageMagick, Kile va extraire ces informations du fichier EPS et l'insérera comme option. Ceci est fait automatiquement lorsque vous choisissez le fichier graphique. Il y a deux avantages à procéder ainsi :
les informations sont déjà renseignées dans la boîte de dialogue, et LATEX n'aura plus à les retrouver plus tard,
encore plus important, les largeur et hauteur de l'image peuvent être calculées, lorsque la résolution est connue. Ces informations sont affichées vers le haut de la boîte de dialogue, et peuvent vous aider lorsque vous voulez changer l'échelle des graphiques.
Kile peut également gérer les fichiers EPS compressés avec zip ou gzip, qui sont plus petits que les fichiers EPS non compressés. Mais cette caractéristique ne peut être utilisée qu'avec une configuration spéciale du système, et une modification locale de la configuration des graphiques, comme cela est décrit dans la section Graphiques bitmap.

La gestion du et les images bitmap
Si votre système permet les shell-escape, Kile dispose également d'un moyen facile d'inclure des graphiques bitmap, si vous configurez votre système TEX correctement. Il n'y a pas besoin de convertir les graphiques JPEG ou PNG, ceci peut être fait automatiquement lorsque le fichier est converti en PS.
LATEX a besoin d'informations sur les suffixes des fichiers. Le paquet graphicx cherche un fichier graphics.cfg, qui doit être quelque part dans votre chemin de recherche des documents LATEX. Cherchez des éléments comme :

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

et remplacez ces lignes par :

\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

Vous trouverez ce fichier, par exemple dans Debian, dans /etc/texmf/latex/graphics.cfg. Le meilleur moyen de procéder est de copier ce fichier dans votre texpath local et ensuite modifier cette copie. Consultez le manuel de votre distribution TEX pour apprendre comment obtenir la liste de vos dossiers TEX.
Avec ce fichier de configuration, vous pourrez insérer des graphiques bitmap et des fichiers compressés avec zip ou gzip dans LATEX. La commande pour la conversion est donnée par dvips. Lorsque vous regardez la commande de conversion, vous verrez qu'aucun fichier supplémentaire n'est créé. Le résultat du processus de conversion est directement redirigé dans le fichier PS. La seule chose que LATEX doit connaître est la taille des graphiques, et donc nous avons besoin des dimensions de l'image, qui est fournie par Kile.
Certains disent que cette façon de procéder est dangereuse ; vous devez décider de votre façon de travailler. Dans tous les cas, vous n'avez pas besoin des dimensions, puisque Kile extrait ces informations depuis tous les types de graphiques.

PDFLATEX et les graphiques EPS
Comme nous l'avons déjà vu, PDFLATEX n'est pas capable de gérer les fichiers graphiques EPS, mais des convertisseurs comme epstopdf peuvent aider. Le meilleur est d'inclure le paquet epstopdf, qui doit suivre le paquet graphicx.

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

Maintenant, vous pouvez inclure des graphiques EPS, si vous lancez la commande pdflatex avec l'option --shell-escape, mais nous pouvons faire encore mieux et gérer également les fichiers EPS compressés avec zip ou gzip. Encore une fois, nous devons modifier le fichier de configuration graphics.cfg comme précédemment. Cette fois nous cherchons :

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

et ajoutons simplement quelques lignes :

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

Avec ces lignes, PDFLATEX peut maintenant gérer les fichiers EPS, et heureusement, il ne devrait plus y avoir de problèmes avec les fichiers graphiques.

Document maître
En définissant votre document comme document maître, vous pouvez travailler avec des fichiers séparés, ce qui vous donne un document parent (ou un document maître), et des documents enfants. Après avoir défini votre document maître, avec la commande correspondante dans le menu Configuration, toutes les commandes du menu Outils ne s'appliqueront qu'à ce document, même si vous travaillez sur les documents enfants. Vous pouvez même fermer le document maître.

Gestion des erreurs
Après avoir compilé quelque chose, Kile jette un œil aux messages d'erreur qui ont été générés. S'il y a des erreurs ou des alertes, elles seront reportées brièvement dans la fenêtre Journal et messages. On peut regarder de plus près les messages en choisissant Compilation Voir le fichier du journal, ou en utilisant le raccourci clavier 0. Le fichier journal généré est alors affiché dans la fenêtre Journal et messages, les erreurs et les alertes sont surlignées.
Affichage du journal
Affichage du journal
Affichage du journal
Vous pouvez facilement passer d'un message du journal à un autre en utilisant les éléments de menu Compilation Erreur / avertissement LaTeX suivant / précédent, ou en utilisant les boutons de la barre d'outils correspondant.
Pour aller à la ligne du code source LATEX où l'erreur ou l'avertissement s'est produit, cliquez sur l'erreur ou l'avertissement dans la fenêtre Journal et messages. Kile vous emmènera automatiquement à la ligne en question.

Le mode surveillance fichier
Lorsque vous lancez la commande QuickBuild, un afficheur est normalement appelé après la compilation. Si vous n'utilisez pas d'afficheur intégré, une nouvelle fenêtre s'affichera à chaque fois.
Si vous ajustez l'apparence de votre document, vous lancez probablement très souvent QuickBuild, et aurez par conséquent beaucoup de fenêtres ouvertes sur votre bureau. Pour éviter la confusion, vous pouvez activer le mode surveillance fichier, qui empêchera QuickBuild de lancer un afficheur.
Ce mode est bien sûr inutile avec les afficheurs intégrés, puisque vous devez les fermer de toutes façons pour revenir à l'édition du document pour recompiler.