stringtranslate.com

Помощь:Краткое руководство по шаблонам

Это краткий обзор шаблонов . Полную информацию можно найти в Help:Template , Wikipedia:Templates и m:Help:Advanced templates .

Шаблон — это страница Википедии, созданная для включения в другие страницы. Обычно она содержит повторяющийся материал, который может потребоваться отобразить в нескольких статьях или страницах, часто с настраиваемым вводом. Шаблоны иногда используют функции парсера MediaWiki , прозванные « волшебными словами », простой язык сценариев .

Страницы шаблонов находятся в пространстве имен шаблонов . Это означает, что любая страница, заголовок которой начинается с "Template:", например, " Template:foo ", может быть использована для этой цели. Содержимое шаблона с названием Template:foo может быть добавлено на страницу Википедии путем редактирования страницы и ввода текста {{foo}}. При последующем просмотре страницы {{foo}}автоматически заменяется содержимым страницы "Template:foo". Если страница "Template:foo" будет впоследствии изменена, все страницы с {{foo}}ней автоматически изменятся.

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

Когда шаблон автоматически расширяется и появляется на странице, говорят, что он « включен ».

Шаблоны документированы (или должны быть) на своих страницах. Таким образом, если вы хотите узнать, как использовать шаблон с именем "foo" (возможно, потому что вы видели его {{foo|...}}в исходном коде статьи), перейдите на "Template:foo". (Сама документация обычно находится на "Template:foo/doc", но также включена на главную страницу "Template:foo").

Создание, редактирование и использование шаблонов

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

После того, как вы создали шаблон, например Template:foo , вы можете добавить его на страницы, на которых хотите его использовать. Каждая страница, использующая этот шаблон, использует один и тот же шаблонный текст каждый раз, когда пользователь посещает ее. При обновлении шаблона все страницы, содержащие тег шаблона, автоматически обновляются.{{foo}}

В качестве альтернативы, если вы не хотите, чтобы страница отражала будущие обновления шаблона, вы можете добавить к страницам, на которых вы хотите использовать шаблонный текст. Система извлекает одноразовую копию текста шаблона и подставляет ее на страницу вместо тега шаблона. Если кто-то впоследствии редактирует шаблон, страницы, которые использовали ключевое слово, не обновляются . Иногда это то, что вам нужно.{{subst:foo}}subst:

Если шаблон, который вы хотите отредактировать, выглядит как {{foo}}, вам нужно перейти в Template:foo, чтобы отредактировать его. Чтобы попасть туда, введите "Template:foo" в поле поиска (см. поиск ), или создайте викиссылку [[Template:foo]]где-нибудь, например в sandbox , и щелкните по ней.

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

Параметры

Шаблоны могут иметь параметры, которые страница может динамически включать в включенную страницу. Вместо простого имени шаблона, например {{foo}}, встроенный тег шаблона будет иметь дополнительные значения, разделенные вертикальными чертами (|), например {{foo|July|lc=yes}}. Вот Julyзначение первого неименованного параметра; yes— это значение именованного параметра lc. Написание страницы шаблона для шаблона с параметрами сложнее, чем для шаблона без параметров. См. Help:Template .

Редактирование существующих шаблонов

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

Wikipedia:Редактор шаблонов § Используйте советы, которые помогут избежать проблем.

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

Чтобы включить фактическое полное имя шаблона в виде текста (включая окружающие скобки) в статью Википедии, примените ссылку на шаблон template . Основная мотивация сделать это — в инструкции и документации. Короткий пример — код:

{{tl|foo}}
генерирует
{{ фу }}

Часто задаваемые вопросы

Как узнать, как использовать существующий шаблон?
Чтобы просмотреть документацию по шаблону с именем «foo», перейдите по ссылке «Template:foo».
Как узнать, где используется шаблон?
Чтобы получить список всех страниц, на которые включен шаблон, используйте Special:WhatLinksHere и введите template: templatename ( подробнее ).
Могу ли я использовать шаблон в нескольких проектах?
Нет, если вы хотите использовать его, например, в двух Википедиях на разных языках, вам придется создать его дважды.
Чувствительны ли имена шаблонов к регистру?
Да, за исключением, как правило (в большинстве вики) [1] первой буквы.
Как добавить параметры?
Инструкции см. в разделе Справка:Шаблон .
Я отредактировал шаблон, так почему же страница, на которой он используется, не изменилась?
Wikipedia и ваш компьютер хранят кэши веб-страниц  – или сохраненные копии – и не всегда показывают вам обновленную страницу. Сначала попробуйте обойти кэш браузера , нажав ⌥ Opt+ ⌘ Cmd+ R, + + или + . Если это не поможет, вам может потребоваться очистить кэш страницы (что можно сделать несколькими способами). Возможно, самый простой способ сделать это – нажать «Изменить» на странице, на которой отображается шаблон, а затем нажать «Опубликовать изменения» , ничего не изменив – нет необходимости заполнять поле «Сводка» , поскольку не будет никакой истории этого как сгенерированного изменения.Ctrl⇧ ShiftRCtrlF5
Могу ли я переместить шаблон на новое имя?
Да, это работает точно так же, как и обычные перемещения страниц . Когда страница, запрашиваемая для включения, является страницей перенаправления, вместо этого включается цель перенаправления.
Могу ли я использовать шаблон внутри шаблона?
Да.
Как добавить новый шаблон?
Вы начинаете новый шаблон так же, как и обычную страницу. Единственное отличие в том, что его заголовок должен начинаться с Template:. Не забудьте задокументировать его, чтобы другие редакторы могли его использовать!
Где находится руководство по языку программирования, используемому для написания шаблонов?
Язык внутри шаблонов тот же, что и в обычной вики-разметке, но авторы шаблонов склонны использовать более сложные доступные функции, такие как операторы #if:. См. Help:Template Википедии и mw:Help:Template Викимедиа, включая все страницы справки «расширенного функционирования», перечисленные в нижней части этой страницы.

Примеры

Помощь, специфичная для Википедии