Différences

Ci-dessous, les différences entre deux révisions de la page.

--- outils:vscode:markdown [2022/06/13 11:03] – phil
+++ outils:vscode:markdown [2022/07/09 11:13] (Version actuelle) – phil
@@ Ligne 1: / Ligne 1: @@
-{{ :suivant.png?nolink&30|}} {{ :retour.png?nolink&30|}} [[web:accueilweb|{{ :iconemaison.jpg?nolink&30|Sommaire Web}}]]
+[[web:accueilweb|{{ :iconemaison.jpg?nolink&30|Sommaire Web}}]]
-===== IDE VSCode - L'extension markdownlint =====
+===== IDE VSCode - L'extension Markdownlint =====
-[Mise à jour le 14/11/2020]
+[Mise à jour le 20/6/2022]
 {{ :arduino:vscode.png?nolink&150|}} {{ :outils:vscode:markdownlint.png?nolink&50|}}
 ==== Introduction ====
-**markdownlint** est une extension Visual Studio Code qui comprend une bibliothèque de règles pour encourager les normes et la cohérence pour les fichiers Markdown. Il est alimenté par markdownlint pour Node.js qui est basé sur markdownlint pour Ruby.
+Markdown est un système d’édition et de **formatage de texte** ; c’est à la fois une syntaxe, un script de conversion texte → HTML et un format de fichier. Il est couramment utilisé pour les fichiers de documentation d’un projet ou d’un jeu de données souvent nommé **//readme.md//**. Il est stocké au format texte classique et est plus léger que sa version interprétée puisqu’il ne contient pas les balises HTML.
+La **philosophie** du système veut que le texte écrit soit lisible sans interpréteur particulier en mode texte. Il est léger et épuré de l’essentiel de la verbosité d’un langage balisé. Les éléments de syntaxe sont des caractères de ponctuation qui font sens visuellement même non convertis. Une fois converti, le navigateur web (qui joue alors le rôle d’interpréteur) en rendra la lecture plus claire.
+Les fichiers sont généralement enregistrés avec l’extension **.md** (ou .markdown ) pour indiquer aux interpréteurs la nature du texte qu’il vont lire ; mais ça n’a rien d’obligatoire.
+Comme le résultat sera exporté en HTML, vous pouvez tout à fait introduire directement des balises HTML dans votre texte ; mais celui-ci deviendra moins lisible et ne pourra plus être édité par quelqu’un ne maîtrisant pas le HTML. Attention, le formatage markdown ne sera pas appliqué à l’intérieur de ces balises.
+<callout type="primary" icon="true">L'extension **markdownlint** de Visual Studio Code comprend une bibliothèque de règles pour encourager les normes et la cohérence pour les fichiers Markdown. Il est alimenté par markdownlint pour Node.js qui est basé sur markdownlint pour Ruby.</callout>
 ==== 1 Installation ====
@@ Ligne 20: / Ligne 28: @@
 Cliquez sur l'un des avertissements de la boîte de dialogue pour afficher l'entrée d'aide de cette règle dans le navigateur Web par défaut.
-<note>Dans le cadre du cours on ne cherche pas à écrire un code sans avertissement.</note>
+<callout type="primary" icon="true">Dans le cadre du cours on ne cherche pas à écrire un code sans avertissement.</callout>