четверг, 24 февраля 2011 г.

Язык шаблонов 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: Ссылка на страницу, показывающую сообщения с данным ярлыком.

List Widget

  • title: Заголовок виджета.
  • items: Элементы списка.

Link List Widget

  • title: Заголовок виджета.
  • links: Список ссылок:: 
    • name: Текст.
    • target: URL.

Logo Widget

  • fullButton: URL лого.