Projects

Working with Projects
In Kile you can create and work with projects. A project is a group of LATEX, graphic, BibTEX, or other files that contain all the information that is used to build your complete document. A typical project would be a document consisting of several chapters, written in different .tex files; all of them could be included in a project, to make the whole document easier to manage. The specifications of the project are stored in a special file, with extension .kilepr.
A Project adds the following functionalities:
You need not set a master document, Kile does this automatically.
Project files can easily be archived together by going to Project Archive
The Files and Projects view shows which files are included in the project.
After opening a project, any file that was previously opened will be restored with the original encoding and highlighting.
Code completion works across all project files.
Reference completion works across all project files.
Citation completion works across all project files.
Search in all project files.
Specify custom quickbuild and makeidx command.
You can find all project related commands in the Project-menu. From there you can open, close and manage your projects.

Creating a Project
To create a project, select Project New Project....
Project creation window
Project creation window
You will be asked to give the following information to create your project:
Title of your project (Project title text field).
The title of the project will be used to create a name of the project file by transforming to lowercase and adding .kilepr extension.
A folder where the project file will be stored (Project folder text field).
If you want to create a new main file of the project check the Create a new file and add it to this project item.
When you fill out the Filename box, you have to include a relative path from where the .kilepr project file is stored (see the Project folder item).
Type of the created file, Empty File, Article, Book, Letter, Report, can be chosen from a visual list at the bottom of the File panel.
Extensions for the default files in the project can be selected using the Extensions panel. Your choice will be used to define the files that should be opened when you choose Project Open All Project Files menu item and in the Kile wizards. The extensions in the text field should be separated with spaces.

The Files and Projects View
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
The Files and Projects View
The Files and Projects View

Adding and Removing Files
To add a file to your project, open any TEX 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
Adding a file to a project
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.

Archiving your Project
Kile allows you to easily backup your project by storing all its files into a single archive (often known as a tarball). To archive your project, right-click on its name in the Files and Projects view, or select Project Archive.
By default, all files in a project are added to the archive. If you do not want to include a certain file in the archive, right-click on it in the Files and Projects view, and uncheck the Include in Archive option.
The archive operation is currently realized by executing the tar from the project folder (where the .kilepr file is located).

Project Options
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:
The title of your project.
Default file extensions.
The Master document.
The Quickbuild command.
The makeidx options.

Closing a Project
To close a project, select the Files and Projects view from the vertical toolbar, right click on your project title, and then select Close. This will close your project, all the files associated with your project, and will also add the name of the project you just closed to Open Recent Project... in the Project menu.