共用方式為


更新中繼資料

延伸模組名稱

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/fileMetadatadocfx.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

作用中

以下是這項功能的簡短示範。

更新中繼資料示範