Atualizar metadados

Nome da extensão

O Pacote de Criação do Learn, a extensão meta do Visual Studio Code é composta por várias sub extensões. Esta funcionalidade está incluída na extensão Learn Markdown . A extensão Learn Markdown faz parte do Pacote de Criação do Learn. Não é necessário instalá-la separadamente.

Resumo

Num ficheiro Markdown (*.md), existem dois itens de menu contextuais específicos dos metadados. Quando clica com o botão direito do rato em qualquer parte do editor de texto, verá algo semelhante aos seguintes itens de menu:

Atualizar ms.date valor de metadados

Selecionar a opção Atualizar ms.date Valor de Metadados irá definir o valor atual dos ficheiros ms.date Markdown para a data atual. Se o documento não tiver um ms.date campo de metadados, não é efetuada qualquer ação.

Atualizar valores de metadados implícitos

Se selecionar a opção Atualizar valores de metadados implícitos , encontrará e substituirá todos os valores de metadados possíveis que possam ser especificados implicitamente. Os valores de metadados são especificados implicitamente no ficheiro docfx.json , no build/fileMetadata nó. Cada par de valores chave no fileMetadata nó representa as predefinições de metadados. Por exemplo, um ficheiro Markdown no diretório de nível superior/subpasta que omita o ms.author valor de metadados pode especificar implicitamente um valor predefinido a utilizar no fileMetadata nó.

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

Neste caso, todos os ficheiros Markdown assumiriam implicitamente o valor dos ms.author: dapine metadados. A funcionalidade atua nestas definições implícitas encontradas no ficheiro docfx.json . Se um ficheiro Markdown contiver metadados com valores explicitamente definidos como algo diferente dos valores implícitos, estes são substituídos.

Considere os seguintes metadados de ficheiro Markdown, em que este ficheiro Markdown reside no nível superior/subpasta/includes/example.md:

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

# Content

Se a opção Atualizar valores de metadados implícitos tiver sido executada neste ficheiro, com o conteúdo docfx.json assumido acima, o valor de metadados será atualizado para ms.author: dapine.

---
ms.author: dapine
---

# Content

Em ação

Segue-se uma breve demonstração desta funcionalidade.