Ҳуҷҷатгузорӣ

Параметрҳо

Асосӣ

ном
Ном шаблона, необходимое для корректной работы ссылок в строке «Шаблон: Просмотр • Обсуждение • Править» (см. {{Tnavbar}}) на всех страницах, где используется шаблон. Для простоты можно использовать {{subst:PAGENAME}}. Если такие ссылки не нужны, достаточно оставить это поле пустым.
ном
Матн, отображаемый над карточкой. Обычно это тема шаблона, краткое описание его содержания.
боло
Матн, отображаемый боло таблицы. Альтернативный вариант размещения ном шаблона.
боло2
Дополнительный матн, отображаемый боло таблицы. Используется, например, для оригинального ном.
тасвир
Тасвир, которое будет отображено под основным заголовком в правой части таблицы (правее сарлавҳаҳо/списков). Параметр тасвир допускает стандартный викикод для отображения. Для разных типов параметра можно использовать {{Қолаббандии тасвир}}.
зернавис
Зернавис под тасвиром. Отображается только в том случае, если задано тасвир.
сарлавҳаn
Используется для создания сарлавҳаҳо в ряду. Этот и следующие 2 параметра работают при n≥1.
нишонn
Используется для имзоҳо матн
матнn
Используется для принятия параметров в специализированных шаблонах-Қуттӣ.
поён
Ячейка во всю ширину таблицы, располагающаяся поён тан шаблона (то есть под заголовками/нишонми и матном).

Услубҳо

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

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

радаи_ҷадвал
Этот параметр передаётся атрибуту class всей карточки.
рада(n)
Этот параметр применяется к определённому ряду, если матн в этом ряду определён.
радаи_ном
Этот параметр передаётся атрибуту class ном карточки.
радаи_болоӣ
Этот параметр передаётся атрибуту class верхней ячейки.

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

|радаи_ҷадвал = vcard
|рада1     = fn
|рада2     = org
|рада3     = tel

Возможности

Сдвоенные ячейки

Если для параметра матнn значение нишонn не определено, то матнn автоматически расширяется до 2 ячеек.

Необязательные ячейки

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

 |барчасп5 = Население
 |матн5 = {{{население|}}}

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

Необязательные заголовки

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

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

Если есть сарлавҳаN, то матнN и барчаспN игнорируются. Если нет заданного заголовкаN, то показываются матнN и барчаспN.

 |сарлавҳа1 = {{{сарлавҳа1|}}}
 |барчасп1     = {{{барчасп1|}}}
 |матн1     = {{{матн1|}}}
 
 |сарлавҳа1 = сарлавҳа_матн
 |барчасп1     = барчасп_матн
 |матн1     = матн_матн
 
сарлавҳа_матн
 |сарлавҳа1 = 
 |барчасп1     = барчасп_матн
 |матн1     = матн_матн
 
барчасп_матн барчасп_матн

Оформление параметров

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

 |барчасп6 = Масса
 |матн6 = {{#if:{{{масса|}}} |{{{масса}}} кг}}

А расстановку ссылок на страницы можно организовать с помощью «#switch», например:

 |барчасп6     = Раса
 |матн6     = {{#switch:{{{раса|}}}
  |Европеоиды   = [[Европеоидная раса|Европеоиды]]
  |Негроиды     = [[Негроидная раса|Негроиды]]
  |Монголоиды   = [[Монголоидная раса|Монголоиды]]
  |{{{раса|}}}

Пустой шаблон

{{Қуттӣ
 |ном               = {{subst:PAGENAME}}
 |сабки_ҷадвал        = 
 |ном          = 
 |сабки_ном    = 
 |болоӣ            = 
 |сабки_болоӣ      = 
 |болоӣ2           = 
 |сабки_болоӣ2     = 
 |тасвир       = 
 |сабки_тасвир = 
 |зернавис           = 
 |сабки_зернавис     = 
 |сабки_сарлавҳа  = 
 |сабки_барчасп       = 
 |сабки_матн      = 

 |сарлавҳа1  = 
 |барчасп1      = 
 |матн1      = 

 |сарлавҳа2  = 
 |барчасп2      = 
 |матн2      = 

 |сарлавҳа3  = 
 |барчасп3      = 
 |матн3      = 

 |сарлавҳа4  = 
 |барчасп4      = 
 |матн4      = 

 |сарлавҳа5  = 
 |барчасп5      = 
 |матн5      = 

 |сарлавҳа6  = 
 |барчасп6      = 
 |матн6      = 

 |сарлавҳа7  = 
 |барчасп7      = 
 |матн7      = 

 |сарлавҳа8  = 
 |барчасп8      = 
 |матн8      = 

 |сарлавҳа9  = 
 |барчасп9      = 
 |матн9      = 

 |сарлавҳа10 = 
 |барчасп10     = 
 |матн10     = 

 ...

 |сарлавҳа120 = 
 |барчасп120     = 
 |матн120     = 

 |сабки_поёнӣ = 
 |поёнӣ       = 
}}<noinclude>

[[Гурӯҳ:Шаблонҳо:Қуттӣ]]
</noinclude>

Примерный шаблон для карточки персоны

{{Қуттӣ
 |ном               = 
 |радаи_ҷадвал        = vcard
 |сабки_ҷадвал        = 
 |ном          = 
 |сабки_ном    = 
 |болоӣ            = {{#if:{{{ном|}}}|{{{ном}}}|{{PAGENAME}}}}
 |синфи_болоӣ      = fn
 |сабки_болоӣ      = 
 |болоӣ2           = {{{ном дар забони асл|}}}
 |синфи_болоӣ2     = nickname
 |сабки_болоӣ2     = 
 |тасвир       = {{wikidata/p18|{{{фото|}}}}}
 |сабки_тасвир = 
 |зернавис           = {{{зернавис|}}}
 |сабки_зернавис     = 
 |сабки_сарлавҳа  = 
 |сабки_барчасп       = 
 |сабки_матн      = 

 |барчасп1      = Ном при рождении:
 |матн1      = {{{ном при рождении|}}}
 |синф1      = nickname

 |барчасп2      = Дата рождения:
 |матн2      = {{wikidata/p569|{{{дата рождения|}}}|{{{дата смерти|}}}}}

 |барчасп3      = Место рождения:
 |матн3      = {{{место рождения|}}}

 |барчасп4      = Дата смерти:
 |матн4      = {{wikidata/p570|{{{дата смерти|}}}|{{{дата рождения|}}}}}

 |барчасп5      = Место смерти:
 |матн5      = {{{место смерти|}}}

 |барчасп6      = Гражданство:
 |матн6      = {{#if:{{{гражданство|}}}|<span class="country-name">{{{гражданство}}}</span>}}
 |рада6      = adr

 |барчасп7      = Сценические имена / Прозвище:
 |матн7      = {{{прозвище|}}}
 |рада7      = nickname

 |сарлавҳа10 = {{wikidata/p856|{{{сайт|}}}}}
}}

Конвертация из HTML

При переводе шаблонов, написанных на html (использующих элементы div), на основу карточки (в основе которой лежит элемент table) следует производить следующую коррекцию:

  • увеличить ширину (свойство width) главного фрейма на 10px;
  • уменьшить внутренний отступ (свойство padding) там же на 2px;
  • задать явно размер и жирность матн (свойство и параметр font-weight: normal и т. п.).