Wizards and Dialogs

QuickStart Wizard
This wizard has already been described in the section QuickStart Wizard.

Include Graphics
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.
Including a graphics element
Including a graphics element
Choose a graphics file. This can be a JPEG, PNG, PDF, EPS or even a zipped or gzipped EPS file. If you have installed ImageMagick and also configured Kile to use it (Settings Configure Kile... LaTeX Graphics), the width and the height of the graphic is automatically shown. If ImageMagick can determine a resolution, the size of the graphics is also shown in centimeters.
Decide whether your image shall be centered on the page.
Choose whether you want the \graphicspath notation for your graphics file.
By default graphics files have to be in the same folder as your master document. However, it is possible to put them in other folders to make things tidier. Without a \graphicspath command, Kile would include the path for the graphics file. But if you use \graphicspath in your preamble like this:

\graphicspath{{/path/to/my/graphics}{other/path/to/more/graphics}}

and check this option, Kile will only use the base name of the graphics file.
Another example: if you set \graphicspath command like:

\graphicspath{{./}{camera/}{images/}}

LATEX will search in the current folder, then in camera and finally in images to find your graphics file.
If you choose either a width or a height, the whole graphics will be proportionally scaled. If you set two values for width and height at the same time, width and height may be scaled with different factors, and this could not be what you want. See also the information near the top of the dialog to know the original size of the graphics.
Insert an angle by which to rotate the graphics counterclockwise.
The bounding-box information is set automatically when you choose a graphics file. This information is only needed when you work with traditional LATEX and bitmapped graphics. See the discussion of EPS graphics.
If LATEX needs a bounding box and you do not want to generate a bb file, Kile supports this option. On the other hand, PDFLATEX will give a warning when you want to include a png or jpg graphics with this option. This checkbox enables or disables the bounding-box option.
Scale the image by the desired scale factor. ⪚, 0.5 to reduce by half, or 2 to double. When you use this option, you do not have to set a width or height for the image.
In the Trim Image tab you can crop your image in all four directions.
Finally, you have to specify whether you want to embed this image into a figure environment. When you want the text to wrap around the figure, use the wrapfigure environment instead.
When you choose the wrapfigure environment, you need to include the wrapfig package in your preamble.
In either case you can insert a caption and a label for your image. Generally, it is a good idea to add a different prefix to each kind of label. It is common to use the prefix fig: for images.
If you pick the figure environment, you can choose where LATEX should preferably position the figure.
In the wrapfigure environment you can:
Pick a placement rule for the figure and decide whether the figure should float or not. In a two-sided document you can define whether the figure should be on the inside or outside edge of the page.
Define how many shortened lines of the text are set alongside the figure. If you leave this empty, LATEX will determine this itself as well as is possible.
Define an overhang to the chosen side. This is especially useful when you have columns in your document and you want a figure to span over more than just one column or you want shortened text on both sides of the figure.
Choose a width for the figure. This should be a bit bigger than the actual image width, so there will be some empty space between the figure and the text.

Arrays and tabulars
One of the most boring jobs one can do in LATEX 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.
Inserting a tabular environment
Inserting a tabular environment
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:
With the Name option you can select which environment should be used for your array or tabular material.
You can select the vertical cell alignment with the Parameter option. This is only enabled for environments which support that feature.
If it exists for the selected environment, you can select use starred version. When you select this option, you also have to specify a table width.
Tables sometimes look nicer when you select the use booktabs package option.
Of course, you can also Center your whole array.
Inserting bullets helps you when you want to fill in your content in the editor. With this option checked, Kile will insert bullet placeholders for each element of 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.

Inserting floating elements
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.
Inserting a floating element
Inserting a floating element
To insert a new floating environment just follow these steps:
Choose whether you want to insert a figure or a table.
Select the desired positioning rules.
Enter a caption for your floating element.
Type in a label for your new floating element. Kile will automatically suggest an appropriate prefix , ⪚ "fig:" for figures and "tab:" for tables.

Inserting Math environments
Remembering how all the different math elements work can be really annoying. Of course Kile can do the magic for you here: Wizard Math
Inserting a math element
Inserting a math element
Options:
Name: Choose the type of math element you want to create.
Without numbering: This can switch numbering off for numbered elements like equations or aligns.
Space command to separate groups: In an environment which supports several groups like alignat, you can define a space separator when you have more than one group. You can enter any space command here, which exists in mathmode, ⪚ \quad.
Standard tabulator: Select the tabulator which should be used. Kile should automatically pick the right one for you here.
Displaymath mode: For environments like matrices or arrays you can choose which math environment your mathematical text should be displayed with.
Use bullets: With this option checked, Kile will insert bullet placeholders for each element of your mathematical text.

Utilities
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 utilities and then convert it to PDF with ps2pdf.
The 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.
Dialog PSTools
Dialog PSTools
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 to view the result.
1 A5 page + empty page --> A4 	Combine one A5 page together with one empty page on one A4 page. Whenever two A5 pages are combined together, they are rotated 90 degrees and will be arranged on an A4 page in landscape mode.
A5 + empty page
A5 + empty page
1 A5 page + duplicate --> A4 	Put one A5 page and a duplicate together on one A4 page.
duplicate A5 pages
Duplicate an A5 page
2 A5 pages --> A4 	Put two consecutive A5 pages together on one A4 page.
Combine two A5 pages
Combine two A5 pages
2 A5L pages --> A4 	Put two consecutive A5 pages in landscape mode together on one A4 page.
4 A5 pages --> A4 	Combine four consecutive A5 pages together on one A4 page. The A5 pages have to be scaled with factor 0.7 to fit on the page.
4 A5 pages --> A4
4 A5 pages --> A4
1 A4 page + empty page --> A4 	Combine one A4 page together with one empty page on one A4 page. Whenever two A4 pages are combined together on one resulting A4 page, they have to be scaled with factor 0.7 and will be arranged in landscape mode.
1 A4 page + empty page --> A4
1 A4 page + empty page --> A4
1 A4 page + duplicate --> A4 	Put one A4 page and a duplicate together on one A4 page.
1 A4 page + duplicate --> A4
1 A4 page + duplicate --> A4
2 A4 pages --> A4 	Put two consecutive A4 pages together on one A4 page.
Combine two A4 pages
Combine two A4 pages
2 A4L pages --> A4 	Put two consecutive A4 pages in landscape mode together on one A4 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.
copy all pages (sorted) 	Copy all pages of a document. You have to choose the number of sorted copies.
Copy all pages (sorted)
Copy all pages (sorted)
copy all pages (unsorted) 	Copy all pages of a document. You have to choose the number of non-sorted copies.
Copy all pages (unsorted)
Copy all pages (unsorted)
pstops: choose parameter 	There are many options for utilities pstops and psselect. If you need a very special one, you can invoke pstops with an option of your choice. Please read the manual for all possible options.
psselect: choose parameter 	You can invoke psselect with an option of your choice. Please read the manual for all possible options.

PDF Utilities
Many people think of PDFs as frozen files, which cannot be modified. But this is not true, as there exist excellent tools
for manipulations and rearrangements of pages
to read and update document info
to read, set or change some permissions
of an existing PDF document.
Kile's PDF wizard under Wizard PDF Tools uses two different methods to manipulate and rearrange PDF documents:
LATEX package pdfpages, which is part of each LATEX distribution. pdfpages doesn't work with encrypted pages.
pdftk, which is an excellent command line tool for doing everyday things with PDF documents (see The PDF Toolkit).
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.
Dialog PDF Tools
Dialog PDF Tools
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 (⪚ ) 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.
A5 + empty page
A5 + empty page
Whenever two A4 pages are combined together, they are scaled, rotated by 90 degrees and arranged on an A4 page in landscape mode.
A4 + empty page --> A4
A4 + empty page
1 page + duplicate --> A4 	Put one page and a duplicate together on one A4 page.
Duplicate a page
Duplicate a page
If the page to be duplicated has A4 size, it will be scaled to fit on the page.
Duplicate a page
Duplicate a 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.
Combine two A5 pages
Combine two A5 pages
Whenever two A4 pages are combined together, they are scaled, rotated by 90 degrees and arranged on an A4 page in landscape mode.
Combine two A4 pages
Combine two A4 pages
2 pages (landscape) --> A4 	Put two consecutive pages in landscape mode together on one A4 page.
Combine two pages (in landscape mode)
Combine two pages (in landscape mode)
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 --> A4
4 pages --> A4
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.
Combine four pages (in landscape mode)
Combine four pages (in landscape mode)
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, ⪚ 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.
Dialog PDF Properties
Dialog PDF Properties
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.
Dialog PDF Permissions
Dialog PDF Permissions
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.

Document Statistics
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, LATEX 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 LATEX 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, ⪚ 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.