更新元数据

  • 项目

扩展名称

Learn 创作包Visual Studio Code元扩展由多个子扩展组成。 此功能包含在 Learn Markdown 扩展中。 Learn Markdown 扩展是 Learn 创作包的一部分，无需单独安装。

总结

在 Markdown (*.md) 文件中，有两个特定于元数据的上下文菜单项。 右键单击文本编辑器中的任意位置时，会看到类似以下菜单项的内容：

更新元数据上下文菜单

更新 ms.date 元数据值

选择“更新 ms.date 元数据值”选项会将当前的 Markdown 文件 ms.date 值设为当天的日期。 如果文档不包含 ms.date 元数据字段，则不执行任何操作。

更新隐式元数据值

选择“更新隐式元数据值”选项将查找并替换可能隐式指定的所有可能的元数据值。 元数据值是在 build/fileMetadata 节点下的 docfx.json 文件中隐式指定的。 fileMetadata 节点中的每个键值对均表示元数据默认值。 例如，top-level/sub-folder 目录中忽略 ms.author 元数据值的 Markdown 文件可能会隐式指定要在 fileMetadata 节点中使用的默认值。

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

在此情况下，所有 Markdown 文件都将隐式采用 ms.author: dapine 元数据值。 此功能用于在 docfx.json 文件中找到的这些隐式设置。 如果 Markdown 文件包含的元数据值被显式设为除隐式值以外的值，则会覆盖这些值。

请考虑使用以下 Markdown 文件元数据，该 Markdown 文件位于 top-level/sub-folder/includes/example.md 中：

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

# Content

如果在此文件上执行了“更新隐式元数据值”选项，则元数据值上方的假设的 docfx.json 内容将更新为 ms.author: dapine。

---
ms.author: dapine
---

# Content

操作过程

下面是此功能的简短演示。

更新元数据演示