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

Данная статья открывает небольшую серию публикаций с переводами на русский язык разделов справки Blogger, посвященных синтаксису шаблонов разметки блога. Серия призвана помочь тем, для кого сообщение "Запрошенная вами информация в настоящий момент недоступна на вашем языке" представляет собой достаточно большую проблему.

(Перевод материала Page Elements Tags for Layouts, дополненный мной)

Тело страницы блога формируется, главным образом, из секций и виджетов. Секции представляют собой области страницы, такие как боковая панель, подвал и т.д. Виджет - индивидуальный элемент, размещаемый в секции, такой как "Статистика блога", "Постоянные читатели" или любой другой компонент, который вы можете добавить в конструкторе "Элементы страницы".

Для создания секции используется парный тэг <b:section></b:section>, который может иметь следующие атрибуты:

• id (обязательно) - уникальное имя. Допустимые символы: цифры и латинские буквы.
• class (опционально) - имя класса. При переключении блога с одного шаблона на другой эти имена помогают движку определить, куда в новом шаблоне следует перенести контент. Стандартные имена классов: navbar, header, tabs, main, foot.
• 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='Header' locked="yes"/>
<b:widget id="myList" type='List' locked="no" title="My Favorites"/>

Виджет может иметь следующие атрибуты:

• id (обязательно) - может содержать только цифры и латинские буквы, и каждый идентификатор виджета в шаблоне должен быть уникальным. Идентификатор не может быть сменён без удаления виджета и создания нового.
• type (обязательно) - тип виджета, один из перечисленных ниже.
• locked (опционально) - принимает значения 'yes' или 'no', значение по умолчанию: 'no'. При значении 'yes' виджет не может быть перемещён или удалён при помощи конструктора "Элементы страницы".
• title (опционально) - отображаемое имя виджета. Если не указано, будет использовано имя по умолчанию, такое как List1 и т.п.
• pageType (опционально) - может иметь значения 'all', 'archive', 'main', 'index', 'static_page', или 'item', значение по умолчанию: 'all'. Виджет будет отображаться только на страницах соответствующего типа. (В конструкторе "Элементы страницы" видны все виджеты, вне зависимости от значения этого свойства.)

Стандартные, на момент публикации статьи, типы виджетов и их русские названия:

• AdSense (AdSense)
• Attribution (Атрибуты блога в "подвале")
• Blog (Основная часть блога)
• BlogArchive (Архив блога)
• BloggerButton (Логотип)
• BlogList (Blog List)
• CustomSearch (Окно поиска)
• Feed (Канал)
• FollowByEmail (Рассылка обновлений по электронной почте)
• Followers (Постоянные читатели)
• Header (Заголовок страницы)
• HTML (HTML/JavaScript)
• Image (Картинка)
• Label (Ярлыки)
• LinkList (Список ссылок)
• NewsBar (Новости)
• PageList (Страницы)
• Poll (Опрос)
• PopularPosts (Популярные сообщения)
• Profile (Профиль)
• Slideshow (Показ слайдов)
• Stats (Статистика блога)
• Subscribe (Ссылки на подписки)
• Text (Текст)
• TextList (Список)
• VideoBar (Панель видео)

Каждый виджет, также, может быть записан в расширенной форме, содержащей полную разметку и содержимое виджета. Расширенную форму виджетов вы увидите, например, если скачаете шаблон на вкладке "Дизайн->Изменить HTML" или поставив галочку напротив "Расширить шаблоны виджета" (там же). Более подробную информацию о структуре виджетов содержится в статье "Тэги для содержимого виджетов".

Примечание: При отдаче страницы блога браузеру, все тэги <b:section> и <b:widget> заменяются на тэги <div>, имеющие соответствующий ID. Таким образом, например, имеется возможность ссылаться на них через div#header, div#myList и т.п. из CSS.