View on GitHub

Begin-Latex-in-minutes

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

English涓枃Espa帽olPortugu锚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鈥檃i lu. Je ne suis pas un professionnel ou expert, mais un 茅tudiant qui appr茅cie beaucoup ce langage. N鈥檌mporte qui peut ouvrir une discussion dans la section 鈥渋ssue鈥, ou faire une 鈥減ull 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鈥檈st rien 脿 c么t茅 de ce qu鈥檌l permet de faire

Installation de LaTeX

Vous allez avoir besoin de:

  1. Une distribution LaTeX. J鈥檜tilise MiKTeX pour Windows.
  2. Un 茅diteur. J鈥檜tilise TeXMaker pour 茅diter simplement, mais tout 茅diteur de texte fonctionne avec LaTeX.
  3. Un lecteur PDF. (optionnel) N鈥檌mporte quel lecteur de PDF fera l鈥檃ffaire. Il s鈥檃git 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鈥檃utres 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鈥檈xtension .tex. Puis, ins茅rez-y le code ci dessous pour afficher 鈥淗ello World!鈥 et cliquez sur 鈥渜uick build鈥. Pour d鈥檃utres 茅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 鈥減ackages鈥 (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峄沬. 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鈥檌l 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鈥檃v茅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鈥檜tiliser fontspec et polyglossia:

\documentclass[a4paper]{article}

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

\begin{document}

Xin ch脿o th岷 gi峄沬. 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鈥檌mporte 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鈥檕rganisation 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鈥檃ide d鈥檜n sommaire (\tableofcontents).

Example:

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

Notes de bas de page

C鈥檈st tr猫s simple d鈥檜tiliser 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鈥檜tiliser des packages. Pour importer un package en LaTeX, ajoutez simplement \usepackage :package:

Voici un exemple d鈥檜tilisation de deux packages pour les math茅matiques:

Mieux encore, l鈥檃ffichage 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鈥檈xtensions. 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鈥檌mage 脿 l鈥櫭ヽhelle du document. La mention fig est utilis茅e pour r茅f茅rencer l鈥檌mage plus tard. Choisissez donc la avec pr茅caution.

\begin{figure}[h!]

:passport_control: Les valeurs autoris茅es sont :

Voici le rendu de l鈥檌mage :

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鈥檌nsertion 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鈥檜tilisation 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鈥檕ptions, comme l鈥檌nsertion de code inline, personnaliser le style, choisir un langage sp茅cifique, importer du code d鈥檜n autre fichier du m锚me r茅pertoire, 鈥 Cette m茅thode n鈥檜tilise pas {verbatim} mais un package :package: appel茅 listings.

Prenons l鈥檈xemple 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鈥檜n 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鈥檌nsertion 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鈥檈st 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鈥檃voir 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.