內容片段範本

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

現成可用的範本位於：

• /libs/settings/dam/cfm/templates

您可以在下列網址建立內容片段的網站特定範本：

• /apps/settings/dam/cfm/templates
  覆蓋現成可用範本或提供客戶特定、應用程式範圍範本的位置，這些範本在執行時期不會延伸／變更。

• /conf/global/settings/dam/cfm/templates
  需要在執行時期變更的整個客戶特定範本位置。

優先順序是（降序） /conf, /apps、 /libs。

範本之基本架構如下：

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 required	範本的標題(顯示在「建立片段 」精靈中 )。
  jcr:description	String 可選	說明範本用途的文字(顯示在「建立片段 」精靈中 )。
  initialAssociatedContent	String[] 可選	預設情況下，具有系列路徑的陣列，應與新建立的內容片段相關聯。
  precreateElements	Boolean 必要	true,if the subsasets resporting the elements（master element除外）of the content fragment is created; false （如果應「即時」建立）。 注意: 目前，此參數必須設為 true。
  version	Long 必要	內容結構版本； 目前支援： 注意: 目前，此參數必須設為 2。

• 元素

  名稱	類型	值
  elements	nt:unstructured 必要	包含內容片段元素定義的節點。 它是強制性的，並且需要為 Main元素至少包含一個子節點 ，但可以包含[1...n]子節點。 使用模板時，元素子分支將被複製到片段的模型子分支。 第一個元素（如CRXDE Lite中所述）會自動被視為主 要元 素； 節點名稱無關，節點本身除了以主資產表示外，沒有特殊意義； 其他元素則視為子資產處理。

• 元素名稱

  名稱	類型	值
  <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 必要	變數的標題(顯示在片段編輯器的「變數」( Variation )頁籤中（左側邊欄）)。
  jcr:desciption	String 可選 預設: ""	提供變化說明的文字(顯 示在片段編輯器的「變 化 」標籤（左側欄）中)。