{{tag>Logiciel}}

====== LaTeX ======

Nous utiliserons TeX-Live

TeX Live permet d'utiliser le système de production de documents TeX de manière simple et rapide.
Il fournit un système TeX complet avec des binaires pour la plupart des versions d'Unix, y compris GNU/Linux et macOS, ainsi que pour Windows.
Il inclut les principaux programmes, macroprogrammes et polices de caractères liés à TeX qui sont des logiciels libres, y compris la prise en charge de nombreuses langues du monde.
De nombreux systèmes d'exploitation Unix/GNU/Linux fournissent TeX Live via leurs propres distributions et gestionnaires de paquets.

===== Pré-requis =====

===== Installation =====

<subnumberlist>
  - **Installez Texlive** et **mtxdoc.sty** (polices pour musixtex) :<cli prompt='$ '>USER@MACHINE:~$ sudo apt install texlive-{full,music}</cli>Éventuellement :<cli prompt='$ '>USER@MACHINE:~$ sudo apt --fix-broken install</cli>
  - **Dossier texmf** : TeX regarde dans le dossier de l'utilisateur par défaut, ~/texmf
    - **Pour connaître l'emplacement de votre fichier texmf local** :<cli prompt='$ '>USER@MACHINE:~$ kpsewhich -var-value TEXMFHOME
/home/USER/texmf</cli>Sur un système Linux, c'est généralement ~/texmf (/home/<username>/texmf).
    - **pour le créer** :
      - **Créez ce dossier** sur votre ordinateur :<cli prompt='$ '>USER@MACHINE:~$ mkdir texmf/tex/latex</cli><WRAP center round tip 60%>
**script pour créer une hiérarchie texmf locale** :<code bash mklocaltexmf.sh>
#!/bin/sh
# Shell script to make a local texmf hierarchy for MacOS or Linux
# Alan Munn <amunn@msu.edu>
#
# 2018/09/06
#
localdirname=`/Library/TeX/texbin/kpsewhich -var-value TEXMFHOME`
if [ ! -d $localdirname ]; then

	mkdir -p $localdirname/bibtex/bib
	mkdir -p $localdirname/bibtex/bst

	mkdir -p $localdirname/doc

	mkdir -p $localdirname/fonts/afm
	mkdir -p $localdirname/fonts/map
	mkdir -p $localdirname/fonts/misc
	mkdir -p $localdirname/fonts/pk
	mkdir -p $localdirname/fonts/source
	mkdir -p $localdirname/fonts/tfm
	mkdir -p $localdirname/fonts/type1
	mkdir -p $localdirname/fonts/opentype
	mkdir -p $localdirname/fonts/truetype

	mkdir -p $localdirname/generic

	mkdir -p $localdirname/scripts

	mkdir -p $localdirname/source

	mkdir -p $localdirname/tex/context
	mkdir -p $localdirname/tex/generic
	mkdir -p $localdirname/tex/latex
	mkdir -p $localdirname/tex/plain
	mkdir -p $localdirname/tex/xelatex
	mkdir -p $localdirname/tex/xetex
	mkdir -p $localdirname/tex/luatex
	mkdir -p $localdirname/tex/lualatex
	
	echo "Local texmf folder sucessfully created!"
else
echo "Local texmf folder already exists!"
fi</code></WRAP>
      - **Initialisez ce répertoire** :<cli prompt='$ '>USER@MACHINE:~$ texhash ~/texmf
texhash: Updating /home/USER/texmf/ls-R... 
texhash: Done.</cli>Cela fait, il n'est plus nécessaire de faire autre chose pour trouver les paquets ; TeX cherche d'abord dans ce répertoire.
    - **Pour créer un autre dossier texmf** (exemple ~/Dropbox/mylocaltexmf) :
      - **créez le fichier /etc/texmf/texmf.d/10localtexmf.cnf** et indiquez-y la valeur personnalisée de votre texmf personnel :<cli prompt='$ '>USER@MACHINE:~$ cd /etc/texmf/texmf.d
USER@MACHINE:~$ sudo touch 10localtexmf.cnf</cli><code - /etc/texmf/texmf.d/10localtexmf.cnf>TEXMFHOME = ~/Dropbox/mylocaltexmf</code>
      - **générez le fichier /etc/texmf/web2c/texmf.cnf** :<cli prompt='$ '>USER@MACHINE:~$ sudo update-texmf</cli>
      - **vérifiez que cela s'est bien passé** :<cli prompt='$ '>USER@MACHINE:~$ kpsexpand \$TEXMFHOME</cli>S'il s'affiche ~/Dropbox/mylocaltexmf, la modification a fonctionné ; S'il s'affiche ~/texmf, il est toujours sur la valeur par défaut.
    - **Le contenu de votre localtexmf doit refléter la structure standard de texmf**, donc les styles et thèmes latex personnalisés doivent être placés dans ~/texmf/tex/latex.
    - **exécutez** <cli prompt='$ '>USER@MACHINE:~$ sudo texhash</cli> chaque fois que vous mettez à jour votre texmf local.
</subnumberlist>

===== Configuration =====

===== Utilisation =====

  - <cli prompt='$ '>USER@MACHINE:~$ latex test.tex</cli>
    - afficher le fichier de sortie :<cli prompt='$ '>USER@MACHINE:~$ xdvi test.dvi &</cli>Appuyez sur <key>'q'</key>pour quitter l'afficheur
  - Pour produire un PDF, exécutez pdflatex au lieu de latex :<cli prompt='$ '>USER@MACHINE:~$ pdflatex test.tex</cli>
===== Désinstallation =====

===== Problèmes connus =====

===== Voir aussi =====

  * **(en)** [[https://www.tug.org/texlive/]]
  * **(en)** [[https://tex.stackexchange.com/questions/161001/create-a-local-texmf-tree-in-ubuntu]]
  * **(en)** [[https://tex.stackexchange.com/questions/449769/finding-and-configuring-my-texmf-tree]]
  * **(en)** [[https://tex.stackexchange.com/questions/8357/how-to-have-local-package-override-default-package]]
  * **(en)** [[https://qastack.fr/programming/1017055/get-started-with-latex-on-linux]]

----
//Basé sur << [[https://www.tug.org/texlive/|TeX Live]] >> par TeX user group.//