Atualizar metadados

Nome da extensão

O Pacote de Criação do Learn, Visual Studio Code meta extensão é composto por várias subextensão. Esse recurso está incluído na extensão De markdown do Learn . A extensão Do Learn Markdown faz parte do Pacote de Criação do Learn. Não é necessário instalá-lo separadamente.

Resumo

Em um arquivo Markdown (*.md), há dois itens de menu contextual específicos para os metadados. Ao clicar com o botão direito do mouse em qualquer lugar no editor de texto, você verá algo semelhante aos seguintes itens de menu:

Atualizar o valor de metadados ms.date

A seleção da opção Atualizar o Valor de Metadados ms.date definirá o valor ms.date atual dos arquivos Markdown como a data de hoje. Se o documento não tiver um campo de metadados ms.date, nenhuma ação será executada.

Atualizar valores de metadados implícitos

A seleção da opção Atualizar valores de metadados implícitos localizará e substituirá todos os valores possíveis de metadados que possam ser especificados implicitamente. Os valores de metadados são especificados implicitamente no arquivo docfx.json no nó build/fileMetadata. Cada par chave-valor no nó fileMetadata representa padrões de metadados. Por exemplo, um arquivo Markdown no diretório de nível superior/subpasta que omite o valor de metadados ms.author poderia especificar implicitamente um valor padrão a ser usado no nó fileMetadata.

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

Nesse caso, todos os arquivos Markdown assumiriam implicitamente o valor de metadados ms.author: dapine. O recurso atua nessas configurações implícitas encontradas no arquivo docfx.json. Se um arquivo Markdown contiver metadados com valores explicitamente definidos para algo diferente dos valores implícitos, eles serão substituídos.

Considere os seguintes metadados de arquivo Markdown, em que esse arquivo Markdown está localizado em top-level/sub-folder/includes/example.md:

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

# Content

Se a opção Atualizar valores de metadados implícitos fosse executada nesse arquivo, com o conteúdo de docfx.json presumido mencionado acima, o valor dos metadados seria atualizado para ms.author: dapine.

---
ms.author: dapine
---

# Content

Em ação

Veja abaixo uma breve demonstração desse recurso.