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

Язык шаблонов Blogspot: Тэги для описания элементов страницы.

Перевод разделов справки Blogger, посвященных синтаксису шаблонов разметки блога.
Тело страницы блога формируется, главным образом, из секций и виджетов. Секции представляют собой области страницы, такие как боковая панель, подвал и т.д. Виджет — индивидуальный элемент, размещаемый в секции, такой как облако тэгов, блогролл или любой другой компонент, который вы можете добавить на страницу. Для создания секции используется парный тэг <b:section></b:section>, который может иметь следующие атрибуты:
  • id — (обязательный) Уникальное имя. Допустимые символы: цифры и латинские буквы.
  • class — (опциональный) Имя класса. При переключении блога с одного шаблона на другой эти имена помогают движку определить, куда в новом шаблоне следует перенести контент. Стандартные имена классов: navbar,headermainsidebarfooter.
  • maxwidgets — (опциональный) Максимальное количество виджетов, которое может быть размещено в данной секции. Не ограничено, если атрибут не указан.
  • showaddelement — (опциональный) Может принимать значения 'yes' или 'no'. Значение по умолчанию: 'yes'. Определяет, будет ли на странице «Дизайн» → «Элементы страницы» отображаться ссылка «Добавить виджет» для данной секции.
  • growth — (опциональный) Может принимать значения 'horizontal' или 'vertical'. Значение по умолчанию: 'vertical'. Определяет, располагаются ли виджеты в секции горизонтально или вертикально друг над другом.
Пример тэга, определяющего секцию:

<b:section class="header" id="header" maxwidgets="1" showaddelement="no">
</b:section>
Секция может содержать только виджеты, она не может содержать другие секции или произвольный HTML код. Если вам нужно поместить дополнительный код между виджетами, вам придётся разделить секцию на несколько отдельных секций.
В простейшем случае, виджет представлен одиночным тэгом <b:widget/>, на место которого подставляется содержимое виджета при выдаче страницы браузеру. Примеры виджетов:

<b:widget id="header" type='HeaderView' locked="yes"/>
<b:widget id="myList" type='ListView' locked="no" title="My Favorite Things"/>
Виджет может иметь следующие атрибуты:
  • id — (обязательный) Может содержать только цифры и латинские буквы, и каждый идентификатор виджета в шаблоне должен быть уникальным. Идентификатор не может быть сменён без удаления виджета и создания нового.
  • type — (обязательный) Тип виджета, один из перечисленных ниже.
  • locked — (опциональный) Принимает значения 'yes' или 'no', значение по умолчанию: 'no'. При значении 'yes' виджет не может быть перемещён или удалён при помощи конструктора «Элементы страницы».
  • title — (опциональный) Отображаемое имя виджета. Если не указано, будет использовано имя по умолчанию, такое как List1 и т.п.
  • pageType — (опциональный) Может иметь значения 'all', 'archive', 'main', или 'item', значение по умолчанию: 'all'. Виджет будет отображаться только страницах соответствующего типа. (В конструкторе «Элементы страницы» видны все виджеты, вне зависимости от значения этого свойства.)
Допустимые типы виджетов:
  • BlogArchive
  • Blog
  • Feed
  • Header
  • HTML
  • SingleImage
  • LinkList
  • List
  • Logo
  • BlogProfile
  • Navbar
  • VideoBar
  • NewsBar
Каждый виджет также может быть записан в расширенной форме, содержащей полную разметку и содержимое виджета. Расширенную форму виджетов вы увидите, например, если вы скачаете шаблон на вкладке «Дизайн» → «Редактирование HTML» или если включите переключатель «Расширить шаблоны виджета». Примечание: При отдаче странице блога браузеру все тэги <b:section> и<b:widget> заменяются на тэги <div>, имеющие соответствующий ID. Таким образом, например, имеется возможность ссылаться на них через div#header,div#myList и т.п. из CSS.