正如布局专用的微件标记一文中所述,您可以使用许多不同的标记在模板中加入特定的数据。这些数据应采用 <data:name/>
或 <data:name1.name2/>
格式,其中 name
是您要使用的特定数据的名称。以 name1.name2
为例,name2
是名为 name1
的一组数据中的某一项,例如 photo.url
。
本列表集中列出了所有可用数据。由于不同类型的微件所使用的数据不同,因此我们根据页面元素将列表划分为以下不同部分。
通用的数据
与只能在特定微件中使用的其他数据不同,此类信息适用于整个页面,因此您可以在任何地方使用。引用这类数据时,应将其作为总体“博客”数据来引用,例如 <data:blog.title/>
等。
- title:博客的标题。
- pageType:当前页面的类型。可以选择“内容”、“归档”或“索引”。
- url:当前页面的网址。
- homepageUrl:博客的首页。
- pageTitle:当前页面的标题。通常就是博客标题,但用在存档页面或博文页面上时可能包含额外信息。
- encoding:博客所使用的编码,例如 UTF-8。
- languageDirection:“ltr”或“rtl”,分别用于阅读方向为从左到右和从右到左的语言。
- feedLinks:页面标头的自动查找 Feed 链接。
返回页首。
页面标头
此微件非常简单,仅包含两段数据。只要使用 <data:title/>
和 <data:description/>
就能引用这两段数据。
- title:博客的标题。
- description:博客的说明。
返回页首。
博文
博文是所有博客的核心,同时也是最复杂的部分。强烈建议您先看看能否通过修改默认模板达到想要的效果,如果不能,再考虑从头编写博文微件。以下是博文微件中包含的所有数据,不论您想采取哪种方式,都可以参考这些数据。
- feedLinks:页面的 Feed 列表。在主页面上,此列表包含主博客 Feed;而在内容页面上,则还会包含评论 Feed。此列表中的每项内容均包含以下信息:
- url:Feed 网址。
- name:Feed 名称(例如“博文”或“评论”)。
- feedType:Feed 类型(Atom 或 RSS)。
- mimeType:Feed 的 MIME 类型。
- olderPageUrl:如果有博文的发布时间比当前页面上的博文早,则此数据为一个网址,用来查看这些早期博文。内容会因页面类型而有所不同(并非所有页面都有此链接)。
- olderPageTitle:早期博文页面的链接标题。
- newerPageUrl:如果有博文的发布时间比当前页面上的博文晚,则此数据为一个网址,用来查看这些更晚发布的博文,作用与 olderPageUrl 相反。
- newerPageTitle:发布时间更晚的博文页面的链接标题。
- 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:该篇博文专有的 Feed 列表(与总体博客的 feedLinks 不同,它可能包含该篇博文评论的 Feed)。每项内容均包含以下信息:
- url:Feed 网址。
- name:Feed 名称(例如“博文”或“评论”)。
- feedType:Feed 类型(Atom 或 RSS)。
- mimeType:Feed 的 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:微件的内容。
返回页首。
Feed 微件
博客在浏览器中渲染后,系统会使用 Google AJAX API 动态加载 Feed 微件的内容。您只能使用 CSS 设置内容的样式。
- title:微件的名称。
- feedUrl:Feed 的网址。
返回页首。
图片微件
一个图片微件中只有一张图片,并提供有关该图片的所有数据。
- title:微件的名称。
- sourceUrl:图片的网址。
- width:图片的宽度(以像素为单位)。
- height:图片的高度(以像素为单位)。
- caption:图片说明。
返回页首。
标签微件
标签微件包含博客中使用的所有标签的列表。
- title:微件的名称。
- labels:标签列表。每个标签均包含以下信息:
- name:标签的文本。
- count:带有此标签的博文数量。
- url:列出带有此标签的博文的页面链接。
返回页首。
列表微件
最简单的列表形式。每项内容都只是一段文字,不含任何其他类型的数据。
- title:微件的名称。
- items:内容列表。
返回页首。
链接列表微件
一个略微复杂的列表,其中每项内容均包含两个部分:文本和链接。
- title:微件的名称。
- links:链接列表,每个链接均包含以下信息:
- name:链接的文本。
- target:链接的网址。
返回页首。
徽标微件
没有比这更简单的了。这个微件只包含一段数据。
- fullButton:所选 Blogger 按钮的网址。
返回页首。