Actualización de metadatos

Nombre de la extensión

Learn Authoring Pack, Visual Studio Code meta extensión se compone de varias sub extensiones. 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

En un archivo Markdown (*.md) hay dos elementos de menú contextual específicos de los metadatos. Al hacer clic con el botón derecho en cualquier parte del editor de texto, verá algo parecido a los elementos de menú siguientes:

Actualización del valor de los metadatos ms.date

Al seleccionar la opción Actualización del valor ms.date de los metadatos se establecerá el valor ms.date actual de los archivos Markdown en la fecha de hoy. Si el documento no tiene un campo de metadatos ms.date, no se realiza ninguna acción.

Actualización de valores de los metadatos implícitos

Al seleccionar la opción Actualización los valores de los metadatos implícitos se buscarán y reemplazarán todos los valores de metadatos posibles que se pueden especificar implícitamente. Los valores de metadatos se especifican implícitamente en el archivo docfx.json, en el nodo build/fileMetadata. Cada par clave-valor del nodo fileMetadata representa los valores predeterminados de los metadatos. Por ejemplo, un archivo Markdown en el directorio top-level/sub-folder que omite el valor de metadatos ms.author podría especificar implícitamente un valor predeterminado para usarlo en el nodo de fileMetadata.

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

En este caso, todos los archivos Markdown tomarían implícitamente el valor de metadatos ms.author: dapine. La característica actúa en esta configuración implícita que se encuentra en el archivo docfx.json. Si un archivo Markdown contiene metadatos con valores que se establecen explícitamente en un valor distinto de los valores implícitos, estos se reemplazarán.

Considere los metadatos del archivo Markdown siguientes, donde el archivo Markdown reside en top-level/sub-folder/includes/example.md:

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

# Content

Si la opción Actualización de los valores de los metadatos implícitos se ejecutó en este archivo, con el contenido supuesto docfx.json del valor de los metadatos se actualizaría a ms.author: dapine.

---
ms.author: dapine
---

# Content

En acción

A continuación se muestra una breve demostración de esta característica.