Это краткий обзор шаблонов . Полную информацию можно найти в Help: Template и 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]]
где-нибудь, например, в песочнице , и щелкните по ней.
Оказавшись там, просто нажмите «изменить» или «отредактировать эту страницу» в самом верху страницы (а не кнопку редактирования документации внизу) и отредактируйте ее так же, как и любую другую страницу. Вы можете добавить все, что хотите добавить на обычную страницу, включая текст, изображения и другие шаблоны. При редактировании используемых шаблонов рекомендуется использовать песочницы, как описано в руководстве по тестовым примерам и тестовым примерам.
Параметры
Шаблоны могут иметь параметры, которые страница может динамически включать в добавленную страницу. Вместо простого имени шаблона, например {{foo}}
, встроенный тег шаблона будет иметь дополнительные значения, разделенные вертикальными полосами (|), например {{foo|July|lc=yes}}
. Вот July
значение первого безымянного параметра; yes
- значение названного параметра lc
. Написать шаблонную страницу для шаблона с параметрами сложнее, чем для шаблона без параметров. См. Справку: шаблон .
Редактирование существующих шаблонов
Когда вы редактируете используемый шаблон, он может одновременно повлиять на многие страницы Википедии.
Википедия: редактор шаблонов § Используйте советы, которые помогут избежать проблем.
Шаблон ссылки шаблона
Чтобы включить фактическое полное имя шаблона в виде текста (включая окружающие фигурные скобки) в статью Википедии, примените шаблон ссылки шаблона . Основная мотивация для этого - инструкция и документация. Краткий пример - это код:
{{tl|foo}}
- генерирует
- {{ foo }}
Часто задаваемые вопросы
Как я могу узнать, как использовать существующий шаблон?
- Чтобы увидеть документацию по шаблону с именем «foo», перейдите в «Template: foo».
Как узнать, где используется шаблон?
- Чтобы вывести список всех страниц, на которые вставлен шаблон, используйте Special: WhatLinksHere и введите template: templatename ( подробнее ).
Могу ли я использовать шаблон более чем в одном проекте?
- Нет, если вы хотите использовать его, например, в Википедии на двух разных языках, вам нужно будет создать его дважды.
В шаблонах учитывается регистр?
- Да, кроме обычно первой буквы.
Как добавить параметры?
- См . Инструкции в Справке: Шаблон .
Я редактировал шаблон, так почему же страница, на которой он используется, не изменилась?
- В Википедии и на вашем компьютере хранятся кеши веб-страниц - или сохраненные копии - и не всегда отображаются обновленные страницы. Сначала попробуйте обойти кеш браузера, нажав ⌘R, Ctrl + R или F5. Если это не удается, вам может потребоваться очистить кеш страницы (что можно сделать несколькими способами). Возможно, самый простой способ сделать это - щелкнуть редактировать на странице, на которой отображается шаблон, а затем щелкнуть Опубликовать изменения без каких-либо изменений - нет необходимости заполнять поле Сводка, поскольку не будет никакой истории этого. как произведенное изменение.
Могу ли я переместить шаблон под новое имя?
- Да, это работает точно так же, как и обычное перемещение страницы . Когда страница, которую требуется включить, является страницей перенаправления, вместо нее включается цель перенаправления.
Могу ли я использовать шаблон в шаблоне?
- Да.
Как мне добавить новый шаблон?
- Вы запускаете новый шаблон так же, как и обычную страницу. Единственное отличие состоит в том, что его название должно начинаться с
Template:
. Не забудьте задокументировать это, чтобы другие редакторы могли его использовать!
Где можно найти руководство по языку программирования, на котором пишутся шаблоны?
- Язык внутри шаблонов - тот же язык, что и обычная разметка вики, но авторы шаблонов склонны использовать более сложные доступные функции, такие как #if: statement. См. Справку Википедии : Шаблон и mw: Справка: Шаблон Викимедиа , включая все страницы справки "расширенного функционирования", перечисленные внизу этой страницы .
Примеры
- w: en: Template: stub : часто используемое сообщение (в англоязычной Википедии).
- w: en: Шаблон: Биологическая классификация : шаблон с параметрами (в англоязычной Википедии).
- b: en: Шаблон: GeneralChemTOC : горизонтальная строка меню (в англоязычных Викиучебниках ).
- w: en: Шаблон: Подводные работы : шаблон в виде простой таблицы с изображением (в англоязычной Википедии).
Справка по Википедии
- Справка: Шаблон (подробнее)
- m: Справка: Шаблоны (подробности из Викимедиа )
- m: Справка: Расширенные шаблоны (дополнительные сведения из Викимедиа)
- Википедия: пространство имен шаблонов (обычное пространство имен для шаблонов)
- Википедия: включение (включение шаблонов)
- Википедия: Подстановка (подстановочные шаблоны)
- Википедия: шаблоны сообщений (категоризованный список ссылок на доступные шаблоны)