WikiDer > Справка: краткое руководство по шаблонам - Википедия

Help:A quick guide to templates - Wikipedia

Викитекст

Это быстро обзор шаблонов. Полную информацию можно найти в Справка: шаблон и m: Справка: Расширенные шаблоны.

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

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

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

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

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

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

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

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

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

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

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

Параметры

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

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

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

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

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

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

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

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

Как я могу узнать, как использовать существующий шаблон?

Чтобы увидеть документацию по шаблону с именем «foo», перейдите в «Template: foo».

Могу ли я использовать шаблон более чем в одном проекте?

Нет, если вы хотите использовать его, например, в Википедии на двух разных языках, вам нужно будет создать его дважды.

В шаблонах учитывается регистр?

Да, кроме обычно первой буквы.

Как добавить параметры?

Видеть Справка: шаблон для инструкций.

Я редактировал шаблон, так почему же страница, на которой он используется, не изменилась?

Википедия и ваш компьютер веб-страница магазина тайники - или сохраненные копии - и не всегда показывают обновленную страницу. Сначала попробуйте обходить кеш вашего браузера нажав ⌘R, Ctrl + R или F5. Если это не поможет, вам может потребоваться удалять кеш страницы (что можно сделать несколькими способами). Возможно, самый простой способ сделать это - нажать редактировать на странице, на которой отображается шаблон, а затем нажав на Опубликовать изменения ничего не меняя - заполнять Резюме поле, так как не будет история этого как произведенное изменение.

Могу ли я переместить шаблон под новое имя?

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

Могу ли я использовать шаблон в шаблоне?

Да.

Как мне добавить новый шаблон?

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

Где находится руководство по языку программирования, на котором пишутся шаблоны?

Язык внутри шаблонов - тот же язык, что и обычная разметка вики, но авторы шаблонов склонны использовать более сложные доступные функции, такие как #if: statement. См. Википедию Справка: шаблон и Викимедиа mw: Справка: Шаблон, включая все справочные страницы с расширенными функциями, перечисленные в нижней части эта страница.

Примеры

Справка по Википедии