Редактирование: РуСказки:Шаблоны

{{К улучшению|2023-06-26}}
<!--{{Shortcut|ВП:Ш}}-->
{{Руководства}}
{{Другое значение|Быстрые ссылки: [[РуСказки:Механизм шаблонов|Синтаксис]], [[РуСказки:Функции парсера|Функции парсера]], [[mw:Help:Magic words/ru|Метафункции и метапеременные]]}}

'''Шаблон''' — это вики-страница, которая вставляется в вики-страницу, где его вызывают. Шаблоны являются мощным средством, помогающим улучшить организацию РуСказок. Пользуйтесь существующими шаблонами и при необходимости добавляйте новые.

;Обратите внимание:На странице обсуждения или в документации почти любого шаблона приведены правила его использования. Пожалуйста, следуйте им.

;При создании шаблона:
: Помещайте шаблон в подходящую подкатегорию внутри категории [[:Категория:РуСказки:Шаблоны|РуСказки:Шаблоны]], окружив блок категорий тегом {{Tag|noinclude|content=}} (подробнее см. [[Проект:Технические работы/Шаблоны/Категоризация|Категоризация]]);
: Документируйте работу шаблона если это возможно (подробнее см. [[Проект:Технические работы/Шаблоны/Документирование|Документирование шаблонов]]);
: Добавляйте краткое описание шаблона на страницах, указанных в разделе [[#Каталог шаблонов]].

'''См. также:'''
* [[РуСказки:Механизм шаблонов]] — о создании и использовании шаблонов
* [[РуСказки:Рекомендации по созданию шаблонов]]
* [[РуСказки:Правка и тестирование шаблонов в песочнице]]
* [[РуСказки:Навигационные шаблоны]]
* [[РуСказки:Шаблоны-карточки]]
* [[Служебная:Все страницы/Шаблон:|Список всех шаблонов]] (служебная страница)
* [[Служебная:Самые используемые шаблоны|Самые используемые шаблоны]] (служебная страница)
* [https://tools.wmflabs.org/templatetiger/template-choice.php?lang=ru Список всех шаблонов по количеству использований] (на Wikimedia Tool Labs)
* [[Участник:Jack who built the house/Code Prettifier]] — скрипт для оформления кода

== Использование шаблонов ==
Использование шаблона — вставка в редактируемый текст вызова шаблона, в результате чего в месте вызова в редактируемый текст вставляется содержимое другой страницы.

Например, в режиме правки текущего текста мы набрали текст, который является вызовом шаблона: <code><nowiki>{{Ndash}}</nowiki></code>. В режиме просмотра, где вставлен этот текст, вы видите отображение: {{Ndash}}. В это место подставилось содержимое страницы [[Шаблон:Ndash]].

Найти нужный шаблон можно в категориях ниже или воспользовавшись строкой поиска, расположенной на каждой странице РуСказок. Название шаблона можно посмотреть в исходном тексте страниц, на которых он уже есть. На [[Служебная:Поиск|странице поиска]] в группе «Выборочно» нужно снять галочку с поля «(основное)» и поставить галочку в поле «Шаблон».

На странице шаблона обычно указана заготовка для вызова шаблона.

Например,
<pre>
{{Персона
 |имя                  = (имя персоны)*
 |оригинал имени       = (имя персоны на языке оригинала)
 |имя при рождении     = 
 |изображение          = (изображение персоны, только имя файла)
 |ширина               = (размер изображения, по умолчанию 200px)
 |описание изображения = 
 |род деятельности     = 
 |дата рождения        = *
 |место рождения       = 
 |гражданство          = 
 |подданство           = (подданство для тех, кто подданные, а не граждане)
 |дата смерти          =  
 |место смерти         = 
 |отец                 = (в это и четыре следующих поля вписываются имена соответствующих персон)
 |мать                 = 
 |супруг               = 
 |супруга              = 
 |дети                 = 
 |награды и премии     = (ордена, медали и тому подобное; для них есть специальные шаблоны)
 |автограф             = (отсканированная подпись персоны)
 |сайт                 = (официальный сайт)
 |разное               = (дополнительная информация)
 |викисклад            = (название категории на [[Викисклад]]е)
}}
</pre>

Эту заготовку нужно скопировать и вставить в нужную статью. Параметров (иногда называемых полями) может быть много, но не обязательно их все копировать и заполнять значениями.

Ниже представлен вызов шаблона, использующего только часть параметров, и только тех, значения которых заданы:
{|
|-
|<pre>
{{Персона
 |имя = Википе-тан
 |род деятельности = талисман
 |оригинал имени = 
}}</pre>
|{{Персона |имя = Википе-тан |род деятельности  = талисман }}
|}

Параметры бывают именованные и нумерованные. При вызове шаблона с нумерованными параметрами без указания их номеров роль номера выполняет номер позиции подставляемых значений параметров, например: <code><nowiki>{{Персона2|Википе-тан|талисман}}</nowiki></code>. Если значение параметра (например первого) не задано, то будет выводиться текст шаблона <code><nowiki>{{{1}}}</nowiki></code>. Чтобы текст не выводился, параметр нужно задать пустым значением: <code><nowiki>{{Персона2||талисман}}</nowiki></code>. То же, используя вызов с указанием номеров параметров: <code><nowiki>{{Персона2|2=талисман|1=}}</nowiki></code>.

Также на странице шаблона может быть поясняющий текст или таблица с описанием параметров и примером их заполнения:

<dl><dd>
<templatedata>
{
        "description": "Пример описания шаблона «Персона»",
        "params": {
                "имя": {
                        "label": "Имя персоны",
                        "description": "Имя автора. В конце не должно быть точки. Внимание: инициалы отделяются от фамилии и друг от друга неразрывным пробелом. Пример: Иванов С. В.",
                        "type": "string",
                        "default": "",
                        "required": false
                },
                "род деятельности": {
                        "label": "Род деятельности персоны",
                        "description": "Указывается с прописной буквы. Пример: талисман.",
                        "type": "string",
                        "default": "",
                        "required": false
                }
         }
}
</templatedata>
</dd></dl>

Значения параметров шаблонов удобно заполнять в Визуальном редакторе. См. [[mw:Help:VisualEditor/User guide/ru#Редактирование шаблонов]].

== Каталог шаблонов ==
{| border=0 cellspacing=0 cellpadding=10 style="border: 0px solid #aaa; background: none;"
|- valign="top"
| width="33%" |

=== Общие ===
* [[РуСказки:Шаблоны/Общего назначения|Общего назначения]]:
** именование, редактирование
** технические пометки
** навигация по статье
** категории
** разное
* [[РуСказки:Шаблоны/Навигация|Навигация по служебным страницам]]
* [[РуСказки:Шаблоны/Незавершённые статьи|Незавершённые статьи]]
** [[РуСказки:Шаблоны/Незавершённые статьи/Культура|о культуре]]
** ... продолжить список
* [[РуСказки:Шаблоны/Обращения к участникам|Обращения к участникам]]
** [[РуСказки:Шаблонные сообщения|Шаблонные сообщения]]
* [[РуСказки:Шаблоны/Предупреждения|Предупреждения]]
* [[РуСказки:Шаблоны/Ссылки|Ссылки на другие проекты]]
* [[РуСказки:Шаблоны/Библиография|Библиография]]
| width="33%" |

=== Служебные ===
* [[РуСказки:Шаблоны/Вспомогательные|Вспомогательные]]
* [[РуСказки:Шаблоны/Заглавная страница|Заглавная страница]]
* [[РуСказки:Шаблоны/Изображения|Изображения]]
* [[РуСказки:Шаблоны/Лицензии файлов|Лицензии файлов]]
* [[РуСказки:Шаблоны/Незавершённые статьи|Незавершённые статьи]]
* [[РуСказки:Шаблоны/Обсуждения|Обсуждения]]
* [[РуСказки:Шаблоны/Переменные|Переменные]]
* [[РуСказки:Шаблоны/Перемещение содержимого|Перемещение содержимого]]
* [[РуСказки:Шаблоны/Удаление содержимого|Удаление содержимого]]
* [[РуСказки:Шаблоны/Источники|Ссылки на источники информации]]
* [[РуСказки:Шаблоны/Форматирование|Форматирование]]
* [[РуСказки:Шаблоны/Языки|Языки]]
| width="33%" |

=== [[РуСказки:Шаблоны/Навигационные|Навигационные]] ===
* [[РуСказки:Шаблоны/Навигационные/Время|Время]]
* Культура
** [[РуСказки:Шаблоны/Навигационные/Алфавиты|Алфавиты]]
** [[РуСказки:Шаблоны/Навигационные/Кино|Кино]] • [[РуСказки:Шаблоны/Навигационные/Персонажи сериалов|Персонажи сериалов]]
** [[РуСказки:Шаблоны/Навигационные/Литература|Литература]]
** [[РуСказки:Шаблоны/Навигационные/Музыка|Музыка]]
** [[РуСказки:Шаблоны/Навигационные/Религия и мифология|Религия и мифология]]
** [[РуСказки:Шаблоны/Навигационные/Фотография|Фотография]]
* [[РуСказки:Шаблоны/Навигационные/Наука|Наука]]
** [[РуСказки:Шаблоны/Навигационные/География|География]]
** [[РуСказки:Шаблоны/Навигационные/История|История]]
** [[РуСказки:Шаблоны/Навигационные/Эволюция|Эволюция]]
** [[РуСказки:Шаблоны/Навигационные/Языки и языковые группы|Языки и языковые группы]]
* Общество
** [[РуСказки:Шаблоны/Навигационные/Персоналии|Персоналии]]
** [[РуСказки:Шаблоны/Навигационные/Племена и народы|Племена и народы]]

|- valign="top"
| width="33%" |

=== Тематические ===
* [[РуСказки:Шаблоны/Астрономия|Астрономия]]
* [[РуСказки:Шаблоны/Воинские звания|Воинские звания]]
* [[РуСказки:Шаблоны/География|География]]
* [[РуСказки:Шаблоны/Классные чины/СССР - Россия|Прокуратура]]
| width="33%" |

=== [[РуСказки:Шаблоны-карточки|Карточки]] ===
* [[:Категория:Шаблоны-карточки по алфавиту|Все по алфавиту]]
* [[Шаблон:Геокарточки|Геокарточки]]
* [[Шаблон:Антропогеокарточки|Антропогеокарточки]]
| width="33%" |

=== [[РуСказки:Юзербоксы|Юзербоксы]] ===
См. [[РуСказки:Юзербоксы]].
|}

Не все существующие шаблоны есть в этом каталоге. Также можно найти шаблоны по категориям: [[:Категория:РуСказки:Шаблоны]]. Для поиска по всем шаблонам используйте форму ниже.

== Поиск шаблонов ==
В качестве альтернативы использованию каталога вы можете поискать по пространству имён «Шаблоны» через это поле:
<div class="inputbox-hidecheckboxes">
<inputbox>
type=fulltext
width=40
namespaces=Шаблон**
searchbuttonlabel=Поиск
break=no
placeholder=Поиск по шаблонам
</inputbox>
</div>

Вы также можете искать по каталогу шаблонов ([[Служебная:Указатель_по_началу_названия/РуСказки:Шаблоны/|подстраницам этой страницы]]):

<div class="inputbox-hidecheckboxes">
<inputbox>
type=fulltext
width=40
prefix=РуСказки:Шаблоны
searchbuttonlabel=Поиск
break=no
placeholder=Поиск по каталогу шаблонов
</inputbox>
</div>

== См. также ==
* [[Проект:Технические работы/Шаблоны]]

[[Категория:РуСказки:Справка]]
[[Категория:РуСказки:Справка по шаблонам]]
[[Категория:РуСказки:Списки шаблонов]]