Mettre à jour les métadonnées

Nom de l’extension

La méta-extension Learn Authoring Pack, Visual Studio Code est composée de plusieurs sous-extensions. Cette fonctionnalité est incluse dans l’extension Learn Markdown . L’extension Learn Markdown fait partie du Pack de création Learn. Il n’est pas nécessaire de l’installer séparément.

Résumé

Dans un fichier Markdown (*.md), deux éléments de menu contextuel sont propres aux métadonnées. Quand vous cliquez avec le bouton droit n’importe où dans l’éditeur de texte, vous voyez quelque chose similaire aux éléments de menu suivants :

Mettre à jour la valeur de métadonnées ms.date

La sélection de l’option Update ms.date Metadata Value (Mettre à jour la valeur de métadonnées ms.date) permet de définir la valeur ms.date actuelle des fichiers Markdown sur la date du jour. Si le document n’a pas de champ de métadonnées ms.date, aucune action n’est effectuée.

Mettre à jour les valeurs de métadonnées implicites

La sélection de l’option Update implicit metadata values (Mettre à jour les valeurs de métadonnées implicites) permet de rechercher et de remplacer toutes les valeurs de métadonnées possibles qui peuvent être spécifiées implicitement. Les valeurs de métadonnées sont spécifiées implicitement dans le fichier docfx.json, sous le nœud build/fileMetadata. Chaque paire clé-valeur du nœud fileMetadata représente les valeurs par défaut des métadonnées. Par exemple, un fichier Markdown dans le répertoire top-level/sub-folder qui omet la valeur de métadonnées ms.author peut spécifier implicitement une valeur par défaut à utiliser dans le nœud fileMetadata.

{
    "build": {
        "fileMetadata": {
            "ms.author": {
                "top-level/sub-folder/**/**.md": "dapine"
            }
        }
    }
}

Dans ce cas, tous les fichiers Markdown prennent implicitement la valeur de métadonnées ms.author: dapine. La fonctionnalité agit sur ces paramètres implicites qui se trouvent dans le fichier docfx.json. Si un fichier Markdown contient des métadonnées dont les valeurs sont explicitement définies sur une valeur autre que les valeurs implicites, elles sont substituées.

Considérez les métadonnées de fichier Markdown suivantes, ce fichier Markdown se trouvant dans top-level/sub-folder/includes/example.md :

---
ms.author: someone-else
---

# Content

Si l’option Update implicit metadata values (Mettre à jour les valeurs de métadonnées implicites) était exécutée sur ce fichier, avec le contenu supposé de docfx.json ci-dessus, la valeur de métadonnées deviendrait ms.author: dapine.

---
ms.author: dapine
---

# Content

En action

Vous trouverez ci-dessous une brève démonstration de cette fonctionnalité.