Guide officiel d’installation de l’extension LaTeX Workshop dans Visual Studio Code

Le Plan d’Action

1. Installer le moteur : TeX Live
2. Installer un “assistant” pour la compilation : Strawberry Perl
3. Configurer VS Code pour qu’il communique avec TeX Live.
4. Tester avec un document.

Étape 1 : Installation de TeX Live (Le Moteur LaTeX)

C’est l’étape la plus importante et la plus longue. TeX Live va installer tous les compilateurs (pdflatex, xelatex, etc.) et une immense collection de packages LaTeX.

1. Téléchargement :
   • Allez sur la page d’installation de TeX Live pour Windows : https://www.tug.org/texlive/acquire-netinstall.html
   • Téléchargez le petit installateur en ligne : install-tl-windows.exe.
2. Lancement de l’installation :
   • Exécutez install-tl-windows.exe.
   • Il se peut qu’il décompresse d’abord des fichiers. Soyez patient.
   • Une fenêtre d’installation s’ouvrira. Pour une première installation, les options par défaut sont généralement parfaites.
   • Cliquez simplement sur “Install”.
3. Soyez TRÈS patient :
   • L’installation de TeX Live télécharge et installe des milliers de petits fichiers. Selon votre connexion internet, cela peut prendre entre 45 minutes et plus de 2 heures.
   • C’est tout à fait normal. Laissez l’ordinateur travailler tranquillement.
4. Vérification (après installation) :
   • Une fois l’installation terminée, TeX Live est normalement ajouté au PATH de votre système. Pour vérifier que tout fonctionne, ouvrez une nouvelle invite de commandes (cmd ou PowerShell) et tapez :

pdflatex --version

Si une réponse s’affiche avec la version de pdfTeX (MiKTeX ou TeX Live), c’est que l’installation a réussi.

Étape 2 : Installation de Strawberry Perl (L’Assistant Indispensable)

LaTeX Workshop utilise par défaut un script nommé latexmk pour compiler vos documents. Ce script est extrêmement efficace car il gère tout seul les compilations multiples (pour la bibliographie, les références, etc.). Pour fonctionner, latexmk a besoin de Perl.

1. Téléchargement :
   • Allez sur le site de Strawberry Perl : https://strawberryperl.com/
   • Téléchargez la version recommandée pour Windows (généralement la version 64-bit).
2. Installation :
   • Lancez l’installateur et suivez les étapes. C’est une installation très classique et rapide. Laissez les options par défaut.
3. Vérification :
   • Ouvrez une nouvelle invite de commandes et tapez :

perl -v

Si une réponse s’affiche avec la version de Perl, l’installation est un succès.

Étape 3 : Configuration de VS Code et LaTeX Workshop

Maintenant que le moteur (TeX Live) et son assistant (Perl) sont prêts, nous allons dire à VS Code comment les utiliser. La bonne nouvelle, c’est que LaTeX Workshop est si bien fait qu’il détecte souvent tout automatiquement !

1. Ouvrir les Paramètres (JSON) :
   • Dans VS Code, ouvrez la palette de commandes avec Ctrl+Shift+P.
   • Tapez Open User Settings (JSON) et sélectionnez cette option.
   • Le fichier settings.json s’ouvre. C’est ici que nous allons vérifier la configuration.
2. Vérifier la “Chaîne de Compilation” (toolchain) :
   • LaTeX Workshop fonctionne avec des “recettes” (recipes) pour compiler. La recette par défaut utilise latexmk, ce qui est parfait.
   • Vous n’avez généralement rien à ajouter à votre settings.json. LaTeX Workshop trouvera tout seul TeX Live et latexmk.
   • Votre fichier settings.json peut donc être vide ou contenir d’autres réglages.

Étape 4 : Test Final

C’est le moment de vérité.

1. Créez un dossier pour votre projet, par exemple TestLatex.
2. Ouvrez ce dossier dans VS Code (File > Open Folder...).
3. Créez un nouveau fichier nommé article.tex.
4. Collez le code suivant (le même que nous avons corrigé, qui fonctionne avec pdfLaTeX) :

\documentclass[11pt, a4paper]{article}
\usepackage[T1]{fontenc}
\usepackage[utf8]{inputenc}
\usepackage[english,french]{babel}
\usepackage{amsmath}
\usepackage{hyperref}

\title{Mon Premier Article avec VS Code et TeX Live}
\author{Mon Nom}
\date{\today}

\begin{document}
\maketitle

\section{Introduction}
Ceci est un test pour vérifier que ma configuration \LaTeX{} sur VS Code avec TeX Live fonctionne parfaitement.

Si je vois une équation comme $E=mc^2$ et que le PDF est généré, alors tout est en ordre !
\end{document}

1. Sauvegardez le fichier (Ctrl+S).
2. Compilez le document :
   • Cliquez sur l’icône Build LaTeX project (le triangle de lecture vert) en haut à droite de VS Code.
   • La première fois, la compilation peut prendre quelques secondes. Vous verrez des lignes de commande s’afficher dans l’onglet “OUTPUT” en bas.
3. Visualisez le PDF :
   • Cliquez sur l’icône View LaTeX PDF (la loupe avec le logo TeX) juste à côté du bouton de compilation.
   • Le PDF devrait s’ouvrir dans un nouvel onglet, directement dans VS Code.

Si vous voyez votre PDF, félicitations ! Vous disposez maintenant d’un environnement de rédaction LaTeX professionnel, rapide et moderne sur Windows.