Opdater metadata

Navn på filtypenavn

Metaudvidelsen Learn Authoring Pack, Visual Studio Code består af flere underudvidelser. Denne funktion er inkluderet i Udvidelsen Learn Markdown . Udvidelsen Learn Markdown er en del af Learn Authoring Pack. Det er ikke nødvendigt at installere den separat.

Resumé

I en Markdown-fil (*.md) er der to genvejsmenuelementer, der er specifikke for metadata. Når du højreklikker et vilkårligt sted i teksteditoren, kan du se noget, der ligner følgende menupunkter:

Opdater ms.date metadataværdi

Hvis du vælger indstillingen Opdater ms.date metadataværdi , angives den aktuelle Markdown-filværdi ms.date til dags dato. Hvis dokumentet ikke har et ms.date metadatafelt, udføres der ingen handling.

Opdater implicitte metadataværdier

Hvis du vælger indstillingen Opdater implicitte metadataværdier , bliver alle mulige metadataværdier, der implicit kan angives, fundet og erstattet. Metadataværdier angives implicit i filen docfx.json under noden build/fileMetadata . Hvert nøgleværdipar i noden fileMetadata repræsenterer metadatastandarder. En Markdown-fil i mappen med øverste niveau/undermapper , der udelader ms.author metadataværdien, kan f.eks. implicit angive en standardværdi, der skal bruges i noden fileMetadata .

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

I dette tilfælde vil alle Markdown-filer implicit overtage ms.author: dapine metadataværdien. Funktionen fungerer på disse implicitte indstillinger, der findes i filen docfx.json . Hvis en Markdown-fil indeholder metadata med værdier, der eksplicit er angivet til noget andet end de implicitte værdier, tilsidesættes de.

Overvej følgende Markdown-filmetadata, hvor denne Markdown-fil er placeret i øverste niveau/undermappe/include/example.md:

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

# Content

Hvis indstillingen Opdater implicitte metadataværdier blev udført på denne fil, vil det formodede docfx.json-indhold fra oven fra metadataværdien blive opdateret til ms.author: dapine.

---
ms.author: dapine
---

# Content

I aktion

Nedenfor er en kort demonstration af denne funktion.