頁面範本

建立頁面時，您需要選取範本。 頁面範本會用作新頁面的基礎。 範本會定義結果頁面的結構、任何初始內容以及可以使用的元件（設計屬性）。 這有幾個優點：

• 頁面範本可讓專業作者執行以下作業 建立和編輯範本.
  • 這類專業作者稱為 範本作者
  • 範本作者必須是 template-authors 群組。
• 頁面範本會保留與任何使用它們建立的頁面的動態連線。 這可確保對範本所做的任何變更都會反映在頁面本身中。
• 頁面範本讓頁面元件變得更通用，以便無需自訂即可使用核心頁面元件。

使用「頁面範本」，建立頁面的片段會隔離在元件中。 您可以在UI中設定必要的元件組合，因此不需要為每個頁面變數開發新的頁面元件。

本文件:

• 提供建立頁面範本的概觀
• 說明建立可編輯範本所需的管理員/開發人員工作
• 說明可編輯範本的技術基礎
• 說明AEM如何評估範本的可用性

建立新範本

建立頁面範本主要是透過完成 範本主控台和範本編輯器 由範本作者執行。 本節提供此程式的概述，並在後面說明在技術層面上發生的情況。

建立新的可編輯範本時，您可以：

1. 建立 範本的資料夾. 這不是強制性的，但建議使用最佳實務。

2. 選取 範本型別. 系統會複製此專案，以建立 範本定義.

   注意

   現成提供一系列範本型別。 您也可以 建立您自己的網站特定範本型別 如有需要。

3. 設定新範本的結構、內容原則、初始內容和版面配置。

   結構

   • 結構可讓您定義範本的元件和內容。
   • 無法在產生的頁面上移動範本結構中所定義的元件，也無法將其從任何產生的頁面中刪除。
   • 如果您希望頁面作者能夠新增和移除元件，請將段落系統新增至範本。
   • 您可以解鎖元件，然後再將其鎖定，以便定義初始內容。

   如需範本作者如何定義結構的詳細資訊，請參閱 建立頁面範本.

   如需結構的技術詳細資訊，請參閱 結構 於本檔案中。

   原則

   • 內容原則會定義元件的設計屬性。

     • 例如，可用的元件或最小/最大尺寸。

   • 這些適用於範本（以及使用範本建立的頁面）。

   如需範本作者如何定義原則的詳細資訊，請參閱 建立頁面範本.

   如需原則的技術詳細資訊，請參閱 內容原則 於本檔案中。

   初始內容

   • 初始內容定義根據範本首次建立頁面時顯示的內容。
   • 然後，頁面作者可以編輯初始內容。

   如需範本作者如何定義結構的詳細資訊，請參閱 建立頁面範本.

   如需初始內容的技術細節，請參閱 初始內容 於本檔案中。

   配置

   • 您可以為一系列裝置定義範本配置。
   • 範本的回應式版面運作方式與頁面製作相同。

   如需範本作者如何定義範本配置的詳細資訊，請參閱 建立頁面範本.

   如需範本配置的技術詳細資訊，請參閱 版面 於本檔案中。

4. 啟用範本，然後允許其用於特定內容樹狀結構。

   • 您可以啟用或停用範本，讓頁面作者可以使用或無法使用此範本。
   • 範本可設為可用於或不可用於某些頁面分支。

   如需範本作者如何啟用範本的詳細資訊，請參閱 建立頁面範本.

   如需啟用範本的技術詳細資訊，請參閱 為我們啟用和允許範本e在此檔案中

5. 使用它來建立內容頁面。

   • 使用範本建立新頁面時，靜態範本與可編輯範本之間沒有可見的差異和指示。
   • 對於頁面作者，程式是透明的。

   如需頁面作者如何使用範本建立頁面的詳細資訊，請參閱 建立及組織頁面.

   如需使用可編輯的範本建立頁面的技術詳細資訊，請參閱 結果內容頁面 於本檔案中。

範本資料夾

若要組織範本，您可以使用下列資料夾：

• global
• 特定網站

在標準AEM執行個體中 global 資料夾已存在於範本主控台中。 如果在目前資料夾中找不到原則及/或範本型別，這會保留預設範本並做為遞補內容。 您可以將預設範本新增至此資料夾或建立新資料夾（建議選項）。

範本型別和原則會根據下列優先順序繼承至所有資料夾：

1. 目前的資料夾
2. 目前資料夾的父系
3. /conf/global
4. /apps
5. /libs

將會建立所有允許專案的清單。 如果任何設定重疊( path/ label)，則只會向使用者顯示最接近目前資料夾的執行個體。

若要建立新資料夾，您可以執行下列任一項作業：

• 以程式設計方式或CRXDE Lite
• 使用 設定瀏覽器

使用 CRXDE Lite

1. 可以程式設計方式或CRXDE Lite方式為您的執行個體建立新資料夾（在/conf下）。

   必須使用下列結構：

   /conf
       <your-folder-name> [sling:Folder]
           settings [sling:Folder]
               wcm [cq:Page]
                   templates [cq:Page]
                   policies [cq:Page]
   

2. 然後，您可以在資料夾根節點上定義下列屬性：

   <your-folder-name> [sling:Folder]

   • 名稱: jcr:title
   • 類型: String
   • 值：您要在「 」中顯示的「 」資料夾標題 範本 主控台。

3. 除了標準編寫許可權和許可權之外(例如， content-authors)您現在需要指派群組並定義作者所需的存取許可權(ACL)，才能在新資料夾中建立範本。

   此 template-authors group是需要指派的預設群組。 請參閱區段 ACL和群組 以取得詳細資訊。

使用設定瀏覽器

1. 前往 全域導覽 -> 工具 > 設定瀏覽器.

   現有資料夾會列在左側，包括 global 資料夾。

2. 按一下​建立。

3. 在 建立設定 對話方塊需要設定下列欄位：

   • 標題：提供設定資料夾的標題
   • 可編輯的範本：勾選以允許在此資料夾中使用可編輯的範本

4. 按一下 建立

ACL和群組

建立範本資料夾後（透過CRXDE或使用設定瀏覽器），必須為範本資料夾的適當群組定義ACL，以確保適當的安全性。

的範本資料夾 wknd教學課程 可作為範例。

範本 — 作者群組

此 template-authors group是用來管理範本存取的群組，且隨附於AEM，但為空白。 必須將使用者新增至專案/網站的群組。

下表詳細說明範本編輯的必要許可權。

此預設值 template-authors 群組僅涵蓋專案設定，其中所有 template-authors 允許成員存取及編寫所有範本。 對於更複雜的設定，需要多個範本作者群組來分隔範本的存取許可權，則必須建立更多自訂範本作者群組。 不過，範本作者群組的許可權仍會相同。

範本型別

建立新範本時，您需要指定範本型別：

• 範本型別可有效提供範本的範本。 建立新範本時，會使用所選範本型別的結構和初始內容來建立新範本。

  • 範本型別會複製以建立範本。
  • 複製一旦發生，範本和範本型別之間的唯一連線是靜態參考，以供參考。

• 範本型別可讓您定義：

  • 頁面元件的資源型別。
  • 根節點的原則，定義範本編輯器中允許的元件。
  • 建議為回應式格線定義中斷點，並在範本型別上設定行動模擬器。

• AEM提供少量現成可用的範本型別，例如「HTML5頁面」和「最適化表單頁面」。

  • 提供其他範例作為的一部分 wknd教學課程。

• 範本型別通常由開發人員定義。

現成的範本型別儲存在下列位置：

• /libs/settings/wcm/template-types

您的網站特定範本型別應儲存在類似位置：

• /apps/settings/wcm/template-types

自訂範本型別的定義應儲存在使用者定義的資料夾中（建議使用），或是儲存在 global. 例如：

• /conf/<my-folder-01>/<my-folder-02>/settings/wcm/template-types
• /conf/<my-folder>/settings/wcm/template-types
• /conf/global/settings/wcm/template-types

建立範本型別

如果您已建立可作為其他範本基礎的範本，則可以複製此範本作為範本型別。

1. 建立範本，就像建立任何頁面範本一樣 如此處的紀錄，這會作為範本型別的基礎。
2. 使用CRXDE Lite，複製新建立的範本 templates 節點至 template-types 下的節點 範本資料夾.
3. 從刪除範本 templates 下的節點 範本資料夾.
4. 在範本的副本中，位於 template-types 節點，全部刪除 cq:template 和 cq:templateType 全部屬性 jcr:content 節點。

您也可以使用GitHub提供的範例可編輯範本作為基礎，來開發自己的範本型別。

GITHUB上的程式碼

您可以在GitHub上找到此頁面的程式碼

• 在GitHub上開啟aem-sites-example-custom-template-type專案
• 將專案下載為 ZIP檔案

範本定義

可編輯範本的定義已儲存 使用者定義的資料夾 （建議使用）或選擇使用 global. 例如：

• /conf/<my-folder>/settings/wcm/templates
• /conf/<my-folder-01>/<my-folder-02>/settings/wcm/templates
• /conf/global/settings/wcm/templates

範本的根節點為型別 cq:Template 骨架結構為：

<template-name>
  initial
    jcr:content
      root
        <component>
        ...
        <component>
  jcr:content
    @property status
  policies
    jcr:content
      root
        @property cq:policy
        <component>
          @property cq:policy
        ...
        <component>
          @property cq:policy
  structure
    jcr:content
      root
        <component>
        ...
        <component>
      cq:responsive
        breakpoints
  thumbnail.png

主要元素包括：

• <template-name>

  • [initial](#initial-content)
  • jcr:content
  • [structure](#structure)
  • [policies](#policies)
  • thumbnail.png

jcr：content

此節點保留範本的屬性：

• 名稱: jcr:title
• 名稱: status
  • "型別： String
  • 值： draft， enabled 或 disabled

結構

定義結果頁面的結構：

• 與初始內容合併( /initial)建立新頁面時。

• 對結構所做的變更將反映在使用範本建立的任何頁面中。

• 此 root ( structure/jcr:content/root)節點會定義產生頁面中可用的元件清單。

  • 範本結構中定義的元件無法在任何結果頁面上移動或刪除。
  • 解鎖元件後， editable 屬性已設定為 true.
  • 解鎖已包含內容的元件後，此內容將移至 initial 分支。

• 此 cq:responsive 節點保留回應式佈局的定義。

初始內容

定義建立新頁面時將具有的初始內容：

• 包含 jcr:content 複製到任何新頁面的節點。
• 與結構合併( /structure)建立新頁面時。
• 如果在建立後變更初始內容，則不會更新任何現有頁面。
• 此 root node會儲存元件清單，以定義結果頁面中可用的元件。
• 如果在結構模式下將內容新增到元件，且隨後解鎖該元件（反之亦然），則此內容會用作初始內容。

配置

時間 編輯範本您可以定義版面，這會使用 標準回應式佈局.

內容原則

內容原則會定義元件的設計屬性。 例如，可用的元件或最小/最大尺寸。 這些適用於範本（以及使用範本建立的頁面）。 可在範本編輯器中建立和選取內容原則。

• 屬性 cq:policy，位於 root 節點
  /conf/<your-folder>/settings/wcm/templates/<your-template>/policies/jcr:content/root
  提供頁面段落系統內容原則的相對參照。

• 屬性 cq:policy，於下的元件明確節點上 root，提供個別元件原則的連結。

• 實際原則定義儲存在下列位置：
  /conf/<your-folder>/settings/wcm/policies/wcm/foundation/components

頁面原則

頁面原則可讓您定義 內容原則 頁面（主要parsys）的範本或結果頁面中。

啟用和允許使用範本

1. 啟用範本

   使用範本之前，必須透過以下任一方式啟用它：

   • 啟用範本 從 範本 主控台。

   • 在上設定狀態屬性 jcr:content 節點。

     • 例如，在：

       /conf/<your-folder>/settings/wcm/templates/<your-template>/jcr:content

     • 定義屬性：

       • 名稱：狀態
       • 型別：字串
       • 值: enabled

2. 允許的範本

   • 在上定義允許的範本路徑 頁面屬性 子分支的適當頁面或根頁面的URL。

   • 設定屬性：

     cq:allowedTemplates
     於
     jcr:content 必要分支的節點。
     例如，其值為：

   /conf/<your-folder>/settings/wcm/templates/.*

結果內容頁面

從可編輯範本建立的頁面：

• 使用合併的子樹狀結構建立 structure 和 initial 在範本中

• 具有範本和範本型別中所儲存資訊的參考。 這是透過以下專案達成： jcr:content 具有下列屬性的節點：

  • cq:template — 提供實際範本的動態參考；讓範本的變更反映在實際頁面上。

  • cq:templateType — 提供範本型別的參考。

上圖顯示範本、內容和元件如何相互關聯：

• 控制器 — /content/<my-site>/<my-page> — 參照範本的結果頁面。 內容會控制整個程式。 根據定義，它會存取適當的範本和元件。
• 設定 — /conf/<my-folder>/settings/wcm/templates/<my-template> - 範本和相關內容原則 定義頁面設定。
• 模型 — OSGi套件組合 — OSGI套件組合 實作功能。
• 檢視 — /apps/<my-site>/components — 在製作和發佈環境中，內容會由元件轉譯。

轉譯頁面時：

• 範本:

  • 此 cq:template 其屬性 jcr:content 節點將被引用，以存取與該頁面對應的範本。

• 元件:

  • 頁面元件會合併 structure/jcr:content 範本的樹狀結構，具有 jcr:content 頁面的樹狀結構。
    • 頁面元件僅可讓作者編輯已標籤為可編輯的範本結構節點（以及任何子系）。
    • 在頁面上呈現元件時，該元件的相對路徑將取自 jcr:content 節點；下方的相同路徑 policies/jcr:content 接著會搜尋範本的節點。
      • 此 cq:policy 此節點的屬性指向實際內容原則（即它儲存該元件的設計設定）。
        • 這可讓您擁有重複使用相同內容原則設定的多個範本。

範本可用性

在網站管理介面中建立新頁面時，可用範本的清單取決於新頁面的位置以及每個範本中指定的版位限制。

下列屬性決定是否使用範本 T 允許用於要放置為頁面子項的新頁面 P. 以下每個屬性都是多值字串，其中包含零個或多個用來與路徑比對的規則運算式：

• 此 cq:allowedTemplates 的屬性 jcr:content 的子節點： P 或祖先 P.

• 此 allowedPaths 屬性 T.

• 此 allowedParents 屬性 T.

• 此 allowedChildren 的範本屬性 P.

評估的運作方式如下：

• 第一個非空白 cq:allowedTemplates 將頁面階層從開頭遞增時發現屬性 P 比對的路徑 T. 如果沒有任何相符的值， T 已拒絕。

• 若 T 具有非空白 allowedPaths 屬性，但沒有值符合的路徑 P， T 已拒絕。

• 如果上述兩個屬性都空白或不存在， T 除非屬於與相同的應用程式，否則會遭拒 P. T 屬於與相同的應用程式 P 若且唯若第二層路徑的名稱 T 與路徑的第二層級名稱相同 P. 例如，範本 /apps/wknd/templates/foo 屬於與頁面相同的應用程式 /content/wknd.

• 若 T 具有非空白 allowedParents 屬性，但沒有值符合的路徑 P， T 已拒絕。

• 如果範本屬於 P 具有非空白 allowedChildren 屬性，但沒有值符合的路徑 T， T 已拒絕。

• 在所有其他情況下， T 允許。

下圖說明範本評估程式：

限制子頁面中使用的範本

若要限制哪些範本可用於在指定頁面下建立子頁面，請使用 cq:allowedTemplates 屬性 jcr:content 頁面節點，用來指定允許做為子頁面的範本清單。 例如，清單中的每個值都必須是允許的子頁面範本的絕對路徑 /apps/wknd/templates/page-content.

您可以使用 cq:allowedTemplates 範本的屬性 jcr:content 節點，將此設定套用至使用此範本的所有新建立頁面。

如果您想要新增更多限制，例如關於範本階層的限制，您可以使用 allowedParents/allowedChildren 範本的屬性。 然後，您可以明確指定從範本T建立的頁面必須是從範本T建立的頁面的父項/子項。

Business.Adobe.com 資源