[Blogger.com] Язык шаблонов Blogspot: Тэги для подстановки данных.

(Перевод статьи Layouts Data Tags)

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

• Глобально доступные данные
• Page Header
• Blog Posts
• Blog Archives
• Profile
• Text / HTML / JavaScript
• Feed
• Picture
• Labels
• List
• Link List
• Logo

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

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

• 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 лого.