Aggiornare i metadati

Nome estensione

L'estensione meta Learn Authoring Pack, Visual Studio Code è costituita da più estensioni secondarie. Questa funzionalità è inclusa nell'estensione Learn Markdown . L'estensione Learn Markdown fa parte di Learn Authoring Pack, non è necessario installarla separatamente.

Riepilogo

In un file Markdown (*.md) sono presenti due voci di menu contestuali specifiche per i metadati. Quando si fa clic con il pulsante destro del mouse in un punto qualsiasi dell'editor di testo, verrà visualizzato un risultato simile alle voci di menu seguenti:

Aggiornare il ms.date valore dei metadati

Se si seleziona l'opzione Aggiorna ms.date valore metadati , il valore dei file ms.date Markdown corrente verrà impostato sulla data odierna. Se il documento non dispone di un ms.date campo di metadati, non viene eseguita alcuna azione.

Aggiornare i valori dei metadati impliciti

Se si seleziona l'opzione Aggiorna valori di metadati impliciti, verranno rilevati e sostituiti tutti i possibili valori di metadati che potrebbero essere specificati in modo implicito. I valori dei metadati vengono specificati in modo implicito nel file docfx.json nel build/fileMetadata nodo . Ogni coppia di valori chiave nel fileMetadata nodo rappresenta le impostazioni predefinite dei metadati. Ad esempio, un file Markdown nella directory top-level/sub-folder che omette il ms.author valore dei metadati potrebbe specificare in modo implicito un valore predefinito da usare nel fileMetadata nodo.

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

In questo caso, tutti i file Markdown accettano implicitamente il valore dei ms.author: dapine metadati. La funzionalità agisce su queste impostazioni implicite presenti nel file docfx.json . Se un file Markdown contiene metadati con valori impostati in modo esplicito su un valore diverso dai valori impliciti, viene eseguito l'override.

Si considerino i metadati del file Markdown seguenti, in cui si trova questo file Markdown nella cartella principale/sub-folder/includes/example.md:

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

# Content

Se l'opzione Aggiorna i valori dei metadati impliciti è stata eseguita in questo file, con il contenuto docfx.json assunto riportato sopra il valore dei metadati verrà aggiornato a ms.author: dapine.

---
ms.author: dapine
---

# Content

In azione

Di seguito è riportata una breve dimostrazione di questa funzionalità.