Debian
Debian-France
Debian-Facile
Debian-fr.org
Forum-Debian.fr
Debian ?
Communautés
Vous n'êtes pas identifié(e).
L'icône rouge permet de télécharger chaque page du wiki visitée au format
PDF et la grise au format ODT →
Ci-dessous, les différences entre deux révisions de la page.
| Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente Prochaine révision Les deux révisions suivantes | ||
|
doc:tex:latex [30/06/2023 22:46] Philou92 [Installation] |
doc:tex:latex [01/07/2023 20:45] Philou92 [Installation] |
||
|---|---|---|---|
| Ligne 15: | Ligne 15: | ||
| ===== Introduction ===== | ===== Introduction ===== | ||
| 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 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 : | Ce que vous trouverez ici : | ||
| * comment installer LaTeX sur votre //debian//, | * comment installer LaTeX sur votre //debian//, | ||
| Ligne 29: | Ligne 30: | ||
| ==== Installer LaTeX ==== | ==== Installer LaTeX ==== | ||
| - | Deux options d’installation s’offrent à vous : | + | 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 : | ||
| - | === Option 1 installer LaTeX à partir des paquets debian === | + | |
| + | === Option 1 installer LaTeX à partir des paquets debian (option recommandée) === | ||
| ^Option ^ **1 - Installer les paquets //texlive//((en suivant le wiki //debian// là : [[https://wiki.debian.org/fr/Latex]]. Il est recommandé d’installer à minima les paquets //texlive// et //texlive-lang-french//)) de la distribution //debian//**\\ Option recommandée ^ | ^Option ^ **1 - Installer les paquets //texlive//((en suivant le wiki //debian// là : [[https://wiki.debian.org/fr/Latex]]. Il est recommandé d’installer à minima les paquets //texlive// et //texlive-lang-french//)) de la distribution //debian//**\\ Option recommandée ^ | ||
| Ligne 40: | Ligne 44: | ||
| 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// | 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 que votre installation fonctionne bien. Placez-vous dans un répertoire temporaire et éditer le code LaTeX suivant dans un fichier nommé essai.tex :<file latex 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} | ||
| + | </file> | ||
| + | |||
| + | * Enregistrer et fermer et le fichier puis compiler en pdf avec la commande :<code user>pdflatex essai.tex</code> | ||
| + | * Vérifier que le fichier essai.pdf a été produit correctement | ||
| === Option 2 installer LaTeX à partir de la distribution texlive dite à la vanille === | === Option 2 installer LaTeX à partir de la distribution texlive dite à la vanille === | ||
| - | |||
| - | <note warning>Option 2 en chantier !</note> | ||
| ^Option ^ ** 2 - Installer la distribution //texlive// dite à la //vanille//**((en suivant le guide d’installation ici [[https://www.tug.org/texlive/doc/texlive-fr/texlive-fr.html]]))\\ Option pour les administrateurs aguerris ^ | ^Option ^ ** 2 - Installer la distribution //texlive// dite à la //vanille//**((en suivant le guide d’installation ici [[https://www.tug.org/texlive/doc/texlive-fr/texlive-fr.html]]))\\ Option pour les administrateurs aguerris ^ | ||
| Ligne 56: | Ligne 72: | ||
| <note important>Lire le document d’installation. Ce qui va suivre n’est un résumé des actions et quelques compléments</note> | <note important>Lire le document d’installation. Ce qui va suivre n’est un résumé des actions et quelques compléments</note> | ||
| - | == Étape 1 == | + | == Étape 1 - installation de la distribution == |
| Cette étape nécessite une bonne connexion réseau (entre 1,5 et 2Go de téléchargement). | 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 dans en ligne de commande dans terminal. | L’ensemble des actions d’administration cités ci-dessous se font dans en ligne de commande dans terminal. | ||
| Ligne 62: | Ligne 78: | ||
| * 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 : <code user>tar -xzf install-t-unx.tar.gz</code> | * 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 : <code user>tar -xzf install-t-unx.tar.gz</code> | ||
| - | * 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 : <code user>ls -al install-tl-AAAAMMJJ</code>. Il contient entre autre un fichier exécutable //install-tl// | + | * 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 : <code user>ls -al install-tl-AAAAMMJJ</code>. 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 : <code root>/home/<USER>/chemin/temp/install-tl</code> | * Réf 3.1.1 : éxécutez le programme //install-tl// à l’aide de la commande : <code root>/home/<USER>/chemin/temp/install-tl</code> | ||
| * Réf 3.2 : les options d’installations s’affichent | * 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.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’options //medium scheme (small + more packages and languages)// | + | * 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. | * 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. | * 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 | * 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)… | + | * 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 : <file config /home/<USER>/.bashrc> | * 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 : <file config /home/<USER>/.bashrc> | ||
| PATH=/usr/local/texlive/2023/bin/x86_64-linux:$PATH; export PATH | PATH=/usr/local/texlive/2023/bin/x86_64-linux:$PATH; export PATH | ||
| Ligne 77: | Ligne 93: | ||
| </file> Faites de même pour le fichier .bashrc du compte root en ajoutant la ligne : <file config /root/.bashrc> | </file> Faites de même pour le fichier .bashrc du compte root en ajoutant la ligne : <file config /root/.bashrc> | ||
| PATH=/usr/local/texlive/2023/bin/x86_64-linux:$PATH; export PATH | PATH=/usr/local/texlive/2023/bin/x86_64-linux:$PATH; export PATH | ||
| - | </file><file config nom> | ||
| - | conf | ||
| </file> | </file> | ||
| - | * Testez que votre installation fonctionne bien. Placer vous dans votre répertoire temporaire et éditer le code LaTeX suivant dans un fichier nommé essai.tex :<file latex essai.tex> | + | * Testez que votre installation fonctionne bien. Placez-vous dans votre répertoire temporaire et éditer le code LaTeX suivant dans un fichier nommé essai.tex :<file latex essai.tex> |
| \documentclass[french]{article}% | \documentclass[french]{article}% | ||
| \usepackage[utf8]{inputenc}% | \usepackage[utf8]{inputenc}% | ||
| Ligne 94: | Ligne 108: | ||
| * Enregistrer et fermer et le fichier puis compiler en pdf avec la commande :<code user>pdflatex essai.tex</code> | * Enregistrer et fermer et le fichier puis compiler en pdf avec la commande :<code user>pdflatex essai.tex</code> | ||
| - | * Si le fichier essai.pdf a été produit correctement, passer à l’étape suivante. | + | * Vérifier que le fichier essai.pdf a été produit correctement |
| + | * Exécuter les deux commandes tlmgr((http://mirrors.ctan.org/info/tlmgrbasics/doc/tlmgr.pdf)) suivantes :<code user>tlmgr info schemes</code> et <code user>tlmgr info collections</code> Elles retournent un résumé de votre installation texlive (préfixe i=installé). | ||
| + | * Vérifier que tlmgr fonctionne également avec le compte root <code root>tlmgr info schemes</code> | ||
| + | * Si tout fonctionne passer à l’étape suivante. | ||
| + | |||
| + | == Étape 2 création du paquet debian factice == | ||
| + | |||
| + | <note important>Lire le document de référence de TeX User Group [[https://tug.org/texlive/debian.html#vanilla]] | ||
| + | Pour la suite il est considéré que nous sommes à minima en 2023 et que votre distribution //debian// est //debian 12 Bookworm//</note> | ||
| + | |||
| + | * Installer les paquets debian tex-common et texinfo : | ||
| + | * <code root>apt update && apt install tex-common</code><code root>apt install texinfo</code> | ||
| + | * Ajouter à la variable d’environnement ENV_PATH du fichier /etc/login.defs le chemin /usr/local/texlive/2023/bin. La ligne devrait ressembler à cela :<file config extrait /etc/login.defs> | ||
| + | ... | ||
| + | ENV_PATH PATH=/usr/local/bin:/usr/bin:/bin:/usr/local/games:/usr/games:/usr/local/texlive/2023/bin | ||
| + | ... | ||
| + | </file> | ||
| + | * Inutile d’installer le paquet lmodern puisqu’il est fourni par la distribution texlive. | ||
| + | * Installer le paquet equivs (216Mo) : <code root>apt install equivs</code> | ||
| + | * Créer un répertoire temporaire de travail dans votre home : <code user>cd && mkdir -p /tmp/tl-equivs && cd /tmp/tl-equivs</code> | ||
| + | * Créer un modèle de fichier de configuration equivs nommé texlive-local en exécutant la commande :<code user>equivs-control texlive-local</code> | ||
| + | * É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 Mainteneur à la place de //you <you@yourdomain.example.org>// | ||
| + | <note important>Ce fichier ajoute une dépendance au paquet freeglut3 qui n’est pas disponible dans //debian 12//. freeglut3 est une boite à outil OpenGL dont l’utilité est loin d’être pertinente nous allons la supprimer.</note> | ||
| + | * Supprimer la ligne « Depends: freeglut3 » et enregistrer le fichier <file config 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 | ||
| + | </file> | ||
| + | * Pour créer le paquet factice exécuter la commande : <code user>equivs-build texlive-local</code> cela va créer le fichier texlive-local_2022.99999999-1_all.deb | ||
| + | * Ensuite installer le paquet factice : <code root>dpkg -i /home/<USER>/tmp/tl-equivs/texlive-local_2022.99999999-1_all.deb</code> | ||
| + | * 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. | ||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| + | |||
| - | == Étape 2 == | ||
| Ligne 130: | Ligne 186: | ||
| ==== Liste d’éditeurs en mode texte ==== | ==== Liste d’éditeurs en mode texte ==== | ||
| - | <note warning>Option 2 en chantier</note> | ||
| - | ^ Éditeur ^ Commentaire ^ Installation type option 1 (//texlive debian//) ^ Installation type option 2 (//texlive à la vanille//) ^ | ||
| - | |[[doc:editeurs:vim:|Vim]] |Vim dispose de plusieurs plugins pour éditer efficacement dont Vim-Latex. Il est cependant possible de créer ces propres macro-commandes adaptées à vos besoins (lire le document de V.Lozano) | Voir le tuto [[doc:editeurs:vim:|Vim]] |Voir le tuto [[doc:editeurs:vim:|Vim]] | | ||
| - | |[[doc:editeurs:emacs|emacs]] |utilisé en combinaison avec le paquet debian //auctex// offre un outil puissant pour éditer avec LaTeX |Pour installer emacs voir le tuto [[doc:editeurs:emacs|emacs]]\\ Pour installer auctex entrer la commande :\\ <code root>apt install auctex</code> |Pour installer emacs voir le tuto [[doc:editeurs:emacs|emacs]]\\ Le paquet auctex ne peux pas être installé correctement car il dépend du paquet //preview-latex-style// qui lui même dépend du paquet //tex-common// | | ||
| - | |[[doc:environnements:gnome:gedit:|gedit]] |Éditeur Gnome à utiliser en combinaison avec son greffon gedit-latex-plugin |Pour installer gedit voir le tuto [[doc:environnements:gnome:gedit:|gedit]]\\ pour installer le greffon gedit-latex-plugin entrer la commande :\\ <code root>apt install gedit-latex-plugin </code> |Pour installer gedit voir le tuto [[doc:environnements:gnome:gedit:|gedit]]\\ pour installer le greffon gedit-latex-plugin entrer la commande :\\ <code root>apt install --no-install-recommends gedit-latex-plugin </code> | | ||
| + | ^ Éditeur ^ Commentaire ^ | ||
| + | |[[doc:editeurs:vim:|Vim]]\\ |Vim dispose de plusieurs plugins pour éditer efficacement dont Vim-Latex. Il est cependant possible de créer ces propres macro-commandes adaptées à vos besoins (lire le document de V.Lozano).\\ Installation : voir le tuto [[doc:editeurs:vim:|Vim]] | | ||
| + | |[[doc:editeurs:emacs|emacs]] |utilisé en combinaison avec le paquet debian //auctex// offre un outil puissant pour éditer avec LaTeX\\ Pour installer emacs voir le tuto [[doc:editeurs:emacs|emacs]]\\ Pour installer auctex entrer la commande :\\ <code root>apt install auctex</code> | | ||
| + | |[[doc:environnements:gnome:gedit:|gedit]]\\ |Éditeur Gnome à utiliser en combinaison avec son greffon gedit-latex-plugin\\ Pour installer gedit voir le tuto [[doc:environnements:gnome:gedit:|gedit]]\\ Pour installer le greffon gedit-latex-plugin entrer la commande :\\ <code root>apt install gedit-latex-plugin </code> | | ||
| ==== Liste d’éditeurs en mode graphique ==== | ==== Liste d’éditeurs en mode graphique ==== | ||
| - | ^ Éditeur ^ Commentaire ^ Installation type option 1 (//texlive debian//) ^ Installation type option 2 (//texlive à la vanille//) ^ | + | ^ Éditeur ^ Commentaire ^ |
| - | |TeXmaker |Éditeur complet |<code root>apt install texmaker</code> |Compliqué | | + | |TeXmaker\\ |Éditeur complet.\\ Installation : <code root>apt install texmaker</code> Une configuration peut s’avérer nécessaire après installation pour dire à TeXmaker où trouver les programmes //texlive// (consulter la documentation) | |
| - | |TeXworks |Un éditeur complet qui s’inspire de TeXshop (éditeur dédié aux plateformes macOS) |<code root>apt install texworks</code> |Compliqué | | + | |TeXworks\\ |Un éditeur complet qui s’inspire de TeXshop (éditeur dédié aux plateformes macOS)\\ Installation : <code root>apt install texworks</code> Configuration automatique. Prêt à l’emploi. | |
| - | |TeXstudio |Éditeur basé sur TeXmaker avec des fonctionnalités en plus |<code root>apt install texstudio</code> |<code root>apt install --no-install-recommends texstudio</code>\\ /!\ Vous aurez peut-être besoin d’ajouter le paquet //adwaita-qt// | | + | |TeXstudio\\ |Éditeur basé sur TeXmaker avec des fonctionnalités en plus\\ Installation : <code root>apt install texstudio</code> Une configuration peut s’avérer nécessaire après installation pour dire à TeXstudio où trouver les programmes //texlive// (consulter la documentation) | |
| - | |kile |L’environnement LaTeX intégré à KDE |<code root>apt install kile</code> |Impossible | | + | |kile\\ |L’environnement LaTeX intégré à KDE\\ Installation : <code root>apt install kile</code> Configuration automatique. Prêt à l’emploi. | |
| - | |lyx |Environnement LaTeX avec une interface WYSIWYG |<code root>apt install lyx</code> |Compliqué | | + | |latexila\\ |L’éditeur LaTeX conçu pour le bureau Gnome\\ Installation : <code root>apt install latexila</code> | |
| - | |latexila |L’éditeur LaTeX conçu pour le bureau Gnome |<code root>apt install latexila</code> |Compliqué | | + | |gummi\\ |Éditeur simple pour LaTeX avec prévisualisation en direct\\ Installation : <code root>apt install gummi</code> | |
| - | |gummi |Éditeur simple pour LaTeX avec prévisualisation en direct |<code root>apt install gummi</code> |<code root>apt install -no-install-recommends gummi</code>| | + | |[[doc:programmation:geany|geany]]\\ |Utilisation sans bouillir avec son plugin geany-plugin-latex\\ Installation : suivre les instructions du lien [[doc:programmation:geany|geany]]\\ Une configuration peut s’avérer nécessaire après installation pour dire à geany où trouver les programmes //texlive// | |
| - | |[[doc:programmation:geany|geany]] |Utilisation sans bouillir avec son plugin geany-plugin-latex |Suivre les instructions du lien [[doc:programmation:geany|geany]] |Suivre les instructions du lien [[doc:programmation:geany|geany]] | | + | |
