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 : \tex­tit{texte à mettre en ita­lique}.

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

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 \under­line{texte à sou­li­gner} 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 :

Pour mettre les chiffres en bas de casse, vous pou­vez uti­li­ser la com­mande \old­sty­le­nums{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 : \text­su­per­script{super­script} et \text­sub­script{sub­script}.

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 bfse­ries. À 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
  
• {\script­size plop} : très très petit
  
• {\foot­no­te­size plop  : très petit
  
• {\small plop} : petit
  
• {\nor­mal­size plop} : nor­male (taille défi­nie dans le \docu­ment­class)
  
• {\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

À 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 :

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…) :

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 docu­ment­class, selon votre ver­sion de babel).

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

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

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) :

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 :

Ce qui donne :

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 : min­ted.

Installation de minted

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

ou encore

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

Préparation de Texmaker à l'utilisation de minted

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

Pour cela, allez dans Options, Confi­gu­rer Tex­Ma­ker et ajou­ter l'option -shell-escape après la com­mande pdfla­tex.

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 min­ted :

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

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

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

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

Ce qui donne :

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 :

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 :

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 :

Vous pou­vez mettre dans votre pré­am­bule autant de \use­min­ted­style 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 :

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

Encore un peu de flottants…

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

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

Ce qui donne :

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

Ce qui donne :

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 min­ted avec une option et cus­to­mi­ser ça comme ça (dans le pré­am­bule) :

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

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 :

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

Numéroter les lignes

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

Voyez :

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 🙂 :

Ce qui donne :

Bon, je pour­rais conti­nuer long­temps à vous par­ler des trucs coolish que peut faire min­ted, 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 :

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

Ce qui donne :

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

Ce qui donne :

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 !