Ce manuel s'adresse à toute personne, quel que soit son niveau d'expérience avec L^AT_EX, KDE, Kile ou Linux®.

Les utilisateurs experts peuvent probablement se passer de lire ce manuel, mais toutes les suggestions sur la documentation seront prises en compte. Si vous souhaitez contribuer à ce projet ou à la documentation, veuillez consulter la page web de Kile.

Vous avez besoin de réponses à propos de Kile ? Vous êtes coincés au niveau de la compilation ? Vous voulez voir une nouvelle caractéristique implémentée ? Le moyen idéal pour poser les questions techniques ou pour démarrer une discussion est d'utiliser notre liste de discussion : (kile-devel AT lists.sourceforge.net).

Le système de composition typographique L^AT_EX est similaire à d'autres langages balisés comme XML, qui est utilisé dans beaucoup de types de documents (y compris celui que vous lisez actuellement), ou HTML, utilisé pour les pages web. L'idée générale derrière les langages balisés est d'avoir des mot clés spéciaux appelés balises, qui indiquent au programme (un traitement de texte, un navigateur web ou le compilateur L^AT_EX) comment le texte encadré par ces balises doit être interprété. Kile vous offre un grand nombre de balises dans le menu LaTeX dans la barre de menus.

Bien que nous souhaitions vous donner une bonne idée de ce qu'est L^AT_EX, ce document n'est évidemment pas le « Definitive Book on L^AT_EX ». Si vous voulez apprendre L^AT_EX en profondeur, allez emprunter un livre spécialisé à la bibliothèque.

Comme avec d'autres langages de balisage, les documents L^AT_EX contiennent un préambule, qui définit les propriétés globales, comme la taille du papier, la numérotation des pages, les dimensions du texte dans la page, et un corps, qui contient le texte du document. Le préambule est composé d'au moins la commande \documentclass. Il précède le corps du document, qui débute par la commande \begin{document}, et, comme on peut s'y attendre, et se termine par la commande \end{document}.

Si vous regardez la barre d'outils d'édition, vous noterez trois grands menus déroulants. Ils ont été conçus pour vous permettre d'ajouter rapidement certaines caractéristiques habituellement utilisées dans votre document. La première liste déroulante est utilisée pour diviser rapidement votre document en parties, chapitres, sections, et ainsi de suite. Les commandes disponibles pour ajouter des segments à votre code source L^AT_EX sont :

La liste déroulante nommée Autre est utilisée pour insérer des éléments dans votre document comme des index, des notes de bas de page et des références. Les commandes disponibles sont :

La liste déroulante Autre

Choix d'un label pour la référence

Lorsque vous utilisez cite, une liste déroulante d'éléments bibliographiques vous est présentée, mais si vous utilisez BibT_EX, ceci ne fonctionnera que si le fichier appartient au projet. Pour modifier les fichiers BibT_EX, il est recommandé d'utiliser des éditeurs spécialisés. L'auteur a de bons résultats avec KBibT_EX. Bien sûr, vous pouvez également écrire les fichiers BibT_EX à la main depuis Kile.

La dernière liste déroulante dénommée Taille est utilisée pour régler la taille du texte. Vous pouvez choisir la taille du texte principal, des notes de bas de page, etc. Les commandes disponibles sont :

Un environnement est un segment de texte qui est géré différemment du reste du document. Par exemple, vous créez un rapport avec une police de taille 12, mais vous devez modifier la taille de la police pour quelques phrases. Les commandes \begin{environment}, \huge et \end{environment} vous permettront de modifier temporairement le texte contenu entre les commandes d'environnement afin qu'il soit de taille huge.

Les changements ne sont effectifs que de \begin{environment} à \end{environment}. Il n'y a aucune limitation quant au nombre de changements que vous pouvez effectuer dans un environnement.

Vous pouvez ajouter un grand nombre de caractéristiques afin de rendre votre document plus lisible et plus accessible. Vous pouvez utiliser des polices spécifiques, le gras, l'italique, le souligné, etc. dans votre document, et ces commandes se termineront soit avec une commande \end, soit à la fin de votre environnement.

Maintenant que nous vous avons donné quelques bases sur la façon d'écrire le code en utilisant le langage L^AT_EX, nous allons vous montrer comment créer un document en utilisant Kile, pas à pas.

C'est fait ! Vous venez de créer votre premier document L^AT_EX !

Une fois que vous avez créé votre fichier DVI, vous pourrez imprimer votre document, ou le transformer en fichier PostScript® ou PDF si vous le souhaitez. Expérimentez et amusez-vous !

DVI signifie fichier DeVice Independent (indépendant du périphérique). Ces fichiers sont produits par T_EX ou L^AT_EX afin d'être lus par un pilote sur votre ordinateur. Vous pouvez envoyer un .dvi vers un grand nombre de sorties, comme une imprimante, un convertisseur vers un fichier PostScript® ou PDF, ou l'écran de votre ordinateur.

Les fonctions de recherche avant vous permettent de passer de votre éditeur directement à la position correspondante dans le fichier DVI ou PDF.

Kile offre une configuration pour cette option pour tous les exécutables L^AT_EX. Allez dans Configuration → Configurer Kile... → Outils+Compilation et choisissez toujours la configuration PDFLatTeX+ViewPDF.

Pour réaliser une recherche avant, positionnez le curseur sur la ligne du code source, et cliquez sur ForwardDVI pour aller à la position associée dans la fenêtre de l'afficheur DVI ou PDF.

La recherche inverse est une caractéristique très utile lorsque vous écrivez un document L^AT_EX vous-même. Si tout est configuré correctement, vous pouvez cliquer dans la fenêtre de Okular avec le bouton gauche de la souris tout en maintenant enfoncée la touche Maj. Après cela, Kile chargera le fichier source L^AT_EX et ira au paragraphe approprié. Pour utiliser la recherche inverse, vous devez compiler votre fichier L^AT_EX avec la configuration PDFLatTeX+ViewPDF.

La recherche inverse fonctionnera uniquement si :

Avec cette caractéristique de Okular, un clic avec le bouton gauche de la souris dans le document DVI ou PDF, tout en maintenant enfoncée la touche Maj, fera s'ouvrir Kile avec le document L^AT_EX correspondant, et tentera d'aller à la ligne correspondante. N'oubliez pas d'indiquer à Okular d'utiliser Kile comme éditeur de texte, dans l'élément de menu de Okular Configuration → Configurer Okular... (sur la page Éditeur).

Configuration de Okular

Si vous essayez d'utiliser QuickBuild, et que l'afficheur DVI ne s'ouvre pas, il est probable que vous avez une erreur. Si c'est le cas, elle sera visible dans le fichier journal ou la zone de message, et le résumé de l'erreur sera donné.

Le fichier journal explique la source de l'erreur dans votre code. Dans l'éditeur, vous pouvez utiliser les boutons de la barre d'outils nommés Erreur LaTeX précédente et Erreur LaTeX suivante pour naviguer entre les erreurs. Le fichier journal indique toujours la ligne à laquelle l'erreur s'est produite. Pour voir cette ligne, cliquez sur l'erreur dans la fenêtre du journal, et Kile vous emmènera à cette ligne.

Pour sélectionner du texte, vous disposez des options suivantes :

Maintenir le bouton gauche de la souris, puis sélectionner le texte en glissant la souris copie automatiquement le texte sélectionné dans le presse-papiers.

Maintenir enfoncée la touche Maj et utiliser les touches fléchées permet de sélectionner des portions de code source dans la fenêtre de l'éditeur.

Le complètement des parenthèses est un outil visuel utilisé par l'éditeur pour vous indiquer quelle parenthèse correspond avec telle autre. Si vous ouvrez n'importe quel fichier .tex, et sélectionnez une parenthèse (ce peut être des parenthèses (), des crochets [] ou des accolades {}), l'éditeur va colorer cette parenthèse et la parenthèse correspondante en jaune (cette couleur par défaut peut être modifiée). Ainsi, par exemple, si vous positionnez le curseur sur l'accolade dans \section{Introduction}, vous verrez \section{Introduction} avec la coloration syntaxique par défaut jaune, vous montrant l'emplacement des accolades de début et de fin.

Kile a la possibilité d'analyser et d'appliquer une coloration syntaxique pour différents types de code. Par exemple, les commandes L^AT_EX se distinguent du texte normal, les formules sont également colorées avec une couleur différente.

Plusieurs assistants peuvent insérer les puces optionnelles, une sorte de signets dans le texte. L'élément de menu Modifier → Puces ou le raccourci clavier correspondant vous permettront d'aller à la puce précédente ou suivante. Ceci mettra également cette puce en évidence de sorte qu'elle sera automatiquement supprimée lorsque vous saisirez la première lettre.

L'édition est bien sûr l'aspect principal lorsque vous utilisez un programme comme Kile. Bien que Kate dispose déjà de grandes possibilités, Kile ajoute quelques caractéristiques importantes, qui sont spécifiques à l'écriture de code source L^AT_EX. L^AT_EX utilise toujours beaucoup d'environnements et de groupes. Kile possède donc des commandes très spéciales pour les sélectionner. Dans Modifier → Sélectionner, vous trouverez les commandes suivantes pour sélectionner du texte.

texte \bfseries\itshape encore du texte

Pour supprimer des parties du document, vous pouvez bien sûr les sélectionner, et utiliser la touche Supprimer. Kate offre également la commande Ctrl+K qui supprime la ligne entière. Mais Kile propose une commande de suppression plus rapide. Dans Modifier → Supprimer, vous trouverez les commandes suivantes pour supprimer du texte.

Nous avons déjà vu que les environnements sont un point central de L^AT_EX. Kile offre quatre commandes pour faire les choses le plus simplement possible avec L^AT_EX, dans le sous-menu Modifier → Environnement.

Kile offre également quelques commandes spéciales pour les groupes L^AT_EX, qui sont caractérisés par une paire d'accolades {...}. Dans le sous-menu Modifier → Groupe TeX, vous trouverez des commandes importantes, qui correspondent à celle de Modifier → Environnement.

Dans L^AT_EX, deux guillemets simples sont utilisés comme guillemets doubles. De façon à vous aider à les insérer efficacement, Kile vous permet d'appuyer sur " pour insérer deux guillemets simples d'ouverture. De plus, si vous souhaitez fermer une citation, vous devez également appuyer sur ". Kile reconnaîtra cette situation et insérera deux guillemets fermants pour L^AT_EX.

Pour obtenir un guillemet double au sens littéral, appuyez sur " deux fois.

Vous pouvez activer ou désactiver cette insertion automatique des guillemets doubles ouvrant et fermant dans la section Configuration → Configurer Kile... → LaTeX+Général.

Si vous ajoutez également des options spécifiques à la langue ou des fichiers de style comme ngerman ou french, vous pourrez également utiliser les guillemets doubles en allemand ou en français. Beaucoup d'autres langues sont disponibles.

Si vous appuyez sur Ctrl+Entrée, Kile insère une nouvelle ligne intelligente. Si le curseur se situe dans un environnement de liste, comme enumerate ou itemize, Kile n'insérera pas simplement une nouvelle ligne, mais également une commande \item.

Si vous êtes dans un environnement tableau, Kile terminera la ligne en cours avec \\, suivi d'une nouvelle ligne.

Si vous êtes dans un commentaire L^AT_EX, Kile commencera la ligne suivante avec un %.

Encore mieux, Kile est suffisamment intelligent pour gérer les environnements L^AT_EX prédéfinis et ceux définis par l'utilisateur, qui peuvent être ajoutés dans la section Configuration → Configurer Kile... → LaTeX+Général.

Certains utilisateurs aiment arranger les colonnes dans des environnements tabular et mettre tous les caractères « et commercial » & les uns en dessous des autres. Kile tente de gérer ceci. Si vous appuyez sur Alt+Maj+&, Kile regardera la prochaine tabulation dans la ligne au dessus. Bien qu'il soit possible que la tabulation ne soit pas celle correspondante, Kile ajoutera des espaces pour ajuster la position de la colonne pour la tabulation actuelle.

Lorsque vous saisissez des caractères, vous pouvez activer ce mode de complètement pour les commandes L^AT_EX et pour les mots normaux avec Modifier → Complètement → Compléter la commande (La)TeX ou avec le raccourci clavier Ctrl+Maj+Espace. Kile lit d'abord les lettres à partir de la position actuelle du curseur vers la gauche, et s'arrête au premier caractère qui n'est pas une lettre ou au premier backslash. Si le motif commence par un backslash, Kile entrera en mode de complètement pour les commandes T_EX ou L^AT_EX. Sinon, il entrera en mode dictionnaire normal, dans lequel vous ne trouverez aucune commande L^AT_EX. En fonction du mode choisi, une boîte de complètement sera ouverte. Vous verrez toutes les commandes ou les mots dont le début correspond au motif actuel. Vous pouvez naviguer avec les touches du curseur dans cette liste et choisir un élément avec Entrée ou double-cliquer avec la souris.

Lorsque vous appuyez sur Correction, la dernière lettre de votre motif est effacée, et la liste de complètement devrait augmenter. En revanche, si vous saisissez une nouvelle lettre, le motif est étendu et les mots visibles dans la liste devraient être moins nombreux.

Si vous décidez de ne pas utiliser les suggestions de cette liste, faites-la disparaître avec Échap.

Vous verrez que toutes les commandes sont écrites avec une courte description de leurs paramètres. Ces descriptions disparaissent bien évidemment lorsque vous choisissez une commande. Vous pouvez également si vous le souhaitez laisser Kile insérer des puces à ces endroits, de façon à pouvoir y aller facilement avec Modifier → Puces → Puce suivante et insérer le paramètre souhaité.

Allez dans Configuration → Configurer Kile... → Kile+Complètement pour configurer une ou plusieurs de ces listes. Vous pouvez choisir différentes listes de mots pour les commandes T_EX et L^AT_EX, et un mode dictionnaire pour les mots normaux.

Si vous choisissez l'option Afficher les commandes LaTeX, les éléments de tous les fichiers de mots compressés cwl choisis pour le complètement des commandes L^AT_EX seront affichées dans une vue séparée de la barre latérale de Kile. Vous verrez les commandes disponibles ainsi que des paramètres et options qui doivent ou peuvent être fournies pour un complètement. Vous pouvez également simplement choisir une entrée avec un clic de souris, et elle sera insérée dans le document, avec tous les paramètres et options vidés.

Comme chaque liste de mots choisie sera affichée dans une vue séparée, il est possible qu'il y ait trop de vues, de sorte que la fenêtre principale de Kile soit plus grande que ce qu'un petit écran permet. Ceci est particulièrement laid, et Kile travaille avec un nombre maximum permis de vues, qui est réglé par défaut à 10. Si cette valeur est trop élevée pour votre écran, vous pouvez la réduire.

Le mode commande n'est pas utile pour le complètement des environnements. Vous devez toujours saisir quelques lettres de \begin, et invoquer le mode de complètement qui résulte en une longue liste de balises d'environnements. D'un autre côté, les environnements sont si souvent utilisés que Kile offre un mode spécial pour le complètement des environnements. Oubliez la balise ouvrante et écrivez par exemple al.

Lorsque vous appelez le mode de complètement avec Modifier → Complètement → Environnement ou avec le raccourci clavier Alt+Maj+Espace, la balise ouvrante est automatiquement ajoutée et vous verrez \begin{al. Après ce changement, la liste de complètement est beaucoup plus courte.

Maintenant sélectionnez un environnement, et vous verrez qu'il est également automatiquement fermé. Encore mieux, si Kile reconnaît un environnement de liste, il insérera également une balise \item.

Allez dans Configuration → Configurer Kile... → Kile+Complètement pour configurer une ou plusieurs de ces listes. Ce mode utilise les mêmes listes de mots que le mode de complètement pour les commandes T_EX et L^AT_EX.

Kile gère les listes d'abréviations définies par l'utilisateur, qui sont remplacées à la demande par une chaîne de caractères plus longue. Regardez Configuration → Configurer Kile... → Kile+Complètement pour configurer une ou plusieurs de ces listes. Pour l'exemple donné ici, la liste d'abréviations dans example.cwl doit être choisie. Vous trouverez dans ce fichier par exemple l'élément L=\LaTeX.

Par exemple, saisissez uniquement la lettre L. Maintenant appelez le mode abréviation du complètement par mot avec Modifier → Complètement → Abréviation ou le raccourci clavier Ctrl+Alt+Espace, et la lettre L sera remplacée par la chaîne \LaTeX.

Le complètement des abréviations gère aussi les nouvelles lignes %n et %C pour placer le curseur, si ces caractères sont présents dans le texte étendu. Ainsi, si vous avez l'entrée

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

dans le fichier de complètement, et si vous appelez le complètement de l'abréviation, le texte remplacé ressemblera à ce qu'il y a ci-dessous, où le x montre la position finale du curseur.

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

Les spécifications du format des fichiers de complètement se trouvent dans les spécifications du format de fichier CWL.

Les fichiers de complètement peuvent être installés dans le dossier personnel d'un utilisateur sans le sous-dossier ~/.kde/share/apps/kile/complete/<mode>/, où <mode> vaut soit abbreviation, dictionary ou tex.

La boîte de dialogue Insérer une image permet l'insertion d'images le plus simplement possible. Elle peut être obtenue par le menu LaTeX → Insertion d'image. Vous pouvez jeter un œil sur Formats de fichiers graphiques et Graphiques EPS pour un aperçu de quelques éléments fondamentaux sur les formats d'images.

Un travail particulièrement fastidieux avec L^AT_EX est l'écriture d'une matrice ou d'un environnement tableau. On doit garder un œil sur tous les éléments, s'assurer que l'environnement est bien formé, et que tout est bien là où il doit l'être. Une bonne indentation permet d'améliorer les choses, mais il y a plus simple : utiliser les éléments de menu Assistant → Tableau ou Assistant → Matrice de Kile. Vous aurez alors un formulaire de saisie en forme de matrice, que vous pouvez facilement remplir. Cette boîte de dialogue offre également des options de typographie pour le contenu du tableau.

En utilisant la barre d'outils en haut de la boîte de dialogue, vous pouvez régler l'alignement d'une cellule, définir un style de police, Fusionner et Scinder les cellules, choisir un cadre, et spécifier les couleurs du texte et de l'arrière-plan. Tout à droite se trouve un bouton Coller. Avec ce bouton, vous pouvez insérer un tableau depuis le presse-papiers dans la boîte de dialogue, ce qui vous permet de copier / coller des tableaux depuis un tableur par exemple.

Vous pouvez choisir en dessous le nombre de lignes et de colonnes, et vous pouvez améliorer d'autres éléments de votre tableau :

L'option Assistant → Tabulation affichera une boîte de dialogue plus simple pour configurer rapidement un environnement tabulation. Elle vous permet de régler facilement le nombre de lignes et de colonnes, ainsi que l'espacement nécessaire.

Kile vous aide à insérer vos éléments flottants. Avec Assistant → Flottants, il est très simple de créer un nouvel environnement figure ou tableau.

Pour insérer un nouvel environnement flottant, suivez simplement les étapes suivantes :

Se souvenir de la façon dont les différents éléments mathématiques fonctionnent peut être vraiment ennuyant. Bien sûr, Kile peut vous aider ici : Assistant → Mathématiques

Options :

Les fichiers PS ne sont pas aussi populaires que les fichiers PDF, mais sont une excellente base pour la manipulation et le réarrangement des pages. Si vous avez besoin d'une sortie PDF, vous pouvez réarranger les pages avec des utilitaires PostScript®, puis convertir en PDF avec la commande ps2pdf.

L'assistant PostScript® disponible dans le menu Assistant → Outils PostScript suggérera les réarrangements les plus populaires. La conversion est réalisée par les programmes pstops et psselect, qui se trouvent dans la plupart des distributions dans le paquet psutils. Si l'un de ces programmes n'est pas disponible, l'élément correspondant ne sera pas visible.

Choisissez d'abord votre fichier d'entrée. Si Kile trouve un fichier PS correspondant à votre document maître actuel, le fichier d'entrée sera déjà rempli, mais vous pouvez également choisir un autre fichier. Choisissez ensuite un fichier de sortie, et choisissez une des tâches. Finalement, vous devez décider si vous souhaitez réaliser la conversion uniquement, ou également invoquer Okular pour afficher le résultat.

Beaucoup de gens pensent que les fichiers PDF sont des fichiers gelés, qui ne peuvent pas être modifiés. Mais ce n'est pas vrai, car il existe d'excellents outils

d'un document PDF existant.

L'assistant PDF de Kile, dans Assistant → Outils PDF utilise deux méthodes pour manipuler et réarranger les documents PDF :

Si un de ces utilitaires, pdfpages ou pdftk, n'est pas présent dans votre système, les éléments correspondant ne seront pas visibles. De plus, rappelez-vous que seul pdftk peut fonctionner avec les fichiers chiffrés.

Réarrangements

Lorsque l'assistant PDF de Kile est appelé, il démarre avec l'outil Réarrangements.

Choisissez d'abord votre fichier d'entrée. Si Kile trouve un fichier PDF correspondant à votre document maître actuel, le fichier d'entrée sera déjà rempli, mais vous pouvez également choisir un autre fichier. Choisissez ensuite un fichier de sortie ou écrasez le ficher PDF existant, et choisissez une des tâches. Finalement, vous devez décider si vous souhaitez réaliser la conversion uniquement, ou également invoquer l'afficheur (par exemple Okular) pour afficher le document résultant.

Si le fichier PDF est chiffré, seul pdftk fonctionne et vous devez fournir le mot de passe de ce document pour exécuter les tâches.

1 page + page vide --> A4

combine une page avec une page vide sur une page A4. Si deux pages A5 sont combinées ensemble, elles sont tournées de 90 degrés et réarrangées sur une page A4 en mode paysage.

Si deux pages A4 sont combinées ensemble, elles sont mises à l'échelle, tournées de 90 degrés et réarrangées sur une page A4 en mode paysage.

1 page + copie --> A4

met une page et une copie ensemble dans une page A4.

Si la page à copier est de dimension A4, elle sera redimensionnée pour s'adapter à la page.

2 pages --> A4

combine deux pages consécutives sur une page. Si deux pages A5 sont combinées ensemble, elles sont tournées de 90 degrés et réarrangées sur une page A4 en mode paysage.

Si deux pages A4 sont combinées ensemble, elles sont mises à l'échelle, tournées de 90 degrés et réarrangées sur une page A4 en mode paysage.

2 pages (paysage) --> A4

Met deux pages consécutives en mode paysage ensemble sur une page A4.

4 pages -->A4

combine quatre pages consécutives ensemble sur une page A4. Les pages doivent être redimensionnées pour s'adapter aux dimensions de la page.

4 pages (paysage) --> A4

combine quatre pages consécutives en mode paysage sur une page A4. Les pages doivent être redimensionnées pour s'adapter aux dimensions de la page.

Sélectionner les pages paires

Sélectionne toutes les pages paires d'un document.

Sélectionner les pages impaires

Sélectionne toutes les pages impaires d'un document.

Sélectionner les pages paires (ordre inverse)

Sélectionne toutes les pages paires d'un document et inverse l'ordre.

Sélectionner les pages impaires (ordre inverse)

Sélectionne toutes les pages impaires d'un document et inverse l'ordre.

inverser toutes les pages

Inverse toutes les pages d'un document.

déchiffrer un fichier

Si le fichier PDF est chiffré, vous pouvez le déchiffrer.

Choisir les pages

Ajoutez une liste de pages séparées par des virgules, ou une plage de pages, par exemple 1,4-7,9. Seules ces pages apparaîtront dans le PDF résultant.

Supprimer des pages

Ajoutez une liste de pages séparées par des virgules, ou une plage de pages, qui seront retirées du fichier PDF choisi.

Appliquer un filigrane en arrière plan

Applique un filigrane PDF à l'arrière plan d'un fichier PDF unique. L'assistant utilise uniquement la première page du PDF pour le fond et l'applique à toutes les pages du PDF en entrée. Cette page est redimensionnée et orientée si nécessaire afin de l'adapter à la page.

appliquer une couleur d'arrière-plan

Applique une couleur d'arrière plan à toutes les pages du document actuel. Ce ne peut être fait qu'une fois car la seconde couleur sera placée derrière la première couleur, et ne sera donc plus visible.

appliquer un tampon à l'avant plan

Applique un tampon à l'avant plan en haut des pages du document PDF fourni en entrée. L'assistant n'utilise que la première page du document PDF du tampon, et l'applique à toutes les pages du PDF fourni en entrée. Cette page est redimensionnée et tournée si nécessaire pour l'ajuster à la page en entrée. Vous obtiendrez de meilleurs résultats si le tampon a un fond transparent.

pdftk : choisissez un paramètre

Vous pouvez invoquer pdftk avec l'option de votre choix. Consultez le manuel pour la liste des options possibles.

pdfpages : choisissez un paramètre

Vous pouvez invoquer pdfpages avec l'option de votre choix. Consultez le manuel pour la liste des options possibles.

Propriétés

L'ajout, la modification et la suppression des propriétés ne sont possibles que si la commande pdftk est installée, et si Kile a été compilé avec la bibliothèque libpoppler.

Les métadonnées classiques des fichiers PDF incluent le titre du document, l'auteur, le sujet, les mots clés, le créateur, le producteur et les dates de création et de dernière modification.

Permissions

L'ajout, la modification et la suppression des permissions ne sont également possibles que si la commande pdftk est installée.

Un mot de passe est nécessaire pour ajouter ou modifier ces paramètres du document. De plus, le PDF est chiffré pour verrouiller le contenu du fichier par ce mot de passe ou pour renforcer des restrictions plus laxistes imposées par l'auteur. Ainsi l'auteur peut permettre ou interdire de

• Imprimer les pages

• modifier les pages

• copier de texte et les images depuis les pages

• modifier ou ajouter des annotations

• remplir les formulaires avec des données

Modifier les permissions force toujours le chiffrement sur 128 bits de Acrobat 5 et 6, et nécessite également un mot de passe.

Mais gardez à l'esprit que le chiffrement et un mot de passe ne garantissent pas une sécurité réelle pour le PDF. Le contenu est chiffré, mais la clé est connue. Vous devriez plutôt considérer ceci comme une demande polie, mais ferme de respecter les souhaits de l'auteur.

La boîte de dialogue des statistiques dans Fichier → Statistiques vous donne un aperçu des statistiques pour une sélection, un document ou un projet entier. Elle inclut le nombre de mots, de commandes ou d'environnements L^AT_EX ainsi que le nombre de caractères de chaque type.

Les statistiques obtenues peuvent être copiées dans le presse-papiers sous forme de texte ou comme tableau L^AT_EX joliment formaté

Lorsque vous sélectionnez un texte et ouvrez la boîte de dialogue des statistiques, vous obtenez les statistiques pour le texte actuellement sélectionné. Si vous ouvrez la boîte de dialogue sans sélectionner de texte, les statistiques affichées concernent tous les fichiers ouverts. Si vous souhaitez obtenir les statistiques pour le projet entier, vous pouvez utiliser Projet → Ouvrir tous les fichiers du projet pour ouvrir facilement et rapidement tous les fichiers sources de votre projet.

Une note d'avertissement doit cependant être faite concernant l'exactitude des nombres. Nous avons ajouté de la logique pour obtenir une bonne estimation, par exemple K\"uhler donne un mot et une commande, avec respectivement six et deux caractères. Mais il y a d'autres combinaisons dans lesquelles des parties de commandes sont comptées comme des mots et vice-versa. Notez que l'algorithme a été testé pour des langues similaires à l'anglais ou l'allemand. Ne prenez pas ces chiffres pour argent comptant. Si vous devez faire un rapport avec un nombre de mot ou de caractères exact, faites des tests pour vérifier si l'exactitude de Kile est satisfaisante pour vos besoins.

\bibitem est une commande utilisée pour saisir une référence dans un environnement thebibliography dans votre document. La syntaxe pour utiliser \bibitem est \bibitem[label]{key}.

L'option [label] vous permet d'ajouter votre propre système de labels pour les éléments de la bibliographie. Si aucun label n'est défini, les éléments apparaîtront dans l'ordre numérique : [1], [2], [3], etc.

L'argument {key} est utilisé pour référencer et lier les commandes \bibitem et \cite ainsi que les informations qu'elles contiennent. La commande \cite contient le label associé avec le futur \bibitem, qui se trouve dans un environnement thebibliography, et contient les données de la référence. Deux \bibitem et \cite correspondant doivent avoir la même {key} ; le moyen le plus simple d'organiser les clés est d'utiliser le nom de l'auteur. Les secondes accolades dans l'environnement thebibliography correspond au label bibliographique le plus long que vous comptez utiliser. Ainsi, en insérant {machin}, cela signifie que tous vos labels sont plus court ou égaux à l'expression machin. Si ce paramètre est mal réglé, l'indentation dans la bibliographie ne sera pas très esthétique.

La bibliographie est une section séparée de votre document principal, et un exemple de code pour la bibliographie ressemblerait à quelque chose comme ceci :

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

Ainsi, votre code source principal contiendra l'emplacement des informations liées aux \bibitem en utilisant \cite. Ce code source ressemble à :

Ma thèse, sur la philosophie des Simpsons\copyright est inspirée de mon livre favori \cite{Simpson}.

Comme il est souvent difficile de se souvenir des clés de citation exactes lorsque vous avez de nombreuses références, Kile fournit un moyen facile d'insérer une citation. En utilisant LaTeX → Références → Cite, une liste de toutes les clés de citation s'affichera : choisissez la référence correcte et une citation sera insérée dans votre document. Pour mettre à jour la liste des clés, soit enregistrez le fichier, ou choisissez Modifier → Rafraîchir la structure ou appuyez sur F12. Si le complètement automatique est activé, Kile vous affichera la liste de toutes les étiquettes bibitem dès que vous ouvrez une commande \cite.

Le résultat dans la bibliographie de votre document devrait ressembler à quelque chose comme :

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

Kile peut également travailler avec les éditeurs BibT_EX, comme KBibT_EX, afin de faciliter la saisie des citations. Lorsqu'un fichier BibT_EX est ajouté au projet, Kile vous aidera à insérer la commande de citation, comme décrit ci-dessus.

Vous pouvez créer de nouveaux menus ou en modifier en utilisant un assistant de configuration de menu utilisateur confortable depuis Assistant → Modifier le menu utilisateur.

Sur la gauche, vous verrez une arborescence de menu. Tout comme dans un menu standand, trois types différents d'éléments de menu sont disponibles :

Pour modifier ce menu, utilisez les six boutons sur le côté gauche. Des actions supplémentaires sont disponibles dans le menu contextuel des éléments de menu déjà existant.

Chaque élément de menu standard est assigné à une action parmi trois types possibles, où chacun d'eux dispose d'attributs différents qui peuvent être réglés :

Si une information importante pour une action est manquante, les éléments de menu sont colorés en rouge. Ce peut être par exemple in fichier inexistant.

ou un titre manquant pour l'entrée de menu, qui sera alors affichée avec des points d'interrogation comme ???.

Si vous ouvrez le menu contextuel d'un tel élément de menu coloré en rouge, vous aurez une option supplémentaire pour obtenir des informations concernant l'erreur.

D'autres informations sont également disponibles en utilisant le bouton Qu'est-ce que c'est  ? de la plupart des éléments graphiques.

La plupart des entrées de menu disposent de paramètres supplémentaires explicites, qui peuvent être cochés. Si certains de ces paramètres ne sont pas disponibles pour certaines actions, ils sont désactivés.

Voici un exemple pour exécuter un programme externe :

Vous pouvez voir qu'un script perl est appelé, ce qui ne devrait pas fonctionner avec la sérection actuelle. Le paramètre Nécessite du texte sélectionné est coché pour s'assurer qu'il y a une sélection. La sortie de ce script sera insérée (Insérer la sortie du programme choisi) et remplacera la sélection actuelle (Remplacé le texte sélectionné), mais ne sera pas elle-même sélectionnée.

Bien sûr, vous pouvez également appeler vos propres programmes et scripts. Par exemple, vous choisissez une liste de nombres, séparés par des espaces, puis appelez un script ou un programme en Perl, qui transforme cette sélection en code L^AT_EX pour une matrice. Quel que soit ce que vous avez en tête, vous pouvez le réaliser en utilisant les entrées de menu utilisateur suivantes.

Vous pouvez installer différents menus à chaud pour différentes tâches. Lorsque vous appelez l'assistant de menu utilisateur, le fichier de définition du menu actuel est chargé. Si vous le modifiez et fermez la boîte de dialogue avec Ok, vos modifications seront enregistrées et installées comme le nouveau menu utilisateur. Fermer la boîte de dialogue avec Annuler annulera tous les changements.

Vous êtes également libre d'enregistrer le fichier modifié dans le dossier des menus utilisateurs ou de charger un autre fichier de définition de menu et de l'installer. Tous les fichiers de définition de menu doivent être enregistrés dans le dossier des menus utilisateurs local de Kile : KILE_APP_DIR/usermenu/.

Regardez le fichier de définition de menu d'exemple example.xml pour voir davantage d'entrées de menu et leurs paramètres.

Vous aurez toujours besoin de voir le résultat lorsque vous travaillez avec L^AT_EX. L^AT_EX doit compiler le source, et l'afficheur doit ensuite être appelé. Ceci peut être ennuyant si vous n'avez modifié que quelques lettres dans une équation difficile à saisir. Kile offre un mode Prévisualisation rapide, dans lequel vous pouvez ne compiler qu'une partie du document et gagner ainsi beaucoup de temps. Il gère quatre modes différents, qui peuvent être combinés avec sept configurations.

Tous les réglages doivent être faits dans Configuration → Configurer Kile... → Outils+Prévisualisation.

Les fichiers graphiques EPS sont le moyen traditionnel d'insérer des fichiers graphiques dans des documents L^AT_EX. Comme les listes de discussions sont pleines de questions concernant les graphiques EPS, vous discuterons des aspects importants et montreront comment Kile les gère.

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

En définissant votre document comme document maître, vous pouvez travailler avec des fichiers séparés, ce qui vous donne un document parent (ou un document maître), et des documents enfants. Après avoir défini votre document maître, avec la commande correspondante dans le menu Configuration, toutes les commandes du menu Outils ne s'appliqueront qu'à ce document, même si vous travaillez sur les documents enfants. Vous pouvez même fermer le document maître.

Après avoir compilé quelque chose, Kile jette un œil aux messages d'erreur qui ont été générés. S'il y a des erreurs ou des alertes, elles seront reportées brièvement dans la fenêtre Journal et messages. On peut regarder de plus près les messages en choisissant Compilation → Voir le fichier du journal, ou en utilisant le raccourci clavier Alt+0. Le fichier journal généré est alors affiché dans la fenêtre Journal et messages, les erreurs et les alertes sont surlignées.

Affichage du journal

Vous pouvez facilement passer d'un message du journal à un autre en utilisant les éléments de menu Compilation → Erreur / avertissement LaTeX suivant / précédent, ou en utilisant les boutons de la barre d'outils correspondant.

Pour aller à la ligne du code source L^AT_EX où l'erreur ou l'avertissement s'est produit, cliquez sur l'erreur ou l'avertissement dans la fenêtre Journal et messages. Kile vous emmènera automatiquement à la ligne en question.

Lorsque vous lancez la commande QuickBuild, un afficheur est normalement appelé après la compilation. Si vous n'utilisez pas d'afficheur intégré, une nouvelle fenêtre s'affichera à chaque fois.

Si vous ajustez l'apparence de votre document, vous lancez probablement très souvent QuickBuild, et aurez par conséquent beaucoup de fenêtres ouvertes sur votre bureau. Pour éviter la confusion, vous pouvez activer le mode surveillance fichier, qui empêchera QuickBuild de lancer un afficheur.

Ce mode est bien sûr inutile avec les afficheurs intégrés, puisque vous devez les fermer de toutes façons pour revenir à l'édition du document pour recompiler.

Les signets font référence à un segment de texte ou une ligne dans l'environnement de Kile. Pour utiliser un signet, choisissez une ligne spécifique dans votre document à laquelle vous voudrez retourner, et appuyez sur Ctrl+B, et Kile ajoutera un signet pour cette ligne. Vous pouvez également placer un signet en surlignant une ligne et en choisissant le menu étiqueté Signets → Définir un signet.

Pour enlever tous vos signets, choisissez Signets → Effacer tous les signets.

Pour créer un projet, choisissez Projet → Nouveau projet....

On vous demandera de donner les informations suivantes pour créer votre projet :

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

Pour ajouter un fichier à votre projet, ouvrez un fichier T_EX, 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

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.

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 :