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 [16/06/2023 22:39] Philou92 [Liens utiles] |
doc:tex:latex [30/06/2023 22:46] Philou92 [Installation] |
||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
- | ====== Projet tuto LaTeX ====== | + | ====== LaTeX ====== |
* Objet : Utiliser LaTeX | * Objet : Utiliser LaTeX | ||
Ligne 9: | Ligne 9: | ||
* [[user>smolski]] (Coordinateur) | * [[user>smolski]] (Coordinateur) | ||
* [[user>Philou92]] (Adepte du LaTeX) | * [[user>Philou92]] (Adepte du LaTeX) | ||
- | * Dépôt git : | ||
- | * Nom du dépôt (non créer encore) : nomdudepot FIXME | ||
- | * URL Gitweb (non ouvert encore : [[:url-invalide|http://debian-facile.org/gitweb/…]] FIXME | ||
* Commentaires sur le forum : [[https://debian-facile.org/viewtopic.php?pid=398772#p398772]]((N'hésitez pas à * intervenir !)) | * Commentaires sur le forum : [[https://debian-facile.org/viewtopic.php?pid=398772#p398772]]((N'hésitez pas à * intervenir !)) | ||
{{tag>en-chantier}} | {{tag>en-chantier}} | ||
+ | |||
+ | ===== 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 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. | ||
===== Installation ===== | ===== Installation ===== | ||
Ligne 25: | Ligne 30: | ||
==== Installer LaTeX ==== | ==== Installer LaTeX ==== | ||
Deux options d’installation s’offrent à vous : | Deux options d’installation s’offrent à vous : | ||
+ | |||
+ | |||
+ | === Option 1 installer LaTeX à partir des paquets debian === | ||
- | ^ ^ Options d’installations de LaTeX ^^ | + | ^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 ^ |
- | ^Options | **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//** | ** 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]])) | | + | ^Avantages\\ | - Installation facile comme tous paquets debian\\ - Fonctionne sans souci. Prête à l’emploi\\ - Parfait pour apprendre LaTeX sans rentrer dans les arcanes du fonctionnement des moteurs tex, LaTeX, etc. | |
- | ^Avantages\\ |- Installation facile comme tous paquets debian\\ - Fonctionne sans souci. Prête à l’emploi\\ - Parfait pour apprendre LaTeX sans rentrer dans les arcanes du fonctionnement des moteurs tex, LaTeX etc. |- Installation d’une texlive totalement indépendante du système debian, les deux distributions peuvent vivre chacune leur vie sans gêner l’autre comme une célèbre marque de matelas…\\ - Installation facile si on prend le soin de lire le guide d’installation\\ - L’installation peut-être dimensionnée en fonction de ses besoins\\ - L’installation peut se faire en root ou dans le répertoire d’un utilisateur\\ - L’utilitaire tlmgr((http://mirrors.ctan.org/info/tlmgrbasics/doc/tlmgr.pdf)) permet d’installer/désinstaller très facilement des packages LaTeX \\ - Mise à jour de la distribution texlive à la demande\\ - Désinstallation extrêmement facile. Il suffit de supprimer le répertoire d’installation\\ - Suit pleinement l’arborescence des répertoires TDS\\ - //texlive// étant multi-plateforme il sera plus facile de trouver de l’aide sur le fonctionnement de votre distribution | | + | ^Inconvénients\\ | - L’installation peut s’avérer lourde si on souhaite utiliser des packages LaTeX en dehors de du méta-paquet //debian texlive//\\ - L’installation d’autre méta-paquet va installer une multitude de packages LaTeX qui vous seront probablement inutiles. Cela occupe de l’espace disque et ralenti les processus de mise à jour\\ - La désinstallation complète des fichiers et paquets d’une //texlive// à la sauce //debian// peut s’avérer complexe car elle ne supprime pas forcément toutes les dépendances et peut nécessiter de faire le ménage par la suite. Cette situation peut survenir si vous avez installé des paquets qui dépendent de paquets texlive\\ - L’installation ne suit pas les canons de l’arborescence des répertoires TDS((https://faq.gutenberg-asso.fr/5_fichiers/tds/start)). Cela concerne notamment les fichiers de documentation et de nombreux programmes\\ - Il n’y aura aucune mise à jour des packages entre deux versions stables de debian. Cela peut être gênant si on souhaite bénéficier d’un package LaTeX récent. Pour cela il faudra le télécharger sur le serveur CTAN((https://ctan.org/)) puis l’installer le répertoire local ou utilisateur. Le problème est que ce paquet ne sera jamais mis à jour automatiquement | |
- | ^Inconvénients\\ | - L’installation peut s’avérer lourde si on souhaite utiliser des packages LaTeX en dehors de du méta-paquet //debian texlive//. L’installation d’autre méta-paquet va installer une multitude de packages LaTeX qui vous seront probablement inutiles. Cela occupe de l’espace disque et ralenti les processus de mise à jour\\ - La désinstallation complète des fichiers et paquets d’une //texlive// à la sauce //debian// est complexe car elle ne supprime pas forcément toutes les dépendances et nécessite souvent de faire le ménage par la suite\\ - L’installation ne suit pas les canons de l’arborescence des répertoires TDS((https://faq.gutenberg-asso.fr/5_fichiers/tds/start)). Cela concerne notamment les fichiers de documentation et de nombreux programmes\\ - Il n’y aura aucune mise à jour des packages entre deux versions stables de debian. Cela peut-être gênant si on souhaite bénéficier d’un package LaTeX récent. Pour cela il faudra le télécharger sur le serveur CTAN((https://ctan.org/)) puis l’installer le répertoire local ou utilisateur. Le problème est que ce paquet ne sera jamais mis à jour automatiquement\\ |A priori aucun…\\ | | + | |
+ | 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// | ||
+ | |||
+ | |||
+ | === 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 ^ | ||
+ | ^Avantages\\ | - Installation d’une texlive totalement indépendante du système debian, les deux distributions peuvent vivre chacune leur vie sans gêner l’autre comme une célèbre marque de matelas…\\ - Installation facile si on prend le soin de lire le guide d’installation\\ - L’installation peut-être dimensionnée en fonction de ses besoins\\ - L’installation peut se faire en root ou dans le répertoire d’un utilisateur\\ - L’utilitaire tlmgr((http://mirrors.ctan.org/info/tlmgrbasics/doc/tlmgr.pdf)) permet d’installer/désinstaller très facilement des packages LaTeX \\ - Mise à jour de la distribution texlive à la demande\\ - Désinstallation extrêmement facile. Il suffit de supprimer le répertoire d’installation\\ - Suit pleinement l’arborescence des répertoires TDS\\ - //texlive// étant multi-plateforme il sera plus facile de trouver de l’aide sur le fonctionnement de votre distribution | | ||
+ | ^Inconvénients | - Nécessite de maîtriser la ligne de commande et l’administration de votre debian | | ||
+ | |||
+ | L’installation de //texlive// dite à la vanille va se dérouler en deux étapes : | ||
+ | - 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]] | ||
+ | - création d’un paquet factice debian (.deb) pour faire croire à votre distribution que texlive est installé. | ||
+ | |||
+ | <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 == | ||
+ | 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. | ||
+ | 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 : <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// | ||
+ | * 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.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)// | ||
+ | * 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 : <file config /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 | ||
+ | </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 | ||
+ | </file><file config nom> | ||
+ | conf | ||
+ | </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> | ||
+ | \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> | ||
+ | * Si le fichier essai.pdf a été produit correctement, passer à l’étape suivante. | ||
+ | |||
+ | == Étape 2 == | ||
Ligne 41: | Ligne 106: | ||
|Initiation à LaTeX. Pour débutants ou jeunes utilisateurs (Adrien Bouzigues) |[[https://mirror.ibcp.fr/pub/CTAN/info/guide-latex-fr/guide-latex-fr.pdf]] | | | |Initiation à LaTeX. Pour débutants ou jeunes utilisateurs (Adrien Bouzigues) |[[https://mirror.ibcp.fr/pub/CTAN/info/guide-latex-fr/guide-latex-fr.pdf]] | | | ||
|LaTeX… pour le prof de maths ! Aide-mémoire, astuces et approfondissements (Arnaud Gazagnes)|https://math.univ-lyon1.fr/irem/IMG/pdf/LatexPourLeProfDeMaths.pdf|Tout est dans le titre | | |LaTeX… pour le prof de maths ! Aide-mémoire, astuces et approfondissements (Arnaud Gazagnes)|https://math.univ-lyon1.fr/irem/IMG/pdf/LatexPourLeProfDeMaths.pdf|Tout est dans le titre | | ||
- | |LaTeX Companion (2eme édition) traduction Française. Pearsons. (J.André) | |La bible LaTeX. Ouvrage malheureusement épuisé | | + | |LaTeX Companion (2ᵉ édition) traduction française. Pearsons. (J. André) | |La bible LaTeX. Ouvrage malheureusement épuisé. La 3ᵉ édition en version anglaise sera bientôt disponible (info [[https://www.latex-project.org/news/2023/03/17/TLC3/]]) | |
- | |LaTeX pour l’impatient (4eme édition). H&K |[[https://www.h-k.fr/]] |Excellent ouvrage pour débuter et plus… | | + | |LaTeX pour l’impatient (4ᵉ édition). H&K |[[https://www.h-k.fr/]] |Excellent ouvrage pour débuter et plus… | |
- | |Documentations du Réseau exhaustif d'archives TeX (Ctan) |[[https://ctan.org/tex-archive/documentation]] |Documentations très majoritairement en langue anglaise | | + | |Documentations du Réseau exhaustif d’archives TeX (Ctan) |[[https://ctan.org/tex-archive/documentation]] |Documentations très majoritairement en langue anglaise | |
- | |Administration d’une distribution TeX (Daniel Flipo) |[[http://daniel.flipo.free.fr/doc/tex-admin/TeX-admin.pdf]] |Date un peu. L’administration d’une //texlive// c’est nettement simplifiée depuis. À consulter toutefois notamment le chapitre consacré à //Debian// | | + | |Administration d’une distribution TeX (Daniel Flipo) |[[http://daniel.flipo.free.fr/doc/tex-admin/TeX-admin.pdf]] |Date un peu (2009). L’administration d’une //texlive// s’est nettement simplifiée depuis. À consulter toutefois notamment le chapitre consacré à //Debian// | |
+ | |(Xe)LaTeX appliqué aux sciences humaines |[[https://shs.hal.science/halshs-00924546]] |(Xe)LaTeX le moteur apte à utiliser les fontes OpenType et TrueType | | ||
+ | |TeX pour l’impatient |https://texdoc.org/serve/fbook.pdf/0 |Où comment utiliser plain TeX. Document utile pour comprendre le fonctionnement bas niveau de LaTeX et ses nombreux package | | ||
+ | |TikZ pour l’impatient |[[http://math.et.info.free.fr/TikZ/]] |Où comment inclure des figures précises d’une grande qualité au format PDF sans savoir dessiner | | ||
Ligne 53: | Ligne 122: | ||
|Forum LaTeX - Texnique |[[https://texnique.fr/osqa/]] | | |Forum LaTeX - Texnique |[[https://texnique.fr/osqa/]] | | ||
|Groupe francophone des utilisateurs de LaTeX |[[https://www.gutenberg-asso.fr/]] | | |Groupe francophone des utilisateurs de LaTeX |[[https://www.gutenberg-asso.fr/]] | | ||
+ | |Vidéo Apprendre le Latex (Alain Olivetti) |https://www.youtube.com/@AlainOlivetti/playlists | | ||
+ | |Tout sur les packages, les distributions //TeX//, les documentations… |[[https://ctan.org/]] | | ||
+ | |||
+ | |||
+ | ===== Éditeurs LaTeX ===== | ||
+ | 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. | ||
+ | |||
+ | ==== 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> | | ||
+ | |||
+ | |||
+ | ==== Liste d’éditeurs en mode graphique ==== | ||
+ | |||
+ | ^ Éditeur ^ Commentaire ^ Installation type option 1 (//texlive debian//) ^ Installation type option 2 (//texlive à la vanille//) ^ | ||
+ | |TeXmaker |Éditeur complet |<code root>apt install texmaker</code> |Compliqué | | ||
+ | |TeXworks |Un éditeur complet qui s’inspire de TeXshop (éditeur dédié aux plateformes macOS) |<code root>apt install texworks</code> |Compliqué | | ||
+ | |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// | | ||
+ | |kile |L’environnement LaTeX intégré à KDE |<code root>apt install kile</code> |Impossible | | ||
+ | |lyx |Environnement LaTeX avec une interface WYSIWYG |<code root>apt install lyx</code> |Compliqué | | ||
+ | |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 |<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 |Suivre les instructions du lien [[doc:programmation:geany|geany]] |Suivre les instructions du lien [[doc:programmation:geany|geany]] | | ||
+ | |||
+ | |||
+ | ===== Visionneurs de documents PDF ===== | ||
+ | |||
+ | 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 du document. | ||
+ | |||
+ | ^ Nom du paquet ^ | ||
+ | |[[doc:environnements:gnome:evince|evince]]| | ||
+ | |[[doc:editeurs:zathura|zathura]]| | ||
- | * Tout sur la distribution LaTeX : [[https://ctan.org/]] | ||
- | ===== Cahier des charges ===== | ||
- | Transcrire le contenu du lien pdf façon df. | ||