更新中繼資料
延伸模組名稱
Learn Authoring Pack,Visual Studio Code中繼延伸模組是由多個子延伸模組所組成。 此功能包含在 Learn Markdown 延伸模組中。 Learn Markdown 延伸模組是 Learn Authoring Pack 的一部分,不需要個別安裝它。
總結
在 Markdown (*.md) 檔案中,中繼資料有兩個特定的內容功能表項目。 當您以滑鼠右鍵按一下文字編輯器中的任何位置時,您會看到類似下列功能表項目的內容:
更新 ms.date
中繼資料值
選取 [ 更新 ms.date
中繼資料值 ] 選項會將目前的 Markdown 檔案 ms.date
值設定為今天的日期。 如果檔沒有 ms.date
元資料欄位,則不會採取任何動作。
更新隱含中繼資料值
選取 [更新隱含中繼資料值 ] 選項將會尋找並取代可能以隱含方式指定的所有可能中繼資料值。 中繼資料值會在 node 底下的 build/fileMetadata
docfx.json檔案中隱含指定。 節點中的每個 fileMetadata
索引鍵值組都代表中繼資料預設值。 例如,省略 ms.author
中繼資料值的最上層/子資料夾目錄中的 Markdown 檔案可以隱含地指定要在節點中使用的 fileMetadata
預設值。
{
"build": {
"fileMetadata": {
"ms.author": {
"top-level/sub-folder/**/**.md": "dapine"
}
}
}
}
在此情況下,所有 Markdown 檔案都會隱含地接受 ms.author: dapine
中繼資料值。 此功能會處理 docfx.json 檔案中找到的這些隱含設定。 如果 Markdown 檔案包含明確設定為隱含值以外的值的中繼資料,則會覆寫這些值。
請考慮下列 Markdown 檔案中繼資料,此 Markdown 檔案位於 最上層/sub-folder/includes/example.md中:
---
ms.author: someone-else
---
# Content
如果在此檔案上執行 [更新隱含中繼資料值 ] 選項,則會將中繼資料值上方假設的 docfx.json 內容更新為 ms.author: dapine
。
---
ms.author: dapine
---
# Content
作用中
以下是這項功能的簡短示範。