Sélection des meilleures règles pour structurer et pour coder un document LaTeX, notamment des formules mathématiques, pour un rendu optimal sur les pages HTML d'un site et sur les documents PDF générés.

RÉDACTION EN COURS

Cet article n'a pas pour but de se transformer en cours de saisie de textes avec le langage LaTeX. Il se veut simplement un aide-mémoire des usages qui ont donné un résultat acceptable aussi bien pour la publication d'une page HTML d'un site au travers de MathJax que pour la génération d'un fichier PDF à télécharger.

Si vous détectez une erreur ou si vous connaissez une meilleure façon de faire sur un point, n'hésitez pas à en faire profiter tout le monde en cliquant sur le mot commentaire en bas de cette page !

1. Structure d'un document Latex

1.1. Déclarations

babel multiple

1.2. Entête du document

Attention ! L'entête du document n'est pas repris automatiquement lors de l'importation d'un document LaTeX. Le titre doit être soit recopié dans le champ Titre de l'article (œuvre), soit éclaté dans les champs Titre et Sous-titre ; le résumé doit être recopié dans le champ Description.

Titre

Résumé

1.3. Chapitrage

 \‎section, \‎subsection, \‎subsubsection

Ajouter une ligne de commentaire juste au dessus de la commande. Ex. : % § 3.1.

1.4. Listes à puces et listes numérotées

\‎begin{itemize}
\item Texte 1
\item Texte 2
\end{itemize}
  • Texte 1
  • Texte 2
\‎begin{enumerate}
\item Texte 1
\item Texte 2
\end{enumerate}
  1. Texte 1
  2. Texte 2

Bogue ! Cette commande refuse les paramètres. De plus, la version française supprime les interlignes, notamment à la fin. Ceci oblige à forcer un saut de ligne par ~\\ par exemple.

2. Insertion des images

Les références des images font l'objet d'un traitement automatique lors de l'importation du fichier .tex sur le serveur. Les spécifications mentionnées dans le présent chapitre doivent être strictement respectées pour que les images apparaissent correctement aussi bien sur les documents PDF que les pages HTML générés.

2.1. Enregistrement des images

dans le même dossier que le fichier .tex

en objet joint sur le serveur, le titre servant de légende

2.2. Images flottantes

[8] : nombre de lignes de texte en retrait (PDF)
{r} : flottement à droite (PDF, HTML ?)
{50mm} : largeur d'affichage (PDF et HTML)
{-4mm} : placement en hauteur (PDF)
[scale=.7] : échelle d'affichage (PDF)
\‎begin{wrapfigure}[8]{r}{50mm}
   \‎\vspace{-4mm}
   \‎includegraphics[scale=.7]{image.jpg}
\‎end{wrapfigure}

3. Règles typographiques

 espacement et retrait en début de paragraphe en PDF -> éviter les pliages de lignes par \‎\‎

image flottante et texte juste en-dessous

texte et formule en plein texte juste en-dessous, puis saut de paragraphe

4. Expressions mathématiques

4.1. Expressions en ligne et expressions séparées

Les expressions mathématiques peuvent être placées en ligne, c'est-à-dire dans le flot du texte entre deux caractères $.
NB : Le code HTML généré les place entre \‎( et \‎).

Elles sont affichées au centre d'un nouveau paragraphe quand elles sont saisies entre \‎[ et \‎] ou dans une commande LaTeX d'alignement.

L'équation $a=b$ en ligne. L'équation \(a=b\) en ligne. L'équation séparée : \‎[a=b\‎] L'équation séparée : \[a=b\]

4.2. Espacements

~ ou \

\quad et \qquad

4.3. Caractères spéciaux

\‎\backslash → \‎

Angstrom : \‎AA → Å en mode texte ; \‎text{Å} → Å en mode maths

Degrés : ° en mode texte, ^\‎circ en mode maths
On écrit 21 °C avec une espace et 4 K en kelvins, sans le symbole °.

4.4. Opérateurs

Pour les distinguer les uns des autres, les opérateurs de fonctions sont écrits en caractères droits et les variables en obliques.

Pour un opérateur que Latex ne reconnait pas, le faire précéder de \‎rm et placer le tout entre accolades { }.
Ex. : {\‎rm ftn}(x) → \( {\rm ftn}(x) \)

4.5. Variables

romain, grec, cyrillique

polices \‎mathbb{R} → \(\mathbb{R}\)

indices et exposants

vecteurs, chapeau

remplacer \‎bar (ex. : \(\bar{X}\)) par \‎overline (ex. : \(\overline{X}\))

4.6. Parenthèses, crochets et accolades

Taille de base : (  ), [  ], \‎{  \‎}
Taille automatique : \‎left( et \‎right) – NB : \‎right. ou \‎left. demande de ne pas afficher un côté.

Taille moyenne : \‎big(

Grande taille : \‎bigl bigr, \‎Bigl Bigr, \‎biggl biggr, \‎Biggr Biggr

Angles : \(\langle\) \‎langle, \(\rangle\) \‎rangle

4.7. Textes

\‎text{Ceci est un texte.}

Il est possible de placer des formules en ligne entre $.

Bogue ! La  version PDF interprète les commandes LaTeX non placées entre $. -> toujours les placer entre $ pour la version HTML.

4.8. Symboles

4.8.1. Opérateurs

\‎star \(\star\)

\‎forall \(\forall\)  ;  \‎exits \(\exists\)

4.8.2. Flèches

\‎Rightarrow \(\Rightarrow\)

\‎overrightarrow{ABC} \(\overrightarrow{ABC}\)

\‎xrightarrow[T]{n+1} \(\xrightarrow[T]{n+1}\)

Point centré : \‎cdot \(\cdot\)

Points de suite : \‎dots \(\dots\) ou \‎cdots \(\cdots\)

4.8.3. Chapeaux

\‎widehat{ABC} \(\widehat{ABC}\)

4.9. Fonctions

4.9.1. Formules courantes

\‎frac et \‎cfrac

4.9.2. Ajout d'une fonction

déclaration ?

Usage comme toute autre fonction : \‎Pr(X)

4.10. Systèmes de formules

L'ajout de * après le nom de l'environnement supprime la numérotation automatique des formules.

Éviter \‎begin{equarray} qui n'aligne que des formules et qui ajoute des espacement autour du signe =.

4.10.1. Formules simples

\‎begin{align*}  avec placement automatique des taquets

\‎begin{alignat*}[n]  avec placement manuel des taquets
avec n = (nombre max de taquets sur une ligne + 1) / 2
Bogue ! En HTML, le nombre n est affiché.

& comme taquet d'alignement, alternativement à gauche ou à droite.

\‎intertext{texte séparatif} préserve les alignements. → non testé

4.10.2. Formules complexes
\‎[ f(x)=
\‎begin{aligned}
&0 \‎qquad 0<x<1 \\
&1 \‎qquad \‎text{ailleurs}
\‎end{aligned} \‎]
\[ f(x)=
\begin{aligned}
&0 \qquad 0<x<1 \\
&1 \qquad \text{ailleurs}
\end{aligned} \]
\‎[ f(x)=\‎left\‎{
\‎begin{aligned}
&0 \‎qquad 0<x<1 \\
&1 \‎qquad \‎text{ailleurs}
\‎end{aligned}
\‎right.\‎]
\[ f(x)=\left\{
\begin{aligned}
&0 \qquad 0<x<1 \\
&1 \qquad \text{ailleurs}
\end{aligned}
\right.\]
4.10.3. Formules multi-lignes

Pour les longues formules qui ne tiennent pas sur une seule ligne.

\‎multline -> non testé !

4.10.4. Formules encadrées
\‎[ \‎boxed{c^2=a^2+b^2} \‎] \[\boxed{c^2=a^2+b^2}\]

4.11. Tableaux

La commande \‎tabular n'est pas interprétée par MathJax, car elle n'est applicable qu'en mode texte, pas en mode formule. On pourra utiliser à ma place l'environnement array ; il ne faudra pas oublier d'encadrer dans un bloc \‎text{ } les textes à afficher et caractères droits ou contenant des caractères accentués.

\‎[
\‎begin{array}{r|r|r}
2 & 3 & 6 \‎\‎
\‎hline
12 & 200 & 2~400 \‎\‎
\‎end{array}
\‎] 

\[
\begin{array}{r|r|r}
2 & 3 & 6 \\
\hline
12 & 200 & 2~400 \\
\end{array}
\]

La commande \‎multicolumn n'est pas non plus interprétée par MathJax et il n'y a pas de contournement connu.

4.12. Matrices

version 0.9.5-0429-141203
↑ Haut