網站範本
網站範本是用於儲存範本來源內容的 Power Pages 網站中繼資料記錄。 網站範本通常包含動態內容轉譯的 Liquid,並且是用來整合 Liquid 範本與 Power Pages 其餘部分的主要資料表。
網站範本可以包含在其他內容中,或是使用範本標籤與其他範本結合,並且在這些標籤中透過其名稱屬性參考。 這些標籤也可以用來建立整個自訂頁面版面配置,或建立 Power Pages 網站的自訂頁首和頁尾。
網站範本屬性
屬性 | 描述: |
---|---|
姓名 | 範本的名稱。 用來參考此範本,當它包含在其他內容中或透過其他範本擴充時。 |
來源 | 範本的來源內容。 在 Power Apps 中,會針對此欄位提供具有語法醒目提示功能和其他程式碼編輯功能的原始程式碼編輯器。 |
MIME 類型 | 選擇性地提供 MIME 類型做為範本內容。 如果未提供,則會假設為 text/html 類型。 只有在範本與頁面範本關聯,並控制該範本的所有內容轉譯時,才會使用此值。 |
做為頁面版面配置的網站範本
網站範本可與頁面範本搭配用來為 Power Pages 網站建立新的自訂頁面版面配置。
若要根據網站範本建立新的頁面範本,請在建立新的頁面範本記錄時選取網站範本的類型。 然後選取網站範本。
請注意,使用網站頁首和頁尾選項 (預設為勾選狀態)。 如果已選取此選項,則網站範本會控制全域網站頁首與頁尾之間所有頁面內容的轉譯。 如果未選取此選項,則網站範本會在您轉譯 HTML 的情況下負責轉譯整個回應,也就是,從 doctype 到根 <html> 標籤的所有內容,以及其間的所有內容。
雖然網站範本最常見的使用案例是轉譯 HTML,但是轉譯整個回應 (取消選取使用網站頁首和頁尾) 可讓您選擇轉譯所選的任何文字格式。 這就是網站範本的 MIME 類型屬性發揮作用之處。 呈現不使用網站頁首和頁尾的頁面範本時,HTTP 回應 Content-Type 標頭會設定為相關聯網站範本的 MIME 類型 (如果未提供 MIME 類型,則使用 text/html),提供各種使用 Liquid 呈現非 HTML 內容的選項。 常見的使用案例會是透過設定 MIME 類型的 application/rss+xml 來轉譯 RSS 摘要。
網站範本做為網站頁首和頁尾
網站範本也可以用來覆寫 Power Pages 使用的全域頁首和頁尾。 將網站的頁首範本或頁尾範本欄位設定為您選擇的網站範本。 如果您覆寫網站頁首,您選取的範本會負責轉譯網站的主要導覽、登入/登出連結、搜尋介面等,通常由預設頁首範本處理的網站介面元素。
內建網站範本
Power Pages 中提供一組預先製作的 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' %} |
Web 範本做為元件 (預覽版)
可以建立網站範本並將其用作網頁中的元件,以讓製作者使用這些可重複使用的元件,並提供符合需求的參數。
其他資訊:做為元件的網站範本