建立頁面時,您必須選取範本,以作為建立新頁面的基礎。 範本會定義產生的頁面、任何初始內容,以及可使用的元件。
使用范 本編輯器,建立和維護範本不再是開發人員專屬的工作。也可以涉及一種稱為模板作 者的權力用戶。開發人員仍需要設定環境、建立用戶端程式庫和建立要使用的元件,但是當這些基本功能準備就緒後,範本作者就可以彈性地建立和設定範本,而不需要開發專案。
範本控制台允許範本作者:
範本編輯器允許範本作者:
本檔案說明範本作者如何使用範本主控台和編輯器來建立及管理可編輯的範本。
有關可編輯模板在技術級別上如何工作的詳細資訊,請參閱開發人員文檔頁面模板 — 可編輯以了解詳細資訊。
AEM 6.4.5.0或更新版本必須搭配SPA Editor使用可編輯的範本。
范 本編輯器不支援直接在範本層級定位。可以定位根據可編輯的範本建立的頁面,但無法定位範本本身。
使用範本控制台建立的頁面和範本不適用於傳統UI,且不支援這類使用。
管理員必須在Configurations Browser中配置模板資料夾,並應用適當權限,模板作者才能在該資料夾中建立模板。
在開始前,請務必考慮下列要點:
建立新模板需要協作。 因此,會為每個任務指示角色。
根據您的執行個體的設定方式,請注意AEM現在提供兩種基本類型的範本可能會很有用。 這不會影響您實際使用範本建立頁面的方式,但會影響您可建立的範本類型,以及頁面與其範本的關聯方式。
使用「模板控制台」和「模 板編輯器 」建立新模板時 ,需要在以下角色之間協作:
管理員:
admin
權限。開發人員:
範本作者:
這是群組成員的特定作者template-authors
可以配置元件的使用情況和其他需要的高級詳細資訊:
一些技術知識
開發人員的技術資訊。
由於某些工作(例如建立資料夾)的性質,因此需要開發環境,而這需要知識/經驗。
本文檔中詳述的任務將列出負責執行這些任務的角色。
AEM現在提供兩種基本範本類型:
可編輯的範本
靜態範本
根據定義,範本控制台和範本編輯器只允許建立和編輯可編輯的範本。 因此,本檔案專注於可編輯的範本。
使用範本建立新頁面時,靜態和可編輯的範本之間沒有可見的差異,也沒有任何指示。 對於頁面作者而言,程式是透明的。
建立新的可編輯範本時,您可以:
使用Template控制台。 這可在工具控制台的一般區段中使用。
如有需要,可以為範本建立資料夾
視需要 為範本定義其他屬性
編輯范 本以定義:
啟用范 本以供建立頁面時使用
允許 網站所需頁面或分支的範本
發佈范 本,以便在發佈環境中使用
最初設定網站時,通常會預先定義允許的範本。
切勿在模板中輸入任何需要為國際化的資訊。
應為您的專案建立範本資料夾,以保留專案專用範本。 這是一項管理任務,在文檔頁面模板 — 可編輯中有介紹。
開啟範本主控台(透過工具 -> 一般),然後導覽至所需的資料夾。
在標準AEM例項中,範本主控台中已存在global資料夾。 如果在當前資料夾中找不到策略和/或模板類型,則此選項將保留預設模板,並充當後援。
建議使用為專案🔗建立的範本資料夾。
選擇Create,然後選擇Create Template以開啟嚮導。
選擇模板類型,然後選擇下一步。
範本類型是預先定義的範本配置,可視為範本的範本。 這些由開發人員或系統管理員預先定義。 如需詳細資訊,請參閱開發人員檔案頁面範本 — 可編輯。
完成模板詳細資訊:
選擇 建立。將顯示確認,選擇Open以開始編輯模板或Done以返回模板控制台。
建立新範本時,在主控台中標示為Draft,表示頁面作者尚無法使用。
範本可以有下列屬性:
影像
要用作模板縮圖的影像以輔助選擇,例如在「建立頁面」嚮導中。
標題
說明
要查看和/或編輯屬性:
主控台會指出範本的狀態(草稿、啟用或停用)。
若要定義範本縮圖:
編輯範本屬性。
選擇您要上傳縮圖,還是從範本內容產生縮圖。
對於這兩種方法,都會顯示縮圖的預覽。
如果不滿意,請按一下或點選清除以上傳其他影像或重新產生縮圖。
對縮圖感到滿意時,按一下或點選「儲存並關閉」。
若要在建立頁面時使用範本,您必須:
可以啟用或停用範本,使其在建立頁面精靈中可用或無法使用。
範本啟用後,當範本作者開始進一步更新範本時,將會顯示警告。 這會通知使用者可能已參考範本,因此任何變更都可能影響參考範本的頁面。
主控台會指出範本的狀態(草稿、啟用或停用)。
範本可供某些頁面分支使用或無法使用。
開啟要讓範本可用的分支根頁面的頁面屬性。
開啟Advanced標籤。
在「 範本設定 」下 ,使用「新增」欄位 ,指定範本的路徑。
路徑可以是明確的或使用模式。 例如:
/conf/<your-folder>/settings/wcm/templates/.*
路徑的順序不相關,會掃描所有路徑並擷取任何範本。
如果「允許的模板」清單為空,則樹將升級,直到找到值/清單。
請參閱範本可用性 — 允許的範本原則維持不變。
按一下儲存以儲存對頁面屬性的變更。
設定時,通常會為整個網站預先定義允許的範本。
轉譯頁面時參照範本時,必須發佈完全設定的範本,才能在發佈環境中使用。
在範本控制台中,選取範本。
從工具欄中選擇發佈以開啟嚮導。
選取要串聯發佈的內容原則。
從工具列選取Publish以完成動作。
建立或編輯範本時,您可以定義各種方面。 編輯範本類似於頁面編寫。
可編輯範本的下列方面:
此處新增的元件無法由頁面作者從產生的頁面中移動/移除。 如果希望頁面作者能夠將元件添加和刪除到生成的頁面,則需要向模板添加段落系統。
元件鎖定時,您可以新增內容,但頁面作者無法編輯內容。 您可以解除鎖定元件,以便定義初始內容。
在結構模式中,不能移動、剪切或刪除任何作為未鎖定元件父級的元件。
元件解除鎖定後,您可以定義將複製到從範本建立的結果頁面的初始內容。 可在產生的頁面上編輯這些未鎖定的元件。
在初始內容模式以及產生的頁面中,可以刪除任何具有可存取父項(即佈局容器內的元件)的未鎖定元件。
您可以在此處預先定義所需裝置格式的範本版面。 範本製作的 「版面」模式與頁面製作的「版面 🔗 」模式功能相同。
在頁面原則下,您可以將預先定義的頁面原則連結至頁面。 這些頁面原則定義各種設計設定。
樣式系統允許模板作者在元件的內容策略中定義樣式類,以便內容作者能夠在編輯頁面上的元件時選擇它們。 這些樣式可作為元件的替代視覺變化,使其更具彈性。
有關詳細資訊,請參閱樣式系統文檔。
工具列中的模式選取器可讓您選取和編輯範本的適當方面:
而頁面資訊功能表上的頁面原則選項可讓您選取所需的頁面原則:
如果作者開始編輯已啟用的範本,將會顯示警告。 這會通知使用者可能已參考範本,因此任何變更都可能影響參考範本的頁面。
在Structure模式中,可定義模板的元件和內容,並定義模板及其元件的策略。
在範本結構中定義的元件無法在產生的頁面上移動,也無法從任何產生的頁面中刪除。
如果您希望頁面作者能夠新增和移除元件,請在範本中新增段落系統。
元件可以再次解鎖和鎖定,以便定義初始內容。
已定義元件和頁面的設計原則。
在範本編輯器的Structure模式中:
新增元件
有數種機制可將元件新增至範本:
新增後,每個元件都會加上:
將現成可用的標題元件新增至範本時 ,其中會包含預設的文字 結構。
如果您變更此項目,並新增您自己的文字,則從範本建立頁面時,將會使用此更新的文字。
如果您保留預設文字(結構),則標題會預設為後續頁面的名稱。
將元件和資產新增至範本雖然不相同,但有許多與頁面編寫時的類似動作相似之處。
元件動作
將元件新增至範本後,對元件執行動作。 每個個別執行個體都有一個工具列,可讓您存取可用的動作,該工具列取決於元件類型。
它也取決於所採取的操作,例如當策略與元件關聯時,設計配置表徵圖將可用。
編輯和配置
透過這兩個動作,您可以將內容新增至元件。
用於指示結構的邊框
在Structure模式下工作時,橘色邊框表示當前選擇的元件。 虛線也代表上層元件。
例如,在螢幕擷圖中,選取Text元件,位於Layout Container(回應格線)內。
策略和屬性(一般)
內容(或設計)原則會定義元件的設計屬性。 例如,可用元件或最小/最大尺寸。 這些規則適用於範本(以及使用範本建立的頁面)。
為元件建立內容原則或選取現有原則。 這可讓您定義設計詳細資訊。
設定視窗分為兩個部分。
可用的屬性取決於所選元件。 例如,對於文本元件,屬性定義了複製和貼上選項、格式選項和段落樣式等選項。
政策
內容(或設計)原則會定義元件的設計屬性。 例如,可用元件或最小/最大尺寸。 這些規則適用於範本(以及使用範本建立的頁面)。
在Policy下,可以通過下拉清單選擇要應用到元件的現有策略。
通過選擇選擇策略下拉清單旁的添加按鈕,可以添加新策略。 然後,應在Policy Title欄位中指定新標題。
選擇策略下拉清單中選定的現有策略可以使用下拉清單旁邊的複製按鈕作為新策略複製。 然後,應在Policy Title欄位中指定新標題。 預設情況下,複製的策略的標題將為Copy of X,其中X是複製策略的標題。
策略說明在策略說明欄位中是可選的。
在還使用所選策略部分的其他模板中,您可以輕鬆查看哪些其他模板使用在選擇策略下拉清單中選擇的策略。
如果添加了多個相同類型的元件作為初始內容,則相同的策略適用於所有元件。 這反映了靜態模板的**設計模式**中的相同限制。
屬性
在屬性標題下,您可以定義元件的設定。 標題有兩個標籤:
主要
在Main標籤上,定義元件最重要的設定。
例如,對於影像元件,可定義允許的寬度並啟用延遲載入。
如果設定允許多個配置,請按一下或點選Add按鈕以添加其他配置。
若要移除設定,請按一下或點選設定右側的Delete按鈕。
若要移除設定,請按一下或點選 Delete按鈕。
功能
Features標籤可讓您啟用或停用元件的其他功能。
例如,對於影像元件,您可以定義裁切比例、允許的影像方向,以及是否允許上傳。
請注意,在AEM裁切比率中,定義為height/width。 這與傳統的寬度/高度定義不同,且是由於舊版相容性原因而完成。 如果您清楚定義名稱,因為這是UI中顯示的內容,頁面編寫使用者將不會察覺到任何差異。
實作RTF編輯器的元件 的內容原則只能針對RTE透過其UI設定提供的選項定義。
策略和屬性(佈局容器)
佈局容器的策略和屬性設定與一般用法類似,但有一些差異。
容器元件必須配置策略,因為它可讓您定義容器中可用的元件。
設定視窗分為兩個部分,如同一般使用視窗一樣。
政策
內容(或設計)原則會定義元件的設計屬性。 例如,可用元件或最小/最大尺寸。 這些規則適用於範本(以及使用範本建立的頁面)。
在Policy下,可以通過下拉清單選擇要應用到元件的現有策略。 此功能與一般使用視窗的功能相同。
屬性
在屬性標題下,您可以選擇哪些元件可用於配置容器並定義其設定。 標題有三個標籤:
允許的元件
在「允許的元件」標籤上,定義哪些元件可用於配置容器。
預設元件
在預設元件標籤中,您定義哪些元件會自動與指定的媒體類型相關聯,以便當作者從資產瀏覽器拖曳資產時,AEM能知道要與哪個元件建立關聯。 請注意,此類配置僅可使用帶拖放區的元件。
按一下或點選「新增對應 」,以新增全新元件和MIME類型對應。
在清單中選取元件,然後按一下或點選「 新增類型 」,將其他MIME類型新增至已映射的元件。按一下「 刪除 」圖示以移除MIME類型。
回應式設定
在回應式設定標籤上,您可以在版面容器的產生格線中設定欄數。
解除鎖定/鎖定元件
您可以解除鎖定/鎖定元件,以定義內容是否可在初始內容模式中進行變更。
元件解除鎖定時:
邊框中顯示開啟的掛鎖指示器。
元件工具列將隨之調整。
已輸入的任何內容將不再以Structure模式顯示。
無法移動、剪切或刪除未鎖定元件的父項。
這包括解除鎖定容器元件,以便在初始內容模式或產生的頁 面中新增其他元件 。如果您在解除鎖定容器之前已將元件/內容新增至容器,則這些元件/內容在「結構」模式中將不再顯示,但會以「初始內容 」模式顯示。在「 結構模式」中,只有容器元件本身會顯示其「允許的元 件」清單。
為了節省空間,版面容器不會成長以容納允許的元件清單。 容器反而會變成可捲動清單。
可配置的元件以「策略」表徵圖顯示 ,可以點選或按一下該表徵圖以編輯該元件的策略和屬性。
與現有頁面的關係
如果在根據範本建立頁面後更新結構,則這些頁面將反映對範本的變更。 工具列中會顯示警告,提醒您此事實以及確認對話方塊。
初始 內容模式用於定義內容,當首次根據範本建立頁面時,這些內容將會顯示。然後頁面作者就可以編輯初始內容。
雖然在「結構 」模式下建立的所有內容在「初始內容」中都可 見 ,但只能選擇和編輯已解鎖的元件。
使用 該範本建立的頁面可以考慮編輯模式的初始「內容模式」。因此,策略未在初始內容模式中定義,而是在**結構**模式中定義。
標籤可用於編輯的未鎖定元件。 選取後,其邊框會呈藍色:
解除鎖定的元件有一個工具欄,允許您編輯和配置內容:
如果容器元件已解除鎖定(在「結 構 」模式中),則您可以在「初始內容 」模式中新增元件至容器。在「初始內 容」模式中新增的元件 ,可在產生的頁面上移動或從中刪除。
您可以使用「拖曳元件到此處 」區域,或從適當容器的工具列 中使用「插入新元件 」選項來新增元件。
如果在根據範本建立頁面後更新範本的初始內容,則這些頁面不會受到範本中初始內容變更的影響。
初始內容的用途是準備元件和頁面版面,以作為建立內容的起點。 其目的並非實際內容可維持原樣。 因此,無法翻譯初始內容。
您可以定義裝置範圍的範本配置。 範本 的回應式版面配置在頁面製作上的運作方式與相同。
版面的變更會反映在初始內容模式中,但在結構模式中未出現任何變更。
頁面設計 (包括所需的用戶端程式庫和頁面原則) 會保留在「頁面資訊」功能表的「 頁面設計 」選 項下。
若要存取頁面設計對話方塊:
您可以將內容原則套用至範本或產生的頁面。 這會定義頁面上主要段落系統的內容原則。
您可以從Select policy下拉式清單中為頁面選擇現有策略。
通過選擇選擇策略下拉清單旁的添加按鈕,可以添加新策略。 然後,應在Policy Title欄位中指定新標題。
選擇策略下拉清單中選定的現有策略可以使用下拉清單旁邊的複製按鈕作為新策略複製。 然後,應在Policy Title欄位中指定新標題。 預設情況下,複製的策略的標題將為Copy of X,其中X是複製策略的標題。
在Policy Title欄位中定義策略的標題。 需要策略才能有標題,以便在選擇策略下拉清單中輕鬆選擇該標題。
策略說明在策略說明欄位中是可選的。
在還使用所選策略部分的其他模板中,您可以輕鬆查看哪些其他模板使用在選擇策略下拉清單中選擇的策略。
使用頁面屬性,您可以使用頁面設計對話方塊來定義所需的用戶端程式庫。 這些客戶端庫包括要載入模板的樣式表和javascript以及使用該模板建立的頁。
指定您要套用至使用此範本建立之頁面的用戶端程式庫。 在用戶端程式庫區段的文字欄位中輸入程式庫名稱。
如果需要多個程式庫,請按一下「新增」按鈕,為程式庫名稱新增其他文字欄位。
視需要為用戶端程式庫新增任意數量的文字欄位。
使用拖曳控點拖曳欄位,視需要定義程式庫的相對位置。
雖然範本作者可以在範本上指定頁面原則,但他/她需要從開發人員取得適當用戶端程式庫的詳細資訊。
使用初始頁面屬性選項,可以定義建立結果頁面時要使用的初始頁面屬性。
從模板編輯器中,從工具欄中選擇頁資訊,然後選擇初始頁屬性以開啟對話框。
在對話方塊中,您可以定義要套用至使用此範本建立之頁面的屬性。
使用Done確認定義。
建立範本時,您應考慮:
從該範本建立頁面後,對範本所做的變更所產生的影響。
以下是範本上可能的不同操作清單,以及這些操作如何影響從這些操作建立的頁面:
結構變更:
內容原則和設計設定的變更:
初始內容的變更:
版面的變更取決於修改的元件是否屬於:
請格外小心:
在啟用的模板上鎖定或解鎖元件。
這可能會產生副作用,因為現有頁面可能已在使用它。 通常:
AEM在不再是草稿的範本上變更元件的鎖定狀態時,會顯示明確警告。
為網站特 定範本建立專屬資料夾。
從範本 控制台發佈 範本。