版面配置的資料標記

您可以使用許多不同的標記將其他資訊納入您的範本中。資料標記的格式如下:

  • <data: name />
  • <data: name1.name2 />

其中的「Name」是您要使用的資料名稱。

name1.name2 為例,name2name1 資料組中的項目,例如 photo.url

這份清單列出了所有可用的資料,並依網頁元素分類說明。

全區通用的資料

這類資訊可用在任何位置,不像其他資料只能用於特定小工具。這類資料的參照格式必須是「網誌」通用資料的其中一種,例如 <data:blog.title />

  • title:網誌的標題。
  • pageType:目前網頁的類型。可用的選項為「item」、「file」或「index」。
  • url:目前網頁的網址。
  • homepageUrl
  • pageTitle:目前網頁的標題。通常是網誌標題,但可能包含檔案和會話串網頁上的其他資訊。
  • encoding:網誌上使用的編碼,例如 UTF-8。
  • feedLinks:網頁標題的自動探索資訊提供連結。
網頁標題

這個小工具包含兩項資料。參照格式為 <data: title /><data: description />

  • title:網誌標題。
  • description:網誌說明。
網誌文章

如要變更標準模型,您可以使用這個小工具內含的資料。

  • feedLinks:網頁的資訊提供清單。在主要網頁上,這個標記包含主要網誌的資訊提供。如果是在項目網頁上,這個標記還包含留言的資訊提供。這份清單中的每個項目都包含以下標記:
    • url
    • name:資訊提供名稱,例如「文章」或「留言」。
    • FeedType:Atom 或 RSS。
    • mimeType:資訊提供的 MIME 類型。
  • olderPageUrl:如有較舊文章,這個標記代表那些文章的網址。內容會依網頁類型而有所不同 (並非所有網頁都有這個連結)。
  • olderPageTitle:較舊文章網頁的連結標題。
  • newerPageUrl:olderPageUrl 較新的對應標記。
  • newerPageTitle:olderPageTitle 較新的對應標記。
  • commentLabel:用來顯示留言數目的詞組。
  • authorLabel:用來顯示文章作者的詞組 (例如「張貼者」)。
  • timestampLabel:用來顯示文章撰寫時間的詞組 (例如「張貼時間」)。
  • postLabelsLabel:用來顯示文章標籤清單的詞組 (例如「此文章的標籤」)。
  • backlinksLabel:用來說明文章反向連結的詞組 (例如「此文章的連結」)。
  • posts:這個網頁的文章清單。每篇文章都包含以下標記:
    • dateHeader:文章日期 (清單中只有當日發佈的第一篇文章才會顯示)。
    • id:就是 postID。
    • title
    • body
    • author
    • url
    • timestamp:發佈文章的時間和日期。與日期標題不同的是,所有文章都會有這個標記。
    • labels:標籤清單。每個標籤都包含以下標記:
      • name:標籤名稱
      • url:列出網誌中使用該標籤的所有文章的網頁網址。
      • isLast:True 或 False。說明該標籤是否為清單中的最後一個標籤。
    • allowComments:如果該文章允許讀者留言,則為「True」。
    • numComments:該文章的留言數。
    • showBacklinks:是否顯示該文章的反向連結。
    • numBacklinks:該文章的反向連結數目。
    • addCommentUrl:該文章的「新增留言」網址。
    • emailPostUrl:該文章的「透過電子郵件寄送這篇文章」網址。
    • editUrl:文章編輯格式的網址。
    • feedLinks:該文章專屬的資訊提供清單 (與整體網誌 feedLinks 不同的是,這個標記可能包含文章留言的資訊提供)。每項資訊提供都包含以下標記:
      • url:資訊提供網址。
      • name:資訊提供名稱 (例如「文章」或「留言」)。
      • feedType:資訊提供的類型 (Atom or RSS)。
      • mimeType:資訊提供的 MIME 類型。
    • comments:文章的所有留言清單 (僅限項目網頁)。每則留言都包含以下標記:
      • id:留言的數字 ID。
      • body:評論內文。
      • timestamp:建立留言的時間。
      • author:如果沒有顯示名稱,留言者將顯示「匿名」。
      • authorUrl:如果不是匿名留言,這個標記就是留言作者簡介的網址。
      • deleteUrl:刪除留言的網址。
      • isDeleted:說明留言是否遭到刪除。
網誌封存

這裡提供「網頁元素」類別中的其他預設選項。如要設計新版本的網誌,最簡單的方式就是使用「FLAT」樣式,然後視需要變更其餘資料。

  • title
  • style:可用選項包括「MENU」、「FLAT」或「HIERARCHY」。
  • date:列出各種封存單位。每個封存都含有以下標記:
    • name:封存時段的名稱 (例如「2015 年 10 月」)。
    • url:含有該時段所有文章的網頁連結。
    • post-count:文章數。
簡介小工具

網誌如果只有一名作者,簡介小工具將包含以下資訊。如要查看其他部分的相片資料,您可以使用 <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
資訊提供小工具

資訊提供小工具內含 feedData 清單,其中含有資訊提供中的所有項目。

每個項目都包含與本身相關的資訊。參照這項資料時,您需要重複清單中的每個項目,例如 <b: loop var = "i" values ​​= "feedData.items">。接著,使用 <data: i.title /><data: i.alternate.href /> 等記號來取得每個項目的資訊。

  • title:小工具的標題。
  • feedURL:資訊提供網址。
  • feedData:資訊提供中的項目,其中每個項目包含以下標記:
    • title
    • str_published:項目的發佈時間 (以網誌所在時區的格式顯示)。
    • published:項目的發佈時間 (以秒為單位顯示發佈以來的時間)。
    • str_updated:項目的上次更新時間 (以網址所在時區的格式顯示)。
    • updated:項目的上次更新時間 (以秒為單位顯示更新以來的時間)。
    • author
    • summary:如提供,則為項目摘要
    • alternate:取得項目詳細資訊的地點,包含以下標記:
      • href:項目的永久連結。
      • type:項目的內容類型。
圖片小工具

圖片小工具包含單一圖片,並提供該圖片的所有相關資料。

  • title
  • sourceUrl:圖片網址
  • width 和 height:以像素為單位
  • caption
標籤小工具

標籤小工具包含在網誌中使用的標籤清單。

  • title
  • labels:標籤清單,包含以下標記:
    • name:標籤名稱
    • count:使用該標籤的文章數
    • url:顯示具有該標籤的文章的網頁網址
清單小工具

每個項目都是單一文字片段,不含其他資料類型。

  • title
  • items:項目清單
連結清單小工具

每個項目包含兩個部分:文字和連結。

  • title
  • links:連結清單。每個連結包含以下標記:
    • name:連結文字
    • target:連結網址
標誌小工具
  • fullButton:所選的 Blogger 按鈕連結。

進一步瞭解如何使用小工具標記

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