Explorador de metadatos

Nombre de la extensión

La extensión meta Learn Authoring Pack, Visual Studio Code consta de varias extensiones secundarias. Esta característica se incluye en la extensión Learn Markdown . La extensión Learn Markdown forma parte del paquete de creación de Learn, no es necesario instalarla por separado.

Resumen

El explorador de metadatos aparece automáticamente en la barra lateral explorador de Visual Studio Code al abrir un archivo Learn Markdown.

Orígenes de metadatos

El Explorador de metadatos muestra los metadatos de tres orígenes: el front matter de YAML del archivo Markdown que está abierto en el editor y las secciones fileMetadata y globalMetadata del archivo docfx.json del docset. Los iconos ayudan a identificar rápidamente el origen de los metadatos mostrados. Si faltan metadatos necesarios en el artículo, esa clave de metadatos aparece con un icono de advertencia.

Icono	Origen de metadatos
	Cabecera YAML del archivo Markdown en uso
	fileMetadata sección del archivo docfx.json
	globalMetadata sección del archivo docfx.json
	Faltan completamente estos metadatos necesarios.

Precedencia

El Explorador de metadatos solo muestra claves de metadatos únicas. Si se puede aplicar más de un valor para la misma clave, el explorador usa la misma configuración de precedencia que DocFx. El orden de prioridad en la prioridad decreciente es:

1. Metadatos iniciales en YAML
2. fileMetadata
3. globalMetadata

Si se aplican varios patrones globales basados en carpetas a un solo artículo, se selecciona la entrada que aparece por última vez en el archivo docfx.json . Por ejemplo, considere el archivo en C:/docs/csharp/reference/keywords.md y las siguientes entradas en el archivo docfx.json :

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

En este caso, mientras que ambos patrones glob incluyen la ruta de acceso al archivo, se selecciona el segundo valor de language-reference .

Botón de ayuda

Puede mantener el puntero sobre un valor para ver una presentación expandida en la información sobre herramientas. Esto es especialmente útil para las claves que tienen varios valores en una matriz. La información también incluye el origen de los metadatos.

Actualizar

Si ha deshabilitado el guardado automático en Visual Studio Code, el explorador de metadatos se actualiza automáticamente al guardar el archivo Markdown. Si tiene habilitado el guardado automático, puede actualizar los metadatos mostrados haciendo clic en el botón Actualizar situado en la parte superior del explorador.

Al abrir un archivo Markdown diferente, el explorador se actualiza automáticamente.

Consulte también

• Metadatos