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

Blogger LogoДанная статья открывает небольшую серию публикаций с переводами на русский язык разделов справки 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.

Комментариев: 0

Отправить комментарий

Хотите подписать свой комментарий, но у вас нет аккаунта? Выберите в выпадающем списке Имя/URL.
Вы сможете вписать свои имя или ник. Поле для указания URL можно оставить пустым.

Тэги, допустимые в комментариях