Обновление метаданных

Имя расширения

Пакет разработки 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

В действии

Ниже приведена краткая демонстрация этой функции.

Демонстрация: обновление метаданных