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.