布局数据标记

 

如用于布局的窗口小部件标记一文所述，您可以使用许多不同的标记将特定的数据段包含在模板中。它们的格式都可以定为 <data:name/> 或 <data:name1.name2/>，其中 name 是您想使用的特定数据段的名称。在 name1.name2 一例中，name2 是一个名为 name1 的一组数据内的特定项目，如 photo.url。

这是此类可用数据的主列表。由于不同的窗口小部件使用不同的数据，因此该列表被页面元素分成不同的部分。

• 全局数据
• 页面标题
• 博客帖子
• 博客归档
• 个人资料
• 文本/HTML/JavaScript
• 供稿
• 图片
• 标签
• 列表
• 链接列表
• 徽标

全局数据

此信息适用于整个页面，因此可在任何位置使用，与其他只能在特定窗口小部件中使用的数据不同。这类数据应作为整个"博客"数据的一部分来引用，如 <data:blog.title/> 等。

• title：博客的标题。
• pageType：当前页面的类型。应为"项目"、"存档"或"索引"其中之一。
• 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：数字形式的帖子 ID。
  • title：帖子标题。
  • body：帖子内容。
  • author：帖子作者的显示名称。
  • url：此帖的ÓÀ3/4ÃÁ´1/2Ó¡£
  • timestamp：帖子的时间戳。与 dateHeader 不同，每个帖子都有此标记。
  • labels：帖子的标签列表。每个标签均可包含下列标记：
    • name：标签文字。
    • url：列出本博客中具有此标签的所有帖子的页面网址。
    • isLast：真或假。此标签是否为列表中的最后一个标签（添加逗号时非常有用）。
  • allowComments：如果此帖允许发表评论则为"真"。
  • 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：窗口小部件内容。

返回页首¡£

供稿窗口小部件

除本身所带的信息，供稿窗口小部件还包含名为 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：此项目的ÓÀ3/4ÃÁ´1/2Ó。
    • type：此项目的内容类型。

返回页首¡£

图片窗口小部件

图片窗口小部件包含一幅图片，并提供关于该图片的所有相关数据。

• title：窗口小部件标题。
• sourceUrl：图片网址。
• width：图片宽度，以像素为单位。
• height：图片高度，以像素为单位。
• caption：图片标题。

返回页首¡£

标签窗口小部件

标签窗口小部件包含博客中使用的所有标签列表。

• title：窗口小部件标题。
• labels：标签列表，每项可包含下列标记：
  • name：标签文字。
  • count：有此标签的帖子数。
  • url：显示有此标签的帖子的网页链接。

返回页首¡£

列表窗口小部件

列表的最简单形式。每项均为一段文字，其中的数据没有类型差别。

• title：窗口小部件标题。
• items：项目列表。

返回页首¡£

链接表窗口小部件

稍微复杂的列表，其中每项具有两个部分：文字和链接。

• title：窗口小部件标题。
• links：链接表，每项可包含：
  • name：链接的文字。
  • target：链接的网址。

返回页首¡£

徽标窗口小部件

没有比这更简单的了。此处只有一种数据。

• fullButton：您选择的 Blogger 按钮网址。

返回页首¡£

布局数据标记