Kile : User Manual

The LaTeX editor

In addition to the usual commands of an editor, Kile proposes other commands in order to facilitate the edition of your source files.

The preamble

To define the preamble of the source file, you can:

use the "Quick start" wizard.
use a template of preamble already recorded in the "User" menu.
"Copy/Paste" the preamble from another document.

With the toolbar or the "LaTeX/Sectionning" menu, you can insert the title of a section or of a paragraph thanks to a dialog box. Then, the "Structure" view is automatically updated. While clicking on one item in the "Structure" view, the cursor is placed on the corresponding line in the editor.
Note: for the file names, it is necessary to double-click. For a good work with Kile, all yours files must be located in the same directory than your main document.

Latex tags and Mathematical symbols

Kile enables you to directly insert the most current tags with the "Latex" and "Math" menus. With a simple click on a mathematical symbol, Kile inserts the corresponding code.
The menu "User" is also at your disposal to insert your own source code extracts.
Note: if the code of the menu is "%environment", Kile will directly insert:
```
\begin{environment } 

\end{environment } 
```
For the "bib" files , the "Bibliography" menu enables you to directly insert the entries corresponding to the standard types of document. (Note: use the "Clean" command to delete the optional fields)
Additional option: a selected text can be directly framed by certain environments.
Example: while clicking on the button "Bold" after having selected the word "Hello", you will obtain the code:
```
\textbf{Hello } 
```
(this option is available for the environments of the "Font Styles" and "Math Font Styles" menus like for the "center", "flushleft", "flushright", "tiny", "scriptsize"... environments)
The "Tabular", "Array" and "Tabbing" wizards are also at your disposal to help you insert the code corresponding to these environments.
A spell checking of your document (or of the selected paragraphs) is also possible (Menu "Edit").
Note: Kile uses the standard KDE tool for spell checking which does not allow the automatic use of the option "- t" of I(A)Spell.

The LaTeX Shell

The commands of the "Tools" menu enable you to directly launch the standard programs associated with LaTeX. To configure these tools, use the "Configure Kile" command of the "Options" menu.
Note : the commands can't be launched with an untitled document. You must save it before.

About the "log" file

The "Next Latex Error" and "Previous LaTeX Error" commands allow to get to the errors detected during compilation. While clicking on the number of a line in the "log" file , the cursor is placed on the corresponding line in the editor.

The "Quick Build" command

With this command, the compilation and the display of the document are automatically launched unless a LaTeX error is detected in the "log" file . (Note: only errors will stop the process, warnings are ignored)

About documents separated in several files

After having defined your "master" document (with the corresponding command of the "Options" menu), all the commands of the "Tools" menu will apply only to this document even when working on the "children" documents . (Note: you can even close the "master" document)

Use of the "Watch File" mode

Example of use with Kdvi:

launch the "Quick Build" command.
leave open Kdvi and select the "Watch File" mode for this program.
select the "Watch File" mode (menu "Tools") for Kile.
for all new launching of the "Quick Build" command, the "dvi" document will be automatically updated (with the same position) without Kdvi being started again.

Note : You can also use this mode with kghostview, but it will not work with the embedded viewers.

Use of the "Kdvi Forward Search" command

With this command, Kdvi displays the "dvi" document directly in the place corresponding to the position of the cursor in Kile. This command is not available if a "master" document is defined in Kile. You must also insert the following command in the preamble to your document:

\usepackage[active]{srcltx }

Note: the "srcltx.sty" and "srctex.sty" files (provided with the documentation of Kdvi) must be copied in the current directory of your document.

Use of the "Kdvi Inverse Search" command with Kile

Thanks to this command of Kdvi, with a middle-mouse click in the "dvi" document, Kile will open the "tex" document automatically and will propose to go to the corresponding line.
(Note: the document "tex" must be compiled as well as the "Kdvi Forward Search" command)
To select Kile as the default editor in Kdvi, use the command "kile %f --line %l" ("Settings" Menu - "DVI options" - "DVI specials").

The GnuPlot front end

The Gnuplot front end provided with Kile is an adaptation of the Xgfe program created by David Ishee. The use of this tool requires a good knowledge of Gnuplot.
Example: Layout of the function "sinus"

Check the "Function" box and enter "sin(x)" in the corresponding field.
Enter "X" in the "Variable X" field, "- 5" in the "Start" field and "5" in the "End" field .
Click on the "Plot" button to see the graphic.
To export the graphic under the format of Xfig: select "fig" in the "Terminal" menu, click on the "Output File" button, enter the name of the file (with the extension ".fig") and click on the "Plot" button .You may then open this graphic with Xfig to modify and export it with the "eps" format before incorporating it in your document.

Credits

Kile contains source code from this free (GPL) program :
Xgfe (X Windows GUI front end to Gnuplot) : Copyright (C) 1998 David Ishee

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.