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

到目前為止

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

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

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

目標

  • 對象：進階

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

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

什麼是參考

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

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

內容片段 - 參考

內容參考

內容參考可讓您參考任何其他內容。 這會開啟瀏覽器，讓您選取內容項目。

資產/媒體參考

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

內容片段 - 插入資產

片段參考

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

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

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

看起來很簡單，但當然一家公司既有 CEO 又有員工…這些都是人，每一個都被定義為人員。

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

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

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

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

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

如何編寫巢狀片段

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

內容片段 - 參考

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

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

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

注意

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

內容片段樹狀結構

臨時參考

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

內容片段 - 臨時參考

下一步

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

其他資源

本頁內容