Aktualizace metadat
Název rozšíření
Sada Learn Authoring Pack a meta rozšíření Visual Studio Code se skládá z několika dílčích rozšíření. Tato funkce je součástí rozšíření Markdown Learn. Rozšíření Learn Markdown je součástí sady Learn Authoring Pack, není potřeba ho instalovat samostatně.
Souhrn
V souboru Markdown (*.md) jsou dvě položky místní nabídky specifické pro metadata. Když kdekoli v textovém editoru kliknete pravým tlačítkem, zobrazí se něco podobného jako následující položky nabídky:
Aktualizace ms.date
hodnoty metadat
Výběrem možnosti Aktualizovat ms.date
hodnotu metadat nastavíte aktuální hodnotu souborů ms.date
Markdownu na aktuální datum. Pokud dokument neobsahuje ms.date
pole metadat, neprovede se žádná akce.
Aktualizace implicitních hodnot metadat
Výběrem možnosti Aktualizovat implicitní hodnoty metadat se najdou a nahradí všechny možné hodnoty metadat, které je možné implicitně zadat. Hodnoty metadat se implicitně zadají v souboru docfx.json pod uzlem build/fileMetadata
. Každý pár hodnot klíče v fileMetadata
uzlu představuje výchozí hodnoty metadat. Například soubor Markdownu v adresáři nejvyšší úrovně nebo podsložky , který vynechá ms.author
hodnotu metadat, může implicitně určovat výchozí hodnotu, která se má použít v fileMetadata
uzlu.
{
"build": {
"fileMetadata": {
"ms.author": {
"top-level/sub-folder/**/**.md": "dapine"
}
}
}
}
V tomto případě by všechny soubory Markdown implicitně převzaly ms.author: dapine
hodnotu metadat. Funkce funguje na tato implicitní nastavení, která najdete v souboru docfx.json . Pokud soubor Markdown obsahuje metadata s hodnotami, které jsou explicitně nastaveny na něco jiného než implicitní hodnoty, jsou přepsány.
Představte si následující metadata souboru Markdown, kde se tento soubor Markdownu nachází v nejvyšší úrovni/podsložky/includes/example.md:
---
ms.author: someone-else
---
# Content
Pokud se v tomto souboru spustila možnost Aktualizovat implicitní hodnoty metadat , s předpokládaným obsahem docfx.json výše by se hodnota metadat aktualizovala na ms.author: dapine
.
---
ms.author: dapine
---
# Content
V akci
Níže je stručná ukázka této funkce.