內容片段範本

注意

內容片段模型 建議您建立所有新內容片段。

內容片段模型用於WKND中的所有範例。

注意

在AEM 6.3之前,內容片段是根據範本而非模型建立。

內容片段範本現已過時。 它們仍可用於建立片段,但建議改用內容片段模型。 片段範本不會新增任何功能,且這些功能將在未來版本中移除。

建立內容片段時會選取範本。 它們為新片段提供了基本結構、元素和變異。 用於內容片段的範本需受Granite Configuration Manager的規範。

現成可用的範本位於:

  • /libs/settings/dam/cfm/templates

您可以在下方為內容片段建立網站特定範本:

  • /apps/settings/dam/cfm/templates
    用於覆蓋現成可用的模板或提供客戶特定、應用程式範圍的模板的位置,這些模板不打算在運行時擴展/更改。

  • /conf/global/settings/dam/cfm/templates
    需要在執行階段變更之執行個體範圍客戶專屬範本的位置。

優先順序順序為(降序) /conf, /apps, /libs.

注意

必須 不會變更 /libs 路徑。

這是因為 /libs 下次升級執行個體時即會覆寫(而當您套用Hotfix或Feature Pack時,很可能會覆寫)。

設定和其他變更的建議方法為:

  1. 重新建立所需項目(亦即, /libs)底下 /apps

  2. 在內進行任何變更 /apps

範本的基本結構如下:

conf
  global
    settings
      dam
        cfm
          templates
            <template-name>
              ...

具體結構為:

+ <template-name>
    - jcr:primaryType
    - jcr:title
    - jcr:description
    - initialAssociatedContent
    - precreateElements
    - version
    + elements
        - jcr:primaryType
        + <element-name>
            - jcr:primaryType
            - jcr:title
            - defaultContent
            - initialContentType
            - name
        ... + other element definitions
    + variations
        - jcr:primaryType
        + <variation-name>
            - jcr:primaryType
            - jcr:title
            - jcr:description
            - name
        ... + other variation definitions

有關節點及其屬性的詳細資訊包括:

  • 範本

    名稱 類型
    <template-name> nt:unstructured 此節點是每個模板的根節點。 此為必要項目,且名稱應是唯一的。
    jcr:title

    String

    必填

    範本的標題(顯示於 建立片段 精靈)。
    jcr:description

    String

    可選

    說明範本用途的文字(顯示於 建立片段 精靈)。
    initialAssociatedContent

    String[]

    可選

    依預設,具有系列路徑的陣列應與新建立的內容片段相關聯。
    precreateElements

    Boolean

    必填

    true,如果在建立內容片段時,應建立代表內容片段元素(主版元素除外)的子資產; false 如果應該「即時」建立它們。

    附註:目前此參數必須設為 true.

    version

    Long

    必填

    內容結構的版本;目前支援:

    附註:目前此參數必須設為 2.

  • 元素

    名稱 類型
    elements

    nt:unstructured

    必填

    包含內容片段元素定義的節點。 此為必要項目,需要包含 主要 元素,但可以包含[1..n]子節點。

    使用模板時,元素子分支將被複製到片段的模型子分支。

    第一個元素(如CRXDE Lite中所檢視)會自動被視為 main 元素;節點名稱無關,節點本身除以主要資產表示外,沒有特殊意義;其他元素會以子資產的形式處理。

  • 元素名稱

    名稱 類型
    <element-name> nt:unstructured 此節點定義元素。 此為必要項目,且名稱應是唯一的。
    jcr:title

    String

    必填

    元素的標題(顯示在片段編輯器的元素選取器中)。
    defaultContent

    String

    可選

    預設: ""

    元素的初始內容;僅使用 precreateElements = true
    initialContentType

    String

    可選

    預設: text/html

    元素的初始內容類型;僅使用 precreateElements = true;目前支援:

    • text/html
    • text/plain
    • text/x-markdown
    name

    String

    必填

    元素的內部名稱;片段類型必須是唯一的。
  • 變數

    名稱 類型
    variations

    nt:unstructured

    可選

    此選用節點包含內容片段初始變異的定義。
  • 變數名稱

    名稱 類型
    <variation-name>

    nt:unstructured

    若變異節點存在,則此為必要項目

    定義初始變數。
    依預設,變異會新增至內容片段的所有元素。

    變異的初始內容將與個別元素相同(請參閱 defaultContent/ initialContentType)

    jcr:title

    String

    必填

    變異的標題(顯示在片段編輯器的 變異 標籤(左側欄)。
    jcr:desciption

    String

    可選

    預設: ""

    提供變異說明的文字 (顯示在片段編輯器的 變異 標籤(左側欄)。

本頁內容