了解如何在內容片段中使用參考

上次更新: 2023-11-07

到目前為止

AEM Headless 內容作者歷程的一開始,簡介部分介紹了和 Headless 內容編寫相關的基本概念和術語。

您已經了解 Headless CMS 編寫的基本知識,包含如何使用 AEMaaCS 編寫內容,尤其是編寫內容片段。

本文以這些概念為基礎,以便您了解如何使用參考為您的 AEM Headless 專案編寫您自己的內容。

目標

  • 對象:進階

  • 目標:介紹如何如何使用 Headless CMS 編寫的參考。有哪些類型參考可用,它們的作用為何:

    • 內容參考
    • 資產/媒體參考
    • 片段參考
    • 文字區塊內的臨時參考

什麼是參考

參考只是一種連接資源 (無論是其他內容、資產 (如影像) 還是其他片段) 的機制。雖然非常相似,但還是有一些不同。

一些參考有專用資料類型 (例如,內容參考和片段參考),而其他參考只是新增至文字區塊內的參考 (資產參考和臨時參考)。

內容片段 - 參考

內容參考

內容參考可讓您參考任何其他內容。 這樣會開啟一個瀏覽器,讓您選取內容專案。

資產/媒體參考

可以使用​插入資產​選項,讓資產 (例如影像或媒體) 可在文字區塊內被參考。如此將可開啟瀏覽器,讓您選取資產。

內容片段 - 插入資產

片段參考

片段參考可讓您參考其他片段。 為什麼這很重要需要進一步說明。

例如,您可能定義了以下內容片段模型:

  • 城市
  • 公司
  • 人員
  • 獎項

看似簡單明瞭,但公司同時有CEO和員工…這些都是人,每一個都被定義為人員。

人員可以獲得一個獎項 (或兩個)。

  • 我的公司 - 公司
    • CEO - 人員
    • 員工 - 人員
      • 人員獎項 - 獎項

這只是供初學者了解。根據複雜程度,獎項可以是特定於公司的,或者公司可以在特定城市設有主要辦公室。

可以使用片段參考來表示這些相互關係,因為您 (作者) 和無周邊應用程式都可理解。

作為作者,您不負責定義這些關係 (由內容架構師在建立內容片段模型時定義),但您需要知道如何識別和編輯參考。

如何編寫巢狀片段

編寫片段參考非常簡單 (儘管欄位通常不會被標記為​片段參考)。您可以直接輸入參考,或者 (更有可能) 選取資料夾圖示以開啟瀏覽器,讓您可瀏覽和選取所需片段。

內容片段 - 參考

內容片段模型定義在控制:

  • 是否可以選擇新增多個參考
  • 您可以選取的內容片段模型類型;內容片段模型定義允許參考的片段模型,因此 AEM 僅根據這些模型顯示片段。

使用內容片段編輯器的​樹狀結構​索引標籤,您可以瀏覽片段參考的片段,然後瀏覽該片段包含的任何參考。選取一個參考會開啟該片段供您編輯。

注意

使用主面板中的階層連結,您可以瀏覽回起點。

內容片段樹狀結構

臨時參考

臨時參考可以簡單連結的形式新增到文字區塊內:

內容片段 - 臨時參考

下一步

現在您已經了解了內容片段中的參考和結構,下一步是了解中繼資料和標記。將介紹和討論如何定義內容片段的中繼資料和標記。

其他資源

本頁內容