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 的關鍵區域。對於內容片段,您將使用​ Assets主控台

您可以選取左上方的「Adobe」圖示,然後選取小型指南針圖示,以開啟「導覽」面板:

導覽面板

NOTE
雖然內容片段是AEM Sites ​的功能,但在​ Assets ​主控台中找到它們。 這個技術細節不會影響您的操作,但了解它可能會有用。

在主控台中,您可以選取資料夾以導覽至您的內容片段,或選取階層連結(在標題中)以導覽備份樹狀結構。

階層連結

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

Assets ​主控台有專用的​ 動作工具列 ​和​ 快速動作,您可以在選取資源(例如資料夾或內容片段)之後使用。

快速動作適用於單一資源,請參閱下列範例中的​ Basel

快速動作

「動作」工具列可讓您存取全部的動作,適用於目前的情境。 可用的動作可能會變更;例如,視您的位置而定,或您是否已選取多個資源:

動作工具列

您可以使用檢視選擇器來選取檢視資源的格式:

檢視選擇器

您可以使用邊欄選擇器檢視有關專案的其他資訊。 這也能讓您存取其他動作。

左側邊欄

編寫內容片段 authoring-content-fragments

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

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

組織和導覽 organizing-and-navigating

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

建立資料夾 creating-folder

您可以在Assets主控台的​ 檔案 ​區段中建立一系列資料夾,以執行此操作。 選擇​ 建立 ​選項 (右上角),然後選擇​ 資料夾

建立資料夾選項

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

建立資料夾對話框

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

本章節的技術稍微進階一些。如果您正要開始和嘗試一些事情,其實並不需要它,但當您有許多片段時,它最有用。 所以了解它是件好事 - 即使您還沒有使用它。

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

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

建立資料夾屬性 - 原則

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

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

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

以防萬一…

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

建立資料夾屬性 - 設定

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

建立內容片段 creating-fragment

建立內容片段非常類似 — 您只使用​ 內容片段 ​選項代替:

建立內容片段選項

此時會開啟精靈。 第一步是選取您的片段將依據的內容片段模式:

建立內容片段 — 選取模型

繼續使用​ 下一步 ​之後,您可以提供片段的詳細資料(基本 ​和​ 進階):

建立內容片段 - 提供名稱

向​ Create ​確認,然後您就可以在編輯器中​ 開啟 ​您的片段。

編輯片段 editing-fragment

您可以在建立片段後立即開啟片段,或是從Assets主控台選取片段。

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

  • 左側有一列圖示 - 可讓您存取各個功能區域。編輯器會在​ 變化 ​索引標籤中開啟,這是大部分編輯進行的地方。您可能也對​ 附註 ​和​ 中繼資料 ​索引標籤感興趣。

  • 包含片段資訊的標頭,以及對各種動作的存取。

  • 主編輯區域 - 這取決於用於建立片段的模型。

例如:

  • 只需要多個資訊的片段,其中一些具有特定類型。對於無周邊內容,參考是關鍵,歷程的後續部分將會說明。

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

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

    內容片段編輯器 - Alaska Spirits

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

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

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

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

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

  • 內容片段模型

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

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

    這個標題相當明顯,因為它是編輯器中的索引標籤。

    內容片段已在多個版本的 AEM 中使用。最初,它們在編寫頁面時可用於「傳統」用途……並且它們仍用於此種情況。這可能涉及建立資產(例如影像)的關聯,雖然這些資產未內嵌在片段中,但在製作頁面時,作者仍需要使用這些資產。

  • 預覽

    這是編輯器中的另一個索引標籤,提供技術檢視,主要供開發人員使用。

  • 更新頁面參考

    (省略符號) 下拉式清單可提供此動作。對於 Headless 作者來說這並不有趣,因為它與頁面編寫有關。

發佈 publishing

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

發佈動作可在編輯器中使用(或從​ Assets ​主控台的工具列中使用):

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

下一步 whats-next

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

其他資源 additional-resources

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2