Installer des outils de création de contenu

Cet article explique comment installer les outils recommandés dont vous avez besoin pour apporter des contributions efficaces, en profondeur ou importantes à Microsoft Learn. Voici quelques exemples de mises à jour importantes :

• Révisions longues de plusieurs articles
• Création d’un nouvel article
• Tout travail pour lequel vous souhaitez utiliser les extensions Visual Studio Code disponibles, comme Learn Authoring Pack

Important

Si vous n’effectuez que des changements mineurs, vous n’avez pas besoin d’effectuer les étapes décrites dans cet article. Consultez la page portant sur la modification dans le navigateur pour savoir comment effectuer des modifications rapides sans installer d’outils.

Les contributeurs qui souhaitent apporter des modifications importantes sont encouragés à suivre les étapes décrites ci-dessous. Même si vous disposez d’autorisations en écriture sur le dépôt principal, nous vous conseillons vivement (et ce guide part de cette hypothèse) de dupliquer (fork) et de cloner le dépôt, de façon à stocker les modifications que vous proposez dans votre duplication.

Dans cet article, vous allez :

• Installer Git
• Installer Visual Studio Code
• Installer Learn Authoring Pack

Installer les outils client Git pour Windows

Cette installation comprend le système de gestion de version de Git ainsi que Git Bash, l’application en ligne de commande qui permet d’interagir avec votre dépôt Git local.

1. Téléchargez Git pour Windows.

2. Exécutez le fichier exécutable téléchargé (.EXE) et suivez les invites relatives à l’installation. Sélectionnez Suivant à chaque invite pour accepter tous les paramètres par défaut.

3. Sélectionnez un éditeur de code lorsque le système vous y invite. L’éditeur par défaut est Vim.

4. Cliquez sur Terminer pour terminer l’installation.

Une fois Git installé sur votre appareil Windows, configurez votre nom Git et votre adresse e-mail.

Installer les outils client Git pour Mac et Linux

• Git pour Mac est fourni dans le cadre des Outils en ligne de commande Xcode. Exécutez simplement git depuis la ligne de commande. Vous serez invité à installer les outils en ligne de commande si nécessaire. Vous pouvez aussi télécharger Git pour Mac à partir de Software Freedom Conservancy.
• Git pour Linux et Unix

Suivez les instructions du client choisi pour l’installation et la configuration.

Installer Visual Studio Code

Visual Studio Code est un éditeur léger qui fonctionne sous Windows, Linux et Mac. Il comprend l’intégration Git et permet d’installer des extensions.

Téléchargez et installez la version de Visual Studio Code correspondant à votre système d’exploitation :

• Windows
• Mac
• Linux

Utilisez tous les paramètres par défaut pendant l’installation.

Conseil

Pour lancer VS Code et ouvrir le dossier actif, exécutez la commande code . en ligne de commande ou dans un interpréteur de commandes Bash. Si le dossier actif fait partie d’un dépôt Git local, l’intégration de GitHub apparaît automatiquement dans Visual Studio Code.

Installer Learn Authoring Pack

Learn Authoring Pack pour Visual Studio Code inclut une assistance de base pour la création de code Markdown, des aperçus de page, la prise en charge des modèles Markdown, markdownlint et le vérificateur orthographique de code. Ces fonctionnalités simplifient et rationalisent le processus de contribution. Par conséquent, nous considérons Learn Authoring Pack comme une extension obligatoire pour les contributeurs.

Pour installer Learn Authoring Pack, choisissez Installer à partir de la page Learn Authoring Pack sur VS Code Marketplace.

Pour utiliser Learn Authoring Pack, appuyez sur Alt+M dans Visual Studio Code. Pour configurer une barre d’outils afin d’afficher les fonctions disponibles, modifiez les paramètres de Visual Studio Code (Ctrl + virgule) et ajoutez un paramètre utilisateur "markdown.showToolbar": true.

Pour plus d’informations, consultez la page Learn Authoring Pack pour Visual Studio Code.

Comprendre les éditeurs Markdown

Markdown est un langage de balisage léger qui est utilisé pour créer du contenu. Visual Studio Code est l’outil de prédilection pour modifier des fichiers Markdown sous Microsoft. D’autres outils d’édition Markdown sont disponibles. L’article Informations de référence sur Markdown couvre les concepts de base de Markdown et les fonctionnalités prises en charge par le site web learn.microsoft.com.

Étapes suivantes

Vous pouvez maintenant configurer un dépôt Git local.