頁面範本 page-templates
建立頁面時,您需要選取範本。 頁面範本會用作新頁面的基礎。 範本會定義結果頁面的結構、任何初始內容以及可以使用的元件(設計屬性)。 這具備數個優點:
-
頁面範本可讓專業作者執行以下作業 建立和編輯範本.
- 這類專業作者稱為 範本作者
- 範本作者必須是
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
group是必須指派的預設群組。 請參閱區段 ACL和群組 以取得詳細資訊。
使用設定瀏覽器 using-the-configuration-browser
-
前往 全域導覽 > 工具 > 設定瀏覽器.
現有資料夾會列在左側,包括
global
資料夾。 -
按一下 建立。
-
在 建立設定 對話方塊需要設定下列欄位:
- 標題:提供設定資料夾的標題
- 可編輯的範本:勾選以允許在此資料夾中使用可編輯的範本
-
按一下 建立
ACL和群組 acls-and-groups
建立範本資料夾(透過CRXDE或使用「設定瀏覽器」)後,必須為範本資料夾的適當群組定義ACL,以確保適當的安全性。
的範本資料夾 wknd教學課程 可作為範例。
範本 — 作者群組 the-template-authors-group
此 template-authors
group是用來管理範本存取的群組,且隨附於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
如果您已建立可作為其他範本基礎的範本,則可以複製此範本作為範本型別。
您也可以使用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
node會儲存元件清單,以定義結果頁面中的可用專案。 - 如果在結構模式下將內容新增到元件,且隨後解鎖該元件(或反之),則此內容會用作初始內容。
版面配置 layout
時間 編輯範本您可以定義版面,此會使用 標準回應式佈局.
內容原則 content-policies
內容原則會定義元件的設計屬性。 例如,可用的元件或最小/最大尺寸。 這些適用於範本(以及使用範本建立的頁面)。 可在範本編輯器中建立和選取內容原則。
-
屬性
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
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
— 提供範本型別的參考。
-
上圖顯示範本、內容和元件如何相互關聯:
轉譯頁面時:
-
範本:
- 此
cq:template
屬性屬於jcr:content
節點是用來存取對應至該頁面的範本。
- 此
-
元件:
-
頁面元件會合併
structure/jcr:content
範本的樹狀結構jcr:content
頁面的樹狀結構。- 頁面元件將只允許作者編輯已標籤為可編輯的範本結構的節點(以及任何子系)。
- 在頁面上呈現元件時,元件相對路徑會取自
jcr:content
節點;下方的相同路徑policies/jcr:content
接著會搜尋範本的節點。- 此
cq:policy
此節點的屬性指向實際內容原則(也就是說,它儲存該元件的設計組態)。- 這可讓您擁有重複使用相同內容原則設定的多個範本。
- 此
-
範本可用性 template-availability
在網站管理員介面中建立頁面時,可用範本清單會根據新頁面的位置及每個範本中指定的版位限制而定。
下列屬性決定是否使用範本 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
屬性 -
僅於網站根目錄上
/content/wknd/jcr:content
allowedPaths
, allowedParents
、和 allowedChildren
亦可放置在範本上,以定義更複雜的規則。 不過,如果可能的話,這是 很多 更簡單以進一步定義 cq:allowedTemplates
需要進一步限制允許的範本時網站子區段上的屬性。cq:allowedTemplates
作者可以在以下位置更新屬性: 進階 的標籤 頁面屬性. 無法使用(標準) UI更新其他範本屬性,因此需要開發人員維護規則和每次變更的程式碼部署。限制子頁面中使用的範本 limiting-templates-used-in-child-pages
若要限制哪些範本可用來在指定頁面下建立子頁面,請使用 cq:allowedTemplates
屬性 jcr:content
頁面節點,用來指定允許做為子頁面的範本清單。 清單中的每個值都必須是允許的子頁面範本的絕對路徑,例如, /apps/wknd/templates/page-content
.
您可以使用 cq:allowedTemplates
範本的屬性 jcr:content
節點,將此設定套用至使用此範本的所有已建立頁面。
如果您想要新增更多限制,例如關於範本階層,您可以使用 allowedParents/allowedChildren
屬性。 然後,您可以明確指定從範本T建立的頁面必須是從範本T建立的頁面的父項/子項。