LaTeX, langage de description de document

LaTeX est un langage de description de document. Si vous avez déjà utilisé le langage HTML, ou édité un wiki, vous êtes déjà familier à l'idée d'utiliser des symboles ou des commandes au sein d'un texte pour en définir le rendu et la mise en page. LaTeX est utilisé couramment pour les publications scientifiques. Il est très utile pour créer des documents formatés de manière logique, avec un excellent rendu des équations et formules. Il permet également de générer facilement sommaires, listes de figures et numéros d'équation. Les fichiers LaTeX peuvent ensuite être convertis en un grand nombre de formats différents comme par exemple PDF, PostScript, DVI, et HTML. Il se prononce "Latèque" ou "Latec" mais certainement pas Latex.

Un fichier LaTeX est un fichier contenant du texte et des commandes de marquage. Il peut être écrit avec un éditeur de texte (Gedit par exemple), il est ensuite converti vers d'autres formats grâce à un compilateur LaTeX. Certaines personnes préféreront écrire des fichiers LaTeX dans un environnement intégré, avec menus et boutons de formatage de texte comme l'excellent et très complet Kile ou aussi Texmaker. Il existe également de nombreux paquets additionnels permettant d'enrichir LaTeX en fonctionnalités diverses.

• Disposer des droits d'administration.
• Disposer d'une connexion à Internet configurée et activée.

Tout comme GNU/Linux, LaTeX est en fait une collection de plusieurs outils et fichiers indépendants. Et pour éviter de devoir les rechercher un par un, puis de les installer, il existe une distribution LaTeX.

Sous Ubuntu, c'est TeX-Live présent dans le dépôt « Universe » qui permet de faire du LaTeX.

• Pour l'installation minimale, installez le paquet texlive.
• Pour le support de la langue française, installez le paquet texlive-lang-french.
• Pour une compilation de greffons bien utiles, installez le paquet texlive-latex-extra.
• Pour l'installation complète sans se poser de questions au sujet des paquets supplémentaires, installez le paquet texlive-full.

LaTeX peut être complété par des paquets additionnels.

Si vous voulez que ces paquets s'installent automatiquement il faut la commande tlmgr.

Pour cela il faut installer directement TexLive sur votre Ubuntu sans installer les paquets fournis pour votre distribution.

Télécharger texliveunix.

positionnez-vous dans le répertoire de téléchargement du fichier.

Extraction du script

tar zxvf install-tl-unx.tar.gz

Installation des paquets nécessaires

sudo apt-get install tex-common texinfo equivs perl-tk perl-doc

cd /home/user/install-tl-20131112
sudo ./install-tl 

sudo ./install-tl -gui

Si vous le souhaitez vous pouvez commencer par changer le mode d'installation (complète (par défaut), minimaliste…) en allant dans le menu Scheme (Tapez S).

Changer les options d’installation pour avoir des liens symboliques :

 <O> options:
   [ ] use letter size instead of A4 by default
   [X] allow execution of restricted list of programs via \write18
   [X] create all format files
   [X] install macro/font doc tree
   [X] install macro/font source tree
 
 <V> set up for portable installation
 
Actions:
 <I> start installation to hard disk
 <H> help
 <Q> quit
 
Enter command: O

===============================================================================
Options setup:
 
 <P> use letter size instead of A4 by default: [ ]
 <E> execution of restricted list of programs: [X]
 <F> create format files:                      [X]
 <D> install font/macro doc tree:              [X]
 <S> install font/macro source tree:           [X]
 <L> create symlinks in standard directories:  [ ]
            binaries to: 
            manpages to: 
                info to: 
 
Actions: (disk space required: 3072 MB)
 <R> return to main menu
 <Q> quit
 
Enter command: L
New value for binary directory [/usr/local/bin]: 
New value for man directory    [/usr/local/man]: 
New value for info directory   [/usr/local/info]:

Choisir les langues à installer

===============================================================================
Options setup:

 <P> use letter size instead of A4 by default: [ ]
 <E> execution of restricted list of programs: [X]
 <F> create format files:                      [X]
 <D> install font/macro doc tree:              [X]
 <S> install font/macro source tree:           [X]
 <L> create symlinks in standard directories:  [X]
            binaries to: /usr/local/bin
            manpages to: /usr/local/man
                info to: /usr/local/info

Actions: (disk space required: 3072 MB)
 <R> return to main menu
 <Q> quit

Enter command: R

Actions:
 <I> start installation to hard disk
 <H> help
 <Q> quit

Enter command: L
===============================================================================
Language support:

 a [X] African scripts                   s [X] Indic scripts                   
 b [X] Arabic                            t [X] Italian                         
 c [X] Armenian                          u [X] Latin                           
 d [X] Chinese, Japanese, Korean         v [X] Latvian                         
 e [X] Croatian                          w [X] Lithuanian                      
 f [X] Cyrillic                          x [X] Mongolian                       
 g [X] Czech/Slovak                      y [X] Norwegian                       
 h [X] Danish                            z [X] Other hyphenation patterns      
 i [X] Dutch                             0 [X] Polish                          
 j [X] US and UK English                 1 [X] Portuguese                      
 k [X] Finnish                           2 [X] Spanish                         
 l [X] French                            3 [X] Swedish                         
 m [X] German                            4 [X] Tibetan                         
 n [X] Greek                             5 [X] Turkmen                         
 o [X] Hebrew                            6 [X] Vietnamese                      
 p [X] Hungarian                        

Language-specific documentation:

 A [X] Arabic documentation              M [X] Mongolian documentation         
 B [X] Bulgarian documentation           N [X] Polish documentation            
 C [X] Chinese documentation             O [X] Portuguese documentation        
 D [X] Czech/Slovak documentation        P [X] Russian documentation           
 E [X] Dutch documentation               S [X] Serbian documentation           
 F [X] English documentation             T [X] Slovenian documentation         
 G [X] Finnish documentation             U [X] Spanish documentation           
 H [X] French documentation              V [X] Thai documentation              
 I [X] German documentation              W [X] Turkish documentation           
 J [X] Italian documentation             X [X] Ukrainian documentation         
 K [X] Japanese documentation            Y [X] Vietnamese documentation        
 L [X] Korean documentation             

Actions: (disk space required: 3072 MB)
 <+> select all
 <-> deselect all
 <R> return to main menu
 <Q> quit

Enter letter(s) to select language(s): R

Commencer l'installation

Actions:
 <I> start installation to hard disk
 <H> help
 <Q> quit

Enter command: I

Fin de l'installation de TexLive

...
 See
   /usr/local/texlive/2012/index.html
 for links to documentation.  The TeX Live web site
 contains updates and corrections: http://tug.org/texlive.

 TeX Live is a joint project of the TeX user groups around the world;
 please consider supporting it by joining the group best for you. The
 list of user groups is on the web at http://tug.org/usergroups.html.


 Add /usr/local/texlive/2012/texmf/doc/man to MANPATH, if not dynamically determined.
 Add /usr/local/texlive/2012/texmf/doc/info to INFOPATH.

 Most importantly, add /usr/local/texlive/2012/bin/x86_64-linux
 to your PATH for current and future sessions.

 Welcome to TeX Live!
Logfile: /usr/local/texlive/2012/install-tl.log

Valider l'exécution de texlive

echo $PATH
/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:/usr/games:/usr/local/games

si le chemin /usr/local/texlive/2011/bin/x86_64-linux n’apparaît pas

nano $HOME/.bashrc

ajoutez à la fin de votre .bashrc pour un shell bash.

PATH=/usr/local/texlive/2011/bin/x86_64-linux:$PATH

Tester que tlmgr fonctionne

tlmgr --help

Administration graphique

sudo tlmgr -gui

Mettre à jour TexLive a partir des dépots CTAN

sudo tlmgr update --self --all

Installation du paquet siunitx :

sudo tlmgr install siunitx

Vous trouverez la liste détaillée sur le site du Catalogue Tex en ligne ou sur le Réseau d'archives TeX. Ils peuvent en général être téléchargés sous forme de fichiers compressés « tar.gz » ou « zip ». Pour les installer, il faut d'abord les décompresser puis les copier dans le répertoire « /usr/local/share/texmf/tex/latex/ ». Lancez ensuite texhash, pour mettre à jour la base de données.

Supposons que vous avez téléchargé le paquet « mhchem.zip » vers votre répertoire personnel, les commandes suivantes devraient fonctionner :

sudo mkdir -p /usr/local/share/texmf/tex/latex
cd /usr/local/share/texmf/tex/latex
sudo unzip $HOME/mhchem.zip
sudo texhash

Parmi d'autres paquets utiles :

• mhchem : molécules chimiques, réactions chimiques, etc.
• Isotope
• Package UTF-8

texworks est un excellent éditeur de texte pour LaTeX qui s'inspire de l'éditeur TeXShop bien connu des adeptes de LaTeX sous Mac OS X. Cet éditeur est particulièrement simple d'utilisation.

• Page dédiée sur le wiki : kile
• Installation de Kile : kile

Dans la même veine que Texmaker, Kile est un logiciel avec une interface graphique KDE et très complet. Vous pouvez l'installer facilement, le paquet kile est présent dans les dépôts.

Si vous rencontrez des problèmes d'accents lors des ouvertures et sauvegardes sous Kile, pensez à spécifier qu'il doit utiliser le bon encodage (UTF-8 par défaut). Pour ce faire, allez dans Settings → Configure Kile → Editor → Open/Save. En haut, pour « Encoding », choisissez « Western European (ISO 8859-15) ». Pensez également à ouvrir vos fichiers en « Western European (ISO 8859-15) », en haut à gauche quand vous ouvrez un fichier.

• Page dédiée sur le wiki : texmaker
• Installation de Texmaker : texmaker

Éditeur de texte spécialisé dans la conception de texte LaTeX. Cet éditeur utilise la bibliothèque Qt et est donc optimisé pour KDE (KUbuntu).

Le plug-in Texlipse permet d'éditer un fichier latex dans Eclipse : http://texlipse.sourceforge.net/

Pour l'installer, ajouter http://texlipse.sourceforge.net/ au gestionnaire de mise à jours Eclipse.

Voir aussi : eclipse_pour_latex

• LaTeXila : éditeur de code LaTeX pour Gnome http://projects.gnome.org/latexila/

WineFish (n'est plus mis à jour depuis 2006. Dernière version disponible 1.33)

• Page dédiée sur le wiki : TeXstudio

À l'origine TeXstudio était appelé TeXmakerX. C'est un "fork" de TeXmaker. http://texstudio.sourceforge.net/

• Page dédiée sur le wiki : lyx
• Installation de LyX : lyx

Un logiciel libre d'édition de documents qui lui aussi utilise LaTeX, mais avec une interface très différente des précédentes. L'avantage de ce logiciel est de permettre une pseudo-visualisation en direct de ce qu'on veut obtenir, ce qui permet en un clin d'œil de repérer la structure du document.

• Page dédiée sur le wiki : Gummi

Voir ce post.

• Page dédiée sur le wiki : vim
• Installation de Vim : vim
• Plugin vim-latexsuite vim-latexsuite

Vim a aussi son plugin latex :)

• Page du wiki montrant un exemple de configuration d'emacs avec AucTeX: Écrire en LaTeX avec Emacs : exemple de configuration
• Installation : emacs
• Plugin auctex : auctex (conseillé)

Emacs permet d'éditer du code, l'édition est aussi facilitée avec son plugin auctex.

• Plugin Whizzytex : whizzytex
• Plugin yatex yatex
• Plugin texmacs texmacs

• Page dédiée sur le wiki : gedit.
• Installation de gedit : gedit
• Installation de gedit LaTeX Plugin : gedit-latex-plugin
• Installation d'une liste de plugins gedit : gedit-plugins

En premier lieu, il est fortement conseillé de configurer gedit de façon à faciliter la programmation. En particulier, dans Préférences → Affichage, cocher

• Afficher les numéros de ligne (indispensable pour revenir rapidement sur des lignes incorrectes relevées lors d'une compilation)
• Surligner la ligne actuelle (plutôt utile pour se repérer rapidement dans le code
• Surligner les parenthèses correspondantes (permet en particulier d'identifier rapidement si les {} des commandes sont bien situés).

Dans Préférences → Éditeur, il est aussi fortement conseillé d'activer l'indentation automatique.

Quelques raccourcis par défaut, qui s'avèrent très utiles à l'usage:

• Ctrl + D permet de supprimer la ligne courante.
• Alt + flèche haut ou bas permet de déplacer d'un bloc la ligne courante respectivement au dessus de la ligne supérieure ou en dessous de la ligne inférieure.

Notons enfin que depuis la version 10.04, une (ou plusieurs) ligne sélectionnée sera automatiquement indentée par la commande tabulation, et désindentée par la commande shift + tabulation.

Une des façons les plus simples est d'utiliser le plugin latex de gedit.

Attention cependant à ne pas oublier l'extension .tex (exemple : fichier.tex) dans votre fichier sinon gedit vous indiquera qu'il n'arrive pas à compiler.

Installation du plugin pour Ubuntu 8.10 et inférieur :

• Télécharger l'archive et copier son contenu dans ~/.gnome2/gedit/plugins.
• Installer les paquets rubber et texlive-latex-recommended
• Activer le plugin dans gedit (édition→préférence→greffon). Enjoy !

Utilisation alternative de Gedit sans le plugin LaTex dédié.

Pour ceux qui n'ont pas été convaincus par le plugin dédié à LaTex, Gedit peut malgré tout être un outil assez puissant pour LaTeX pour peu que l'on utilise quelques plugins appropriés du paquet gedit-plugins Pour activer ces plugins, aller dans Édition → Préférences → Greffons. Parmi les plugins les plus intéressants, on note:

• « Commentateur de code » : permet de commenter/décommenter une ligne avec un raccourci clavier (Ctrl + M / Ctrl + Shift + M) (ce plugin peut aussi servir pour d'autres langages de programmation)
• « Signets » : permet d'installer des marqueurs dans le fichier source pour en avoir un accès rapide via un raccourci clavier
• « Outils externes » : permet de programmer des scripts qui pourront par exemple effectuer la compilation automatique du document latex (les résultats de la compilation s'afficheront dans une console en bas de gedit)
• « Extraits de code » : particulièrement utile (et même indispensable pour ceux qui en ont pris l'habitude), ce plugin permet de programmer des raccourcis clavier personnalisés pour entrer des commandes courantes de LaTeX. Par exemple, « sec » suivi immédiatement d'une tabulation sera remplacé par \section{[un texte à remplir]} ; une nouvelle tabulation amènera ensuite immédiatement à la ligne suivante (ou en fin de ligne, au choix).

L'emploi de ces quatre plugins (éventuellement combinés avec d'autres dans la liste des greffons) permet déjà une pratique extrêmement confortable (même si le plugin LaTeX dédié peut éventuellement faire l'affaire à lui seul).

• Page dédiée sur le wiki : geany
• Installation de geany : geany
• Plugin : geany-plugin-latex

Geany est un IDE, et ce plugin permet d'éditer du code latex.

Pour consulter la documentation d'un package :

texdoc nom_du_package

Un module vous permet de réaliser vos présentations en latex : latex-beamer

Placez ensuite en en-tête de votre document :

\documentclass[slidetop,9pt]{beamer}

puis initialisez le document :

\begin{document}

Pour insérer une diapo, procédez comme suit :

\begin{frame}{Le titre de la diapo dans la barre de menu}
   \frametitle{Le titre de la diapo}
   Le contenu de la diapo
\end{frame} 

et terminez le document avec :

\end{document}

Vous trouverez un tutoriel complet ici.

De nombreux thèmes de présentation sont disponibles : en voir un aperçu ici

• L'extension OOoLatex permet d'intégrer des équations LaTeX dans des documents OpenOffice (Writer et Impress).
• L'extension TexMaths permet d'intégrer des équations LaTeX dans des documents LibreOffice (Writer, Impress et Draw).

• la chaine éditoriale Scenari et plus spécifiquement Opale permettent d'intégrer et de générer des documents avec des formules LaTeX.

• la poule ou l'œuf est une chaîne éditoriale prenant en compte le format LaTeX

• SPIP est un CMS qui permet de générer automatiquement des contenus avec des formules LaTeX

• Gajim permet de taper des formules en latex après avoir activé l'option use_latex (nécessite le programme dvipng).

• Pidgin dispose d'un greffon (installé par défaut) permettant de taper des formules en latex.

• Pidgin dispose d'un greffon permettant de taper des formules en latex.

• Inkscape dispose d'une fonctionnalité permettant de représenter des formules en latex.

• latexdraw est un logiciel de dessin vectoriel pour latex. Il génère soit du code PSTricks, soit un pdf compilé avec latex le tout intégrable dans un document comme figure. À partir de sa version 3, latexdraw permet notamment d'éditer et de visualiser nativement du texte et des formules latex. latexdraw.sourceforge.net latexdraw

• anki

• mnemosyne

Voir Pandoc.

• On peut exporter un document odt en latex avec OpenOffice.org (il faut installer le paquet openoffice.org-writer2latex).
• Writer2latex permet de convertir les documents odt en fichier latex.

Utiliser wv

Il se peut que vous ayez besoin de convertir un document Latex vers un autre format.

Le logiciel Pandoc permet, en ligne de commande, de passer directement du format LaTeX (.tex) aux formats Rich Text File (.rtf), Word 2010 (.docx), OpenDocument (.odt), HTML, mathML et bien d'autres. Les solutions ci-dessous sont déjà anciennes voire obsolètes, moins complètes et souvent bugguées .

Ces formats sont gérés de base avec toutes les distributions latex. Voici les commandes respectives pour créer ces fichiers :

• PDF : pdflatex
• DVI : latex
• PS : latex puis dvi2ps

Le RTF est un format de fichier de traitement de texte que vous pourrez facilement convertir ensuite en format Microsoft Word ou OpenOffice.org avec openoffice.org. Il suffit d'installer le paquet latex2rtf.

Ensuite pour convertir :

latex2rtf -M12 fichier.tex

L'option -M12 permet de convertir en images les formules de votre document grâce au script latex2png.

Plusieurs utilitaires permettent de créer un document html à partir d'un fichier latex :

• tex4ht
• hevea
• latex2html
• tth

Nous vous conseillons d'essayer d'abord le premier qui en général rend de meilleurs résultats, puis le second, …

Il y a deux moyens de créer des documents odt à partir d'un fichier latex :

• Soit on crée d'abord un fichier html comme expliqué plus haut, puis on l'ouvre avec OpenOffice.org
• Soit on utilise tex4ht avec une de ces deux commandes :

mk4ht oolatex fichier.tex
mk4ht ooxelatex fichier.tex

(Il peut être utile de lancer plusieurs fois la commande pour avoir un bon résultat, comme pour toute compilation latex !)

Contrairement à Windows, il vous faudra utiliser le codage de caractères UTF-8 (et non latin1). L'en-tête contient alors :

...
\usepackage[utf8]{inputenc}   % accents dans la source
...

Par contre, si vous souhaitez encoder vos fichiers en latin1, vous pouvez aussi taper le code suivant :

...
\usepackage[latin1]{inputenc}
...

Toutefois, si certains caractères unicode posent problème lors du rendu final, ajouter les dans l'entête avec :

\PrerenderUnicode{é,è,à} 

Enfin si vous voulez convertir l'encodage d'un fichier tex, de latin1 vers UTF8 par exemple, vous pouvez utiliser la ligne de commande iconv.

Un autre moyen est d'utiliser recode pour transformer les caractères accentués en balise LaTeX :

Si fichier.tex utilise UTF-8

 recode -d UTF-8..LaTeX fichier.tex 

Si fichier.tex utilise latin1

 recode -d latin1..LaTeX fichier.tex 

ou si on veut préserver le fichier original :

 recode -d UTF-8..LaTeX < fichier.tex > nouveau_fichier.tex

Pour en finir avec les problèmes d'encodage, on utilisera XeLaTex ou LuaLaTeX.

Si vous avez un problème pour la sélection de texte avec Evince allez jeter un œil sur la page consacrée à Evince.

Si vous obtenez des erreurs du type :

Font OT1/ptm/m/n/20.74=ptmr7t at 20.74pt not loadable: Metric (TFM) file not found

L'installation du paquet latex2html peut corriger le problème.

• Documentation LaTeX [en]
• Groupe francophone des utilisateurs de TeX

• Le framabook (livre libre) Latex : très bon livre assez complet (~300 pages).
• Une courte introduction à LaTeX : une référence …ressuscitée (~130 pages)
• Guide LaTeX sur Wikibook, Guide LaTeX sur Wikibook (en)

• FAQ-LaTeX [fr]
• La page LaTeX des tuteurs de l'ENS (École Normale Supérieure) : excellent guide donnant de nombreuses bases essentielles dans la rédaction d'un document TeX.
• Tutoriel LaTeX sur le Site du Zéro[fr].

• Tutorial Beamer
• Liste des thèmes beamer

• Introduction au LaTeX - www.math-linux.com
• Groupe d'utilisateurs TeX [en] et d'autres liens intéressants
• Guide Pratique teTeX [fr]
• FAQ Latex de Développez.com
• Communauté active d'utilisateurs de LaTex en Mathématiques

Contributeurs : Gauthier, Freetux, djibi, L.Bellegarde, Steren Giannini, Ner0lph. Remise en forme par quent57 et Darkar