可編輯的範本 editable-templates
瞭解在建立頁面、定義其初始內容、結構化內容、編寫原則和版面配置時，如何使用可編輯範本。
概觀 overview
建立頁面時，您需要選取範本。 頁面範本會用作新頁面的基礎。 範本可以定義結果頁面的結構、任何初始內容以及可以使用的元件（設計屬性）。
用來建立可透過通用編輯器編輯之頁面的頁面範本使用可編輯範本功能的有限子集。 因此，本檔案的其餘部分側重於用於建立可使用頁面編輯器編輯的頁面的可編輯範本。
使用頁面編輯器編輯的可編輯範本和頁面 page-editor
建立範本以建立可使用「頁面編輯器」編輯的頁面時，通常會識別專門的作者。
- 這類特殊作者稱為 範本作者
- 範本作者必須是
template-authors群組的成員。 - 可編輯的範本會保留與任何建立頁面的動態連線。 這可確保對範本所做的任何變更都會反映在頁面本身中。
- 可編輯的範本讓頁面元件變得更通用，以便無需自訂即可使用核心頁面元件。
使用可編輯的範本，建立頁面的片段會隔離在元件中。 您可以在UI中設定必要的元件組合，因此不需要為每個頁面變數開發新的頁面元件。
本檔案：
- 提供建立可編輯範本的概觀
- 說明建立可編輯範本所需的管理員/開發人員工作
- 說明可編輯範本的技術基礎
- 說明AEM如何評估範本的可用性
建立新的可編輯範本 creating-a-new-template
建立可編輯的範本主要是由範本作者使用範本主控台和範本編輯器完成。 本節提供此程式的概述，並接著說明在技術層級進行的工作。
建立可編輯的範本時，您可以：
-
為範本🔗建立資料夾。 這並不強制，但建議最佳實務。
-
note note NOTE 現成提供一系列範本型別。 如有必要，您也可以建立您自己的網站特定範本型別。 -
設定新範本的結構、內容原則、初始內容和版面配置。
結構
- 結構可讓您定義範本的元件和內容。
- 範本結構中定義的元件無法在產生的頁面上移動，也無法從任何產生的頁面中刪除。
- 如果您希望頁面作者能夠新增和移除元件，請新增段落系統至範本。
- 您可以解鎖元件，然後再將其鎖定，以便定義初始內容。
如需範本作者如何定義結構的詳細資訊，請參閱建立可使用頁面編輯器編輯的頁面的範本。
如需結構的技術細節，請參閱本檔案中的結構。
原則
-
內容原則會定義元件的設計屬性。
- 例如，可用的元件或最小/最大尺寸。
-
這些適用於範本（以及使用範本建立的頁面）。
如需範本作者如何定義原則的詳細資訊，請參閱建立可使用頁面編輯器編輯的頁面的範本。
如需原則的技術詳細資訊，請參閱本檔案中的內容原則。
初始內容
- 初始內容定義首次根據範本建立頁面時顯示的內容。
- 然後，頁面作者可以編輯初始內容。
如需範本作者如何定義結構的詳細資訊，請參閱建立可使用頁面編輯器編輯的頁面的範本。
如需初始內容的技術細節，請參閱本檔案中的初始內容。
配置
- 您可以為一系列裝置定義範本配置。
- 範本的回應式版面運作方式與頁面製作相同。
如需範本作者如何定義範本配置的詳細資訊，請參閱建立可使用頁面編輯器編輯的頁面的範本。
如需範本配置的技術詳細資訊，請參閱本檔案中的配置。
-
啟用範本，然後允許用於特定內容樹。
- 您可以啟用或停用範本，讓頁面作者可以使用或無法使用此範本。
- 範本可以供某些頁面分支使用或無法使用。
如需範本作者如何啟用範本的詳細資訊，請參閱範本以建立可使用頁面編輯器編輯的頁面。
如需啟用範本的技術詳細資訊，請參閱本檔案中的啟用和允許我們使用範本e
-
使用它來建立內容頁面。
- 使用範本建立頁面時，靜態範本和可編輯範本之間沒有可見的差異和指示。
- 對於頁面作者，程式是透明的。
如需頁面作者如何使用範本建立頁面的詳細資訊，請參閱建立及組織頁面。
如需使用可編輯的範本建立頁面的技術詳細資訊，請參閱本檔案中的結果內容頁面。
cq.shared名稱空間，如果不存在，將導致JavaScript錯誤Uncaught TypeError: Cannot read property 'shared' of undefined。cq.shared，因此任何以這些頁面為基礎的內容都會自動包含cq.shared。 但是，如果您決定從頭開始建立自己的內容頁面，而不根據範例內容，則必須確定包括cq.shared名稱空間。範本資料夾 template-folders
若要組織您的範本，您可以使用下列資料夾：
global- 特定網站
在標準AEM執行個體中，global資料夾已存在於範本主控台中。 此檔案會保留預設範本，並在目前資料夾中找不到原則及/或範本型別時，做為遞補內容。 您可以將預設範本新增至此資料夾或建立資料夾（建議）。
global資料夾。admin許可權的使用者建立。範本型別和原則會根據下列優先順序繼承至所有資料夾：
- 目前的資料夾
- 目前資料夾的父系
/conf/global/apps/libs
將會建立所有允許專案的清單。 如果任何設定重疊( path/ label)，則只會向使用者顯示最接近目前資料夾的執行個體。
若要建立資料夾，您可以執行下列任一操作：
- 以程式設計方式或使用CRXDE Lite
- 使用設定瀏覽器
使用 CRXDE Lite using-crxde-lite
-
可以程式設計方式或使用CRXDE Lite為您的執行個體建立新資料夾（在/conf下）。
必須使用下列結構：
code language-xml /conf <your-folder-name> [sling:Folder] settings [sling:Folder] wcm [cq:Page] templates [cq:Page] policies [cq:Page] -
然後，您可以在資料夾根節點上定義下列屬性：
<your-folder-name> [sling:Folder]- 名稱：
jcr:title - 類型：
String - 值：您要在 範本 主控台中顯示的標題（資料夾）。
- 名稱：
-
除了標準撰寫許可權和許可權（例如
content-authors）之外，您現在需要指派群組並定義作者所需的存取許可權(ACL)，才能在新資料夾中建立範本。template-authors群組是必須指派的預設群組。 如需詳細資訊，請參閱ACL和群組一節。
使用設定瀏覽器 using-the-configuration-browser
-
移至 全域導覽 > 工具 > 設定瀏覽器。
現有資料夾會列在左側，包括
global資料夾。 -
按一下 建立。
-
在 建立設定 對話方塊中，需要設定下列欄位：
- 標題：提供設定資料夾的標題
- 可編輯的範本：勾選以允許此資料夾中的可編輯範本
-
按一下「建立」。
ACL和群組 acls-and-groups
建立範本資料夾（透過CRXDE或使用「設定瀏覽器」）後，必須為範本資料夾的適當群組定義ACL，以確保適當的安全性。
WKND教學課程的範本資料夾可作為範例使用。
範本 — 作者群組 the-template-authors-group
template-authors群組是用來管理範本存取權的群組，且隨附於AEM，但為空白。 必須將使用者新增至專案/網站的群組。
template-authors群組僅適用於必須能夠建立新範本的使用者。下表詳細說明範本編輯的必要許可權。
此預設template-authors群組僅涵蓋專案設定，其中所有template-authors成員都可存取及編寫所有範本。 對於更複雜的設定，需要多個範本作者群組來分隔範本的存取許可權，則必須建立更多自訂範本作者群組。 不過，範本作者群組的許可權將仍相同。
範本型別 template-type
建立範本時，您需要指定範本型別：
-
範本型別可有效提供範本的範本。 建立範本時，會使用所選範本型別的結構和初始內容來建立新範本。
- 範本型別會複製以建立範本。
- 複製一旦發生，範本和範本型別之間的唯一連線是靜態參考，以供參考。
-
範本型別可讓您定義：
- 頁面元件的資源型別。
- 根節點的原則，定義範本編輯器中允許的元件。
- 建議為回應式格線定義中斷點，並在範本型別上設定行動模擬器。
-
AEM提供少量現成可用的範本型別，例如「HTML5頁面」和「最適化表單頁面」。
- 提供其他範例作為WKND教學課程的一部分。
-
範本型別通常由開發人員定義。
現成可用的範本型別儲存在下列位置：
/libs/settings/wcm/template-types
/libs路徑中的任何專案。 這是因為/libs的內容可以隨時由AEM的更新覆寫。您的網站特定範本型別應儲存在類似位置：
/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
/settings/wcm/...），否則將無法找到範本型別。建立範本型別 creating-template-types
如果您已建立可作為其他範本基礎的範本，則可以複製此範本作為範本型別。
- 建立範本，就像建立任何頁面範本一樣。 請參閱範本，以建立可使用頁面編輯器編輯的頁面。 這會作為範本型別的基礎。
- 使用CRXDE Lite，將建立的範本從
templates節點複製到範本資料夾下的template-types節點。 - 從範本資料夾下的
templates節點中刪除範本。 - 在
template-types節點下的範本復本中，從所有jcr:content節點刪除所有cq:template和cq:templateType屬性。
您也可以使用GitHub提供的範例可編輯範本，在此基礎上開發自己的範本型別。
GITHUB上的程式碼
您可以在GitHub上找到此頁面的程式碼
範本定義 template-definitions
可編輯範本的定義會儲存在使用者定義的資料夾 （建議使用）或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-content
此節點會保留範本的屬性：
-
名稱：
jcr:title -
名稱：
status- ''型別：
String - 值：
draft、enabled或disabled
- ''型別：
結構 structure
定義結果頁面的結構：
-
在建立頁面時與初始內容(
/initial)合併。 -
對結構所做的變更會反映在使用範本建立的任何頁面中。
-
root(structure/jcr:content/root)節點會定義結果頁面中可用的元件清單。- 範本結構中定義的元件無法在任何結果頁面上移動或從中刪除。
- 在元件解除鎖定後，
editable屬性設定為true。 - 解鎖已包含內容的元件後，此內容會移至
initial分支。
-
cq:responsive節點保留回應式配置的定義。
初始內容 initial-content
定義建立新頁面時將具有的初始內容：
- 包含已複製到任何新頁面的
jcr:content節點。 - 在建立頁面時與結構(
/structure)合併。 - 如果在建立後變更初始內容，則不會更新任何現有頁面。
root節點儲存元件清單，以定義結果頁面中可用的專案。- 如果在結構模式下將內容新增到元件，且隨後解鎖該元件（或反之），則此內容會用作初始內容。
版面配置 layout
當編輯範本時，您可以定義配置，這會使用標準回應式配置，，內容作者可以在頁面上對其進行設定。
內容原則 content-policies
內容原則會定義元件的設計屬性。 例如，可用的元件或最小/最大尺寸。 這些適用於範本（以及使用範本建立的頁面）。 可在範本編輯器中建立和選取內容原則。
-
root節點上的屬性cq:policy/conf/<your-folder>/settings/wcm/templates/<your-template>/policies/jcr:content/root
提供頁面段落系統內容原則的相對參照。 -
屬性
cq:policy位於root下的元件明確節點上，提供個別元件原則的連結。 -
實際原則定義儲存在下列位置：
/conf/<your-folder>/settings/wcm/policies/wcm/foundation/components
cq:policy保留組態本身的相對參照。頁面原則 page-policies
頁面原則可讓您在範本或結果頁面中定義頁面（主要parsys）的內容原則。
啟用和允許使用範本 enabling-and-allowing-a-template-for-use
-
啟用範本
使用範本之前，必須透過以下任一方式啟用它：
-
正在設定
jcr:content節點上的狀態屬性。-
例如，在：
/conf/<your-folder>/settings/wcm/templates/<your-template>/jcr:content -
定義屬性：
- 名稱：狀態
- 型別：字串
- 值：
enabled
-
-
允許的範本
-
在適當的頁面或子分支的根頁面的 頁面屬性上定義允許的範本路徑。
-
設定屬性：
cq:allowedTemplates
在必要分支的jcr:content節點上。
例如，使用值：
/conf/<your-folder>/settings/wcm/templates/.* -
產生的內容頁面 resultant-content-pages
從可編輯的範本建立的頁面：
-
是以從範本中的
structure和initial合併的子樹狀結構建立 -
具有範本和範本型別中資訊的參考。 這是透過具有下列屬性的
jcr:content節點實現的：-
cq:template— 提供實際範本的動態參考；讓範本的變更反映在實際頁面上。 -
cq:templateType— 提供範本型別的參考。
-
上圖顯示範本、內容和元件如何相互關聯：
轉譯頁面時：
-
範本：
- 已參考其
jcr:content節點的cq:template屬性，以存取對應於該頁面的範本。
- 已參考其
-
元件：
-
頁面元件會將範本的
structure/jcr:content樹狀結構與頁面的jcr:content樹狀結構合併。- 頁面元件將只允許作者編輯已標籤為可編輯的範本結構的節點（以及任何子系）。
- 在頁面上呈現元件時，會從
jcr:content節點取得該元件的相對路徑；接著會搜尋範本的policies/jcr:content節點下的相同路徑。- 此節點的
cq:policy屬性指向實際內容原則（亦即，它儲存該元件的設計組態）。- 這可讓您擁有重複使用相同內容原則設定的多個範本。
- 此節點的
-
範本可用性 template-availability
在網站管理員介面中建立頁面時，可用範本清單會根據新頁面的位置及每個範本中指定的版位限制而定。
下列屬性決定是否允許範本T用於要放置為頁面P子項的新頁面。 這些屬性都是多值字串，其中包含零個或多個用於和路徑比對的規則運算式：
-
P的jcr:content子節點或P的上階的cq:allowedTemplates屬性。 -
T的allowedPaths屬性。 -
T的allowedParents屬性。 -
P之範本的allowedChildren屬性。
評估的運作方式如下：
-
以
P開頭的頁面階層遞增時，找到的第一個非空白cq:allowedTemplates屬性與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屬性 -
僅於網站根目錄上
/content/wknd/jcr:contentallowedPaths、allowedParents和allowedChildren也可以放在範本上，以定義更複雜的規則。 不過，如果可能的話，如果需要進一步限制允許的範本，在網站的子區段上定義其他cq:allowedTemplates屬性會更簡單 許多。cq:allowedTemplates屬性可由作者在 頁面屬性 的 進階 索引標籤中更新。 無法使用（標準） UI更新其他範本屬性，因此需要開發人員維護規則和每次變更的程式碼部署。限制子頁面中使用的範本 limiting-templates-used-in-child-pages
若要限制哪些範本可用於在指定頁面下建立子頁面，請使用頁面jcr:content節點的cq:allowedTemplates屬性，指定允許做為子頁面的範本清單。 清單中的每個值都必須是允許之子頁面的範本的絕對路徑，例如/apps/wknd/templates/page-content。
您可以在範本的jcr:content節點上使用cq:allowedTemplates屬性，將此組態套用至使用此範本的所有已建立頁面。
如果您想要新增更多限制，例如關於範本階層，您可以在範本上使用allowedParents/allowedChildren屬性。 然後，您可以明確指定從範本T建立的頁面必須是從範本T建立的頁面的父項/子項。