Как использовать шаблоны

Информация ревизии
  • id ревизии: 56813
  • Создано:
  • Создатель: Whitebug
  • Комментарий: Перевод
  • Отрецензировано: Да
  • Отрецензировано:
  • Отрецензировано: Unghost
  • Одобрено? Да
  • Является текущей ревизией? Нет
  • Готово для локализации: Нет
Источник ревизии
Содержимое ревизии

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

Что такое шаблоны

Шаблон представляет собой специальную вики страницу, имя которой начинается со слова "Template:". Данная страница обладает всеми свойствами обычной вики страницы: она может быть локализована, может содержать историю правок, а также воспринимать вики разметку.

Перечень существующих Шаблонов может быть найден по следующей ссылке.

Как создать свой шаблон

  1. Create a new KB article. Попробовать можно тут creating a new KB article on our test server.
  2. Необходимо убедиться, что имя шаблона начинается со служебного слва "Template:" - например, Template:aboutconfig.
  3. Измените Категорию страницы на "Template".
  4. Продолжите править Шаблон как бы обычно правите любую статью Базы знаний.

Как задействовать Шаблон в написании Статьи

Для того чтобы использовать Шаблон при написании вики страницы, необходимо "сослаться" на ваш шаблон. Например:

[[Template:Some Template]] or [[T:Some Template]]


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

Шаблоны и нумированные списки

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

Временное решение:
Не используйте знак "#" в рассмотренных случаях, а так же добавляйте <li> </li> по бокам второго и последующих пунктов списка:

Это первый пункт списка
<li>Это второй пункт</li>
<li>Это третий</li>

Когда вы добавляете шаблон в статью, необходимо поместить знак "#" перед шаблоном:

#[[T:List]]
#Данная строка не входит в список шаблона, но является нумированной

Это будет выглядеть следующим образом:

  1. Это первый пункт вашего списка
  2. Это второй строка
  3. А тут третий
  4. Тут идет пункт, который уже не является частью списка из шаблона

Также необходимо помнить, что вы не можете использовать block level {for} в шаблонах. Например:
Пример плохой разметки:
{for not fx10}
Первый пункт - Firefox 9 и ниже
{/for}
{for fx10}
Первый пункт - Firefox 10 и выше
{/for}
<li>Это второй пункт</li>

Пример хорошей разметки:
{for not fx10}Первый пункт - Firefox 9 и ниже{/for}{for fx10}
Первый пункт - Firefox 10 и выше{/for}
<li>Это второй пункт</li>

Применение аргументов в Шаблонах

Шаблоны поддерживают аргументы, дающие вам возможность повторно использовать содержание, которое "почти" совпадает с тем что вы собираетесь написать.

Например, у вас есть стандартное предупреждение, которое оповещает пользователя о том, что этот документ относится только к Firefox 4, а другая версия документа применима только к Firefox 3.6. Текст данных предупреждений, в целом, идентичен, за исключением номера версий браузера. В этом случае очень удобно использовать шаблон!

Template:OnlyVersionX:

{note}Данный документ или его раздел применим только к '''Firefox {{{1}}}'''!{/note}


На вики странице можно будет сослаться на шаблон таким образом:

[[Template:OnlyVersionX|4]]

На другой странице можно сделать следующее:

[[Template:OnlyVersionX|3.6]]

Можно применять несколько аргументов, либо один и тот же аргумент дважды!

Template:XLikesY:

# {{{2}}} likes {{{1}}}.
# {{{3}}} likes {{{2}}}.
# Class! Nobody likes {{{2}}}!


Затем применить шаблон следующим образом:

[[Template:XLikesY|Lisa|Milhouse|Janey]]


Результат будет следующий:

  1. Milhouse likes Lisa.
  2. Janey likes Milhouse.
  3. Class! Nobody likes Milhouse!


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

Template:XPrecededY:

First comes {{{first}}}, then comes {{{second}}}.


Затем вписать шаблон следующим образом:

[[Template:XPrecededY|first=love|second=marriage]]


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

[[Template:XPrecededY|second=marriage|first=love]]


Оба примера использования Template:XPrecededY дадут одинаковые результаты.