ktex¶
Kleag's TeX tool : compilation LaTeX complète, en une commande, pour
n'importe quel document, suivie d'un rapport d'erreurs et d'avertissements
localisés par fichier:ligne.
ktex
Cette commande :
- enchaîne les passes LaTeX (
pdflatex,xelatexoulualatex) et la bibliographie (Biber ou BibTeX), détectés automatiquement ou fixés par configuration ; - compile hors des sources, dans un répertoire temporaire propre au
document : aucun
.aux,.log,.bbl… dans l'arborescence, y compris ceux des chapitres\includes ; - remplace atomiquement le PDF final : la visionneuse ne voit jamais de PDF vide ou partiel, et un échec laisse l'ancien PDF en place ;
- supprime au préalable les
.auxtronqués par une compilation interrompue (cause de l'erreur « File ended while scanning use of… » dès\begin{document}) ; - écrit à la fin, en cas de succès comme d'échec, un
rapport qui situe chaque problème dans le bon fichier,
y compris dans les fichiers
\input/\include, et l'accompagne d'indices.
===== ERREURS (1) =====
chapitres/intro.tex:5: LaTeX Error: \begin{itemize} on input line 3 ended by \end{enumerate}.
→ \end{enumerate} ⟨ici⟩
↳ \begin{itemize} ouvert probablement en : chapitres/intro.tex:3
Avec ktex -w, ktex tient le PDF à jour : il
recompile le document chaque fois qu'un de ses fichiers sources est modifié.
Ce mode surveillance s'inspire de texbuild,
et sa façon de trouver les fichiers à surveiller (le fichier .fls écrit par
TeX), de latexmk.
ktex n'a besoin que de Python ≥ 3.11 et d'une distribution TeX (TeX Live, MiKTeX…) qui fournit les moteurs et outils voulus. Ses messages sont en français si la locale est française, en anglais sinon (voir Utilisation).