Aktualisieren von Metadaten

Name der Erweiterung

Die Learn Authoring Pack, Visual Studio Code-Metaerweiterung besteht aus mehreren Untererweiterungen. Dieses Feature ist in der Learn Markdown-Erweiterung enthalten. Die Learn Markdown-Erweiterung ist Teil des Learn Authoring Pack, es ist nicht erforderlich, es separat zu installieren.

Zusammenfassung

In einer Markdowndatei (*.md) gibt es zwei kontextbezogene Menüelemente, die für Metadaten spezifisch sind. Wenn Sie mit der rechten Maustaste auf eine beliebige Stelle im Text-Editor klicken, wird etwas wie die folgenden Menüelemente angezeigt:

Aktualisieren des Metadatenwerts ms.date

Wenn Sie die Option Metadatenwert ms.date aktualisieren auswählen, wird der aktuelle ms.date-Wert für die Markdowndateien auf das heutige Datum festgelegt. Falls das Dokument kein Metadatenfeld ms.date enthält, wird keine Aktion ausgeführt.

Aktualisieren von impliziten Metadatenwerten

Wenn Sie die Option Implizite Metadatenwerte aktualisieren auswählen, werden alle möglichen Metadatenwerte gefunden und ersetzt, die implizit angegeben werden könnten. Metadatenwerte werden implizit in der Datei docfx.json unter dem Knoten build/fileMetadata angegeben. Jedes Schlüssel-Wert-Paar im Knoten fileMetadata stellt Metadatenstandardwerte dar. Beispielsweise könnte eine Markdowndatei im Verzeichnis top-level/sub-folder, in dem der Metadatenwert ms.author ausgelassen wird, implizit einen Standardwert angeben, der im Knoten fileMetadata verwendet werden soll.

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

In diesem Fall würden alle Markdowndateien implizit den Metadatenwert ms.author: dapine übernehmen. Das Feature wird auf diese impliziten Einstellungen in der Datei docfx.json angewendet. Wenn eine Markdowndatei Metadaten mit Werten enthält, für die explizit etwas anderes als die impliziten Werte festgelegt wird, werden sie überschrieben.

Sehen Sie sich die folgenden Markdowndatei-Metadaten an, bei denen sich diese Markdowndatei in top-level/sub-folder/includes/example.md befindet:

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

# Content

Wenn die Option Implizite Metadatenwerte aktualisieren für diese Datei ausgeführt wurde, würde der Metadatenwert bei dem vorstehenden angenommenen docfx.json-Inhalt auf ms.author: dapine aktualisiert.

---
ms.author: dapine
---

# Content

In Aktion

Nachstehend sehen Sie eine kurze Demo dieses Features.