===== Composer des documents en langage LaTeX =====

==== Installation d'une distribution LATEX compatible avec la variable d'environnement PATH ====

<note>**PATH** est la variable d'environnement utilisée par le système d'exploitation pour localiser les fichiers exécutables indispensables depuis la ligne de commande ou la fenêtre de terminal.</note>

  * **MiKTeX** est une distribution légère de LATEX avec une installation pratique de paquets à la demande. Elle se trouve dans le [[https://docenstock.unicaen.fr/CatalogueServices/CentreLogiciel.pdf|centre logiciel]], vous pouvez donc l'installer même si vous n'êtes pas administrateur de la machine.

Alternativement, si vous êtes administrateur de la machine, vous pouvez installer:
  * TeX Live
  * ou TinyTeX (distribution plus légère basée sur TeX Live).

{{ ::miktex_1.png |}}

<note important>Pour que **MiKTeX** fonctionne correctement il faut installer **Perl**. (on utilisera pour se faire **ActivePerl**, qui se trouve aussi dans le [[https://docenstock.unicaen.fr/CatalogueServices/CentreLogiciel.pdf|centre logiciel]]).</note>

===== Installation de Perl =====

{{ ::centrelogiciel_perl.png |}}


==== Modification de la variable d'environnement PATH ====

Rajoutez le chemin vers l'exécutable Perl dans la variable d'environnement PATH.

{{ ::path_addingperl.png |}}

=== Vérification ===

On peut vérifier que l'installation s'est bien déroulée en tapant ''perl -v'' dans le terminal.

{{ ::path_addingperl_verification.png |}}

==== Installation de l'extension LaTeX Workshop dans VS Code ====

{{ :vscode_latexworkshop.png |}}

==== Composition de documents en LaTeX dans VS Code ====
  * Créez un nouveau document au format **tek**.
  * Saisir le code suivant qui fait appel au paquet //lipsum// : \\ <code latex>\documentclass[12pt]{report}

\usepackage{lipsum}

\begin{document}

\chapter{Introduction}

\lipsum[1-3]

\end{document}</code> \\ Source: https://www.geekering.com/programming-languages/filipesalgueiro/how-to-write-latex-documents-using-visual-studio-code/<<<<<
  * Compilez le code en cliquant sur la flèche verte {{:vscode_latex_greenarrow.png|}} (ou en tapant la combinaison de touches //Ctrl+Alt+B//).
  * Vous pouvez visualiser le fichier généré au format .pdf en cliquant sur l'icône {{:vscode_latex_view.png|}}.

{{ :vscode_latex_example.png |}} 

<note tip>Un onglet **TEX** propose des fonctionnalités avancées. \\ {{ :vscode_latex_textab.png |}}</note>