View on GitHub

Begin-Latex-in-minutes

📜 Brief Intro to LaTeX for beginners that helps you use LaTeX with ease.

English · 中文 · Español · Português · Français · Русский · Deutsch · 日本語 · Polski

LaTeX en quelques minutes

Note: Tout ce qui est écrit dans ce guide vient de ma propre expérience et des articles que j’ai lu. Je ne suis pas un professionnel ou expert, mais un étudiant qui apprécie beaucoup ce langage. N’importe qui peut ouvrir une discussion dans la section “issue”, ou faire une “pull request”. Si vous appréciez mon travail, vous pouvez me faire une donation.

Sommaire

Qu est ce que LaTeX?

LaTeX, pronnoncé «Lah-tech», est un langage et un système de composition de documents. Il est essentiellement utilisé pour les documents scientifiques plutôt technique, mais peut être utilisé pour toute forme de publication.

Pourquoi utiliser LaTeX?

LaTeX possède tout de même quelques inconvénients, mais ce n’est rien à côté de ce qu’il permet de faire

Installation de LaTeX

Vous allez avoir besoin de:

  1. Une distribution LaTeX. J’utilise MiKTeX pour Windows.
  2. Un éditeur. J’utilise TeXMaker pour éditer simplement, mais tout éditeur de texte fonctionne avec LaTeX.
  3. Un lecteur PDF. (optionnel) N’importe quel lecteur de PDF fera l’affaire. Il s’agit juste de pouvoir afficher le résultat.

Il vous faut également un compilateur. Le compilateur par défaut de la plupart des éditeurs est pdfLaTeX, mais si vous utilisez les formats de polices TTF/OTF, utilisez LuaLaTeX.

Si vous préférez, vous pouvez utiliser un éditeur en ligne, comme ShareLaTeX. Allez jetter un oeil aux Outils supplémentaires pour d’autres suggestions.

Premier document LaTeX

Commençons par le fameux Hello World. Si vous avez intallé TexMaker, commencez par créer un nouveau fichier portant l’extension .tex. Puis, insérez-y le code ci dessous pour afficher “Hello World!” et cliquez sur “quick build”. Pour d’autres éditeurs, la procédure devrait être similaire.

\documentclass[a4paper]{article}

\begin{document}

Hello World !  % Ceci est votre contenu

\end{document}

Le résultat devrait être le suivant:

Un regard plus attentif

:eyes: Regardons en détails votre premier document LaTex :

:zap: Attention :zap:

Multilangue

Certains langages ne sont pas directement supportés.

:white_check_mark: Première méthode :white_check_mark:

Elle consiste à installer des “packages” (Vous allez voir ça après) car pdfLaTeX, le compilateur par défaut, est limité à 256 caractères et quelques encodages. Par exemple:

\documentclass[a4paper]{article}

\usepackage[T5]{fontenc}
\usepackage[utf8]{inputenc}

\begin{document}

Xin chào thế giới. Ceci est le "hello world" Vietnamien.

\end{document}

Ici, nous utilisons les packages usepackage[T5]{fontenc} et usepackage[utf8]{inputenc}. Les packages importent ce qu’il faut pour afficher ce contenu correctement. Si vous utilisez TexMaker voici le résultat de ce code avec les packages :

et sans les packages :package::

:umbrella: Écrire en Chinois, Japonais, ou Coréen peut s’avérer délicat en général. Ici, usepackage{CJKutf8}, \begin{CJK}{UTF8} et \end{CJK} gèrent ça très bien !. Voici du japonais :jp: :

\documentclass[a4paper]{article}
\usepackage{CJKutf8}

\begin{document}

\begin{CJK}{UTF8}{min}
この記事を読んでいただきありがとうございます。
%Merci d'avoir lu cet article.
\end{CJK}

\end{document}

Aussi simple que manger des :sushi: et des :bento: :

:white_check_mark: Seconde méthode :white_check_mark:

Une autre méthode est de remplacer le compilateur TeX par LuaLaTeX (ou XeLaTeX). Il suffit alors d’utiliser fontspec et polyglossia:

\documentclass[a4paper]{article}

\usepackage{fontspec}
\usepackage{polyglossia}
%\setmainfont[]{DejaVu Serif}

\begin{document}

Xin chào thế giới. Ceci est le "hello world" Vietnamien.

\end{document}

La police par défaut (Latin Modern) ne supporte pas tous les caractères. Mais vous pouvez utiliser n’importe quelle police installée sur votre ordinateur, en décommentant \setmainfont. (Les polices de type TTF et OTF sont entièrement supportées)

Listes

:straight_ruler: L’organisation de votre document est très importante. Alors, rangeons vos éléments dans une liste.
Les deux types communs de listes sont non ordonnées et ordonnées. Ces deux types sont pris en charge par LaTeX :

Voici le rendu des deux listes :

Paragraphes et sections

:blue_book: Une section commence par \section et un paragraphe par \paragraph . :orange_book: Il est possible de créer des sous sections avec \subsection et des sous paragraphes avec \subparagraph

Faire un sommaire

:metal: Il est essentiel de pouvoir naviguer à travers les sections ou sous sections à l’aide d’un sommaire (\tableofcontents).

Example:

:bangbang: Astuce : Vous pouvez utiliser \newpage pour faire une nouvelle page.

Notes de bas de page

C’est très simple d’utiliser footnote+label+ref pour faire des notes en bas de page. Par exemple:

Salut, laissez moi me présenter\footnote{\label{myfootnote}Hello footnote}.
... (plus bas)
Je fais référence à moi même \ref{myfootnote}.

:point_down: :point_down: Vous voyez ? :point_down: :point_down:

:bangbang: Astuce : Vous pouvez utiliser \newline pour aller à la ligne.

Les packages

LaTeX contient beaucoup de fonctionnalités par défaut, mais il est parfois utile d’utiliser des packages. Pour importer un package en LaTeX, ajoutez simplement \usepackage :package:

Voici un exemple d’utilisation de deux packages pour les mathématiques:

Mieux encore, l’affichage de circuits électriques:

:construction: Pour trouver des packages, faites une recherche sur Google. Par exemple, amsmath est très utilisé pour les maths et possède beaucoup d’extensions. Les passer tous en revue dans ce guide est chose impossible ..

Table

Exemple :thought_balloon: :

\begin{table}[h!]
  \centering
  \caption{Description de la table.}
  \label{tab:table1}
  \begin{tabular}{l|c||r}
    1 & 2 & 3\\
    \hline
    a & b & c\\
  \end{tabular}
\end{table}

:star2: Voici le rendu :star2: :

Maintenant, regardons plus en détails :eyes: :

:bangbang: Astuce Vous pouvez utiliser le package :package: booktabs \usepackage{booktabs} pour un meilleur visuel.

Ajouter des images

Pour ajouter une image au document LaTeX, il faut utiliser un environnement figure et le package graphicx. Utilisez \usepackage{graphicx} et

\begin{figure}
  \includegraphics[width=\linewidth]{filename.jpg}
  \caption{De quoi est-il question?}
  \label{fig:unlabel}
\end{figure}

:bangbang: Astuce: Ajoutez [width=\linewidth] pour mettre l’image à l’échelle du document. La mention fig est utilisée pour référencer l’image plus tard. Choisissez donc la avec précaution.

\begin{figure}[h!]

:passport_control: Les valeurs autorisées sont :

Voici le rendu de l’image :

Insérer du code

:white_check_mark: Première méthode :white_check_mark:

Un aspect extrèmement important pour les développeurs dans un compilateur de texte est l’insertion de code dans le document.

En LaTeX, le processus est très simple et professionnel. Il suffit juste de placer le code source dans un environnement particulier.

Exemple :

\documentclass[a4paper]{article}

\begin{document}

Hello world!

\begin{verbatim}
#include <iostream>

int main()
{
	std::cout << "hello world!\n";
	return 0;
}
\end{verbatim}

\end{document}

:speech_balloon: LaTeX supporte la syntaxe des langages suivant :speech_balloon:

Comme vous pouvez le voir, avec l’utilisation de {verbatim} vous pouvez insérer du code dans votre document sans vous souciez du formatage. Voici le rendu :

:white_check_mark: :white_check_mark: Seconde méthode :white_check_mark: :white_check_mark:

Cette méthode vous donne plus d’options, comme l’insertion de code inline, personnaliser le style, choisir un langage spécifique, importer du code d’un autre fichier du même répertoire, … Cette méthode n’utilise pas {verbatim} mais un package :package: appelé listings.

Prenons l’exemple suivant :

\documentclass[a4paper]{article}

\usepackage{listings}
\usepackage{color}

\lstdefinestyle{mystyle}{
keywordstyle=\color{magenta},
backgroundcolor=\color{yellow},
commentstyle=\color{green},
basicstyle=\footnotesize,
}
\lstset{style=mystyle}

\begin{document}


Hello world!

\begin{lstlisting}[language=Python]

print "Hello World!"

\end{lstlisting}

\lstinputlisting[language=C++]{hello.cpp}

Lorem ipsum dolor sit amet \lstinline{print "Hello World"} , consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.


\end{document}

Vous pouvez voir que:

  1. Pour insérer un bloc de code, commencez par \begin{lstlisting} et terminez avec \end{lstlisting}
  2. Pour importer du code d’un fichier du même répertoire, il faut utiliser lstinputlisiting{name_of_file}
  3. Spéficier le langage se fait avec [language=C++]
  4. \lstinline permet l’insertion de code inline
  5. Pour appliquer un style particulier, il faut utiliser \usepackage{color} et définir votre style, puis définir votre thème sous forme de liste (Exemple dans le code ci-dessus). Il est possible de customiser beaucoup de choses, mais vous aurez besoin de regarder la documentation pour connaître les noms des propriétés.
  6. Intéressé ?? Voir ici.

Voici le rendu du code au dessus, compilé avec TexMaker:

Travailler sur plusieurs documents

Un problème potentiel en LaTeX peut être la longueur du document. Pour faire face à cette situation, vous pouvez diviser le contenu du document en plusieurs fichiers pour que le contenu soit plus facilement manipulable.

Regardons cet exemple:

% main.tex
\documentclass[a4paper]{article}

\begin{document}

Salut Latex, c'est la partie 1.

Salut Latex, c'est la partie 2.

\end{document}

C’est un simple fichier LaTeX. Maintenant, divisons le en deux parties, en utilisant le mot clé \input:

% main.tex
\documentclass[a4paper]{article}

\begin{document}

Salut Latex, c'est la partie 1.

\input{second_file}

\end{document}

% second_file.tex
Salut Latex, c'est la partie 2.

Le fichier principal est différent, mais mieux organisé. Voici le résultat avec TexMaker:

multi_file.png

:bangbang: Astuce : Pour plus de clareté et de maintenabilité, il est fortement recommandé de diviser systématiquent le fichier principal, de manière hiérachique. Cependant, ne divisez pas sans raison, ou vous pourriez être perdu par la suite.

Outils supplémentaires

Distributions

Éditeurs LaTeX

Compilateurs LaTeX

HOURRA !!

:tada: Merci d’avoir terminé ce guide. Voici plus ou moins tout ce que vous devez connaître à propos de LaTeX. :hammer:
Si vous êtes vraiment intéressé, vous trouverez plus de LaTeX ici ou tout simplement sur le web.

Licence

DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE Copyright (C) 2016 Luong Vo Tout le monde est autorisé à copier et distribuer des copies originelles ou modifiées de ce document, et le changement est autorisé tant que le nom est modifié.
TERMES ET CONDITIONS DE COPIE, DE DISTRIBUTION ET DE MODIFICATION : juste DO WHAT THE FUCK YOU WANT (FAITES CE QUE VOUS VOULEZ)

Une bière dans votre pays équivaut à un repas dans le mien.