Язык шаблонов Blogspot ~ Все и ничего

Скопировал себе в качестве заметки, т.к. рано или поздно приходится
прибегать к правке шаблона.
(Перевод статьи Layouts Data Tags)

Подстановка в шаблон актуальных данных осуществляется конструкцией <data:имя/>, где имя — название конкретной переменной, содержащей данные. Конкретный набор доступных переменных зависит от типа текущего виджета.

Глобально доступные данные

Этот набор переменных применим к старнице в целом и доступен из любого виджета, а также вне виджетов.

blog.title: Заголовок блога.
blog.pageType: Тип текущей страницы: 'item', 'archive' или 'index'.
blog.url: URL текущей страницы.
blog.homepageUrl: Адрес главной страницы блога.
blog.pageTitle: Заголовок текущей страницы, сформированный из заголовка блога и дополнительной информации, такой как название текущего сообщения и т.п..
blog.encoding: Используемая кодировка.
blog.languageDirection: Направление письма для языка блога: "ltr" или "rtl" (слева направо и справа налево).
blog.feedLinks: Ссылки на фиды.

Page Header

Простой виджет, чья задача вывести две переменные: загголовок и описание блога.

title: Заголовок блога.
description: Описание блога.

Blog Posts

Центральная и самая сложная часть любого блога, виджет, отвечающий за выдачу постов.

feedLinks: Список фидов текущей страницы. На главной странице содержит главные фиды блога, на страницах постов — фиды комментариев. Каждый элемент списка состоит из:
- url: URL фида.
- name: Имя фида.
- feedType: Тип фида (Atom или RSS).
- mimeType: MIME тип.
olderPageUrl: Если имеются сообщения, более старые, чем сообщения на текущей странице, это поле содержит ссылку на предыдущие сообщения. Контекстно зависит от типа страницы. (Не на всех страницах есть ссылка.)
olderPageTitle: Заголовок ссылки на предыдущие сообщения.
newerPageUrl: Аналогично olderPageUrl, но для более новых сообщений.
newerPageTitle: Аналогично olderPageTitle, но для более новых сообщений.
commentLabel: Текст, используемый для отображения количества комментариев, например "comments".
authorLabel: Текст, используемый для отображения автора сообщения, например "posted by."
timestampLabel: Текст, используемый для отображения даты сообщения, например, "posted at."
postLabelsLabel: Текст, отображаемый перед списком ярлыков сообщения, например, "labels for this post."
backlinksLabel: Текст, используемый для отображения числа ссылок на сообщение, например, "links to this post."
posts: Список сообщений для текущей страницы. Каждый элемент списка содержит следующее:
- dateHeader: Дата сообщения. Присутствует только если это первое сообщение в списке, опубликованное в указанный день, т.е. для для всех сообщений, относящихся к одной дате, дата указывается только перед самым верхним.
- id: Числовой идентификатор сообщения.
- title: Заголовок сообщения.
- body: Содержимое сообщения.
- author: Отображаемое имя автора.
- url: Ссылка на страницу сообщения.
- timestamp: Timestamp. В отличие от dateHeader, присутствует в каждом сообщении.
- labels: Список ярлыков сообщения. Каждый элемент списка содержит следующее:
  - name: Текст ярлыка.
  - url: URL страницы, перечисляющей все сообщения с данным ярлыком.
  - isLast: True или false. Указывает, является ли ярлык последним в списке. Используется для правильной расстановки знаков препинания и/или разметки.
- allowComments: 'True' если разрешено оставлять комментарии к сообщению.
- numComments: Число оставленных комментариев.
- showBacklinks: Отображать ли обратные ссылки на данное сообщение.
- numBacklinks: Число ссылок.
- addCommentUrl: URL формы добавления комментария.
- emailPostUrl: URL формы 'email this post'.
- editUrl: URL формы редактирования сообщения.
- feedLinks: Список фидов для данного сообщения. Каждый элемент спсика содержит следующее:
  - url: URL фида.
  - name: Название фида.
  - feedType: Тип фида (Atom или RSS).
  - mimeType: MIME тип фида.
- comments: Список всех комментариев сообщения (только на страницах типа item). Каждый элемент списка содержит следующее:
  - id: Числовой идентификатор комментария.
  - body: Тело комментария.
  - timestamp: Время создания комментария.
  - author: Отображаемое имя автора комментария (или 'Anonymous').
  - authorUrl: URL профиля автора комментария, если комментарий не анонимный.
  - deleteUrl: URL для удаления комментария.
  - isDeleted: Был ли комментарий удалён. (Текст удалённых комментариев заменяется заглушкой.)

Blog Archives

title: Заголовок виджета.
style: Используемый стиль: 'MENU', 'FLAT' или 'HIERARCHY'.
data: Список с архивыми записями:
- name: Название для данного интервала времени, например, "August 2006."
- url: Ссылка на страницу, содержащую сообщения из данного интервала.
- post-count: Количество сообщений в данном интервале.

Profile Widget

Для блога с единственным автором, виджет Profile содержит следующую информацию:

title: Заголовок виджета.
userUrl: URL профиля автора.
location: Местарасположение автора, взятое из профиля.
aboutme: Информация «Обо мне», взятая из профиля.
displayname: Отображаемое имя автора.
photo: Фото, состоящее из следующего:
- url: URL изображения.
- width: Ширина изображения в пикселях.
- height: Высота изображения в пикселях.
- alt: Текст для атрибута "alt".

Для групповых блогов виджет содержит следующую информацию:

title: Заголовок виджета.
authors: Список авторов, содержащий следующее:
- displayname: Отображаемое имя автора.
- userURL: URL профиля автора.

Если в шаблоне необходимо обрабатывать оба варинта, можно использовать переменную team для их различения: <b:if cond='data:team=="true"'> (display multiple authors) </b:if>

Text / HTML / JavaScript Widget

title: Заголовок виджета.
content: Содержимое виджета.

Feed Widget

Виджет Feed динамически загружается при помощи Google AJAX APIA при отображении блога в браузере и его стиль можно изменить только при помощи CSS.

title: Заголовок виджета.
feedUrl: URL фида.

Picture Widget

title: Заголовок виджета.
sourceUrl: URL изображения.
width: Ширина.
height: Высота.
caption: Название изображения.

Labels Widget

title: Заголовок виджета.
labels: Список ярлыков:
- name: Название ярлыка.
- count: Количество сообщений с данным ярлыком.
- url: Ссылка на страницу, показывающую сообщения с данным ярлыком.