Пространство имен шаблонов в Википедии используется для хранения шаблонов , содержащих разметку Wiki, предназначенную для включения на несколько страниц, обычно посредством включения . Хотя пространство имен Template используется для хранения большинства шаблонов, его можно включать и заменять из других пространств имен [1] , поэтому некоторые страницы шаблонов размещаются в других пространствах имен, например, в пространстве имен User .
Шаблоны помогают поддерживать единообразие форматирования и облегчают навигацию между статьями. Они часто включают необязательные и/или переменные элементы, управляемые параметрами , позволяющие специализированное использование. Шаблоны также используются для решения широкого спектра задач по обслуживанию Википедии . У каждого шаблона есть соответствующая Template talk:
страница, на которой редакторы могут обсудить дизайн и реализацию связанного шаблона (см. «Справка: Использование страниц обсуждения» , чтобы узнать, как участвовать в обсуждениях на страницах обсуждения).
Шаблон переносится на другую страницу путем включения тега шаблона в содержимое этой страницы. Тег шаблона содержит имя страницы шаблона , заключенное в двойные фигурные скобки, например {{Disambiguation}}
. Если имя страницы шаблона не начинается с пространства имен и двоеточия, предполагается, что оно находится в пространстве имен шаблона.
Внутренние ссылки на страницы шаблонов могут создаваться с использованием Template:
префикса, например [[Template:Disambiguation]]
. Эти ссылки ведут на страницу, которая непосредственно содержит базовый шаблон и часто документацию.
Иногда вам захочется обратиться к шаблону, а не вызывать его. Самый простой способ сделать это — вызвать Template:Tl (сокращение от «ссылка на шаблон»). Например, чтобы сослаться на шаблон очистки, введите {{tl|Cleanup}}
результаты {{ Очистка }}. Вы также можете добавить параметры, используя Template:Tlp ; например, {{tlp|Convert|1|m}}
отображается как {{ Convert |1|m}} .
Проверьте документацию шаблона на Template:Tl , чтобы узнать о других параметрах, таких как {{ tlb }} (жирный шрифт), (код), (параметры, выделенные курсивом) и многих других.{{tlx}}
{{tlxi|param1|param2}}
Имена шаблонов могут состоять из одного или нескольких слов, например {{Train topics}}
. Первый символ (только) не чувствителен к регистру, поэтому {{cleanup}}
и {{Cleanup}}
являются одним и тем же шаблоном, но {{cfd}}
и {{cfD}}
нет. Названия шаблонов легче всего запомнить, если они соответствуют стандартному английскому написанию, интервалам и использованию заглавных букв (см. также правила именования статей). Избегайте шаблонов, имена которых различаются только регистром, пробелами или знаками препинания.
Если вы хотите поэкспериментировать с шаблонами (и не удалять свои эксперименты до того, как вы их закончите), вы можете сделать это в песочнице шаблонов . Вы также можете использовать шаблоны X1 , X2 , X3 , X4 , X5 , X6 , X7 , X8 , X9 , X10 , X11 и X12 в экспериментальных целях. Чтобы включить тестовый шаблон, используйте форму {{X1}}
для шаблона X1, {{X2}}
для шаблона X2 и т. д.
Каждый из существующих шаблонов часто имеет собственную песочницу и страницы тестовых примеров (особенно те, которые используют {{ Документацию }}). Там изменения должны быть тщательно протестированы перед применением к основному шаблону, чтобы не допустить непреднамеренного повреждения многих страниц.
Для шаблонов, использующих большое количество параметров, может быть полезно разместить каждый параметр на отдельной строке и выровнять знаки равенства. Это поможет будущим редакторам легче читать викикод.
{{Пример названия шаблона| first_parameter = Текст первого_значения| второй_параметр = Текст второго_значения| Third_parameter = Текст третьего_параметра| и т. д. = и т. д.}}
Некоторые шаблоны могут случайно вызвать дополнительные разрывы строк в отображаемых статьях. Это особенно актуально для шаблонов информационных полей и других полей шаблонов, которые обычно располагаются в правой части статьи, поскольку дополнительные строки не будут видны на странице шаблона. Дополнительную информацию см. в Wikipedia:Обработка разрыва строки .
В качестве общей рекомендации избегайте двух разрывов строк в шаблоне. Они могут «складываться» с другими разрывами строк в статье и отображаться как нежелательные пробелы.
Вызов шаблона с помощью формы
{{subst:name of template (|parameters |...)}}
(то есть вставка subst:
сразу после открывающей пары фигурных скобок) сделает копию текста шаблона и поместит ее на страницу, где ее можно будет просмотреть в исходном коде. Шаблон больше не включается , и будущие изменения в шаблоне не изменят текст. В качестве рекомендации этот метод следует использовать для любых коротких временных сообщений, которые быстро удаляются, например, на страницах User_talk:. Хорошим примером является стандартное новое сообщение пользователя .{{Welcome}}
Используйте subst: также, если вам нужно отредактировать сообщение после добавления его на страницу. Если вам не нужно его редактировать и вы предпочитаете, чтобы сообщение автоматически обновлялось вместе с изменениями, внесенными в шаблон, не используйте subst:.
Поскольку шаблоны усложняют работу начинающего редактора, необходимо предоставить документацию, описывающую их использование (необязательные параметры) и область применения (где их следует использовать). Есть два разных способа сделать это:
Альтернативой является использование <noinclude> для добавления второстепенного описания непосредственно в шаблон, например:
'''Это {{{1}}} статья.'''<noinclude>Разместите этот шаблон в любой статье, требующей описания. Этопринимает один параметр — прилагательное, используемое для описания статьи.Например, {{article-describe|bad}} создает текст,'''Это плохая статья.'''</noinclude>
Другой альтернативой является создание формальной подстраницы /doc для документации (предпочтительно для шаблонов с несколькими параметрами и т. д.) и добавление после фактического шаблона. Первый тег «noinclude» должен быть помещен в ту же строку, что и концевые скобки фактического шаблона, следующим образом:<noinclude>{{Documentation}}</noinclude>
{{(Имя Шаблона)(параметры трубопровода)}}<noinclude>...
Если тег «noinclude» начинается на строке под закрывающими скобками шаблона, то в нижней части шаблона появляются нежелательные пробелы, когда он используется в статьях и на других страницах.
Модули Lua иногда используются вместо шаблонов для хранения повторно используемого материала. Причины этого включают использование специфичных для модуля функций, таких как циклы или хранимые значения, а сложный код часто легче читать и поддерживать в модуле. Если модуль легко реализовать в шаблоне, то, как правило, так и должно быть, поскольку есть больше пользователей, имеющих опыт редактирования шаблонов.
Если модуль предназначен для использования в статьях или страницах обсуждения, обычно следует создавать оболочку шаблона, чтобы упростить использование без прямого требования #invoke
функции синтаксического анализа. В этом случае документация в основном размещается на странице /doc шаблона, при этом документация модуля указывает на шаблон и/или объясняет дополнительные технические детали, которые не нужны в основной документации шаблона.
Оболочка шаблона использует больший предел размера включения после раскрытия, чем прямой вызов модуля, поэтому может возникнуть необходимость избегать его использования в статьях, которые близки к этому пределу.
Исторически сложилось так, что префикс «msg:» нужно было добавлять перед именем шаблона, когда он использовался на странице. Например, вместо {{stub}} было введено {{msg:stub}}. В этом больше нет необходимости.
В первые 35 месяцев существования Википедии вообще не было шаблонов или механизмов включения. Страница Википедия:Шаблоновый текст была создана в сентябре 2002 года для сбора часто используемого текста в различных процессах Википедии. Пространство имен MediaWiki было представлено в версии MediaWiki 1.2.6 6 декабря 2003 г. и использовалось не только для пользовательского интерфейса, но и для создания шаблонных текстовых сообщений для вставки в статьи с использованием синтаксиса {{msg: ...}}. Эта функция была заменена пространством имен шаблона во время обновления программного обеспечения до MediaWiki 1.3 30 мая 2004 г. В результате выполнения « скрипта инициализации пространства имен шаблона » все несистемные сообщения были перемещены в новое пространство имен. Скрипт инициализации также заменил ссылки MediaWiki: в статьях на Template: для обхода перенаправлений, созданных ходами.
В течение короткого времени Wikipedia:Статьи для удаления (тогда известные как голоса за удаление или VfD ) использовали MediaWiki: сообщения, названные в формате «MediaWiki:VfD- имя статьи ». Они были перенесены в пространство Template: в июне 2004 года и получили название «Шаблон:VfD- имя статьи ». Сейчас это использование устарело в пользу подстраниц.
Примерно в 2005 году растущая сложность функций шаблонов и желание объединить похожие шаблоны привели к созданию чрезвычайно сложных условных хаков, таких как вложенные шаблоны и трюки CSS . Эти нежелательные методы привели к разработке m:Extension:ParserFunctions, добавленного в 2006 году в MediaWiki 1.7. К 2009 году многие проблемы с читабельностью и сложностью шаблонов все еще оставались ( О шаблонах и языках программирования ). В 2013 году, чтобы сократить время загрузки страниц, в основном из-за медленного рендеринга шаблонов, был включен Lua , создав пространство имен Module: для использования программистами ( новые шаблоны Lua обеспечивают более быстрые и гибкие страницы в вашей вики ).
Используйте эту форму для поиска в пространствах имен Template: или Template_talk:. См. раздел «Справка:Поиск» для получения дополнительной информации.
Страницы, содержащие информацию о часто используемых шаблонах:
Если вы не можете найти существующий шаблон для вашей ситуации, но не хотите создавать его самостоятельно, вы можете обратиться за помощью в Википедию: Запрошенные шаблоны .