Päivitä metatiedot

Laajennuksen nimi

Learn Authoring Pack, Visual Studio Code -metalaajennus koostuu useista alilaajennuksista. Tämä ominaisuus sisältyy Learn Markdown -laajennukseen. Learnin Markdown-laajennus on osa Learn Authoring Packia. Sitä ei tarvitse asentaa erikseen.

Yhteenveto

Markdown-tiedostossa (*.md) on kaksi pikavalikkokohdetta, jotka liittyvät metatietoihin. Kun napsautat hiiren kakkospainikkeella mitä tahansa tekstieditorin kohtaa, näet jotain samankaltaista kuin seuraavissa valikkokohteissa:

Päivitä ms.date metatietoarvo

Jos valitset Päivitä ms.date metatiedot arvo -vaihtoehdon, nykyinen Markdown-tiedostojen ms.date arvo määritetään tämän päivän päivämääräksi. Jos asiakirjalla ei ole ms.date metatietokenttää, mitään toimia ei tehdä.

Implisiittisten metatietojen arvojen päivittäminen

Valitsemalla Päivitä implisiittiset metatietoarvot -vaihtoehdon voit etsiä ja korvata kaikki mahdolliset metatietoarvot, jotka voidaan implisiittisesti määrittää. Metatietoarvot määritetään implisiittisesti solmun alla olevassa docfx.json-tiedostossabuild/fileMetadata. Solmun fileMetadata jokainen avainarvopari edustaa metatietojen oletusarvoja. Esimerkiksi ylimmän tason/alikansion hakemistossa oleva Markdown-tiedosto, joka jättää metatietoarvon ms.author pois, voi implisiittisesti määrittää solmussa käytettävän oletusarvon fileMetadata .

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

Tässä tapauksessa kaikki Markdown-tiedostot ottavat implisiittisesti metatietoarvon ms.author: dapine . Ominaisuus toimii näissä docfx.json-tiedostossa olevien implisiittisten asetusten yhteydessä. Jos Markdown-tiedosto sisältää metatietoja, joiden arvot on nimenomaisesti määritetty johonkin muuhun kuin implisiittisiin arvoihin, ne ohitetaan.

Harkitse seuraavia Markdown-tiedoston metatietoja, joissa tämä Markdown-tiedosto sijaitsee ylimmän tason/alikansion/includes/example.md:n sijainnissa:

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

# Content

Jos tälle tiedostolle suoritettiin Päivitä implisiittiset metatietoarvot - asetus, metatietoarvon yläpuolella oleva oletettu docfx.json-sisältö päivittyy arvoon ms.author: dapine.

---
ms.author: dapine
---

# Content

Käytännössä

Alla on lyhyt esittely tästä ominaisuudesta.