AEM Headless 製作基本知識 author-headless-basics

目前進度 story-so-far

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

本文以這些內容為基礎,以便您了解如何為 AEM Headless 專案製作您自己的內容。

目標 objective

  • 對象:初學者

  • 目標:介紹 Headless CMS 製作的基本知識:

    • 使用 AEMaaCS 製作簡介
    • 內容片段簡介

基本處理 basic-handling

在您掌握內容片段之前,對於如何使用 AEM,這裡有 (非常) 快速的介紹…但沒有什麼能真正取代登入和嘗試使用系統的體驗。

作者、預覽和發佈 author-preview-publish

AEM 安裝通常至少包含三個環境:

  • 作者
  • 發佈
  • 預覽

登入並使用製作環境來產生您的內容。準備好內容後,就可以發佈,使其普遍可用。對於 Headless ,這將針對其他應用程式,對於網頁,這將針對網路讀者。

如需詳細資訊,請參閱製作概念。

在發佈之前,您還可以從​ 內容片段 ​主控台發佈至​ 預覽服務,以進行測試和預覽。請參閱「發佈和預覽片段」。

登入 signing-in

如同大部分系統,需要登入。作為作者,您將取得:

  • 使用者 (帳戶) 名稱
  • 密碼
  • 存取登入畫面的連結

您的帳戶將設定成具有任何您需要的權限。如果您有任何問題,Adobe 建議應聯絡您的內部支援團隊。

導覽 navigation

首次登入小型線上教學課程,將會重點介紹使用者介面的一些主要功能。

然後,您可以使用導覽面板存取 AEM 的關鍵區域。對於內容片段,您使用​ 內容片段 ​主控台 (對於某些動作,您也將使用​ 資產 ​主控台)。

可以透過選擇左上角的 Adobe 圖示,然後選擇小羅盤圖示來開啟導覽面板。

NOTE
雖然內容片段是 AEM Sites 的功能,但它們也另存為​ 資產。這個技術細節不會影響您的操作,但了解它可能會有用。

在主控台中,您可以在左側面板中選擇資料夾以導覽至您的內容片段。您還可以篩選和/或搜尋。

內容片段主控台

動作、選擇、檢視 actions-selecting-viewing

在​ 內容片段 ​主控台中,工具列中有一系列動作可用於您的內容片段:

  • 在 Assets 中開啟
  • 建立
  • 參考者 ​欄也提供直接連結以顯示該片段的所有父參考;包括參考內容片段、體驗片段和頁面。
  • 將游標停留在資料夾名稱上將顯示 JCR 路徑。

選擇您的片段後,所有適當的動作都可用:

  • 開啟
  • 發佈 (和​ 取消發佈)
  • 複製
  • 移動
  • 重新命名
  • 刪除
NOTE
發佈、取消發佈、刪除、移動、重新命名、複製等動作觸發非同步作業。可以透過 AEM 非同步作業 UI 監視該作業的進度。

製作內容片段 authoring-content-fragments

所以,這是對 AEM 使用者介面 (UI) 的非常快速介紹,但希望您有機會嘗試一下。現在我們開始討論您真正感興趣的部分 - Headless 內容片段。

我們必須從頭到尾說明所有事情,但是您的執行個體可能已經建立了資料夾和/或片段,並且它們可能位於不同的位置。原理是一樣的。

組織和導覽 organizing-and-navigating

除非您的內容片段很少,否則您會想要加以組織,以便您 (和其他人) 可以再次找到它們。

建立資料夾 creating-folder

為此,您可以在​ 資產 ​主控台的​ 檔案 ​區段內,建立一系列的資料夾。選擇​ 建立 ​選項 (右上角),然後選擇​ 資料夾

建立資料夾選項

對話框隨即開啟,您可以在其中輸入詳細資料,然後使用「建立」來確認:

建立資料夾對話框

使用路徑和標記限制資料夾中可用的內容片段模型 tags-paths-for-models-in-folder

本章節的技術稍微進階一些。如果您才剛開始嘗試,您並不需要它,但是當您有很多片段時,它就​ 非常 ​實用。所以了解它是件好事 - 即使您還沒有使用它。

您的內容架構師將建立您目前專案所需的所有內容片段模型,一些其他專案可能也需要。為了協助您和其他作者簡化作業,您可以對特定資料夾的可用模型清單加以限制。

建立資料夾後,您可以開啟​ 屬性 ​資料夾。這裡有各種索引標籤,其中包含有關資料夾的資訊和設定詳細資料。特別是對於內容片段,您可以使用​ 原則 ​索引標籤為此資料夾定義特定路徑和/或標記。這限制了可在資料夾中使用的內容片段模型,因為這表示內容片段模型必須滿足這些要求才能用來在此資料夾中產生片段。

建立資料夾屬性 - 原則

NOTE
您可以在「內容片段模型 - 允許在資產資料夾中使用內容片段模型」下閱讀更多詳細資訊。

然後瀏覽這些資料夾以建立和編輯您的內容片段。

以防萬一 - 資料夾雲端服務設定 cloud-services-folder

以防萬一…

您可能會得到一個初始資料夾,您可以在其中建立資料夾。這是因為一些設定細節必須套用 (通常由開發人員或系統管理員執行) 到根資料夾。您可能對此不感興趣,但如果有必要,您可以查看​ 屬性 ​資料夾中​ 雲端服務 ​的​ 設定

建立資料夾屬性 - 設定

NOTE
您可以在「將設定套用到資產資料夾」下閱讀更多資訊。

建立內容片段 creating-fragment

在​ 內容片段 ​主控台,您可以使用​ 建立 ​來開啟​ 新的內容片段 ​對話框:

內容片段主控台 - 建立新片段

指定:

  • 位置
  • 內容片段模型
  • 標題
  • 名稱
  • 說明

然後使用​ 建立 ​或​ 建立並開啟 ​加以確認。

編輯片段 editing-fragment

您可以在建立片段後立即開啟它,或者從內容片段主控台 (也可以從資產主控台) 中選擇它以開啟。

NOTE
內容片段是 Sites 的一項功能,但儲存為​ 資產
有兩個編輯器用於製作內容片段。
  • 新編輯器主要可從「內容片段」主控台存取。
  • 原始編輯器主要可從「資產」主控台存取。

編輯器首次開啟時,您會看到:

  • 頂端工具列:用於關鍵資訊和動作

    • 內容片段主控台的連結 (首頁圖示)
    • 有關模型和檔案夾的資訊
    • 預覽連結;如果設預覽 URL 模式是為模型所設定
    • 發佈和取消發佈動作
    • 顯示全部​ 父參考內容 ​的選項 (連結圖示)
    • 狀態 ​片段,以及最後儲存的資訊
    • 用來切換至原始 (以資產為主) 編輯器的切換開關
  • 左面板:顯示內容片段的​ 變數 ​及其​ 欄位

    • 這些連結可用來導覽至內容片段結構
  • 右側面板:展示一些會顯示屬性 (中繼資料) 和標記的標籤、有關版本歷史記錄的資訊,以及與任何語言版本相關的資訊

    • 在「屬性」標籤中,您可以更新片段的「標題」和「說明」,或者更新「變數
  • 中央面板:顯示所選變數的實際欄位和內容

    • 允許您編輯內容
    • 如果「標籤預留位置」欄位是在此處所示模型中定義,那麼這些欄位可用於導覽

例如,片段可以:

  • 需要多段資訊,其中有些是具有特定類型。對於 Headless 內容,參考是關鍵 (歷程的後續部分將會說明)。

  • 允許您撰寫一長段文字。這裡有用於管理和格式化文字的其他選項。您甚至可以在全螢幕編輯器中開啟各個文字欄位 (使用右側外觀像螢幕的小圖示)

內容片段編輯器 - Alaska Spirits

NOTE
可能需要專案特定文件來協助作者詳細了解如何成功完成某些欄位。
如需一般詳細資訊,請參閱內容片段模型 - 資料類型和屬性。

使用​ 儲存 ​或​ 儲存並關閉 ​確認您的更新。

NOTE
如需更多詳細資訊,您可以閱讀「變化 - 製作內容片段」。

你 (可能) 不需要擔心的事情 what-you-probably-do-not-need-to-worry-about

好的,這部分可能看起來有點奇怪,但是一旦您開啟內容片段編輯器並開始探索,您可以看到各種選項 (可能) 不適用於您作為內容作者的 Headless 歷程。所以這只是在快速提示 Headless 情境中你可忽略的東西:

  • 內容片段模型

    您可以在編輯器右側面板中看到內容片段模型的名稱。這也是一個將您帶到模型編輯器的連結。
    內容片段模型實際上對您的內容片段至關重要,因為它們定義了您使用的結構。然而,建立和編輯模型 (通常) 是另一個角色的責任,即內容架構師。

    note note
    NOTE
    如果想進一步了解,請參閱「AEM Headless 內容架構師歷程」。

發佈 publishing

完成片段後,您可以​ 發佈 ​以供 Headless 應用程式使用。

可在編輯器中使用發佈動作:

內容片段編輯器 - 我的片段

NOTE
您還可以從​ 資產 ​或者​ 內容片段 ​主控台發佈片段。

下一步 whats-next

現在您已經了解基本知識,下一步是了解參考。這將介紹和討論可用的各種參考,以及如何建立片段參考的結構階層,這是 Headless 內容製作的關鍵部分。

其他資源 additional-resources

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab