版面配置資料標記

版面配置的小工具標記一文所述,你可以使用許多不同的標記將某些特定資料納入你的範本中。這些資料的格式會顯示為 <data:name/><data:name1.name2/>,其中 name 是你要使用的特定資料名稱。以 name1.name2 為例,name2name1 資料組中的某特定項目,例如 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 按鈕網址。

返回頁首

這對您有幫助嗎?
我們應如何改進呢?