Aller au menu - Aller au contenu

Icône Structurer son premier document

Par Avatar Laleloulilo
Mise à jour : 15/10/2010
Difficulté : Facile Facile Durée d'étude : 4 heures Creative Commons BY-NC-SA
20 808 visites depuis 7 jours, dont 1 426 sur ce chapitre classé 16/786
Durant les deux premiers chapitres de ce cours, vous avez appris l’histoire de LaTeX ainsi que sa nature et son installation. Ce nouveau chapitre sera pour vous l’occasion d’un premier contact avec les logiciels que vous venez d’installer.

Soyez sûrs d’une chose, le plus dur est derrière vous.

Ce chapitre vous permettra d’écrire votre premier document, de l’imprimer, et de comprendre comment LaTeX transforme un ingrat code informatique en un document chatoyant. :)

C’est un chapitre extrêmement important, il explique les mécanismes essentiels de LaTeX.
Retour en haut
Sommaire du chapitre :
Icône du chapitre
Chapitre précédent Sommaire Chapitre suivant
Retour en haut

La compilation

Cette sous-partie développe le concept de compilation et vous permettra d’appréhender le fonctionnement global de LaTeX.

Cette portion du cours s’appuie sur un constat : des lignes de codes se transforment en une mise en page. Vous pouvez voir dans la capture d’écran ci-dessous un document écrit dans une interface graphique ainsi que son résultat une fois passé par la moulinette de votre distribution LaTeX.

Interface graphique vs Pdf


Que s’est il passé ?


Souvenons-nous du chapitre précédent. Nous y avons appris que les interfaces graphiques ne sont pas indispensables. Elles ne jouent qu’un rôle esthétique. En revanche, nous avons appuyé fortement sur le caractère incontournable de l’installation d’une distribution LaTeX. Les distributions sont les pièces centrales, elles permettent de transformer un fichier de ligne de code (ces fichiers sont des .tex) en un fichier imprimable de type ps ou pdf.

Cette transformation s’appelle une compilation. Votre distribution LaTeX transforme votre fichier.tex en un fichier que vous pourrez utiliser par la suite pour vos travaux et vos publications.

Résumons tout cela.

  • Le code est rédigé dans l’interface graphique.
  • La distribution LaTeX le compile.
  • Le fichier .tex de départ se voit transformé en un fichier .ps, .pdf ou .dvi (un format très peu utilisé).


Le processus de création n’est pas plus compliqué que cela. Pour écrire un document il vous suffira d’écrire votre code au sein de l’interface graphique et votre distribution LaTeX se chargera du travail de transformation. Pour que le travail d’écriture du code et de compilation soit plus simple, les interfaces graphiques sont dotées d’une zone réservée aux raccourcis (type caractère spéciaux) qui vous permettrons d’insérer facilement dans vos écrits des bouts de codes dont vous vous servez souvent (nous verrons par la suite que certains accents doivent être traduits en code, et recopiés de façon très fréquente). Une seconde zone, dédiée aux informations liées à la compilation vous permet de suivre les compilations et d’obtenir des informations sur d’éventuels bogues présents dans vos compositions. En somme LaTeX communique avec vous pour vous aider à travailler.

Manipulerons-nous uniquement des fichiers .tex, .dvi, .ps et .pdf avec LaTeX ?


Pour rédiger un livre, il faut une bibliographie, un index et tout un tas d’élément que LaTeX stocke dans des fichiers aux extensions différentes. Votre fichier .tex de départ créera donc après compilation une multitude de fichiers correspondants à ces besoins. Ne prenez pas peur si votre dossier ne contenant au départ qu’un .tex se voit tout d’un coup envahi par de multiples fichiers aux extensions étranges.

Nous allons résumer toutes ces informations via un schéma. Je vous conseille vivement de l’imprimer, il est souvent pratique de le garder à l’esprit.

Image utilisateur


Si vous avez compris ce schéma, sachez que LaTeX n’a pas un fonctionnement plus compliqué que cela. Il ne nous reste plus qu’à prendre en main les logiciels et à apprendre comment écrire des textes et les mettre en forme dans le formalisme LaTeX.
Retour en haut

Rédaction d'un document simple

Dans cette sous partie, je vais vous aider et vous guider dans l’écriture de votre premier document. Il sera très simple et ne comportera qu’une phrase : « Bonjour, je lis actuellement un cours traitant de LaTeX ! ».

Rédaction du fichier .Tex


Dans un premier temps, il vous faut ouvrir votre interface graphique (Kile, TeXShop, TeXnicCenter ou autre). Il est possible que celle-ci vous pose quelques questions simples (pour connaitre l’emplacement où vous avez installé votre lecteur de pdf par exemple), répondez-y.

Si TeXnicCenter vous demande le chemin d'installation de MiKTeX, vous devrez fournir un chemin du type C:\Program Files (x86)\MiKTeX 2.8\miktex\bin .


Votre éditeur est à présent ouvert et vous vous trouvez face à une fenêtre scindée en trois partie avec une partie console où apparaissent les messages d’information (ainsi que les messages d’erreurs), une zone réservée aux barres d’outils, et une zone réservée à la rédaction de votre fichier.

Grâce aux raccourcis disponibles dans la barre de menu, ouvrez un nouveau document.
Cliquez à l’intérieur de la zone réservée à l’édition et recopiez y le paragraphe ci-dessous.

Code : TeX
1
2
3
4
5
\documentclass{article}

\begin{document}
Bonjour, je lis actuellement un cours traitant de LaTeX !
\end{document}


Enregistrez ce fichier dans un dossier vide de votre choix grâce à la barre de raccourcis présente en haut de votre interface. Nous l’appellerons bonjour.tex.

Il est interdit de mettre des espaces ou des accents dans vos noms de fichiers. Votre compilateur n’apprécie pas l’originalité et aura tendance à vous renvoyer des erreurs.

Autre subtilité, le compilateur compile du texte brut et non pas du texte enrichi comme peut en fournir Word (un texte enrichi est un texte auquel nous avons ajouté une mise en page). Si jamais l’envie vous prends de copier-coller un texte depuis word, faites d’abord un copier-coller dans le bloc note ou un logiciel du même genre. Vous vous éviterez ainsi beaucoup de problèmes.


Compilation



Nous allons maintenant compiler votre fichier .tex en un autre format (postscript, pdf ou dvi). Ici trois cas de figures se présentent pour vous suivant que vous soyez sur windows, sous mac ou encore linux.

Compiler avec Kile (Linux)



Compilation avec Kile


Vous pouvez voir sur la capture d’écran ci-dessus la barre d’outils à votre disposition dans kile. Pour vous tout commence par la création d’un fichier dvi que vous transformerez ensuite en fichier postscript puis en fichier pdf selon vos besoins.

Pas de manipulation compliquées ici, votre interface graphique se charge de tout et vos fichiers produits se trouvent dans le dossier où vous avez enregistré votre fichier .tex.

Compiler en ligne de commande



Nous avons vu dans le chapitre précédent que l’interface graphique n’est pas indispensable. Il vous est possible de créer votre fichier.tex dans un éditeur de texte (emacs, vim…) avant de le compiler en ligne de commande.

La procédure est assez simple. Une fois votre fichier enregistré dans un dossier, ouvrez la console et placez vous dans ce dossier avant d’utiliser l’une ou l’autre des commandes suivantes.

Dans un premier temps, vous pouvez compiler votre fichier bonjour.tex en un fichier en bonjour.dvi. Le fichier créé apparait dans le dossier où vous avez enregistré votre fichier d’origine en .tex.

Code : Console
latex bonjour.tex




Vous pouvez ensuite lire votre fichier bonjour.dvi grâce à la commande xdvi et l’imprimer grâce à la commande dvips.



Code : Console
xdvi bonjour.dvi
dvips bonjour.dvi




Vous pourrez par la suite choisir de transformer votre fichier bonjour.dvi en un fichier .ps grâce à la commande  décrite dvips (en y rajoutant –o comme vous pourrez le voir dans l’exemple). La commande ps2pdf vous permettra de transformer votre fichier au format postscript en fichier pdf.



Il vous est tout à fait possible de compiler directement votre fichier bonjour.tex en un fichier bonjour.pdf grâce à la commande pdflatex. La lecture de pdf se fait grâce à la commande xpdf.



Résumons ces commandes par quelques exemples pratiques. Testez ces commandes, elles vous serviront tout le long du cours.



Code : Console
dvips bonjour.dvi -o
ps2pdf bonjour.ps
pdflatex bonjour.tex
xpdf bonjour.tex







Compiler avec TeXShop (Mac)




Une fois de plus, c’est vous détenteur de mac qui détenez l’interface la plus minimaliste et simple. Il vous suffit de cliquer sur « Composition » tout en ayant sélectionné « LaTeX » dans le menu déroulant à la droite du bouton « Composition ».



Votre interface graphique se charge de tout et les conversions sont faites de façon automatique.



Sans plus attendre vous pouvez admirer le résultat de votre compilation en allant fouiller dans le dossier dans lequel vous avez enregistré votre fichier .tex.




Compiler avec TeXnicCenter (Windows)





Compilation avec TeXnicCenter




Sur votre barre de menu vous constatez la présence d’un menu déroulant. Ce menu vous permet de choisir entre la compilation d’un fichier .tex en un .dvi ou la conversion de ce fichier .dvi en un autre format de fichier.



Le bouton à sa droite vous sert à lancer les compilations/conversions et le boutons encore plus à droite vous donne des aperçus de vos fichiers.

Les fichiers créés apparaissent dans le dossier où vous avez préalablement enregistré votre .tex.




Les résultats




Ici deux possibilités s’offrent à vous. Soit vous avez réussi votre compilation et vous venez de découvrir comment écrire un document en LaTeX (libre à vous de l’imprimer) et vos logiciels fonctionnent. Autre cas de figure, votre interface graphique vous a renvoyé une erreur et je suis dans le regret de vous annoncer que vous avez fait une erreur lors de l’installation et que vous devez la recommencer.




Avant de vous résigner si jamais la compilation n’a pas fonctionné, essayez de recopier une nouvelle fois le code source (pas de copier-coller). Il serait dommage de recommencer l’installation pour un \ oublié.




                

                
Retour en haut

            
                

                    

                        Type de document et caractères spéciaux
                        
                    


                    
Vous venez de créer votre premier document, félicitations ! :D 



Avant toute chose, sachez que la compilation de documents LaTeX fonctionne toujours de la même manière, vous n’avez plus rien à apprendre de ce coté là.



Nous allons revenir ici sur le code que nous avons entré dans l’interface graphique et allons parler des caractères spéciaux. 




Les caractères spéciaux




Comme tout langage de programmation, LaTeX utilise certains caractères pour son usage propre. Dans notre Premier document nous avons utilisé le « \ » pour lui envoyer des ordres. En somme, le « \ » n’est pas simplement recopié par LaTeX, mais interprété. Ce n’est pas le seul caractère à avoir cette spécificité, ils sont 10 et ce sont les suivants : $ & % # _ { } ~ ^ \.



Tentez de mettre l’un de ces caractères dans votre texte, il en résultera des erreurs de compilation. Pour signaler à LaTeX que nous ne lui envoyons pas une commande ou que nous ne communiquons pas avec lui avec ces signes, il suffit de faire précéder les signes par un backslash (le fameux « \ » s’appelle un backslash). Pour le backslash lui-même, nous utiliserons une commande.




                                            












Table des caractères réservés
        
$        
\$    

        
&        
\&    

        
%        
\%    

        
#        
\#    

        
_        
\_    

        
{        
\{    

        
}        
\}    

        
~        
\~    

        
^        
\^{}    

        
\        
\textbackslash{}    





Testons ce tableau ! Entrez le code suivant dans votre interface graphique, puis enregistrez le .tex avant de le compiler et de le convertir en pdf.



Code : TeX
1
2
3
4
5
6
\documentclass{article}

\begin{document}
Bonjour, je lis actuellement un cours traitant de LaTeX !
\$ \& \% \# \_ \^{} \textbackslash{} \{ \}
\end{document}





Le résultat obtenu doit ressembler à la capture ci-dessous.




Les caractères spéciaux




Ce tableau est le premier de ce cours, mais il y en aura d’autres, par exemple pour les accents. Lorsque le cours sera plus avancé, je synthétiserai pour vous tous les tableaux au sein d’une annexe volumineuse que vous pourrez imprimer et garder sous la main.




Types de documents et portions de texte




Nous allons ici décortiquer les trois lignes de codes dont nous n’avons pas encore parlé.




Portions de texte




Nous avons entouré dans nos deux premiers exercices notre texte par un couple de commandes. 



Code : TeX
1
2
\begin{document}
\end{document}







Ces deux commandes délimitent le début et la fin de ce que nous appellerons un environnement. Ici cela reviens à dire que nous commençons un document par \begin{document}
, que nous écrivons du texte avant de fermer le document par \end{document}
.



De façon plus large, nous pourrions vouloir insérer un poème ou une recette dans un texte, il nous suffirait alors d’écrire \begin{recette}
 puis la recette avant de refermer par \end{recette}
. Ce qui pourrait nous donner le code ci-dessous (ici ce n’est qu’un exemple fantaisiste).



Code : TeX
1
2
3
4
5
6
7
8
\begin{document}
\begin{recette}
Ma recette, bla bla bla
\end{recette}
\begin{poeme}
Mon joli poeme, bla, bla bla
\end{poeme}
\end{document}





\begin
 ouvre un environnement et \end
 le ferme. Le type d’environnement se voit encadré par des accolades et les options qui lui sont rattaché sont entre crochets (nous en utiliserons dans la suite du cours). 



En résumé, délimiter un environnement revient à écrire un code du même type que celui-ci-dessous.



Code : TeX
1
2
3
\begin{type}[options]
Bla,bla
\end{type}





Nous apprendrons les noms et les utilités des différents environnements au fil du cours.




Les types de documents


La première ligne de nos 2 exercices n’a pas encore été analysée, et elle contient une information capitale. Tout d’abord, ré-affichons cette ligne, je vous explique tout ensuite.



Code : TeX
1
\documentclass{article}





Une traduction approximative de la commande nous donne quelque chose qui ressemble à ceci : la classe de ce document est de type article. Ici aussi, entre les accolades nous écrivons le type.



Cette commande sert en fait à expliquer à LaTeX que la publication que nous sommes en train de produire est un article. Ceci dans le but que LaTeX mette en page l’intégralité du contenu afin qu’il respecte les normes de typographie et de mise en page d’un article parfaitement présenté.




Pour écrire un roman, je fais comment ?


Tout simplement, vous remplacez le type de document par « book ». Il existe plusieurs types de documents, je vous cite ici les principaux dans un tableau.




                    






Type de document
        
article        
Article (sous entendu scientifique)    

        
book        
Livre    

        
letter        
Lettre    

        
report        
Rapport (stage, thèse…)    







Peut-on là aussi spécifier des options ?


Absolument, nous verrons dans la suite du cours certaines options dédiées aux types de documents. La formulation des options se fait selon la syntaxe suivante.

Code : TeX
1
\documentclass[options]{type}







                

                
Retour en haut

            
    

        

            
Q.C.M.

            
                

                    

                    
Lors de l'écriture de notre premier document, nous avons écrit du code dans ...

                    
    
                        
                                
  •  
    • 
                            
                                
  •  
    • 
                            
                                
  •  
    • 
                            
                    

                

            
                

                    

                    
Combien de caractères doivent être  précédés d'un backslash pour être insérés dans un texte en LaTeX ?

                    
    
                        
                                
  •  
    • 
                            
                                
  •  
    • 
                            
                                
  •  
    • 
                            
                    

                

            
                

                    

                    
Peut on convertir un fichier postscript en un fichier pdf ?

                    
    
                        
                                
  •  
    • 
                            
                                
  •  
    • 
                            
                    

                

            

            

            
Statistiques de réponses au QCM

        

    

    
Retour en haut




Vous venez de réaliser votre premier document avec LaTeX et de commencer à toucher le code. 

Résumons ici ce que nous avons appris.




    

  • La compilation d’un document se déclenche grâce à des raccourcis présents dans l’interface graphique.
    • 

  • Certains caractères doivent être précédés d’un backslash pour être insérés dans un texte.
    • 

  • Le contenu d’un document est encadré par une commande spécifiant le type du document ainsi que des commandes ouvrant et fermant l’environnement document.
    • 





Prochain chapitre : les packages…



    

        
            
            
        
    


    

        
            

                

                    
                    
                    
                

            

        
            Chapitre précédent
        
            Sommaire
        
            Chapitre suivant
        
    







    
Retour en haut



    
Partager

    


    


    

    
Retour en haut

    
            

                27 commentaires pour "Structurer son premier document"
                

                    Note moyenne :
                        3.61
                    / 4
                    (536 votes)
                    
                

            

        
        

            
              

                Pseudo
                Commentaire
              

            
            
              
                

                  
                    
                      Hors ligne 
                    
                      Rafrite
                    
                  
                  
                    #
                    
                         Posté le 23/07/2011 à 20:18:56
                    
                    
                


                
                    

                
                
                    

Théia
Avatar

    

    Avis : Très bon
        
    



    





                		
                
                    
                    Serait-il possible de préciser lorsque tu propose la première compilation quelle durée celle-ci prend en général pour un document moyen ? Personnellement je n'ai jamais eu à "compiler" un document et je n'ai aucune idée sur la durée standard de celle-ci. Comme je rencontre des problèmes à ce sujet, savoir qu'une compilation aurait du durer 5 secondes m'aurait déjà aiguillé un peu ;) .



Merci beaucoup pour se boulot impressionnant et libre d'accès à tous :) et BRAVO !



EDIT : Je vote "très bon" sans longue hésitation :)
                    
                        
Le Destin de l'Univers II, Jean-Pierre Luminet

                        
 

                    
                		
                

              
                

                  
                    
                      Hors ligne 
                    
                      mayalaroz
                    
                  
                  
                    #
                    
                         Posté le 23/07/2011 à 23:46:07
                    
                    
                


                
                    

                
                
                    




     Études : Université catholique de Louvain






                		
                
                    
                    Bonjour,



Je viens d'installer Miktex 2.9 et Texnicenter et j'essaie de compiler mon document tex en pdf. Mon problème vient lors la compilation: Adobe Reader me dit qu'une erreur est survenue lors de l'ouverture de ce document. La syntaxe du nom de fichier, de répertoire ou de volume est incorrecte. Il me dit aussi qu'il n'a pas pu ouvrir a1.tex(mon fichier à compiler) car le type de fichier n'est pas pris en charge ou le fichier est endommagé(Il a été renvoyé en tant que pièce jointe et n'a pas été décodé correctement, par exemple).

Et Texnicenter m'envoie comme message: --------Output Profile : Latex => PDF------- C:\Latex\miktex\bin\bibtex.exe cannot execute the command. Error: Le fichier spécifié est introuvable. Ca doit une bête erreur dans mon profile mais je ne vois où elle est...




 Pourriez-vous m'aider?  :euh:  




Merci d'avance :)
                    
                		
                

              
                

                  
                    
                      Hors ligne 
                    
                      pirega
                    
                  
                  
                    #
                    
                         Posté le 06/11/2011 à 20:00:31
                    
                    
                


                
                    

                
                
                    




    





                		
                
                    
                    Excellent tutoriel !  :D 



Il m'a bien servi pour apprendre à utiliser Latex sous Windows sans ennuis ; mais je vient de passer sous mac et j'ai un petit problème : les caractères spécifique au français (éèçà...) ne passe plus, malgré l'utilisation des trois packages recommandés (il me renvoi des caractères étranges ou une erreur à la compilation). o_O 



Sauriez-vous pourquoi et surtout que faire ?
                    
                		
                

              
                

                  
                    
                      Hors ligne 
                    
                      pirega
                    
                  
                  
                    #
                    
                         Posté le 06/11/2011 à 21:13:55
                    
                    
                


                
                    

                
                
                    




    





                		
                
                    
                    J'ai trouvé, en regardant de nouveau un peu plus loi dans le tuto, qui est vraiment très très  bien, désolé pour le dérangement !
                    
                
                

              
                

                  
                    
                      Hors ligne 
                    
                      remontees
                    
                  
                  
                    #
                    
                         Posté le 13/11/2011 à 21:48:27
                    
                    
                


                
                    

                
                
                    

Vive Symfony2 !
Avatar



    





                		
                
                    
                    Faudrait expliquer que :

Code : TeX
1
2
3
4
5
6
7
8
\begin{document}
\begin{recette}
Ma recette, bla bla bla
\end{recette}
\begin{poeme}
Mon joli poeme, bla, bla bla
\end{poeme}
\end{document}





c'est du code fictif car j'ai essayé de le compiler et ça fonctionne pas du tout !!!
                    
                        
Pensez à indiquer les messages qui vous ont aidé et à indiquer vos problèmes résolus  ;) 

XHTML 1.0/CSS <= 2 : IIIIIIIIII

PHP/MySQL : IIIIIIIIII

Javascript : IIIIIIIIII

HTML5/CSS3 : IIIIIIIIII







Citation
Je sais plus ce que j'écrivais ! :)

Qui que quoi dont où

Alors j'ai activé la prévisualisation automatique !

Citation : Moi
Eh oui


Et maintenant je suis tranquille !






Mon site : http://remontees.free.fr

                        
 

                    
                		
                

              
            
        

        
            
Voir tous les commentaires