Uppdatera metadata

Tilläggsnamn

Metatillägget Learn Authoring Pack, Visual Studio Code består av flera undertillägg. Den här funktionen ingår i Learn Markdown-tillägget . Tillägget Learn Markdown är en del av Learn Authoring Pack. Det finns inget behov av att installera det separat.

Sammanfattning

I en Markdown-fil (*.md) finns det två sammanhangsberoende menyalternativ som är specifika för metadata. När du högerklickar var som helst i textredigeraren visas något som liknar följande menyalternativ:

Uppdatera ms.date metadatavärde

Om du väljer alternativet Uppdatera ms.date metadatavärde anges det aktuella Markdown-filvärdet ms.date till dagens datum. Om dokumentet inte har något ms.date metadatafält vidtas ingen åtgärd.

Uppdatera implicita metadatavärden

Om du väljer alternativet Uppdatera implicita metadatavärden hittar och ersätter du alla möjliga metadatavärden som kan anges implicit. Metadatavärden anges implicit i filen docfx.json under build/fileMetadata noden. Varje nyckelvärdepar i fileMetadata noden representerar standardvärden för metadata. En Markdown-fil i katalogen top-level/sub-folder som utelämnar ms.author metadatavärdet kan till exempel implicit ange ett standardvärde som ska användas i fileMetadata noden.

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

I det här fallet skulle alla Markdown-filer implicit ta på ms.author: dapine sig metadatavärdet. Funktionen fungerar på dessa implicita inställningar som finns i filen docfx.json . Om en Markdown-fil innehåller metadata med värden som uttryckligen anges till något annat än de implicita värdena åsidosätts de.

Överväg följande Markdown-filmetadata, där den här Markdown-filen finns i den översta nivån/undermappen/inkluderar/example.md:

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

# Content

Om alternativet Uppdatera implicita metadatavärden kördes på den här filen, med det antagna docfx.json-innehållet ovanifrån, uppdateras metadatavärdet till ms.author: dapine.

---
ms.author: dapine
---

# Content

I praktiken

Nedan visas en kort demonstration av den här funktionen.