WikiSysop в 07:28, 13 февраля 2007

2007-02-13T07:28:43Z

Новая страница

== Шаблоны ==
'''Шаблонами''' называется класс особых страниц, содержимое которых можно вставить в другие страницы. Причём это содержимое считывается при каждой загрузке страницы: изменения в шаблоне проявятся на страницах, их применяющих. Страницы шаблонов — полноценные вики-документы, для которых отведено своё пространство имён «Шаблон:». Вызывается шаблон пометкой <code><nowiki>{{</nowiki>Имя_шаблона<nowiki>}}</nowiki></code>. При отображении страницы на место этого будет помещено '''содержимое''' страницы «Шаблон:Имя шаблона». Если её ещё нет, то пометка будет отображена как ссылка на несуществующую статью.

Как обычно, имя статьи или шаблона чувствительно к регистру, а пробел эквивалентен подчёркиванию. Возможно также включение шаблона в шаблон, то есть вызов одного шаблона из другого.

Любую страницу можно использовать как шаблон пометкой <code><nowiki>{{</nowiki>Категория:Имя_страницы<nowiki>}}</nowiki></code>. Если Категория отстутствует, то просто: <code><nowiki>{{</nowiki>:Имя_страницы<nowiki>}}</nowiki></code>

Список ссылок на используемыех в тексте страницы шаблоны показывается ниже окна редактирования статьи.

== Параметры ==
Параметры шаблона могут быть поименованными:

<code><nowiki>{{Имя_шаблона|parname1=parvalue1|parname2=parvalue2}}</nowiki></code>, тогда в теле шаблона надо ссылаться на <code><nowiki>{{{parname1}}}</nowiki></code>, <code><nowiki>{{{parname2}}}</nowiki></code>;

Или пронумерованными:

<code><nowiki>{{Имя_шаблона|parvalue1|parvalue2}}</nowiki></code>, тогда в теле шаблона нужно использовать <code><nowiki>{{{1}}}</nowiki></code>, <code><nowiki>{{{2}}}</nowiki></code>.

Лишние (не используемые в теле шаблона) параметры игнорируются. Переменные шаблона вычисляются после вставки шаблона в вызывающую его статью, то есть если в шаблоне содержится подстановка <code><nowiki>{{PAGENAME}}</nowiki></code>, то она будет развёрнута в имя вызывающей статьи, а не в имя этого шаблона.

Имена параметров чувствительны к регистру символов. Желательно использовать в именах параметров только латинские буквы, цифры, дефис. Остальные символы не рекомендуются к использованию.

Таким образом, механизм шаблонов выполняет два типа подстановок:
* вызов шаблона (двойные фигурные скобки) заменяется содержимым шаблона;
* параметры шаблона (тройные фигурные скобки) заменяются параметрами шаблона.

Параметром шаблона может быть ссылка на другую статью. Пусть, например, у нас есть такой шаблон:
<nowiki>
Эта страница: {{{1}}} моя самая любимая.
</nowiki>

и он называется <code>Тест</code>. Тогда его вызов
<nowiki>
{{Тест|[[Песочница]]}}
</nowiki>
будет развёрнут в:
Эта страница: [[Песочница]] моя самая любимая.

== Неопределённые и пустые параметры == <small>пока не настроено</small>
Если какой-либо параметр шаблона не задан, то он останется нераскрытым и на странице использующей шаблон Вы увидите примерно такой текст: <code><nowiki>...{{{1}}}...</nowiki></code>.

Если Вы используете вызов переменных не по именам, а по номерам, то вызов <code><nowiki>{{Шаблон||что_то}}</nowiki></code> делает первый параметр определённым, но равным пустой строке. Если, напротив, нужно задать второй параметр, никак не определяя первый, то для этого следует использовать вызов <code><nowiki>{{Шаблон|2=что_то}}</nowiki></code>. Этот синтаксис следует использовать также и в том случае, когда значение параметра содержит знак равенства (например, «что_то=чему_то»): <code><nowiki>{{Шаблон|1=что_то=чему_то|2=еще_что_то}}</nowiki></code>.

Если для некоторого параметра шаблона подразумевается определённое значение по умолчанию, то можно использовать '''условное включение''' параметра в текст шаблона. Параметр, записанный в теле шаблона в виде: <code><nowiki>{{{parameter|что_то}}}</nowiki></code> будет включён в текст шаблона либо как <code><nowiki>что_то</nowiki></code> (если параметр не был определен), либо будет фигурировать присвоенное ему значение.

Самый простой пример: если некоторый параметр записан внутри шаблона в форме <code><nowiki>1={{{parameter|}}}</nowiki></code> (то есть если в качестве значения по умолчанию используется пустая строка), то в том случае, если этот параметр окажется не заданным, на его месте не будет ничего выводиться.

== Просмотр содержимого шаблона ==
Чтобы увидеть «сырое» содержимое шаблона (подстановки параметров и т. д.), нужно смотреть на шаблон в режиме редактирования, поскольку в противном случае некоторые подстановки вроде могут раскрыться.

Для показа содержимого шаблона (без wiki-интерпретации) можно использовать кодовый «волшебный» префикс «msgnw:»: <code><nowiki>{{msgnw:Шаблон}}</nowiki></code>

== Код шаблона ==
Всё, что находится между тегами <code><nowiki><noinclude> ... </noinclude></nowiki></code> будет обрабатываться и показываться только в случае когда шаблон показывается непосредственно, не включенным в другую страницу. Возможные применения:
* категоризация шаблонов самих по себе (а не страниц которые их содержат). Т.к. если шаблон содержит код категории, то в указанную категорию помещается не только шаблон, но и все страницы, включающие его.
* текст, объясняющий как использовать шаблон

Теги <code><nowiki><includeonly> ... </includeonly></nowiki></code> обладает противоположным действием. Текст будет обрабатываться и показываться только тогда когда шаблон включён в статью. Очевидное применение - включение всех статей, содержащих шаблон в категорию (при этом сам шаблон в категорию не попадёт).

Следует отметить, что при этом есть проблема — если включить статью в категорию посредством шаблона, а потом изменить категорию в шаблоне,то статьи будут содержаться в старой категории до первого редактирования и сохранения статьи содержащей шаблон.

== Вставка шаблона в момент сохранения ==
Используя конструкцию <code><nowiki>{{subst:Шаблон}}</nowiki></code> Вы выполняете подстановку
текста шаблона в момент сохранения ссылающейся страницы.

Например код:

<nowiki>
{{subst:CURRENTDAY}} {{subst:CURRENTMONTHNAME}} {{subst:CURRENTYEAR}},{{subst:CURRENTTIME}} (UTC)
</nowiki>

подставится при сохранении страницы:

3 марта 2005, 16:56 (UTC)

в то время, как

<nowiki>
{{CURRENTDAY}} {{CURRENTMONTHNAME}} {{CURRENTYEAR}}, {{CURRENTTIME}} (UTC)
</nowiki>

каждый раз будет показывать текущее время:

{{CURRENTDAY}} {{CURRENTMONTHNAME}} {{CURRENTYEAR}},  {{CURRENTTIME}} (UTC)

== История изменений для страниц, содержащих шаблоны ==
При просмотре исторических версий статей, содержащих шаблоны и/или картинки, всегда используется текущая версия шаблонов (и картинок), т. е. невозможна автоматическая «абсолютная» реконструкция исторических версий композитных текстов, чтобы также содержались ссылки на соответствующие картинки и шаблоны.

== См. также ==
* http://ru.wikipedia.org/wiki/Википедия:Шаблоны
* http://ru.wikipedia.org/wiki/Википедия:Функции_парсера

[[Категория:Справка]]

Шаблоны - История изменений

WikiSysop в 07:28, 13 февраля 2007