- Le blog participatif de bioinformatique francophone depuis 2012 -

LaTeX : la mise en forme du texte et des paragraphes

-

par

Maria Pommeret
dans

Bon main­te­nant qu'on sait com­pi­ler et insé­rer des flot­tants, un truc cri­tique à voir c'est com­ment mettre en forme : mettre en ita­lique, en emphase, en gras, sou­li­gner, faire des listes à puces, insé­rer du code…

Pré­pa­rez-vous, ça risque d'être un peu long :). (Et par un peu long je veux aus­si dire un peu enqui­qui­nant, mais il faut y pas­ser…)

Mise en forme du texte

Faire joujou avec la police

Par défaut, LaTeX met les carac­tères en forme droite en minus­cule. On peut chan­ger cela 🙂

Mise en emphase

La com­mande \emph{texte} per­met de mettre de l'emphase sur le texte entre acco­lades. Dans un contexte « nor­mal » c'est-à-dire droit, le texte sera mis en ita­lique, et dans un contexte ita­lique le texte sera mis en forme droite. C'est très pra­tique pour mettre en évi­dence du mot dans un texte.

Tes­tez 🙂

Italique et soulignage

Pour mettre en ita­lique le texte, rien de plus simple, il suf­fit d'utiliser cette com­mande : \textit{texte à mettre en italique}.

Si l'on sou­haite, on peut éga­le­ment uti­li­ser l'environnement itshape de la façon sui­vante :

1
2
3
\begin{itshape}
    \lip­sum[1]
\end{itshape}

L'utilisation de l'environnement est assez rare, mais il faut l'avoir vu, ce qui est chose faite 🙂

Il est éga­le­ment pos­sible de sou­li­gner du texte avec LaTeX avec la com­mande \underline{texte à souligner} mais je trouve ça très moche et ce n'est pas recom­man­dé de l'utiliser, sauf contraintes excep­tion­nelles.

Petites majuscules

Pour mettre les lettres en petites majus­cules (capi­tales), par exemple pour mettre les noms de famille des auteurs dans votre biblio­gra­phie, vous pou­vez uti­li­ser la com­mande \textsc ain­si : 

1
Yann \textsc{Pon­ty}

Pour mettre les chiffres en bas de casse, vous pou­vez uti­li­ser la com­mande \oldstylenums{0123456789}.

Lettres supérieures et inférieures

(C'est-à-dire l'équivalent des expo­sants et des indices en mathé­ma­tiques.) Pour cela on a deux com­mandes très expli­cites : \textsuperscript{superscript} et \textsubscript{subscript}.

Mettre en gras

Pour chan­ger la graisse des carac­tères, il suf­fit d'utiliser la com­mande \textbf{texte à mettre en gras}. Il existe éga­le­ment un envi­ron­ne­ment, comme pour la mise en ita­lique qui s'appelle bfseries. À vous tes­ter, mais il est encore une fois peu uti­li­sé.

Faire joujou avec la taille

Il est pos­sible de modi­fier la taille du texte :

  • {\tiny plop} : minus­cule
  • {\scriptsize plop} : très très petit
  • {\footnotesize plop  : très petit
  • {\small plop} : petit
  • {\normalsize plop} : nor­male (taille défi­nie dans le \documentclass)
  • {\large plop} : légè­re­ment grande
  • {\Large plop} : grande
  • {\LARGE plop} : très grande
  • {\huge plop} : énorme
  • {\Huge plop} : gigan­tesque

Récapitulatif et aspects visuels

Tableau récapitulatif de la mise en forme de texte en LaTeX
Tableau réca­pi­tu­la­tif de la mise en forme de texte en LaTeX

À titre de révi­sion, et parce qu'il y a une com­mande inté­res­sante dedans, je vous four­nis le code source de ce tableau :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
\begin{table}
    \cen­te­ring
    \begin{tabu­lar}{|c|c|c|}
        \hline
        \mul­ti­co­lumn{2}{|c|}{Com­mande} & \mul­ti­row{2}{*}{Ren­du} \\
        \cline{1–2}
        à argu­ment & décla­ra­tive & \\
        \hline
        $\backs­lash$emph\{Plop\} & \{$\backs­lash$em Plop \} & \emph{Plop}\\
        \hline
        $\backs­lash$tex­tit\{Plop\} & \{$\backs­lash$it Plop \} & \tex­tit{Plop} \\
        \hline
        $\backs­lash$under­line\{Plop\} &  & \under­line{Plop} \\
        \hline
        $\backs­lash$textsc\{Plop\} & \{$\backs­lash$sc Plop\} & \textsc{Plop} \\
        \hline
        $\backs­lash$text­su­per­script\{Plop\} &  & \text­su­per­script{Plop} \\
        \hline
        $\backs­lash$text­sub­script\{Plop\} &  & \text­sub­script{Plop} \\
        \hline
        $\backs­lash$textbf\{Plop\} & \{$\backs­lash$bf Plop \} & \textbf{Plop} \\
        \hline
        & \{$\backs­lash$tiny Plop\} & {\tiny Plop} \\
        \hline
        & \{$\backs­lash$script­size Plop\} & {\script­size Plop} \\
        \hline
        & \{$\backs­lash$foot­no­te­size Plop\} & {\foot­no­te­size Plop} \\
        \hline
        & \{$\backs­lash$small Plop\} & {\small Plop} \\
        \hline
        & \{$\backs­lash$nor­mal­size Plop\} & {\nor­mal­size Plop} \\
        \hline
        & \{$\backs­lash$large Plop\} & {\large Plop} \\
        \hline
        & \{$\backs­lash$Large Plop\} & {\Large Plop} \\
        \hline
        & \{$\backs­lash$LARGE Plop\} & {\LARGE Plop} \\
        \hline
        & \{$\backs­lash$huge Plop\} & {\huge Plop} \\
        \hline
        & \{$\backs­lash$Huge Plop\} & {\Huge Plop} \\
        \hline
    \end{tabu­lar}
    \label{tab :plop}
\end{table}

Les guillemets

Les guille­mets c'est toute une affaire… Vous avez déjà dû avoir à faire à des trolls qui vous ont dit que vous n'utilisiez pas les guille­mets fran­çais quand vous le devriez etc. Heu­reu­se­ment, vous ne ferez plus l'erreur avec LaTeX !

Pour cela, vous allez devoir ajou­ter un paquet à votre pré­am­bule (avouez que ça vous man­quait…) :

1
\use­pa­ckage[babel=true]{csquotes}

Vous signi­fiez ain­si au paquet csquotes d'utiliser la langue que vous avez pas­sé à babel (soit en para­mètre, soit dans le documentclass, selon votre ver­sion de babel).

Vous pou­vez alors uti­li­ser la com­mande sui­vante :

1
\begin{docu­ment}

Je vais citer une phrase mau­dite : \enquote{J'ai per­du !} qui va auto­ma­ti­que­ment avoir les bons guille­mets !

1
\end{docu­ment}

Alter­na­ti­ve­ment, vous pou­vez uti­li­ser les com­mandes \og plop \fg{} du paquet babel, je ne vous en tien­drai pas rigueur 🙂

Points de suspension

Pour écrire des points de sus­pen­sion, vous pou­vez soit uti­li­ser le carac­tère idoine …, soit uti­li­ser la com­mande \ldots.

Tirets

Il existe plu­sieurs types de tirets en LaTeX (dont le signe moins en mathé­ma­tiques qu'on ver­ra plus tard) :

  • -  : le trait d'union
  • –  : le tiret demi-cadra­tin (uti­li­sé pour mar­quer un inter­valle ou les incises)
  • —  : le tiret cadra­tin (uti­li­sé pour mar­quer l'alternance des per­son­nages dans les dia­logues)

Mise en forme des paragraphes

Comme vous l'avez sûre­ment remar­qué, par défaut, le texte est jus­ti­fié et com­mence par un ali­néa. Pour com­men­cer un nou­vel ali­néa, il suf­fit de pas­ser une ou plu­sieurs lignes vides (LaTeX s'en contre­fiche du nombre, mais vous pas, ça peut vous aider à vous retrou­ver dans votre code source).

Alignement des paragraphes

Si vous sou­hai­tez modi­fier l'alignement de votre texte, c'est-à-dire qu'il ne soit plus jus­ti­fié, LaTeX vous pro­pose trois envi­ron­ne­ments (avec les com­mandes équi­va­lentes) :

Ali­gne­ment des para­graphes en LaTeX
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
\begin{table}
    \cen­te­ring
    \begin{tabu­lar}{|c|c|c|}
        \hline
        Ali­gne­ment & Envi­ron­ne­ment & Com­mande \\
        \hline
        Jus­ti­fié à gauche & \texttt{flu­sh­left} & \texttt{$\backs­lash$rag­ged­left} \\
        \hline
        Jus­ti­fié à droite & \texttt{flush­right} & \texttt{$\backs­lash$rag­ge­dright} \\
        \hline
        Cen­tré & \texttt{cen­ter} & \texttt{$\backs­lash$cen­te­ring} \\
        \hline
    \end{tabu­lar}
    \label{tab :para­graphes}
\end{table}

Paragraphe de résumé (abstract)

Il est clas­sique dans un article (ou un report) de com­men­cer par un résu­mé (un abs­tract dans le jar­gon). Pas de panique ! LaTeX a juste le bon envi­ron­ne­ment pour vous :

1
2
3
\begin{abs­tract}
    Ceci est un abs­tract. Oui il est très court. J'avais grave la flemme.
\end{abs­tract}

Ce qui donne :

Aspect du résumé (qui dépend encore une fois de babel)
Aspect du résu­mé (qui dépend encore une fois de babel)

Le résu­mé prend une page entière et est tra­di­tion­nel­le­ment mis avant le début du texte.

Mise en forme de code

Il existe envi­ron douze mil­liards de façon de mettre en forme du code avec LaTeX, je vais vous pré­sen­ter exclu­si­ve­ment ma pré­fé­rée : minted.

Installation de minted

Pour cela il va vous fal­loir Python >= 2.6 parce qu'on a besoin de Pygments. Vous pou­vez ins­tal­ler Pygments de la façon sui­vante :

1
sudo easy_​install Pyg­ments

ou encore

1
pip ins­tall Pyg­ments

Puis uti­li­sez votre ges­tion­naire de paquets pour ins­tal­ler le paquet minted.

Préparation de Texmaker à l'utilisation de minted

Alors en fait puisque minted cause au monde exté­rieur (à savoir Pygments), il faut pas­ser une option à pdflatex pour que ça puisse se faire : l'option -shell-escape.

Pour cela, allez dans Options, Confi­gu­rer TexMaker et ajou­ter l'option -shell-escape après la com­mande pdflatex.

Bon, faites gaffe à ce que vous faites avec cette option parce que l'option -shell-escape auto­rise LaTeX à exé­cu­ter des com­mandes arbi­traires sur votre machine, du coup faites-le sur des docu­ments en qui vous avez confiance…

Utilisation de minted

C'est très simple d'utiliser minted :

1
2
3
4
5
6
7
\begin{min­ted}{python}
def fah­ren­heit(T_​in_​cel­sius):
    """
    Returns the tem­pe­ra­ture in degrees Fah­ren­heit.
    """
    return (T_​in_​cel­sius * 9 /​ 5) + 32
\end{min­ted}

Main­te­nant, com­pi­lez et vous obtien­drez :

Et hop ! De la colo­ra­tion syn­taxique.

Si vous vou­lez insé­rer une seule ligne de code, vous pou­vez uti­li­ser la com­mande sui­vante :

1
\mint{python}|import this|

Ce qui donne exac­te­ment le même résul­tat qu'avec l'environnement :

Tou­jours de la colo­ra­tion syn­taxique !

Si vous vou­lez inli­ner du code, la com­mande appro­priée est \mintinline qui s'utilise de la façon sui­vante :

1
Lala­la j'écris du texte et puis pouf je mets du code python \min­tin­line{python}{import this} lala­la.

Ce qui donne :

Du code inli­né \o/​

Et si, comble du luxe, vous vou­lez insé­rer un fichier entier de code (sait-on jamais pour un cor­ri­gé de TD ça peut ser­vir…), vous pou­vez uti­li­ser la com­mande sui­vante :

1
\input­min­ted{python}{exo1.py}

Les styles minted

Il existe une foule de styles min­ted que vous pou­vez uti­li­ser pour colo­rer votre code. Je vous sug­gère de consul­ter http://​pyg​ments​.org/​d​e​mo/ d'y envoyer un bout de code et de tes­ter les dif­fé­rents styles qui vous seront pro­po­sé après avoir cli­qué sur High­light !

Pour voir la liste des styles dis­po­nible (ain­si qu'une brève des­crip­tion), vous pou­vez taper dans votre ter­mi­nal la com­mande sui­vante :

1
pyg­men­tize -L styles

Une fois que vous avez trou­vé le style qui vous convient, vous pou­vez le sélec­tion­ner dans le pré­am­bule de la manière sui­vante :

1
\use­min­ted­style[lan­gages]{nom_​du_​style}

Vous pou­vez mettre dans votre pré­am­bule autant de \usemintedstyle que vous vou­lez pour autant de lan­gage que vous sou­hai­tez.

Vous pou­vez aus­si mettre le style que vous vou­lez en pas­sant cela en option à l'environnement :

1
2
3
4
5
6
7
\begin{min­ted}[style=manni]{python}
def fah­ren­heit(T_​in_​cel­sius):
    """
    Returns the tem­pe­ra­ture in degrees Fah­ren­heit.
    """
    return (T_​in_​cel­sius * 9 /​ 5) + 32
\end{min­ted}

Ce qui donne un style légè­re­ment dif­fé­rent :

Uti­li­sa­tion du thème man­ni alors que le thème vim a été uti­li­sé pour l'ensemble du docu­ment.

Encore un peu de flottants…

minted donne accès à l'environnement listing qui mets le code dans un envi­ron­ne­ment flot­tant, ce qui per­met d'avoir une légende (via \caption) et une réfé­rence (via \label), tout comme pour les tables ou les figures.

Voi­ci com­ment pro­cé­der :

1
2
3
4
5
6
7
8
9
10
11
\begin{lis­ting}
\begin{min­ted}{python}
def fah­ren­heit(T_​in_​cel­sius):
    """
    Returns the tem­pe­ra­ture in degrees Fah­ren­heit.
    """
    return (T_​in_​cel­sius * 9 /​ 5) + 32
\end{min­ted}
\cap­tion{Exemple de code flot­tant}
\label{lst :exemple}
\end{lis­ting}

Ce qui donne :

Et tada, un envi­ron­ne­ment flot­tant pour le code !!

Bon, et vous savez ce qui vient :). La com­mande magique pour obte­nir la liste des lis­tings :

1
\lis­to­flis­tings

Ce qui donne :

Hor­reur et dam­na­tion, c'est en anglais, babel nous a tra­his !

Dam­mit.

Heu­reu­se­ment, c'est réglable. Pour cela il va fal­loir bidouiller un peu, et pour faire ça il faut char­ger le paquet minted avec une option et cus­to­mi­ser ça comme ça (dans le pré­am­bule) :

1
2
\use­pa­ckage[new­float]{min­ted}
\Setup­Floa­tin­gEn­vi­ron­ment{lis­ting}{listname=Liste des Codes}%

Et après com­pi­la­tion, on obtient :

Ouf, nous voi­là sau­vés 🙂

Pour chan­ger le nom de la légende en « Code » au lieu de « Lis­ting » (parce que je pré­fère et que c'est plus expli­cite), il suf­fit d'utiliser la même méthode :

1
\Setup­Floa­tin­gEn­vi­ron­ment{lis­ting}{name=Code}

Et on obtient après com­pi­la­tion :

Et voi­là, on a cus­to­mi­sé le nom de l'environnement !

Numéroter les lignes

Il est pos­sible de numé­ro­ter les lignes en uti­li­sant l'option linenos (soyez atten­tif, il y a un truc coolish ^^) :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
\begin{lis­ting}[h]
\begin{min­ted}[line­nos]{python}
def f(x):
    return x**2
\end{min­ted}
\
\begin{min­ted}[line­nos]{ruby}
def func
    puts "mes­sage"
end
\end{min­ted}
 
\begin{min­ted}[line­nos, firstnumber=last]{python}
def g(x):
    return 2*x
\end{min­ted}
\end{lis­ting}

Voyez :

Vous voyez à quel point c'est trop cool LaTeX ?

Des maths dans les commentaires ? Sure why not !

Je sais que j'ai pas encore par­lé de maths en LaTeX, donc reve­nez à cette sous-sec­tion plus tard 🙂 ! L'important c'est que vous ayez une réfé­rence de com­ment faire 🙂 :

1
2
3
4
5
6
\begin{min­ted}[mathes­cape]{python}
def sum_​from_​one_​to(n):
    # Returns $\sum_{i=1}^{n}i$
    r = range(1, n + 1)
return sum(r)
\end{min­ted}

Ce qui donne :

Une jolie somme ! \o/​

Bon, je pour­rais conti­nuer long­temps à vous par­ler des trucs coolish que peut faire minted, mais l'article est déjà long et il reste d'autres trucs cool à voir, on y revien­dra peut être plus tard !

Mise en forme d'algorithmes

Il existe envi­ron douze mil­liards de façon de for­ma­ter des algo­rithmes avec LaTeX, je vais vous pré­sen­ter mon pré­fé­ré. Pour com­men­cer, allons mettre ce qu'il faut dans le pré­am­bule :

1
2
\use­pa­ckage[lines­num­be­red,lined,boxed,com­ments­num­be­red]{algorithm2e}
\SetAl­go­rithm­Name{Algo­rithme}{Liste des algo­rithmes}

L'utilisation de base est assez simple, comme vous pou­vez le consta­ter avec cet exemple tiré de la docu­men­ta­tion :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
\begin{algo­rithm}
    \SetAl­go­Li­ned
    \KwDa­ta{Cet article}
    \KwRe­sult{Com­ment faire du for­mat­tage de texte et de para­graphe avec \LaTeX}
    ini­tia­li­sa­tion\;
    \While{pas à la fin du docu­ment}{
        lire para­graphe cou­rant\;
        \eIf{com­prendre}{
            aller au para­graphe sui­vant\;
            para­graphe cou­rant devient celui là\;
        }{
            retour­ner au début du para­graphe\;
        }
    }
    \cap­tion{Com­ment écrire un algo­rithme}
    \label{alg :algo-com­prendre}
\end{algo­rithm}

Ce qui donne :

Et un pre­mier algo tout beau tout propre

On peut faire des choses plus com­plexes comme celle-ci :

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
\begin{algo­rithm}
\KwDa­ta{Les don­nées\\
qui peuvent être mises sur plu­sieurs lignes…\\
\Indp et inden­tées
}
\KwRe­sult{Même chose pour les résul­tats}
%-% Défini­tion d'une donnée cus­tom
\SetKw­Da­ta{data1}{data1}
%-% Défini­tion d'une fonc­tion cus­tom
\SetKw­Func­tion{function1}{function1}
\tcc{Un com­men­taire pour dire qu'on com­mence le code}
\If(\tcc*[h]{un simple if mais avec un com­men­taire}){ceci est vrai}{
on fait ça, sinon rien\;
\tcc{On va intro­duire d'autres if pour mon­trer que c'est pos­sible}
\eIf{on est d'accord}{
on fait ça\;
}{
sinon, on fait des choses plus com­pli­quées\;
\uIf{cette pre­mière pro­po­si­tion est vraie}{
on fait ça\;
}
\uEl­seIf{cette autre pro­po­si­tion est vrai}{
on fait cela \tcc*[r]{else if}
}
\Else{
}
}
}
\tcc{main­te­nant les boucles}
\For{\for­cond}{
une boucle for\;
}
\While{i < n}{
une boucle while conte­nant un repeat – until\;
\Repeat{condi­tion d'arrêt}{
faire cette chose\;
}
}
\tcc{et on ter­mine}
\Return 0
\end{algo­rithm}

Ce qui donne :

Un bel algo­rithme avec tout plein de key­words

Bon bah je pense que c'est tout pour cette fois, on se retrouve bien­tôt !

Un grand mer­ci à mes relecteur.rice.s : Max, Nisaea, et Pau Ssrls !

Vous avez aimé ? Dites-le nous !

Moyenne : 0 /​ 5. Nb de votes : 0

Pas encore de vote pour cet article.

Partagez cet article :

Chopopope

Maria Pommeret

Après un master en bioinformatique et biostatistiques (master BIBS - Université Paris-Sud), j'ai débuté une thèse sur la structure secondaires des ARNs de bovin, entre le LIX (Laboratoire d'Informatique de Polytechnique) et l'unité G2B (Génétique et Génomique Bovine) de l'INRA Jouy-en-Josas.

Pour continuer la lecture :

Commentaires

4 réponses à “LaTeX : la mise en forme du texte et des paragraphes”

  1. Avatar de Nibuald
    Nibuald

    Petite ques­tion : Com­ment faites vous pour rendre latex inter-opé­rable avec les autres outils ? Je m'explique : vous écri­vez un article, une thèse, un mémoire, … et vous vou­driez le faire cor­ri­ger. Quels moyens pour ajou­ter des com­men­taires et des révi­sions à l'instar d'un Micro­soft Word ou Google Docs ?

    Répondre
    1. Yoann M.
      Yoann M.

      Per­son­nel­le­ment je com­mente sur le pdf et c'est tout aus­si effi­cace.

      Répondre
    2. Avatar de lucas
      lucas

      Dans ces cas là, une pla­te­forme cen­tra­li­sée semble tout indi­quée (sha­re­la­tex, over­leaf,…),
      si les relec­teurs ne prennent pas peur en voyant du latex.

      Une manière un poil plus com­pli­quée que l'annotation de pdf pro­po­sée par Yoann : sépa­rer le conte­nu tex­tuel du reste (struc­ture prin­ci­pale et pré­am­bule) en les met­tant dans des .tex sépa­rés, et en les impor­tant avec \input{}.

      Main­te­nant, seuls les fichiers conte­nant du texte peuvent être envoyés aux relec­teurs qui ne connaissent pas latex, vu qu'ils ne contiennent que des com­mandes ou du bali­sage léger qui se com­prend vite.

      L'avantage prin­ci­pal est de gar­der la com­plexi­té pour ceux qui veulent (en pas­sant par un docu­ment col­la­bo­ra­tif cen­tra­li­sé comme sha­re­la­tex), et de per­mettre à ceux qui ne veulent pas de pas­ser par un autre moyen (comme google doc ou une ins­tance ether­pad par exemple) pour édi­ter du texte.

      Après, le meilleur sys­tème pour le relec­teur (impri­mer et anno­ter à la main, pour ma part)
      n'est pas sou­vent le meilleur pour l'auteur (avoir un diff entre le fichier ini­tial et le fichier relu).

      Répondre
      1. Avatar de Nibuald
        Nibuald

        Mer­ci lucas pour ta réponse. Je ne connais­sais pas les pla­te­formes cen­tra­li­sées.

        Répondre

Laisser un commentaire