如版面配置的小工具標記一文所述,你可以使用許多不同的標記將某些特定資料納入你的範本中。這些資料的格式會顯示為 <data:name/>
或 <data:name1.name2/>
,其中 name
是你要使用的特定資料名稱。以 name1.name2
為例,name2
是 name1
資料組中的某特定項目,例如 photo.url
。
這份清單包含所有主要的可用資料。由於不同類型的小工具使用的資料並不相同,以下就各項網頁元素分項說明。
整個網誌都適用的資料
這些通用資訊會套用到整個網頁,可用在任何位置,不像其他資料只能用於特定小工具。這些資料的標記看起來像這樣:<data:blog.title/>
,是屬於整個網誌的資料 (可從標記中的 "blog" 這個英文字得知)。
- title:網誌的標題。
- pageType:目前網頁的類型;可以是「item」、「archive」或「index」。
- url:目前網頁的網址。
- homepageUrl:網誌的首頁。
- pageTitle:目前網頁的標題。這通常就是網誌的標題,但這裡可以包含有關封存或文章網頁的其他資訊。
- encoding:網誌使用的編碼,例如 UTF-8。
- languageDirection:分別以「ltr」或「rtl」表示「由左至右」或「由右至左」的語言。
- feedLinks:網頁標題的自動探索動態消息連結。
返回頁首。
網頁標題
這是一個簡單的小工具,只包含兩項資料;這兩項資料的標記就是 <data:title/>
和 <data:description/>
。
- title:網誌的標題。
- description:網誌的說明。
返回頁首。
網誌文章
這是所有網誌的核心部分,也是最複雜的部分。如果你有想要從頭開始撰寫網誌文章小工具的念頭,建議你還是修改其中一個預設範本就好。不過,如果你覺得這麼做有其必要,以下是這個小工具可用的所有資料,提供給你參考。
- feedLinks:該網頁的動態消息清單。在主網頁上,這個標記包含了主要網誌動態消息;在項目 (item) 網頁上,這個標記還包含了留言動態消息。這份清單中的每個項目都包含以下標記:
- url:動態消息網址。
- name:動態消息名稱 (例如「文章」或「留言」)。
- feedType:動態消息類型 (Atom 或 RSS)。
- mimeType:動態消息的 MIME 類型。
- olderPageUrl:如果有比目前網頁上的文章還要舊的文章,這個標記代表那些較舊文章的網址。內容會依網頁類型而有所不同 (並非所有網頁都有這個連結)。
- olderPageTitle:較舊文章網頁的連結標題。
- newerPageUrl:較新文章的網址,類似於 olderPageUrl。
- newerPageTitle:較新文章網頁的連結標題,類似於 olderPageTitle。
- commentLabel:用來標示留言數目的用語,例如「留言數」。
- authorLabel:用來標示文章作者的用語,例如「張貼者」。
- timestampLabel:用來標示文章撰寫時間的用語,例如「張貼時間」。
- postLabelsLabel:用來標示文章標籤清單的用語,例如「這篇文章的標籤」。
- backlinksLabel:用來標示文章反向連結的用語,例如「這篇文章的連結」。
- posts:該網頁所有文章的清單;每篇文章都包含以下標記:
- dateHeader:該文章的日期 (清單中只有當日發布的第一篇文章才會有這個標記)。
- id:文章的數字 ID。
- title:文章的標題。
- body:文章的內容。
- author:文章作者的顯示名稱。
- url:該文章的永久連結。
- timestamp:文章的時間戳記。與 dateHeader 不同的是,每篇文章都會有這個標記。
- labels:文章的標籤清單;每個標籤都包含以下標記:
- name:標籤的名稱。
- url:網頁的網址,此網頁會列出網誌中使用該標籤的所有文章。
- isLast:True 或 False;用於表示該標籤是否為清單中的最後一個標籤 (以逗號分隔標籤時需要這項資訊)。
- allowComments:如果該文章允許讀者留言,則為「True」。
- numComments:該文章的留言數。
- showBacklinks:用於表示是否要顯示該文章的反向連結。
- numBacklinks:該文章的反向連結數目。
- addcommentUrl:該文章的「新增留言」表單網址。
- emailPostUrl:該文章的「轉寄這篇文章」表單網址。
- editUrl:該文章的編輯表單網址。
- feedLinks:該文章專屬的動態消息清單 (與整個網誌的 feedLinks 不同的是,這個標記可能會包含文章留言的動態消息)。每則動態消息都包含以下標記:
- url:動態消息網址。
- name:動態消息名稱 (例如「文章」或「留言」)。
- feedType:動態消息類型 (Atom 或 RSS)。
- mimeType:動態消息的 MIME 類型。
- comments:該文章所有留言的清單 (僅限項目網頁);每則留言都包含以下標記:
- id:留言的數字 ID。
- body:留言的內文。
- timestamp:建立留言的時間。
- author:留言者的顯示名稱,或是顯示為「匿名」。
- authorUrl:留言者的個人資料網址 (如果不是匿名留言)。
- deleteUrl:用於刪除該留言的網址。
- isDeleted:用於表示是否已刪除該留言 (已刪除的留言文字會顯示為一個預留位置)。
返回頁首。
網誌封存
這裡提供的各種樣式適用於 [網頁元素] 分頁中的不同預設選項。如要設計新版本,最簡單的作法就是使用「FLAT」樣式,然後視需要調整其餘資料。
- title:小工具的標題。
- style:可以是「MENU」、「FLAT」或「HIERARCHY」。
- data:封存單元的清單;每個封存單元都包含以下標記:
- name:該封存時段的名稱,例如「2006 年 8 月」。
- url:網頁的連結,此網頁會列出該時段的各篇文章。
- post-count:在該時段內有多少篇文章。
返回頁首。
個人資料小工具
網誌如果只有一位作者,個人資料小工具將包含以下資訊。請注意,你必須使用記號來存取 photo
資料的其他部分,例如 <data:photo.url/>
。
- title:小工具的標題。
- userUrl:作者的個人資料網址。
- location:作者個人資料中的位置資訊。
- aboutme:個人資料中的「關於我自己」資訊。
- displayname:作者的顯示名稱。
- photo:使用者的個人資料相片,包含以下標記:
- url:相片的網址。
- width:相片的寬度,以像素為單位。
- height:相片的高度,以像素為單位。
- alt:相片的替代文字。
如果是團隊協作的網誌,則個人資料小工具可包含多位作者,但每一位作者的相關資訊會較少,如下所示。
- title:小工具的標題。
- authors:全部作者清單;每位作者都包含以下標記:
- displayname:作者的顯示名稱。
- userURL:作者的個人資料網址。
如要讓設計的範本同時適用於一位作者和多位作者的網誌類型,你可以使用 data:team
變數來區分這兩種類型的網誌;例如,<b:if cond='data:team=="true"'> (顯示多位作者) </b:if>
返回頁首。
文字/HTML/JavaScript 小工具
文字小工具和 HTML/JavaScript 小工具的作用方式相同,也都包含相同的兩項資料。
- title:小工具的標題。
- content:小工具的內容。
返回頁首。
動態消息小工具
瀏覽器在顯示網誌後,會隨即透過 Google AJAX API 動態載入動態消息小工具的內容;且只能使用 CSS 設定樣式。
- title:小工具的標題。
- feedUrl:動態消息的網址。
返回頁首。
圖片小工具
圖片小工具只會包含一張圖片,並提供該圖片的所有相關資料。
- title:小工具的標題。
- sourceUrl:圖片的網址。
- width:圖片的寬度,以像素為單位。
- height:圖片的高度,以像素為單位。
- caption:圖片說明文字。
返回頁首。
標籤小工具
標籤小工具包含了網誌中使用的所有標籤。
- title:小工具的標題。
- labels:標籤清單;每個標籤都包含以下標記:
- name:標籤的名稱。
- count:使用該標籤的文章數。
- url:網頁的網址,此網頁會列出使用該標籤的各篇文章。
返回頁首。
清單小工具
這是最簡單的清單形式,每個項目都只是一段文字,不含任何其他類型的資料。
- title:小工具的標題。
- items:項目清單。
返回頁首。
連結清單小工具
這是稍微複雜一點的清單形式,清單中的每個項目都包含兩個部分:文字和連結。
- title:小工具的標題。
- links:連結清單;每個連結都包含以下標記:
- name:連結的文字。
- target:連結的網址。
返回頁首。
標誌小工具
這個小工具是最簡單的了,就只包含一項資料。
- fullButton:你所選取的 Blogger 按鈕網址。
返回頁首。