LaTeX

• Objet : Utiliser LaTeX
• Commentaires : créer un document sous LaTeX
• Suivi :
  • Création par smolski le 29/10/2017
  • Reprise du chantier par Philou92 le 14/06/23
• Membres :
  • smolski (Coordinateur)
  • Philou92 (Adepte du LaTeX)
• Commentaires sur le forum : https://debian-facile.org/viewtopic.php?pid=398772#p398772¹⁾

Ce tuto n’a pas pour ambition de vous apprendre à utiliser LaTeX. Il existe pour cela pléthore d’excellentes documentations, livres, et vidéo qui plus est en langue française. Vous en trouverez une liste à la section « Liens utiles » https://debian-facile.org/projets:tuto-latex#liens-utiles.

Ce que vous trouverez ici :

• comment installer LaTeX sur votre debian,
• des listes d’éditeurs de texte et de visionneur pdf que vous pourrez installer pour travailler efficacement.

N’hésitez pas à amender ces listes.

Il y a deux manières d’installer LaTeX sur votre machine debian. La première en installant les paquets ad-hoc de la distribution debian et une autre en téléchargeant et installant directement la distribution texlive. Chacune ont leur avantages et leurs inconvénients à connaître.

Aussi deux options d’installation s’offrent à vous :

Pour l’installation suivre le wiki debian là : https://wiki.debian.org/fr/Latex. Il est recommandé d’installer à minima les paquets texlive et texlive-lang-french

* Testez le fonctionnement de votre installation. Placez-vous dans un répertoire temporaire et éditer le code LaTeX suivant dans un fichier nommé essai.tex :

essai.tex

\documentclass[french]{article}%
\usepackage[utf8]{inputenc}%
\usepackage[T1]{fontenc}%
\usepackage{babel}
\begin{document}
{\LARGE\centering%
Oh joie intense ma texlive brille de mille feux !
}
\end{document}

• Enregistrer et fermer et le fichier puis compiler en pdf avec la commande :

  pdflatex essai.tex

• Vérifier que le fichier essai.pdf a été produit correctement

L’installation de texlive dite à la vanille va se dérouler en deux étapes :

1. installation de la distribution. Il est recommandé de lire et suivre le guide d’installation consultable à cette adresse : https://www.tug.org/texlive/doc/texlive-fr/texlive-fr.html
2. création d’un paquet factice debian (.deb) pour faire croire à votre distribution que texlive est installé.

Cette étape nécessite une bonne connexion réseau (entre 1,5 et 2Go de téléchargement). L’ensemble des actions d’administration cités ci-dessous se font en ligne de commande dans un terminal. Vous avez évidemment les droits d’administration sur la machine cible.

• Réf 3.1 : télécharger, dans un répertoire temporaire (ex. /home/<USER>/chemin/temp/), le programme d’installation sur la page https://tug.org/texlive/acquire-netinstall.html dont le lien s’intitule install-tl-unx.tar.gz puis désarchivez à l’aide de la commande :

  tar -xzf install-t-unx.tar.gz

• Cela crée le répertoire install-tl-AAAAMMJJ ou AAAA représente l’année, MM le mois et JJ le jour du téléchargement. Lire le contenu du répertoire :

  ls -al install-tl-AAAAMMJJ

  . Il contient entre autres un fichier exécutable install-tl

• Réf 3.1.1 : éxécutez le programme install-tl à l’aide de la commande :

  /home/<USER>/chemin/temp/install-tl

• Réf 3.2 : les options d’installations s’affichent
• Réf 3.2.1 : normalement l’exécutable a détecté le type de votre plateforme. Si ce n’est pas le cas modifiez le.
• Réf 3.2.2 : choisir ce qui va être installé (écran select schemes). Si vous ne savez pas quoi choisir, je conseille l’option medium scheme (small + more packages and languages)
• suit ensuite le choix des collections : un choix est déjà sélectionné en fonction de l’option précédente. Ce menu vous permet d’affiner les choix d’installation. Par exemple vous pouvez ajouter ou supprimer des langues. Ex. de choix essentiels pour démarrer confortablement: a - Essential programmes and files, b - BibTeX additional styles, c - Tex auxiliary programs, f - Recommended fonts, g - Graphics and font utilities, t - French, D - Latex fundamental packages, X - MetaPost and Metafont packages. Sachez que vous pourrez toujours amender cette liste après l’installation.
• Réf 3.2.3 : choisir un répertoire d’installation. Par défaut le répertoire sera, en 2023, /usr/local/texlive/2023. Rien ne vous empêche de choisir un autre emplacement. Pour la suite on considérera que vous avez choisi le répertoire par défaut.
• ne rien modifier dans l’écran suivant : Options customizations
• Procéder à l’installation (choix I) puis attendre le chargement des paquets texlive. Cela peut être long (environ 1,5Go avec les options d’installation proposées)…
• Réf 3.4.1 Il faut maintenant modifier quelques variables d’environnement de votre compte utilisateur en éditant le fichier .bashrc et ajoutant à la fin les trois lignes suivantes :

  /home/USER/.bashrc

  PATH=/usr/local/texlive/2023/bin/x86_64-linux:$PATH; export PATH 
  MANPATH=/usr/local/texlive/2023/texmf-dist/doc/man:$MANPATH; export MANPATH 
  INFOPATH=/usr/local/texlive/2023/texmf-dist/doc/info:$INFOPATH; export INFOPATH

  Faites de même pour le fichier .bashrc du compte root en ajoutant la ligne :

  /root/.bashrc

  PATH=/usr/local/texlive/2023/bin/x86_64-linux:$PATH; export PATH 

• Testez le fonctionnement de votre installation. Placez-vous dans votre répertoire temporaire et éditer le code LaTeX suivant dans un fichier nommé essai.tex :

  essai.tex

  \documentclass[french]{article}%
  \usepackage[utf8]{inputenc}%
  \usepackage[T1]{fontenc}%
  \usepackage{babel}
  \begin{document}
  {\LARGE\centering%
  Oh joie intense ma texlive brille de mille feux !
  }
  \end{document}

• Enregistrer et fermer et le fichier puis compiler en pdf avec la commande :

  pdflatex essai.tex

• Vérifier que le fichier essai.pdf a été produit correctement
• Exécuter les deux commandes tlmgr⁷⁾ suivantes :

  tlmgr info schemes

  et

  tlmgr info collections

  Elles retournent un résumé de votre installation texlive (préfixe i=installé).

• Vérifier que tlmgr fonctionne également avec le compte root

  tlmgr info schemes

• Si tout fonctionne passer à l’étape suivante.

• Installer les paquets debian tex-common et texinfo :

• apt update && apt install tex-common

  apt install texinfo

• Ajouter à la variable d’environnement ENV_PATH du fichier /etc/login.defs le chemin /usr/local/texlive/2023/bin. La ligne devrait ressembler à cela :

  extrait /etc/login.defs

  ...
  ENV_PATH   PATH=/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games:/usr/local/texlive/2023/bin
  ...

• Inutile d’installer le paquet lmodern puisqu’il est fourni par la distribution texlive.
• Installer le paquet equivs (216Mo) :

  apt install equivs

• Créer un répertoire temporaire de travail dans votre home :

  cd && mkdir -p /tmp/tl-equivs && cd /tmp/tl-equivs

• Créer un modèle de fichier de configuration equivs nommé texlive-local en exécutant la commande :

  equivs-control texlive-local

• Éditer le fichier texlive-local, remplacer son contenu par celui du lien https://tug.org/texlive/files/debian-equivs-2022-ex.txt. Pour bien marquer que c’est vous qui êtes à l’origine du paquet renseigner votre nom et adresse mail à la ligne Maintainer :

  texlive-local

  ...
  Maintainer: you <you@yourdomain.example.org>
  ...

• Supprimer la ligne « Depends: freeglut3 » et enregistrer le fichier

  extrait texlive-local

   ...
   texlive-pstricks, texlive-pstricks-doc, texlive-publishers,
   texlive-publishers-doc, texlive-science, texlive-science-doc, texlive-xetex,
   thailatex, tipa, tipa-doc, xindy, xindy-rules, xmltex, asymptote, texinfo
  Depends: freeglut3 <--**** ligne à supprimer ***************************
  Architecture: all
  Description: My local installation of TeX Live 2022.
   A full "vanilla" TeX Live 2022

• Pour créer le paquet factice exécuter la commande :

  equivs-build texlive-local

  cela va créer le fichier texlive-local_2022.99999999-1_all.deb

• Ensuite installer le paquet factice :

  dpkg -i /home/<USER>/tmp/tl-equivs/texlive-local_2022.99999999-1_all.deb

• C’est fini. Votre distribution debian est maintenant persuadée que l’ensemble des paquets debian texlive sont déjà installés. Les paquets qui en dépendent sont leurrés et n’installeront automatiquement aucun paquet texlive debian.
• Il est recommandé de redémarrer votre machine.

Cette section sera mise à jour lors de la prochaine version de debian prévue… quand elle sera prête.

N’importe quel éditeur de texte permet d’éditer un document source LaTeX. Qu’ils soient en mode texte ou graphique tous sont utilisables avec plus ou moins de fonctionnalités et facilités d’utilisation. Il n’y a pas de bon ou mauvais éditeur. Ce n’est qu’une affaire de goût et d’usage. Ne seront présentés ci-dessous que ceux qui vous permettront à la fois d’éditer et de compiler votre document voire plus.

Ne sont présentés ici que les visionneurs connus avec la capacité de se rafraîchir automatiquement après une compilation pdflatex. Tous les autres visionneurs qui n’ont pas cette capacité nécessiteront un rafraîchissement manuel après chaque compilation du document.