This manual is intended for any individual, regardless of her or his experience with L^AT_EX, KDE, Kile or Linux®.

Advanced users are not likely to read this manual, but all suggestions on documentation will be considered. If you would like to contribute to this project or the documentation, please consult the Kile web page.

Do you need answers about Kile? Are you stuck with the compilation process? Do you want to see a new feature implemented? The preferred way to ask technical questions or to start a discussion is to use our mailing list: (kile-devel AT lists.sourceforge.net).

The L^AT_EX typesetting system is similar to other markup languages such as XML, which is used in many types of documents (including the one you are reading), or HTML, which is used for web pages. The general idea behind markup languages is to have special keywords, called tags, that tell a program (a word processor, a web browser, or the L^AT_EX compiler) how the text enclosed within the tags is to be interpreted. Kile offers a number of such tags in the LaTeX menu in the menu bar.

While we will try to give you a good idea of what L^AT_EX is, this document is, of course, not The Definitive Book on L^AT_EX. If you want to learn L^AT_EX in depth, you may want to borrow a specialized book from your local library.

As with any other markup language, L^AT_EX documents contain a preamble, which defines global properties, such as paper size, page numbering, dimensions of the text on the page, and a document body, which contains the text of the document. The preamble is composed at least of the \documentclass command. It precedes the document body, which starts with the command \begin{document} and is concluded with the command \end{document}.

If you look at the Edit toolbar, you will notice three large drop-down menus. The drop-down menus were designed for you to be able to quickly add certain common features into your document. The first drop down box is used for quickly dividing your document by parts, chapter, sections and so on; the available commands to add segments to your L^AT_EX source code are:

The drop down box named Other is used to insert items into your document such as indexes, footnotes, and references; the available commands are:

The Other drop-down menu

Selecting the label for a reference

When using cite, you are presented with a drop-down list of bibitems, but if you are using BibT_EX this will only work if the file belongs to a Project. For editing BibT_EX files the usage of specialized editors is recommended. The author has had good results with KBibT_EX. Of course you can also write the BibT_EX files by hand inside Kile.

The last drop down box labeled tiny is used to set the size of the text. You can set the size of the main text, of footnotes, and so on. The available commands are:

An environment is a segment of text that is managed differently from the rest of the document. For example, you create a report with font size 12, but you need to change your font size for a few sentences. The commands \begin{environment}, \huge and \end{environment} will let you temporarily alter the text inside the environment commands to be size huge.

Changes are only effective from \begin{environment} to \end{environment}. There are no limits as to how many changes you can make inside an environment.

There are many features you can add to your document that will make it more readable and user-friendly. You can add features such as specific fonts, bold, italics, underline etc. to your document, and these commands will end with either an \end command, or at the end of your environment.

Now that we have given you some background about how to write code using the L^AT_EX markup language, we will show you how to create a document using Kile step-by-step.

That's it! You have just created your first L^AT_EX document!

Once you have created your DVI, you will be able to print your document, or change it into a PostScript® or PDF file if you want. Experiment and have fun!

DVI stands for DeVice Independent file. These files are produced by T_EX or L^AT_EX to be read by a driver of some sort on your computer. There are many different types of output that a .dvi can be sent to, such as a printer, PostScript® or PDF file converter, or your computer screen.

The forward search functions allow you to jump from your editor directly to the associated position of the DVI or PDF file.

Kile offers a configuration with this option for all L^AT_EX binaries. Go to Settings → Configure Kile... → Tools+Build and always choose the Modern configuration.

To execute a forward search, position the cursor on a line of source code, and click Forward Search to jump to the associated position in the DVI or PDF viewer window.

Inverse search is a very useful feature when you are writing a L^AT_EX document yourself. If everything is set up properly, you can click into Okular's window with the left mouse button while pressing Shift. After that Kile loads the L^AT_EX source file and jumps to the proper paragraph. To use inverse search, you have to compile your L^AT_EX file with the Modern configuration.

Inverse search cannot work unless:

With this feature of Okular, a left mouse click while pressing Shift in the DVI or PDF document will result in Kile opening the corresponding L^AT_EX document and attempt to go to the corresponding line. Remember to tell Okular to use Kile as a text editor, in Okular's menu item Settings → Configure Okular... (on the page Editor).

Configuring Okular

If you are trying to use quickbuild, and the DVI viewer does not open, chances are you have an error. If you have an error, it will be visible in the log file / message area, and the summary of the error will be given.

The log file will explain the source of the error in your code. In the editor, you can use the buttons in the toolbar labeled Previous LaTeX Error and Next LaTeX Error to jump to and from errors. The log file always states in which line the error occurred. To view the line where an error occurred, click on the error in the log window, and Kile will take you to the error's line.

To select text, you have the following options:

Holding the left mouse button, and dragging the text you want to select, automatically copies the selected text to the clipboard.

Holding Shift and using the arrow keys allows you to select portions of the source code in the editor window.

Bracket completion is a visual tool that the editor view uses to indicate to you which bracket matches which. If you open any .tex file, and select any bracket, whether it be a parenthesis (), square brackets [] or braces {}, the editor will highlight the bracket and its match in yellow (this default color can be changed). So, for example, if you position the cursor on the braces in \section{Introduction}, you would see \section{Introduction} in the default yellow highlight, showing you the location of the beginning and ending brackets.

Kile has the ability to look for and highlight different types of code. For example, L^AT_EX commands are distinguished from normal text, and math formulas are also highlighted in a different color.

Many wizards can insert optional bullets, a special kind of bookmark within the text. The menu entries Edit → Bullets or the corresponding keyboard shortcuts will allow you to jump to the next or last bullet. This will also highlight this bullet so that it will be deleted automatically, when you enter your first letter.

Editing is of course one of the main aspects when you use a program like Kile. Although Kate already has great capabilities, Kile adds some important features, which are especially needed to write L^AT_EX source. L^AT_EX always needs a lot of environments and groups, so Kile supports very special commands to select them. Under Edit → Select you will find the following commands to select text.

text \bfseries\itshape more text

To delete some parts of a document you can of course select them, and then use the Delete key. Kate also offers the command Ctrl+K which deletes the whole line. But Kile offers a faster way with its own delete commands. Under Edit → Delete you will find the following commands to delete text.

It has already been mentioned that environments are a central point in L^AT_EX. So Kile offers five other commands to make the work with L^AT_EX as easy as possible under submenus Edit → Environment.

Kile also offers some special commands for L^AT_EX groups, which are determined by braces {...}. In submenu Edit → TeX Group you will find some important commands, which correspond to those from Edit → Environment.

In L^AT_EX, two single quotes are used as double quotes. To help you insert these efficiently, Kile allows you to press " to insert two opening single quotes. Furthermore, if you want to close a quotation, you also have to press ". Kile will be smart enough to recognize this situation and inserts two closing quotes for L^AT_EX.

To get a literal double quote on the other side, press " twice.

You can enable or disable this auto insertion of opening and closing double quotes in section Settings → Configure Kile... → LaTeX.

If you also include language-specific options like ngerman or french, you will also be able to use German or French double quotes. Many more languages are available.

If you press Ctrl+Return, Kile inserts an intelligent newline. If your current position is inside a list environment, like enumerate or itemize, Kile will not only insert a newline, but also add a \item command.

If you are inside a tabular environment, Kile will finish the current line with \\, followed by the newline.

If you are inside a L^AT_EX comment, Kile will start the next line with a %.

Even better, Kile is smart enough to support predefined L^AT_EX and user defined environments, which can be added in section Settings → Configure Kile... → LaTeX.

Some users like to arrange columns in tabular environments and put all ampersand characters & beneath each other. Kile tries to support this. If you press Alt+Shift+&, Kile will look for the next tab in the row above. Although this tab may not be the corresponding tab, Kile will add some spaces to adjust the column position with the current tab.

When you type some letters, you can activate this completion mode for L^AT_EX commands and normal words with Edit → Complete → (La)TeX Command or the keyboard shortcut Ctrl+Shift+Space. Kile first reads the letters from the current cursor position to the left and stops at the first non-letter character or a backslash. If this pattern begins with a backslash, Kile will enter completion mode for T_EX or L^AT_EX commands. Otherwise it enters normal dictionary mode, where you will not find any L^AT_EX commands. Depending on the chosen mode, a completion box will be opened. You will see all commands or words whose beginning matches the current pattern. You can navigate with the cursor keys through this list and select one entry with Enter or a double click with the mouse.

When you push the Backspace key, the last letter of your pattern will be deleted, and the completion list may grow. On the other hand, if you type another letter it will expand the pattern and the visible word list may shrink.

If you decide not to select any of the suggestions, you can leave this dialog with Esc.

You will see that all commands are written with a short description of their parameters. These descriptions are of course stripped when you select a command. Optionally you can let Kile insert bullets at these places, so that you can easily jump to these positions with Edit → Bullets → Next Bullet and insert the parameter you want.

Go to Settings → Configure Kile... → Kile+Complete to configure one or more of these lists. You can choose different word lists for T_EX and L^AT_EX commands and dictionary mode for normal words.

If you choose the option Show Latex commands, the entries of all chosen compressed word list (cwl) files for L^AT_EX command completion are shown in a separate view of Kile's sidebar. You will see which commands are available and what parameters and options must or can be given for a completion. You can also simply select one entry with a mouse click and it will be inserted into the document, with all named parameters and options stripped.

As each chosen word list will be shown in a separate view of its own, there could be too many views, so that Kile's main window may be larger than a small screen allows. As this looks very ugly, Kile works with a maximum number of allowed views, which by default is set to 10. If this value is too big for your screen, you should reduce it.

The command mode is not useful for code completion of environments. You always have to type some letters of \begin, and invoking the completion mode will result in a huge list of environment tags. On the other hand, environments are so often used that Kile offers a special mode for code completion of environments. Forget the opening tag and write, for example, al.

When you call the completion mode with Edit → Complete → Environment or keyboard shortcut Alt+Shift+Space, the opening tag is automatically added and you will see \begin{al}. After this change, the completion list is much less cluttered.

Now select an environment, and you will see that it is also automatically closed. Even more, if Kile recognizes it as a list environment, it will also insert a first \item tag.

Go to Settings → Configure Kile... → Kile+Complete to configure one or more of these lists. This mode uses the same word lists as the completion mode for T_EX and L^AT_EX commands.

Kile supports user defined lists of abbreviations, which are replaced on demand by longer text strings. Look at Settings → Configure Kile... → Kile+Complete to configure one or more of these lists. For the example given here, the abbreviation list in example.cwl must be chosen. In this file you will find, for example, the entry L=\LaTeX.

For example, type only the letter L. Now invoke the abbreviation mode of word completion with Edit → Complete → Abbreviation or keyboard shortcut Ctrl+Alt+Space, and the letter L is replaced by the string \LaTeX.

Abbreviation completion also supports newline %n and %C to place the cursor, if these characters are present in the expansion text. So if you have the entry

en1=\begin{enumerate}%n\item %C%n\end{enumerate}%n

in the completion file, and invoke the abbreviation completion, the expansion looks as below, where x shows the final cursor position.

\begin{enumerate}
	\item x
\end{enumerate}

The latest specification of the completion file format can found in the CWL file format specification.

Completion files can be installed in a user's home folder under the ~/.kde/share/apps/kile/complete/<mode>/ subdirectory, where <mode> either stands for abbreviation, dictionary or tex.

The Include Graphics dialog makes insertion of graphics as easy as possible. You can reach it via the menubar with LaTeX → Image Insertion. Please take a look at Graphic File Formats and EPS Graphics to get an overview of some basic facts concerning graphic formats.

One of the most boring jobs one can do in L^AT_EX is to write a matrix or a tabular environment. One has to keep track of all the elements, ensure that the environment is well formed, and that all things are where they are supposed to be. Good indentation helps, but there is a simpler way: using Kile's Wizard → Array or Wizard → Tabular menu entries. You will then have a matrix-style input form that you can easily fill in with your entries. This dialog also offers some options to typeset the tabular material.

Using the toolbar on top of the dialog you can set the align of a cell, define a certain font style, join and split cells, choose a border, and specify background and font colors. On the extreme right there is a Paste button. With this button you can insert a table from the clipboard into the dialog, which allows you to copy and paste tables from a spreadsheet program, for example.

Below you can choose how many rows and columns you want, and you can tweak some more details about your array:

The Wizard → Tabbing option will display a simpler dialog to quickly set up a tabbing environment. It allows you to easily specify the number of rows or columns and the required spacing.

Kile helps you with inserting your floating elements. With the Wizard → Floats wizard it is very simple to create a new figure or table environment.

To insert a new floating environment just follow these steps:

Remembering how all the different math elements work can be really annoying. Of course Kile can do the magic for you here: Wizard → Math

Options:

PS files are not so popular as PDF files, but are an excellent base for manipulations and rearrangements of pages. If you need PDF output, you can rearrange pages with some PostScript® utilities and then convert it to PDF with ps2pdf.

The PostScript® Wizard under Wizard → Postscript Tools will suggest the most popular rearrangement. The conversion is done by the programs pstops and psselect, which can be found in most distributions in the package psutils. If one of these programs is not available, the corresponding item will not be visible.

First choose your input file. If Kile finds a PS file corresponding to your current master document, it is already filled in as the input file, but you are also free to choose another file. Then choose an output file, and select one of the tasks. Finally, you have to decide whether you want to do the conversion only, or also invoke Okular to view the result.

Many people think of PDFs as frozen files, which cannot be modified. But this is not true, as there exist excellent tools

of an existing PDF document.

Kile's PDF wizard under Wizard → PDF Tools uses two different methods to manipulate and rearrange PDF documents:

If one of these helpers, pdfpages or pdftk, is not present in your system, the corresponding items will not be visible. Furthermore, remember that only pdftk can work with encrypted files.

Rearrangements

If Kile's PDF wizard is called, it starts with the Rearrangements register card.

First choose your input file. If Kile finds a PDF file corresponding to your current master document, it will already be filled in as the input file, but you are also free to choose another file. Then choose an output file or overwrite the existing PDF file, and select one of the tasks. Finally, you have to decide whether you want to do the conversion only, or also invoke the viewer (e.g. Okular) to show the resulting document.

If the PDF file is encrypted, only pdftk will work and you have to give the password of this document to execute tasks.

1 page + empty page --> A4

Combine one page together with an empty page on one A4 page. Whenever two A5 pages are combined together, they are rotated by 90 degrees and arranged on an A4 page in landscape mode.

Whenever two A4 pages are combined together, they are scaled, rotated by 90 degrees and arranged on an A4 page in landscape mode.

1 page + duplicate --> A4

Put one page and a duplicate together on one A4 page.

If the page to be duplicated has A4 size, it will be scaled to fit on the page.

2 pages --> A4

Combine two consecutive pages together on one A4 page. Whenever two A5 pages are combined together, they are rotated by 90 degrees and arranged on an A4 page in landscape mode.

Whenever two A4 pages are combined together, they are scaled, rotated by 90 degrees and arranged on an A4 page in landscape mode.

2 pages (landscape) --> A4

Put two consecutive pages in landscape mode together on one A4 page.

4 pages --> A4

Combine four consecutive pages together on one A4 page. The pages have to be scaled to fit on the page.

4 pages (landscape) --> A4

Combine four consecutive pages in landscape mode together on one A4 page. The pages have to be scaled to fit on the page.

select even pages

Select all even pages of a document.

select odd pages

Select all odd pages of a document.

select even pages (reverse order)

Select all even pages of a document and reverse the order.

select odd pages (reverse order)

Select all odd pages of a document and reverse the order.

reverse all pages

Reverse all pages of a document.

decrypt a file

If the PDF file is encrypted, you can decrypt it.

select pages

Add a comma separated list of pages or page ranges, e.g. 1,4-7,9. Only these pages will appear in the resulting PDF file.

delete pages

Add a comma separated list of pages or page ranges, which should be removed from the chosen PDF file.

apply a background watermark

Applies a PDF watermark to the background of a single input PDF. The wizard only uses the first page from the background PDF and applies it to every page of the input PDF. This page is scaled and rotated as needed to fit the input page.

apply a background color

Applies a background color to all pages of the current document. This can only be done once, as the second color will be put behind the first color and will not then be visible.

apply a foreground stamp

Applies a foreground stamp on top of the input PDF document's pages. The wizard uses only the first page from the stamp PDF and applies it to every page of the input PDF. This page is scaled and rotated as needed to fit the input page. This works best if the stamp PDF page has a transparent background.

pdftk: choose parameter

You can invoke pdftk with an option of your choice. Please read the manual for all possible options.

pdfpages: choose parameter

You can invoke pdfpages with an option of your choice. Please read the manual for all possible options.

Properties

The setting, changing and removing of properties will only be possible if pdftk is installed and if additionally Kile was compiled with the libpoppler library.

Traditional PDF metadata includes the document's title, author, subject, keywords, creator, producer and the dates of creation and last modification.

Permissions

Also, the setting, changing and removing of permissions will be only possible if pdftk is installed.

A password is necessary to set or change these document settings. Additionally, PDF encryption is done to lock the file's content behind this password or to enforce lighter restrictions imposed by the author. So the author can allow or restrict:

• printing pages

• modifying pages

• copying text and graphics from pages

• changing or adding annotations

• filling form fields with data.

Changing permissions always forces encryption associated with 128-bit security of Acrobat 5 and 6, and also needs a password.

But always remember: encryption and a password do not provide any real PDF security. The content is encrypted, but the key is known. You should see it more as a polite but firm request to respect the author's wishes.

The statistics dialog in File → Statistics gives you a statistical overview for a selection, a document or a whole project. It includes the number of words, L^AT_EX commands/environments and also includes the number of characters for each type.

The statistics obtained can be copied as text or as a nicely formatted L^AT_EX table to the clipboard.

When you select a text and open the statistics dialog, you get the statistics for the currently selected text. If you open the dialog without any text selected, the statistics for all opened files are shown. If you want to get statistics for the whole project, you can use Project → Open All Project Files for an easy and quick way to open all source files of your project.

A note of caution has to be sounded about the accuracy of the numbers. We have included some logic to get a good estimate, e.g. K\"uhler gives one word and one command, with six and two characters respectively. But there are other combinations in which parts of commands are counted as words and vice versa. Please note that the algorithm was developed and tested for languages similar to English or German. So don't take the numbers for granted. If you write a report whose length has to be of a certain numbers of words or characters, please make some tests first in order to check whether Kile's accuracy satisfies your needs.

\bibitem is a command used to enter a reference in a thebibliography environment in your document. The syntax for using \bibitem is \bibitem[label]{key}.

The optional [label] is for you to add your own labeling system for the bibliography entry. If no label is set, the entries will be set in numerical order: [1], [2], [3], etc.

The argument {key} is used to reference and link the commands \bibitem and \cite to each other and the information they contain. The command \cite contains the label associated with the intended \bibitem, which is located inside a thebibliography environment, and contains the reference data. Both corresponding \bibitem and \cite must have the same {key}; the easiest way to organize keys is by the author's last name. The secondary braces in the thebibliography environment denote the longest bibliography label you expect to have. So, inserting {foo} means you can have any label shorter or as large as the expression foo. Failure to set this parameter correctly may result in a not so attractive indentation of your bibliography.

The bibliography is a section apart from your main document, and an example of code for the bibliography would look like the following:

\begin{thebibliography}{50}
	\bibitem{Simpson} Homer J. Simpson. \textsl{Mmmmm...donuts}. Evergreen Terrace Printing Co.,
	                  Springfield, SomewhereUSA, 1998
\end{thebibliography}

Then, your main source code would contain the location of the information relating to the \bibitem using \cite. That source code would look similar to this:

My thesis, about the philosophy of The Simpsons\copyright comes from my favorite book \cite{Simpson}.

As it is often difficult to remember the exact citation key once you have many references, Kile provides an easy way to insert a citation. Using LaTeX → References → Cite a list with all the citation keys pops up. Select the correct reference and a citation will be inserted into your document. To update the list of keys, either save the file, or Edit → Refresh Structure, or press F12. With code completion enabled, Kile will show you a list of all the bibitem-labels as soon as you open up a \cite command.

The final result in your document's bibliography would then look like this:

[1] Homer J. Simpson. Mmmmm...donuts. Evergreen Terrace Printing Co., Springfield, SomewhereUSA, 1998.

Kile can also work together with BibT_EX editors, such as KBibT_EX to make it easier to enter citations. When a BibT_EX file is added to the project, Kile will help you complete citation commands, just as described above.

You can create new or change existing menus with a comfortable user menu configuration wizard found at Wizard → Edit User Menu.

On the left side you will see an existing menu-tree. Like a standard menu, three different kinds of menu items are available:

To modify this menu, use the six buttons on the left side. More possible actions are available in the context menu of already existing menu items.

Each standard menu item is assigned to one of three action types, where each of them has different attributes, which could be set:

If some important information for an action is missing, menu items are colored red. This may be a nonexisting file

or a missing title for the menu entry, which will be shown with question marks as ???.

If you open the context menu of such a red colored menu item, you will get an additional option for more information concerning this error.

More information may also be available using the What's this feature of most widgets.

Most menu entries may have additional self-explaining parameters, which may be checked. If some of these parameters are not available for some kind of action, they are disabled.

Here is one example for executing an external program:

You can see that a perl script is called, which should work with current selection. The Needs selected text parameter is checked to assure a selection. The output of this script will be inserted (Insert the output of the chosen program) and replace the current selection (Replace selected text), but not selected itself.

Of course you can also call your own programs or scripts. For example select a list of numbers, separated by spaces, and call a script or Perl program, which transforms this selection into L^AT_EX code for a matrix. Whatever your ideas may be, you can realize them using the following usermenu entry.

You can install different menus at runtime for different tasks. When you call the user menu wizard, the current menu definition file is loaded. If you modify it and close the dialog with OK, your changes will be saved and installed as the new user menu. Closing the dialog with Cancel will discard all changes.

You are also free to save the modified file in the user menu directory or to load another menu definition file and install it. All user menu definition files must be saved in the local user menu directory of Kile: KILE_APP_DIR/usermenu/.

Look at the example menu definition file example.xml to see more menu entries with their parameters.

You will always need some time to view the result, when working with L^AT_EX. L^AT_EX has to compile the source and the viewer has to be called. This can be annoying if you only changed some letters in an equation difficult to typeset. Kile offers a Quick Preview mode, where you can compile only a part of a document and save a lot of time. It supports four different modes, which can be combined with seven configurations.

All settings must be done in Settings → Configure Kile... → Tools+Preview.

EPS graphics files are the traditional way to insert graphics files into L^AT_EX documents. As mailing lists are full with questions concerning EPS graphics, we will discuss some important aspects and demonstrate how Kile supports them.

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

   \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

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

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

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

Defining your document as a master allows you to work with separate files, which gives you a parent document (or Master document), and child documents that make up a complete work. After having defined your Master document, with the corresponding command in the Settings menu, all the commands of the Tools menu will apply only to this document, even when you are working on the child documents. You can even close the Master document.

After you have compiled something, Kile takes a look at the error messages that were generated. If there are any errors or warnings, they will be briefly reported in the Log and Messages window. One can take a closer look at the messages by selecting Build → View Log File, or by using the keyboard shortcut Alt+0. The generated log is then displayed in the Log and Messages view; errors and warnings are highlighted.

Viewing the log

You can easily jump from one message in the log file to another by using the Build → Next / Previous LaTeX Error / Warning menu items, or by using the corresponding toolbar buttons.

To jump to the line in the L^AT_EX source where the error or warning occurred, click on the error or warning in the Log and Messages view. Kile will take you automatically to the offending line.

When you launch the Quickbuild command, a viewer of some sort will normally be called after the compilation. If you are not using an embedded viewer, a new window will be opened every time.

If you are adjusting the look of your document, you might launch Quickbuild very often, and have many viewer windows open on your desktop; to avoid this confusion, you can activate the Watch file mode, that will prevent Quickbuild from launching a viewer.

This mode is of course useless with the embedded viewers, as you have to close them anyway to get back to editing the document and recompiling.

Bookmarks are your reference to a segment of text or a line inside the Kile environment. To use a bookmark, select a specific line of your document you would like to return to, then press Ctrl+B, and Kile will add a bookmark to this line. Alternatively, you can also set a bookmark by highlighting a line and choosing the menu labeled Bookmarks → Set Bookmark.

To remove all your bookmarks, select Bookmarks → Clear All Bookmarks.

To create a project, select Project → New Project....

You will be asked to give the following information to create your project:

The Files and Projects view is a button of the sidebar menu. From this view, you can see the structure of your project, its files, and the name of the .kilepr file that stores the project information. Adding, removing, or changing options in your project is done via the Files and Projects view.

The Files and Projects View

To add a file to your project, open any T_EX file, right click on its name in the Files and Projects view, and select Add to Project. If you have opened multiple projects, a dialog box will pop up in which you can specify to which project the file should be added.

You can also right-click on the project's name in the Files and Projects view, and select Add Files... to bring up a file selection dialog.

Adding a file to a project

To remove a file from a project, right-click on it and select Remove File. This does not delete your file (and also does not close it), but only removes it from the list of files contained in the .kilepr extension.

Kile has a few options related to your project that can be set. To change them, right-click on the title of your project and select Project Options, and you will have the option of changing: