Шаблон:Карточка/Документация

Материал из свободной русской энциклопедии «Традиция»
Перейти к: навигация, поиск

Использование[править]

Параметры[править]

Основные[править]

имя
Имя шаблона, необходимое для корректной работы ссылок «просмотр • обсуждение • редактирование» на всех страницах, где используется шаблон. Для простоты можно использовать {{subst:PAGENAME}}.
шапка
Текст, отображаемый в самом верху таблицы. Годится для названия проекта или тому подобного.
свойство_шапки
Используется для присвоения значения свойства SMW.
название
Текст, отображаемый над карточкой. Обычно это тема шаблона, краткое описание его содержания.
вверху
Текст, отображаемый вверху таблицы. Альтернативный вариант размещения названия шаблона.
свойство_вверху
Используется для присвоения значения свойства SMW.
вверху2, …, вверху5
Дополнительный текст, отображаемый вверху таблицы. Используется, например, для оригинального названия.
свойство_вверху2, …, свойство_вверху5
Используется для присвоения значения свойства SMW.
изображение, … изображение2
Изображение, которое будет отображено под основным заголовком. Параметр изображение допускает стандартный викикод для отображения
значок
Значок, которы будет выведен левее названия
подпись
Подпись под изображением. Отображается только в том случае, если задано изображение.
заголовокn
Используется для создания заголовков в ряду. Этот и следующие 2 параметра работают при 1≤n≤99
меткаn
Используется для подписи текста
текстn
Используется для принятия параметров в специализированных шаблонах-карточках.
свойствоn
Используется для присвоения значения свойства SMW.
типn
Тип свойства SMW — страница (по умолчанию), строка, дата, место, число или координаты.
категорияn, постфиксn, категория_дняn, постфикс_дняn, категория_годаn, постфикс_годаn
Используется для автоматической категоризации.
обратноn
название обратного свойства SMW для автоматического сбора значений.
внизу
Ячейка во всю ширину таблицы, располагающаяся внизу тела шаблона (то есть под заголовками/метками и текстом).

Стили[править]

стиль_тела
Применяется ко всей карточке, обычно используется для указания её ширины, например, width:300px;
стиль_шапки
Применяется к шапке
стиль_названия
Применяется к названию карточки
стиль_изображения
Применяется к ячейке, в которой располагается изображение и его описание
стиль_подписи
Применяется к подписи изображения
стиль_заголовков
С помощью этого стиля можно настроить отображение заголовков, в частности, указать цвет фона: background: #a3eea3;
стиль_вверху
Применяется к альтернативному заголовку, например, для указания цвета фона или изменения размера шрифта: font-size:medium;
стиль_вверху2, … стиль_вверху5
Используется для изменения стиля дополнительного текста вверху таблицы, например, чтобы убрать курсивное начертание: font-style:normal;
стиль_внизу
CSS стили, которые должны быть применены к верхней (указанной параметром вверху) и нижней (указанной параметром внизу) ячейкам.
стиль_меток
Применяется к меткам
стиль_текста
Применяется к тексту

Микроформаты[править]

Icons-mini-icon 2main.png Основная статья: ВП:Проект:Микроформаты
класс_тела
Этот параметр передаётся атрибуту class всей карточки.
класс(n)
Этот параметр применяется к определённому ряду, если текст в этом ряду определён.
класс_названия
Этот параметр передаётся атрибуту class названия карточки.
класс_шапки
значение атрибута class шапки.
класс_вверху, …, класс_вверху5
Этот параметр передаётся атрибуту class верхней ячейки.
класс_изображения
Этот параметр передаётся атрибуту class изображения.
класс_значка
Этот параметр передаётся атрибуту class значка.

Например, для реализации микроформата hCard добавьте следующие параметры:

|класс_тела = vcard
|класс1 = fn
|класс2 = org
|класс3 = tel

Создание необязательных ячеек[править]

Ряд с меткой, но без текста не будет отображён. Это позволяет легко создавать необязательные параметры в специализированных шаблонах-карточках. Для создания опциональной ячейки используйте параметр следующим образом:

|метка5 = Население
|текст5  = {{{население|}}}

Таким образом, если параметр население не будет определён, строка «Население» не будет отображена.

Для оформления параметра можно использовать функцию парсера «#if». Например, следующие строки добавят к параметру текст6 подпись кг, если этот параметр определён:

|метка6 = Mass
|текст6  = {{#if:{{{mass|}}} |{{{mass}}} кг}}

Таким же образом можно организовать необязательные заголовки. Следующий пример будет выводить заголовок «Структура», если параметры содержимое и размещение определены:

|заголовок5 = {{#if:{{{содержимое|}}}{{{размещение|}}}|Структура}}
|метка6  = Содержимое
|текст6   = {{{содержимое|}}}
|метка7  = Размещение
|текст7   = {{{размещение|}}}

Связь с формой[править]

Создаваемому на основе {{Карточка}} шаблону можно сопоставить форму Semantic Forms с помощью параметра форма. Ссылка на страницу редактирования статьи с помощью этой формы появится в нижней части шаблона-карточки.

Пустой шаблон[править]

{{Карточка
|имя               = {{subst:PAGENAME}}
|стиль_тела        = 
|шапка             =
|стиль_шапки       =
|свойство_шапки    =
|класс_шапки       =
|название          = 
|стиль_названия    =
|класс_названия    = 
|вверху            = 
|стиль_вверху      = 
|свойство_вверху   =
|тип_вверху        =
|класс_вверху      =
|вверху2           = 
|стиль_вверху2     =
|свойство_вверху2  = 
|тип_вверху2       =
|класс_вверху2     =
|вверху3           = 
|стиль_вверху3     =
|свойство_вверху3  = 
|тип_вверху3       =
|класс_вверху3     =
|вверху4           = 
|стиль_вверху4     =
|свойство_вверху4  = 
|тип_вверху4       =
|класс_вверху4     =
|значок            =
|изображение       = 
|стиль_изображения = 
|подпись           = 
|стиль_подписи     = 
|стиль_заголовков  = 
|стиль_меток       = 
|стиль_текста      = 

|заголовок1        = 
|метка1            = 
|текст1            = 
|свойство1         =
|обратно1          =
|тип1              =
|категория1        =
|постфикс1         =
|категория_дня1    =
|постфикс_дня1     =
|категория_года1   = 
|постфикс_года1    =

|заголовок2        = 
|метка2            = 
|текст2            = 
|свойство2         =
|обратно2          =
|тип2              =
|категория2        =
|постфикс2         =
|категория_дня2    =
|постфикс_дня2     =
|категория_года2   = 
|постфикс_года2    =

|заголовок3        = 
|метка3            = 
|текст3            = 
|свойство3         =
|обратно3          =
|тип3              =
|категория3        =
|постфикс3         =
|категория_дня3    =
|постфикс_дня3     =
|категория_года3   = 
|постфикс_года3    =

 …

|заголовок99       = 
|метка99           = 
|текст99           = 
|свойство99        =
|обратно99         =
|тип99             =
|категория99       =
|постфикс99        =
|категория_дня99   =
|постфикс_дня99    =
|категория_года99  = 
|постфикс_года99   =

|стиль_внизу       =
|внизу             = 

|форма             =
}}

Создание шаблонов[править]

Для создания шаблонов на основе {{Карточка}} и форм для их редактирования рекомендуется использовать приспособление Генератор шаблонов-карточек и форм Summary для панели инструментов «Традиции», которому достаточно передать спецификацию вызова шаблона.