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

Материал из Викитаки

Перейти к: навигация, поиск

Содержание

1 Использование
- 1.1 Параметры
  - 1.1.1 Основные
  - 1.1.2 Стили
2 Микроформаты

Использование

Параметры

Основные

имя: Имя шаблона, необходимое для корректной работы ссылок «просмотр{{ }} обсуждение{{ }} редактирование» на всех страницах, где используется шаблон. Для простоты можно использовать {{subst:PAGENAME}}.
шапка: Текст, отображаемый в самом верху таблицы. Годится для названия проекта или тому подобного.
свойство_шапки: Используется для присвоения значения свойства SMW.
название: Текст, отображаемый над карточкой. Обычно это тема шаблона, краткое описание его содержания.
вверху: Текст, отображаемый вверху таблицы. Альтернативный вариант размещения названия шаблона.
свойство_вверху: Используется для присвоения значения свойства SMW.
вверху2, …, вверху5: Дополнительный текст, отображаемый вверху таблицы. Используется, например, для оригинального названия.
свойство_вверху2, …, свойство_вверху5: Используется для присвоения значения свойства SMW.
изображение, … изображение2: Изображение, которое будет отображено под основным заголовком. Параметр изображение допускает стандартный викикод для отображения
значок: Значок, которы будет выведен левее названия
подпись: Подпись под изображением. Отображается только в том случае, если задано изображение.
заголовок_n: Используется для создания заголовков в ряду. Этот и следующие 2 параметра работают при 1≤n≤80
метка_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 стили, которые должны быть применены к верхней (указанной параметром вверху) и нижней (указанной параметром внизу) ячейкам.
стиль_меток: Применяется к меткам
стиль_текста: Применяется к тексту

Микроформаты

класс_тела: Этот параметр передаётся атрибуту 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    =

 …

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

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

|форма             =
}}

Создание шаблонов

Для создания шаблонов на основе {{Карточка}} и форм для их редактирования рекомендуется использовать приспособление MediaWiki:Gadget-MakeCard, которому достаточно передать спецификацию вызова шаблона.