Explorador de metadados

Nome da extensão

O Learn Authoring Pack, extensão meta do Visual Studio Code é composto por várias subextensões. Esse recurso está incluído na extensão Learn Markdown . A extensão Learn Markdown faz parte do Learn Authoring Pack, não há necessidade de instalá-la separadamente.

Resumo

O explorador de metadados aparece automaticamente na barra lateral do Explorer do Visual Studio Code quando você abre um arquivo Learn Markdown.

Fontes de metadados

O Explorador de Metadados mostra metadados de três fontes: o front matter YAML do ficheiro Markdown aberto no editor, e as secções fileMetadata e globalMetadata do ficheiro docfx.json do docset. Os ícones ajudam a identificar rapidamente a origem dos metadados exibidos. Se o artigo não tiver os metadados necessários, essa chave de metadados aparecerá com um ícone de aviso.

Ícone	Fonte de metadados
	Matéria frontal YAML do arquivo Markdown ativo
	fileMetadata secção do ficheirodocfx.json
	globalMetadata secção do ficheirodocfx.json
	Esses metadados necessários estão faltando completamente

Precedência

O explorador de metadados mostra apenas chaves de metadados exclusivas. Se mais de um valor puder ser aplicado à mesma chave, o explorador usará as mesmas configurações de precedência que o DocFx. A ordem de precedência na prioridade decrescente é:

1. Matéria frontal YAML
2. fileMetadata
3. globalMetadata

Se vários padrões de glob baseados em pasta se aplicarem a um único artigo, a entrada que aparece por último no arquivo docfx.json será selecionada. Por exemplo, considere o arquivo em C:/docs/csharp/reference/keywords.md e as seguintes entradas no arquivo docfx.json :

"ms.topic": {
  "csharp/**/*.md": "conceptual",
  "csharp/reference/*.md": "language-reference"
}

Nesse caso, enquanto ambos os padrões de glob incluem o caminho para o arquivo, o segundo valor de language-reference é selecionado.

Dica de ferramenta

Você pode pairar o rato sobre um valor para ver uma exibição expandida no tooltip. Isso é especialmente útil para chaves que têm vários valores em uma matriz. As informações também incluem a fonte dos metadados.

Atualizar

Se você tiver o salvamento automático desabilitado no Visual Studio Code, o explorador de metadados será atualizado automaticamente quando você salvar o arquivo Markdown. Se a gravação automática estiver ativada, pode atualizar os metadados apresentados clicando no botão Atualizar na parte superior do explorador.

Quando você abre um arquivo Markdown diferente, o explorador é atualizado automaticamente.

Ver também

• Metadados