使用網站範本儲存來源內容

網站範本是 Dynamics 365 實體 (adx_webtemplate),隨 Dynamics 365 入口網站提供,用來儲存範本來源內容。 網站範本通常會包含動態內容翻譯的 Liquid,而且是用來整合 Liquid 範本與 Dynamics 365 入口網站系統其餘部分的主要實體。

網站範本可以包含在其他內容中,或是使用範本標籤與其他範本結合,並且在這些標籤中透過其 [名稱] 屬性參考。 他們也可以用來建立整個自訂頁面範本,或是建立入口網站的自訂頁首和頁尾。

網站範本屬性

名稱 範本的名稱。 用來參考此範本,當它包含在其他內容中或透過其他範本擴充時。
來源 範本的來源內容。 在 Dynamics 365 中,會針對此欄位提供具有語法醒目提示功能和其他程式碼編輯功能的原始程式碼編輯器。
MIME 類型 選擇性地提供 MIME 類型做為範本內容。 如果未提供,則會假設為 text/html 類型。 只有在範本與頁面範本關聯,並控制該範本的所有內容轉譯時,才會使用此值。

網站範本做為頁面範本

網站範本可以搭配頁面範本用來建立 Dynamics 365 入口網站內容管理系統的新範本。 這可以完全在 Dynamics 365 內完成,不需要撰寫 .NET 程式碼或重新部署入口網站應用程式。

若要根據網站範本建立新的頁面範本,在建立新的頁面範本記錄時選取網站範本的 [類型]。 然後選取 [網站範本]。

請注意,[使用網站頁首和頁尾] 選項 (預設為勾選狀態)。 如果此選項已勾選,您的網站範本將控制全域網站頁首和頁尾之間所有頁面內容的轉譯。 如果未勾選此選項,則網站範本會負責轉譯整個回應 (在您轉譯 HTML 的情況下),這表示,從 doctype 到根 <html> 標籤的一切內容,也包括兩者之間的一切內容。

雖然網站範本最常見的使用案例是轉譯 HTML,但是轉譯整個回應 (取消選取 [使用網站頁首和頁尾]) 可讓您選擇轉譯所選的任何文字格式。 這就是與網站範本的 [MIME 類型] 屬性相關之處。 若轉譯的頁面範本不使用網站頁首和頁尾,HTTP 回應內容類型標頭將會設定為相關網站範本的 MIME 類型。 (text/html 將會使用,如果未提供 MIME 類型) 這可提供各式各樣的選項給您,使用 Liquid 轉譯非 HTML 內容。 常見的使用案例會是透過設定 MIME 類型的 application/rss+xml 來轉譯 RSS 摘要。

網站範本做為網站頁首和頁尾

網站範本也可以用來覆寫 Dynamics 365 入口網站使用的全域頁首和頁尾。 若要這樣做,將網站的 [頁首範本] 或 [頁尾範本] 欄位設定為您選擇的網站範本。 請注意,如果您覆寫 [網站頁首],您選取的範本會負責轉譯網站的主要導覽、登入/登出連結、搜尋介面等,通常由預設頁首範本處理的網站介面元素。

內建網站範本

Dynamics 365 入口網站中提供了一組預先製作的 Liquid 範本。 若要使用它們,您必須依名稱新增它們,使用下列清單做為參考。

名稱 描述 代碼
廣告 此範本會依名稱呈現廣告,或是從廣告位置呈現隨機廣告。 {% include 'ad' ad_name:'Name' %}{% include 'ad' ad_placement_name:'Placement Name' %}
部落格 此範本會在清單群組中呈現最近的部落格文章。 {% include 'blogs' %}
導覽路徑標示 此範本會轉譯目前頁面的上階頁面連結,重新呈現為首頁。 {% include 'breadcrumbs' %}
子連結清單群組 此範本會將連結轉譯成清單群組中目前頁面的任何子頁面。 {% include 'child_link_list_group' %}{% include 'child_link_list_group' title_only:true %}{% include 'child_link_list_group' image_width:'64px', image_height:'64px' %}
事件:近期 此範本會將連結轉譯成現在到未來 60 天內發生的事件。 {% include 'events_upcoming' %}{% include 'events_upcoming' number_of_days_in_advance:60 %}
論壇 此範本會轉譯網站論壇的清單,包含各自的討論串和文章數。 {% include 'forums' %}
配置 1 欄 此範本會轉譯單欄配置,包含導覽路徑標示、頁面標題及頁面複製內容。 {% extends 'layout_1_column' %}{% block main %}... {% endblock %}
配置 2 欄左寬 此範本會轉譯兩欄配置。 左欄會比右欄寬。 它包含導覽路徑標示、頁面頂端的頁面標題,以及頁面複製內容,位於左欄中。 {% extends 'layout_2_column_wide_left' %}{% block main %}...{% endblock %}{% block aside %}...{% endblock %}
配置 2 欄右寬 此範本會轉譯兩欄配置。 右欄會比左欄寬。 它包含導覽路徑標示、頁面頂端的頁面標題,以及頁面複製內容,位於右欄中。 {% extends 'layout_2_column_wide_right' %}{% block main %}...{% endblock %}{% block aside %}...{% endblock %}
配置 3 欄中間寬 此範本會轉譯三欄配置。 中間欄會比左和右欄寬。 配置包含導覽路徑標示、頁面頂端的頁面標題及頁面複製內容,位於中間欄。 {% extends 'layout_3_column_wide_middle' %}{% block left_aside %}...{% endblock %}{% block main %}...{% endblock %}{% block right_aside %}...{% endblock %}
頁面複製 此範本會轉譯可編輯的頁面複製內容 HTML,並支援內嵌 Liquid。 {% include 'page_copy' %}
頁面標題 此範本轉譯頁面標題。 {% include 'page_header' %}
輪詢 此範本會依名稱轉譯意見調查,或是從意見調查位置呈現隨機意見調查。 {% include 'poll' poll_name:'Name' %}{% include 'poll' poll_placement_name:'Placement Name' %}
搜尋 此範本會轉譯基本搜尋表單,包含單一文字輸入和搜尋按鈕。 {% include 'search' %}
側邊導覽 此範本轉譯垂直樹狀檢視樣式導覽。 它包含上階頁面的連結,可返回第一層 (或指定的深度位移)、目前頁面的同層級頁面連結,以及目前頁面的子頁面連結。 {% include 'side_navigation' %}{% include 'side_navigation' depth_offset:1 %}
程式碼片段 此範本會依名稱轉譯可編輯的 HTML 內容程式碼片段。 {% include 'snippet' snippet_name:'Name' %}
上方導覽 此範本會轉譯可編輯的導覽列,包含下拉式功能表用於主要導覽 Web 連結設定。 {% include 'top_navigation' %}
網頁連結清單群組 此範本呈現網頁連結組的連結清單群組。 {% include 'weblink_list_group' weblink_set_name:'Name' %}

請參閱

新增動態內容並建立自訂範本
了解 Liquid 運算子
Liquid 類型
條件
Liquid 物件
Liquid 標籤
Liquid 篩選
建立進階入口網站範本