Как использовать шаблоны
Информация ревизии
- id ревизии: 56813
- Создано:
- Создатель: Whitebug
- Комментарий: Перевод
- Отрецензировано: Да
- Отрецензировано:
- Отрецензировано: Unghost
- Одобрено? Да
- Является текущей ревизией? Нет
- Готово для локализации: Нет
Источник ревизии
Содержимое ревизии
Шаблоны представляют возможность использовать некоторые статьи Базы Знаний повторно. Вместо того чтобы создавать наборы инструменов снова и снова, вы можете создать и обновлять всего лишь один набор в определенном месте, чтоб затем ссылаться на него на других страницах. Изменения, внесенные в шаблон, будут автоматически отображаться на всех страницах, где был применен шаблон!
Оглавление
Что такое шаблоны
Шаблон представляет собой специальную вики страницу, имя которой начинается со слова "Template:". Данная страница обладает всеми свойствами обычной вики страницы: она может быть локализована, может содержать историю правок, а также воспринимать вики разметку.
Как создать свой шаблон
- Create a new KB article. Попробовать можно тут creating a new KB article on our test server.
- Необходимо убедиться, что имя шаблона начинается со служебного слва "Template:" - например, Template:aboutconfig.
- Измените Категорию страницы на "Template".
- Продолжите править Шаблон как бы обычно правите любую статью Базы знаний.
Как задействовать Шаблон в написании Статьи
Для того чтобы использовать Шаблон при написании вики страницы, необходимо "сослаться" на ваш шаблон. Например:
[[Template:Some Template]]
or
[[T:Some Template]]
Вместо создания простой ссылки, на странице появится содержание Template:Some Template шаблона. Форматирование шаблона будет использовано на странице.
Шаблоны и нумированные списки
В большинстве случаев, использование нумированных списков в шаблоне работает так же как и в любых других страницах Базы Знаний. Существует только одно важное исключение — если ваш шаблон является нумерованным списком, который будет использован как часть другого нумерованного списка, нумирация шаблона собъется.
Временное решение:
Не используйте знак "#" в рассмотренных случаях, а так же добавляйте <li> </li> по бокам второго и последующих пунктов списка:
Это первый пункт списка
<li>Это второй пункт</li>
<li>Это третий</li>
Когда вы добавляете шаблон в статью, необходимо поместить знак "#" перед шаблоном:
#[[T:List]]
#Данная строка не входит в список шаблона, но является нумированной
Это будет выглядеть следующим образом:
- Это первый пункт вашего списка
- Это второй строка
- А тут третий
- Тут идет пункт, который уже не является частью списка из шаблона
Также необходимо помнить, что вы не можете использовать 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]]
Результат будет следующий:
- Milhouse likes Lisa.
- Janey likes Milhouse.
- 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 дадут одинаковые результаты.