Обновление метаданных
Имя расширения
Пакет разработки Learn, Visual Studio Code мета-расширение состоит из нескольких вложенных расширений. Эта функция включена в расширение Learn Markdown . Расширение Learn Markdown входит в состав пакета разработки Learn, его не нужно устанавливать отдельно.
Итоги
В файле Markdown (*.md) есть два элемента контекстного меню, относящиеся к метаданным. Щелкнув правой кнопкой мыши в любом месте текстового редактора, вы увидите примерно такие пункты меню.
Обновление значения метаданных ms.date
Выберите Обновить значение метаданных ms.date
, чтобы установить текущее значение в файлах Markdown ms.date
на сегодняшнюю дату. Если в документе нет поля метаданных ms.date
, ничего делать не нужно.
Обновление неявных значений метаданных
Если выбрать параметр Обновить неявные значения метаданных, будут найдены и заменены все возможные значения метаданных, которые могут быть заданы неявно. Значения метаданных неявно указываются в файле docfx.json в узле build/fileMetadata
. Каждая пара "ключ-значение" в узле fileMetadata
представляет значения по умолчанию для метаданных. Например, файл Markdown в каталоге верхнего уровня или вложенной папки, в котором опущено значение метаданных ms.author
, может неявно указывать значение по умолчанию для использования в узле 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
В действии
Ниже приведена краткая демонстрация этой функции.