了解如何在內容片段中使用參考 author-headless-references
目前進度 story-so-far
在AEM Headless 內容作者歷程的一開始,簡介部分介紹了和 Headless 內容製作相關的基本概念和術語。
您已經了解 Headless CMS 製作的基本知識,包含如何使用 AEMaaCS 製作內容,尤其是製作內容片段。
本文以這些概念為基礎,以便您了解如何使用參考為您的 AEM Headless 專案製作您自己的內容。
目標 objective
-
對象:進階
-
目標:介紹如何如何使用 Headless CMS 製作的參考。有哪些類型參考可用,它們的作用為何:
- 內容參考
- 資產/媒體參考
- 片段參考
- 文字區塊內的臨時參考
什麼是參考 what-are-references
參考只是一種連接資源 (無論是其他內容、資產 (如影像) 還是其他片段) 的機制。雖然非常相似,但還是有一些不同。
一些參考有專用資料類型 (例如,內容參考和片段參考),而其他參考只是新增至文字區塊內的參考 (資產參考和臨時參考)。
內容參考 content-references
內容參考可讓您參考任何其他內容。 這會開啟讓您選取內容項目的瀏覽器。
資產/媒體參考 assets-media-references
可以使用 插入資產 選項,讓資產 (例如影像或媒體) 可在文字區塊內被參考。這會開啟讓您選取資產的瀏覽器。
片段參考 fragment-references
片段參考可讓您參考其他片段。 為什麼這很重要需要進一步說明。
例如,您可能定義了以下內容片段模型:
- 城市
- 公司
- 人員
- 獎項
看起來很簡單,但一家公司既有執行長也有員工…這些都是人,每一個都被定義為人員。
人員可以獲得一個獎項 (或兩個)。
-
我的公司 - 公司
- CEO - 人員
- 員工 - 人員
- 人員獎項 - 獎項
這只是供初學者了解。根據複雜程度,獎項可以是特定於公司的,或者公司可以在特定城市設有主要辦公室。
可以使用片段參考來表示這些相互關係,因為您 (作者) 和無周邊應用程式都可理解。
作為作者,您不負責定義這些關係 (由內容架構師在建立內容片段模型時定義),但您需要知道如何識別和編輯參考。
如何編寫巢狀片段 author-nested-fragment
製作片段參考非常簡單 (儘管欄位通常不會被標記為 片段參考)。您可以直接輸入參考,或者 (更有可能) 選取資料夾圖示以開啟瀏覽器,讓您可瀏覽和選取所需片段。
內容片段模型定義在控制:
- 是否可以選擇新增多個參考
- 您可以選取的內容片段模型類型;內容片段模型定義允許參考的片段模型,因此 AEM 僅根據這些模型顯示片段。
如何導覽巢狀片段 navigate-nested-fragment
使用內容片段編輯器的 樹狀結構 索引標籤,您可以瀏覽片段參考的片段,然後瀏覽該片段包含的任何參考。選取一個參考會開啟該片段供您編輯。
臨時參考 adhoc-references
臨時參考可以簡單連結的形式新增到文字區塊內:
下一步 whats-next
現在您已經了解了內容片段中的參考和結構,下一步是了解中繼資料和標記。將介紹和討論如何定義內容片段的中繼資料和標記。