Kile

Kile est un LaTeX IDE mature développé par le projet KDE. Il est basé sur Qt et destiné principalement à Linux, bien qu'il fonctionne également sur d'autres systèmes d'exploitation. Comme d'autres éditeurs, il gère une distribution TeX que vous installez séparément, mais le caractère de Kile réside dans ses projets, une vue structurelle qui vous permet d'examiner un document, un ensemble d'assistants et une intégration approfondie avec le bureau KDE. Cette page se concentre sur deux choses : le fonctionnement de son mécanisme de build (la partie sur laquelle les gens restent bloqués) et l'intégration KDE qui l'enracine dans le monde Linux/KDE.

Qu'est-ce que Kile

Kile est un éditeur LaTeX dédié écrit en C++, construit sur KDE Frameworks et Qt. Il offre la coloration syntaxique, la saisie semi-automatique des commandes, l'insertion rapide de symboles et de balises, l'insertion ponctuelle d'environnements tels que \begin…\end et QuickPreview pour un essai d'impression d'une seule sélection. Le nom est norvégien pour « coin » ou « chatouiller », et ses auteurs insistent sur le fait qu'il ne se prononce pas « Kyle » mais plus près de /kiːlə/.

Comme la plupart des éditeurs, Kile ne regroupe pas LaTeX lui-même : la compilation fonctionne en ayant les commandes de lancement de Kile déjà installées sur votre système : pdflatex, uplatex, latexmk, etc. L'ordre d'installation est donc important : installez d'abord une distribution TeX (sur Linux, TeX Live est le choix habituel), puis Kile. Une fois qu'une configuration de travail est en place (par exemple TeX Live 2026), il ne reste plus qu'à Kile de configurer la manière dont il construit votre document.

Une unité distinctive est le projet. Regroupez un document multi-fichiers (plusieurs fichiers .tex) dans un seul projet, et Kile se souvient quel fichier est le document maître (le parent qui contient \documentclass). Appuyez sur F5 lorsqu'un fichier enfant est ouvert et que la construction démarre toujours à partir du fichier principal, de sorte que les thèses et les livres divisés en fichiers par chapitre ne perdent jamais pied. Au sein d'un projet, la complétion de \ref et \cite fonctionne également sur tous les fichiers à la fois.

Construire

La version de Kile est organisée autour de l'idée des Outils. Chaque élément – ​​pdflatex, dvipdfmx, le visualiseur PDF – est un « outil » et les menus les trient par objectif dans Construire → Compiler, Construire → Convertir et Construire → Afficher. Ce qu'est réellement chaque outil (la commande qu'il appelle et ses arguments) est entièrement spécifié sous Settings ▸ Configurer Kile ▸ Outils ▸ Construire.

Par exemple, l'outil PDFLaTeX est configuré avec la commande pdflatex et des options comme celles-ci. %source est l'espace réservé de Kile, étendu au fichier en cours de traitement ; inclure -synctex=1 est ce qui permet la recherche avant/inverse (SyncTeX) décrite ci-dessous.

-interaction=nonstopmode -synctex=1 %source

En plus de cela, la pièce maîtresse de Kile est QuickBuild. Il ne s'agit pas d'un seul outil mais d'une chaîne d'outils appelés en séquence, liés à un seul bouton. Attribuez la chaîne « LaTeX → DVItoPDF → ViewPDF » à QuickBuild, par exemple, et une seule pression exécute toute la séquence : compilez, convertissez le DVI en PDF, puis ouvrez-le dans la visionneuse. Le contenu de la chaîne est librement réorganisé dans le même écran de configuration, afin que vous puissiez créer un flux de travail en une seule pression adapté à votre document.

Kile détecte également automatiquement si des outils supplémentaires sont nécessaires — bibliographie (BibTeX), index (makeindex), Asymptote — et les exécute lorsque c'est le cas (ce comportement est activé dans l'onglet Général des outils LaTeX/PDFLaTeX dans l'écran de configuration). Néanmoins, pour que les décomptes de réexécutions et les dépendances soient gérés de manière plus approfondie, une solution courante consiste à ajouter latexmk comme outil : créez un nouvel outil avec la commande latexmk et les options ci-dessous.

-pdf -synctex=1 -interaction=nonstopmode %source

Configurer un outil pour le japonais

La norme de longue date pour le japonais est la combinaison upLaTeX + dvipdfmx. Dans Kile, vous préparez deux outils. Tout d’abord, dans l’outil LaTeX-family, définissez la commande sur uplatex avec les options ci-dessous.

-synctex=1 -interaction=nonstopmode %source

Ensuite, définissez l'outil DVItoPDF — qui transforme le DVI en PDF — sur la commande dvipdfmx avec les options %S.dvi (%S est le nom de base sans extension). Enfin, enchaînez-les dans QuickBuild sous la forme « LaTeX → DVItoPDF → ViewPDF » et les documents japonais sont créés d'une simple pression sur F5. Pour être complet, pointez les outils de bibliographie et d'index vers les upbibtex et upmendex compatibles avec le japonais.

L'arrangement le plus propre consiste à décrire la combinaison de moteurs dans un .latexmkrc et à réduire le côté Kile à un seul outil qui appelle latexmk. Placez le fichier suivant dans le même dossier que votre .tex, et latexmk s'occupe du flux upLaTeX → dvipdfmx, de la bibliographie, de l'index et du nombre de réexécutions. L'avantage : le même résultat que ce soit invoqué depuis Kile, la ligne de commande ou un autre éditeur, avec la configuration rassemblée en un seul endroit.

$latex = 'uplatex %O -synctex=1 -interaction=nonstopmode %S';
$bibtex = 'upbibtex %O %B';
$makeindex = 'upmendex %O -o %D %S';
$dvipdf = 'dvipdfmx %O -o %D %S';
$pdf_mode = 3;

Ici, $pdf_mode = 3 sélectionne le mode « créer un DVI, puis le transformer en PDF avec $dvipdf ». Les jetons %O (options supplémentaires), %S (le fichier source), %B (le nom de base sans extension) et %D (la cible de sortie) sont les espaces réservés de latexmk — notez qu'ils appartiennent à latexmk et sont distincts des %source et %S que vous utilisez dans Paramètres de l'outil Kile.

Intégration KDE et Okular

Kile est profondément ancré dans les conventions du bureau KDE. Sa base est KDE Frameworks : l'endroit où les paramètres sont stockés et leur apparence (thème, icônes) sont directement pilotés par la machinerie de KDE. La clé de voûte est une technologie appelée KParts — le mécanisme de KDE permettant d'intégrer le composant d'une application (une visionneuse ou une fonctionnalité d'édition) dans son intégralité dans une autre. Kile l'utilise pour amener un visualiseur externe PDF directement dans sa propre fenêtre.

Le composant qu'il intègre est la visionneuse de documents standard de KDE, Okular. Étant donné que Okular prend en charge SyncTeX, il peut mapper les lignes source aux positions dans le PDF et inversement. Cela vous donne une recherche avant — passer de la ligne sur laquelle vous vous trouvez dans l'éditeur à l'endroit correspondant dans le PDF — et une recherche inverse, passer d'un endroit du PDF à la ligne source. Pour activer la recherche avant, définissez l'outil d'affichage (Okular) sur la commande okular avec des options telles que --unique %absolute_target (%absolute_target se développe jusqu'au chemin absolu de la sortie PDF).

La recherche inverse est configurée du côté de Okular : définissez « l'éditeur » de Okular sur Kile avec la commande de lancement kile --line %l, et un clic Maj dans le PDF revient à la ligne correspondante dans Kile. Créez une chaîne QuickBuild telle que « LaTeX → DVItoPDF → ForwardPDF » et Okular ouvre la page au niveau de votre curseur à chaque compilation. Cette interaction bidirectionnelle semble transparente précisément parce que KParts les fait partager une seule fenêtre.

Kile cible d'abord Linux/KDE, mais comme Qt et les bibliothèques KDE sont portées ailleurs, il fonctionne également sur macOS, BSD et Windows (la version Windows est même distribuée via le Microsoft Store). Pourtant, il se sent plus à l'aise sur un bureau Linux, où le couplage Okular et l'unité avec les paramètres de KDE portent leurs fruits.

La décision QuickBuild dans Kile

Le premier jour avec Kile, la décision importante n'est pas de savoir quel bouton fait quoi mais quel F5 doit exécuter. Pour les documents principalement en anglais, choisissez PDFLaTeX → ViewPDF ; pour le travail en japonais upLaTeX, choisissez LaTeX(uplatex) → DVItoPDF → ViewPDF ; si la bibliographie et les index doivent être fiables, faites appel à QuickBuild uniquement à latexmk. Prendre cette décision QuickBuild tôt permet à un projet de continuer à compiler le document maître même lorsque vous ajoutez ultérieurement des fichiers de chapitre.

Une fois les paramètres réglés, enregistrez un petit main.tex en tant que projet et confirmez que F5 à partir d'un fichier enfant crée toujours le maître. Lorsqu'une erreur apparaît, lisez .log via Afficher le fichier journal et Erreur suivante, puis assurez-vous que la recherche avant Okular fonctionne. Cette boucle complète est la préparation qui permet à un projet Kile de continuer à croître chapitre par chapitre.