Projets

Travailler avec les projets
Dans Kile, vous pouvez créer et travailler avec des projets. Un projet est un groupe de fichiers LATEX, images, BibTEX, ou autre fichier qui contient toutes les informations utilisées pour construire votre document complet. Un projet typique serait un document consistant en plusieurs chapitres, écrits dans différents fichiers .tex. Tous peuvent être inclus dans un projet, afin de faciliter la gestion du document entier. Les spécifications du projet sont placées dans un fichier spécifique, avec l'extension .kilepr.
Un projet ajoute les fonctionnalités suivantes :
vous n'avez pas à définir de document maître, Kile le fait automatiquement,
les fichiers du projet peuvent être facilement archivés ensemble depuis Projet Archiver,
l'affichage Fichiers et projets montre quels fichiers sont inclus dans le projet,
après avoir ouvert un projet, tout fichier qui avait été précédemment ouvert sera restauré avec l'encodage et la coloration syntaxique d'origine,
le complètement du code fonctionne dans tous les fichiers du projet,
le complètement des références fonctionne dans tous les fichiers du projet,
le complètement des citations fonctionne dans tous les fichiers du projet,
il est possible de chercher du texte dans tous le projet,
il est possible de spécifier des commandes de compilation et makeidx personnalisées.
Vous pouvez trouver toutes les commandes relatives dans le menu Projets. D'ici, vous pouvez ouvrir, fermer et gérer vos projets.

Créer un projet
Pour créer un projet, choisissez Projet Nouveau projet....
Fenêtre de création d'un projet
Fenêtre de création d'un projet
On vous demandera de donner les informations suivantes pour créer votre projet :
le titre du projet (champ texte Titre du projet),
Le titre du projet sera utilisé pour créer le nom du fichier projet en le passant en minuscules et en ajoutant l'extension .kilepr,
un dossier dans lequel les fichiers du projet seront stockés (champ texte Dossier du projet),
Si vous souhaitez créer un nouveau fichier principal pour le projet, cochez l'élément Créer un nouveau fichier et l'ajouter au projet).
Lorsque vous remplissez la boîte nom de fichier, vous devez inclure un emplacement relatif depuis lequel le fichier de projet .kilepr est stocké (voir l'élément Dossier du projet).
Le type du fichier créé, Fichier vide, Article, Book, Letter, Report, peut être choisi dans la liste d'icônes en bas du panneau Fichier.
Les extensions pour les fichiers par défaut dans le projet peuvent être choisies en utilisant le panneau Extensions. Votre choix sera utilisé pour définir les fichiers qui doivent être ouverts lorsque vous choisissez l'élément de menu Projet Ouvrir tous les fichiers du projet, ainsi que dans les assistants de Kile. Les extensions dans la zone de texte doivent être séparées par des espaces.

L'affichage Fichiers et projets
L'affichage Fichiers et projets est un bouton de la barre latérale. Depuis cet affichage, vous pouvez voir la structure de votre projet, ses fichiers, et le nom du fichier .kilepr qui contient les informations sur le projet. L'ajout, la suppression ou la modification des options dans votre projet sont faits via l'affichage Fichiers et projets.
L'affichage fichiers et projets
L'affichage fichiers et projets
L'affichage fichiers et projets

Ajouter et enlever des fichiers
Pour ajouter un fichier à votre projet, ouvrez un fichier TEX, faites un clic droit sur son nom dans l'affichage Fichiers et projets, et choisissez Ajouter au projet. Si vous avez ouvert plusieurs projets, une boîte de dialogue apparaîtra, dans laquelle vous pouvez spécifier le projet auquel le fichier doit être ajouté.
Vous pouvez également cliquer avec le bouton droit de la souris sur le nom du projet dans l'affichage Fichiers et projets..., et choisir Ajouter des fichiers... afin de faire apparaître la boîte de dialogue de sélection de fichiers.
Ajout d'un fichier à un projet
Ajout d'un fichier à un projet
Ajout d'un fichier à un projet
Pour supprimer un fichier d'un projet, cliquez dessus avec le bouton droit de la souris et choisissez Retirer du projet. Ceci ne supprime pas le fichier, mais le retire simplement de la liste des fichiers contenus dans le fichier .kilepr.

Archivage de votre projet
Kile vous permet d'archiver facilement votre projet en enregistrant tous ses fichiers dans une archive unique (souvent connue sous le nom de tarball). Pour archiver votre projet, cliquez avec le bouton droit de la souris sur son nom dans l'affichage Fichiers et projets, ou choisissez Projet Archiver.
Par défaut, tous les fichiers du projet sont ajoutés à l'archive. Si vous ne souhaitez pas inclure certains fichiers à l'archive, cliquez avec le bouton droit de la souris sur l'affichage Fichiers et projets et décochez l'option Inclure dans l'archive.
L'opération d'archivage est actuellement réalisée en exécutant la commande tar depuis le dossier du projet (là où est situé le fichier .kilepr).

Options du projet
Kile dispose de quelques options liées à votre projet. Pour les modifier, cliquez avec le bouton droit de la souris sur le titre de votre projet, et choisissez Options du projet, et vous pourrez modifier :
le titre du projet,
Extensions par défaut des fichiers,
le document maître,
la commande de compilation rapide,
les options de génération de l'index (makeidx).

Fermer un projet
Pour fermer un projet, choisissez l'affichage Fichiers et projets depuis la barre d'outils verticale, cliquez avec le bouton droit de la souris sur le titre du projet, et ensuite choisissez Fermer. Ceci fermera le votre projet, tous les fichiers qui lui sont associés, et ajoutera le nom du projet que vous venez de fermer dans Projets récemment ouverts... dans le menu Projet.