Compare Revisions
Как использовать шаблоны
Revision 57608:
Revision 57608 by Unghost on
Revision 183213:
Revision 183213 by Anticisco on
Keywords:
Search results summary:
Как использовать шаблоны
Как использовать шаблоны
Content:
Шаблоны представляют возможность использовать некоторые статьи Базы Знаний повторно. Вместо того чтобы создавать наборы инструменов снова и снова, вы можете создать и обновлять всего лишь один набор в определенном месте, чтоб затем ссылаться на него на других страницах. Изменения, внесенные в шаблон, будут автоматически отображаться на всех страницах, где был применен шаблон!
__TOC__
= Что такое шаблоны =
Шаблон представляет собой специальную вики страницу, имя которой начинается со слова "Template:". Данная страница обладает всеми свойствами обычной вики страницы: она может быть локализована, может содержать историю правок, а также воспринимать вики разметку.
{note}Перечень существующих Шаблонов может быть найден по следующей [/en-US/kb/category/60 '''ссылке'''].{/note}
=Как создать свой шаблон=
#[/en-US/kb/new Создайте новую статью Базы Знаний]. Попробуйте путем [https://support.allizom.org/en-US/kb/new создания новой статьи Базы Знаний на нашем тестовом сервере].
#Необходимо убедиться, что имя шаблона начинается со служебного слва "Template:" - например, [/en-US/kb/Template:aboutconfig Template:aboutconfig].
#Измените Категорию страницы на "Template".
#Продолжите править Шаблон как вы обычно правите любую другую статью Базы знаний.
= Как задействовать Шаблон в написании Статьи =
Для того чтобы использовать Шаблон при написании вики страницы, необходимо "сослаться" на ваш шаблон.
Например:
<code><nowiki>[[Template:Some Template]]</nowiki></code>
или
<code><nowiki>[[T:Some Template]]</nowiki></code>
Вместо создания простой ссылки, на странице появится содержание '''Template:Some Template''' шаблона. Форматирование шаблона будет использовано на странице.
=Шаблоны и нумерованные списки=
В большинстве случаев, использование нумерованных списков в шаблоне работает так же как и в любых других страницах Базы Знаний. Существует только одно важное исключение — '''если ваш шаблон является нумерованным списком, который будет использован как часть другого большего нумерованного списка, нумерация собъётся.'''
'''Временное решение:'''<br>
'''Не''' используйте знак "#" в любом из пунктов списка, а так же '''добавляйте''' <nowiki><li></nowiki> <nowiki></li></nowiki> по бокам второго и последующих пунктов списка, например так:
<code>Это первый пункт списка<br>
<nowiki><li></nowiki>Это второй пункт<nowiki></li></nowiki><br>
<nowiki><li></nowiki>Это третий пункт<nowiki></li></nowiki><br></code>
Когда вы добавляете шаблон в статью, необходимо поместить знак "#" перед шаблоном:
<code><nowiki>#</nowiki><nowiki>[[</nowiki>T:List]]<br>
<nowiki>#</nowiki>Данная строка не входит в список шаблона, но является нумерованной</code>
Это будет выглядеть следующим образом:
#Это первый пункт вашего списка
#Это второй строка
#А тут третий
#Тут идет пункт, который уже не является частью списка из шаблона
Также необходимо помнить, что вы не можете использовать [[How to use For#w_aaaailoi-i-gkailoi-jalaijaao|блочный уровень <nowiki>{</nowiki>for}]] в этих шаблонах. Например:<br>
'''Пример плохой разметки:'''<br>
<code><nowiki>{</nowiki>for not fx10}<br>
Первый пункт - Firefox 9 и ниже<br>
<nowiki>{</nowiki>/for}<br>
<nowiki>{</nowiki>for fx10}<br>
Первый пункт - Firefox 10 и выше<br>
<nowiki>{</nowiki>/for}<br>
<nowiki><li></nowiki>Это второй пункт<nowiki></li></nowiki></code>
'''Пример хорошей разметки:'''<br>
<code><nowiki>{</nowiki>for not fx10}Первый пункт - Firefox 9 и ниже<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for fx10}<br>
Первый пункт - Firefox 10 и выше<nowiki>{</nowiki>/for}<br>
<nowiki><li></nowiki>Это второй пункт<nowiki></li></nowiki></code>
= Применение аргументов в Шаблонах =
Шаблоны поддерживают аргументы, дающие вам возможность повторно использовать содержание, которое "почти" совпадает с тем что вы собираетесь написать.
Например, у вас есть стандартное предупреждение, которое оповещает пользователя о том, что этот документ относится только к Firefox 4, а другая версия документа применима только к Firefox 3.6. Текст данных предупреждений, в целом, идентичен, за исключением номера версий браузера. В этом случае очень удобно использовать шаблон!
'''Template:OnlyVersionX''':
{<!-- -->note}Данный документ или его раздел применим только к <nowiki>'''Firefox {{{1}}}'''</nowiki>!{<!-- -->/note}
На одной вики странице можно будет сослаться на шаблон таким образом:
<nowiki>[[Template:OnlyVersionX|4]]</nowiki>
На другой странице можно сделать следующее:
<nowiki>[[Template:OnlyVersionX|3.6]]</nowiki>
Можно применять несколько аргументов, либо один и тот же аргумент дважды!
'''Template:XLikesY''':
<pre><nowiki># {{{2}}} нравится {{{1}}}.
# {{{3}}} нравится {{{2}}}.
# Класс! Никому не нравится {{{2}}}!</nowiki></pre>
Затем применить шаблон следующим образом:
<nowiki>[[Template:XLikesY|Lisa|Milhouse|Janey]]</nowiki>
Результат будет следующий:
<blockquote>
# Milhouse нравится Lisa.
# Janey нравится Milhouse.
# Класс! Никому не нравится Milhouse!
</blockquote>
В один момент можно запутаться в этих цифрах в фигурных скобках, поэтому помимо цифр аргументу можно присвоить и ''имя''. Это будет происходить следующим образом:
'''Template:XPrecededY''':
Сначала приходит {{{first}}}, затем приходит {{{second}}}.
Затем вписать шаблон следующим образом:
<nowiki>[[Template:XPrecededY|first=любовь|second=брак]]</nowiki>
Таким образом, называв аргументы именами можно не беспокоиться, о порядке, в котором вы их используете:
<nowiki>[[Template:XPrecededY|second=брак|first=любовь]]</nowiki>
Оба примера использования '''Template:XPrecededY''' дадут одинаковые результаты.
Шаблоны представляют возможность использовать некоторые статьи Базы Знаний повторно. Вместо того чтобы создавать наборы инструменов снова и снова, вы можете создать и обновлять всего лишь один набор в определенном месте, чтоб затем ссылаться на него на других страницах. Изменения, внесенные в шаблон, будут автоматически отображаться на всех страницах, где был применен шаблон!
{warning}'''Локализаторы''': при локализации шаблонов не переводите название страницы - просто используйте оригинальный! Поэтому, если шаблон называется ''Template: browsersettings'', не переводите ни один из элементов имени - просто используйте ''Template: browsersettings'' в вашей локали. Это важно для правильной работы шаблонов.{/warning}
__TOC__
= Что такое шаблоны =
Шаблон представляет собой специальную вики страницу, имя которой начинается со слова "Template:". Данная страница обладает всеми свойствами обычной вики страницы: она может быть локализована, может содержать историю правок, а также воспринимать вики разметку.
{note}Перечень существующих Шаблонов может быть найден по следующей [/en-US/kb/category/60 '''ссылке'''].{/note}
=Как создать свой шаблон=
#[/en-US/kb/new Создайте новую статью Базы Знаний]. Попробуйте путем [https://support.allizom.org/en-US/kb/new создания новой статьи Базы Знаний на нашем тестовом сервере].
#Необходимо убедиться, что имя шаблона начинается со служебного слва "Template:" - например, [/en-US/kb/Template:aboutconfig Template:aboutconfig].
#Измените Категорию страницы на "Template".
#Продолжите править Шаблон как вы обычно правите любую другую статью Базы знаний.
= Как задействовать Шаблон в написании Статьи =
Для того чтобы использовать Шаблон при написании вики страницы, необходимо "сослаться" на ваш шаблон.
Например:
<code><nowiki>[[Template:Some Template]]</nowiki></code>
или
<code><nowiki>[[T:Some Template]]</nowiki></code>
Вместо создания простой ссылки, на странице появится содержание шаблона '''Template:Some Template'''. Форматирование шаблона будет использовано на странице.
=Шаблоны и нумерованные списки=
В большинстве случаев, использование нумерованных списков в шаблоне работает так же как и в любых других страницах Базы Знаний. Существует только одно важное исключение — '''если ваш шаблон является нумерованным списком, который будет использован как часть другого большего нумерованного списка, нумерация собъётся.'''
'''Временное решение:'''<br>
'''Не''' используйте знак "#" в любом из пунктов списка, а так же '''добавляйте''' <nowiki><li></nowiki> <nowiki></li></nowiki> по бокам второго и последующих пунктов списка, например так:
<code>Это первый пункт списка<br>
<nowiki><li></nowiki>Это второй пункт<nowiki></li></nowiki><br>
<nowiki><li></nowiki>Это третий пункт<nowiki></li></nowiki><br></code>
Когда вы добавляете шаблон в статью, необходимо поместить знак "#" перед шаблоном:
<code><nowiki>#</nowiki><nowiki>[[</nowiki>T:List]]<br>
<nowiki>#</nowiki>Данная строка не входит в список шаблона, но является нумерованной</code>
Это будет выглядеть следующим образом:
#Это первый пункт вашего списка
#Это второй строка
#А тут третий
#Тут идет пункт, который уже не является частью списка из шаблона
Также необходимо помнить, что вы не можете использовать [[How to use For#w_aaaailoi-i-gkailoi-jalaijaao|блочный уровень <nowiki>{</nowiki>for}]] в этих шаблонах. Например:<br>
'''Пример плохой разметки:'''<br>
<code><nowiki>{</nowiki>for not fx10}<br>
Первый пункт - Firefox 9 и ниже<br>
<nowiki>{</nowiki>/for}<br>
<nowiki>{</nowiki>for fx10}<br>
Первый пункт - Firefox 10 и выше<br>
<nowiki>{</nowiki>/for}<br>
<nowiki><li></nowiki>Это второй пункт<nowiki></li></nowiki></code>
'''Пример хорошей разметки:'''<br>
<code><nowiki>{</nowiki>for not fx10}Первый пункт - Firefox 9 и ниже<nowiki>{</nowiki>/for}<nowiki>{</nowiki>for fx10}<br>
Первый пункт - Firefox 10 и выше<nowiki>{</nowiki>/for}<br>
<nowiki><li></nowiki>Это второй пункт<nowiki></li></nowiki></code>
= Применение аргументов в Шаблонах =
Шаблоны поддерживают аргументы, дающие вам возможность повторно использовать содержание, которое "почти" совпадает с тем что вы собираетесь написать.
Например, у вас есть стандартное предупреждение, которое оповещает пользователя о том, что этот документ относится только к Firefox 4, а другая версия документа применима только к Firefox 3.6. Текст данных предупреждений, в целом, идентичен, за исключением номера версий браузера. В этом случае очень удобно использовать шаблон!
'''Template:OnlyVersionX''':
{<!-- -->note}Данный документ или его раздел применим только к <nowiki>'''Firefox {{{1}}}'''</nowiki>!{<!-- -->/note}
На одной вики странице можно будет сослаться на шаблон таким образом:
<nowiki>[[Template:OnlyVersionX|4]]</nowiki>
На другой странице можно сделать следующее:
<nowiki>[[Template:OnlyVersionX|3.6]]</nowiki>
Можно применять несколько аргументов, либо один и тот же аргумент дважды!
'''Template:XLikesY''':
<pre><nowiki># {{{2}}} нравится {{{1}}}.
# {{{3}}} нравится {{{2}}}.
# Класс! Никому не нравится {{{2}}}!</nowiki></pre>
Затем применить шаблон следующим образом:
<nowiki>[[Template:XLikesY|Lisa|Milhouse|Janey]]</nowiki>
Результат будет следующий:
<blockquote>
# Milhouse нравится Lisa.
# Janey нравится Milhouse.
# Класс! Никому не нравится Milhouse!
</blockquote>
В один момент можно запутаться в этих цифрах в фигурных скобках, поэтому помимо цифр аргументу можно присвоить и ''имя''. Это будет происходить следующим образом:
'''Template:XPrecededY''':
Сначала приходит {{{first}}}, затем приходит {{{second}}}.
Затем вписать шаблон следующим образом:
<nowiki>[[Template:XPrecededY|first=любовь|second=брак]]</nowiki>
Таким образом, называв аргументы именами можно не беспокоиться, о порядке, в котором вы их используете:
<nowiki>[[Template:XPrecededY|second=брак|first=любовь]]</nowiki>
Оба примера использования '''Template:XPrecededY''' дадут одинаковые результаты.