stringtranslate.com

Википедия:Пространство имен шаблонов

Эту страницу не следует путать с Шаблон:Пространства имен.

Пространство имен шаблонов в Википедии используется для хранения шаблонов , содержащих разметку Wiki, предназначенную для включения на несколько страниц, обычно посредством включения . Хотя пространство имен Template используется для хранения большинства шаблонов, его можно включать и заменять из других пространств имен [1] , поэтому некоторые страницы шаблонов размещаются в других пространствах имен, например, в пространстве имен User .

Шаблоны помогают поддерживать единообразие форматирования и облегчают навигацию между статьями. Они часто включают необязательные и/или переменные элементы, управляемые параметрами , позволяющие специализированное использование. Шаблоны также используются для решения широкого спектра задач по обслуживанию Википедии . У каждого шаблона есть соответствующая Template talk:страница, на которой редакторы могут обсудить дизайн и реализацию связанного шаблона (см. «Справка: Использование страниц обсуждения» , чтобы узнать, как участвовать в обсуждениях на страницах обсуждения).

Шаблон переносится на другую страницу путем включения тега шаблона в содержимое этой страницы. Тег шаблона содержит имя страницы шаблона , заключенное в двойные фигурные скобки, например {{Disambiguation}}. Если имя страницы шаблона не начинается с пространства имен и двоеточия, предполагается, что оно находится в пространстве имен шаблона.

Внутренние ссылки на страницы шаблонов могут создаваться с использованием Template:префикса, например [[Template:Disambiguation]]. Эти ссылки ведут на страницу, которая непосредственно содержит базовый шаблон и часто документацию.

Методические рекомендации

  • WP:TG
  • WP:ТМПГ

Рекомендуемые практики

Ссылки на шаблоны

Иногда вам захочется обратиться к шаблону, а не вызывать его. Самый простой способ сделать это — вызвать Template:Tl (сокращение от «ссылка на шаблон»). Например, чтобы сослаться на шаблон очистки, введите {{tl|Cleanup}}результаты {{ Очистка }}. Вы также можете добавить параметры, используя Template:Tlp ; например, {{tlp|Convert|1|m}}отображается как {{ Convert |1|m}} .

Проверьте документацию шаблона на Template:Tl , чтобы узнать о других параметрах, таких как {{ tlb }} (жирный шрифт), (код), (параметры, выделенные курсивом) и многих других.{{tlx}}{{tlxi|param1|param2}}

Имена шаблонов

  • WP: ТПН

Имена шаблонов могут состоять из одного или нескольких слов, например {{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:. См. раздел «Справка:Поиск» для получения дополнительной информации.

Страницы, содержащие информацию о часто используемых шаблонах:

Если вы не можете найти существующий шаблон для вашей ситуации, но не хотите создавать его самостоятельно, вы можете обратиться за помощью в Википедию: Запрошенные шаблоны .

Смотрите также

Примечания

  1. ^ Пространства имен, из которых включение не разрешено, указаны в вики переменной $wgNonincludableNamespaces.