Chapter 9. The Build Tools

Table of Contents

Compiling, converting and viewing
BibTEX
makeidx
MetaPost and Asymptote
PDFLATEX
LATEX to Web
Passing Command-Line Parameters
Quick Preview
Selection Mode
Environment Mode
Subdocument Mode
Mathgroup Mode
Quick Preview in Bottom Bar
Graphic File Formats
LATEX and PDFLATEX
Graphics Conversion
Use the right File for the right Graphic
EPS Graphics
LATEX and EPS Graphics
The PostScript Way of Kile
The PostScript Way and Bitmap Graphics
PDFLATEX and EPS Graphics
Master Document
Error Handling
The Watch File Mode

Compiling, converting and viewing

To view the result of your work, you first need to compile the source. All the build tools are grouped closely together in the Build->Compile, Build->Convert, and Build->View menus.

To compile your source code for screen viewers like KDVI, KGhostView, KPDF or further conversion, you can use the shortcut Alt-2. Then you can view the DVI file using your default viewer with Alt-3, convert the DVI to a PS file with Alt-4, and view the PS file with Alt-5.

BibTEX

If you are using BibTEX for your bibliography entries, you usually have to follow a special compiling scheme. This means calling LATEX and then BibTEX and then LATEX twice again. Fortunately Kile is clever enough to detect automatically if it is necessary to call additional tools like BibTEX, makeidx and Asymptote. This logic is by default turned on and can be changed in Settings->Configure Kile...->Tools+Build in the General tab in the LATEX and PDFLATEX tools.

makeidx

If you are using the makeidx package to make a final, alphabetical index for your document, you have also to follow a certain compilation pattern or let Kile do this for you in the same way as with BibTEX files.

MetaPost and Asymptote

If you want to compile your document with MetaPost or Asymptote, picture drawing programs, you can do it with Build->Compile->Metapost. or Build->Other->Asymptote.

PDFLATEX

There is also another way to compile your document, if you want a PDF: you can run PDFLATEX, that will compile the source directly into a PDF file, with Alt-6: you can then view the compiled file pressing Alt-7.

Alternatively, you can convert a PS into a PDF with Alt-8, or directly a DVI into a PDF with Alt-9.

Using PDFLATEX instead of LATEX may be just a matter of simplicity or habit, but sometimes the behavior of the two program can differ.

LATEX to Web

Finally, you may want to publish your work on the web and not just on paper. You may then use the latex2html program, that can be called from Kile's menu Build->Convert->LaTeX to Web. The result will be placed in a subfolder of the work folder, and you will be able to see the result of the conversion choosing the menu item Build->View->View HTML.

Passing Command-Line Parameters

If you want to pass some specific command-line parameters to the compile, convert or view tools, you can configure their call in Settings->Configure Kile...->Tools+Build.