Перейти к содержанию

Справка:Шаблоны

Материал из Хабадпедии
Редактирование статей

Руководства по редактированию

Добавление элементов на страницу:

Другое:

Шаблон (на английском: Template) — это метод редактирования в Хабадпедии, позволяющий отображать содержимое определённой страницы внутри другой страницы без необходимости копировать и дублировать содержимое между страницами. Шаблон — это страница, написанная с помощью (вики-синтаксиса), которую можно «вставить» в любую страницу Хабадпедии и которая отображается как есть в реальном времени. Использование шаблона сосредотачивает текст в одном месте, предотвращает дублирование, облегчает внесение обновлений и изменений на многих страницах одновременно и сохраняет единообразие страниц Хабадпедии.

Использование этого метода похоже на создание ссылки, но вместо того, чтобы добавлять две пары квадратных скобок с обеих сторон слова ([[ и ]]), нужно использовать две пары фигурных скобок ({{ и }}). Таким образом можно скопировать содержимое любой страницы в любом пространстве имён, но принято копировать страницы из пространства «Шаблон», созданного для этой цели. Нижеследующие объяснения основаны на использовании этого пространства имён. Об использовании этого метода для страниц других типов см. ниже.

Создание нового шаблона

Обратите внимание: для создания нового шаблона в Хабадпедии и для внесения существенного изменения в существующий шаблон служит страница Хабадпедия:Шаблон/Зал обсуждений. Прежде чем открывать обсуждение, рекомендуется посоветоваться о существовании шаблона или о необходимости нового шаблона на странице Хабадпедия:Справочный стол.

Техническое объяснение

Создание шаблона
Шаблон — это один из типов страниц, существующих в Хабадпедии: чтобы создать новый шаблон, нужно создать новую страницу, в которую будет внесено содержимое шаблона (см. объяснение по ссылке). Шаблон находится в пространстве имён «Шаблон:».
Включение шаблона в статью
На любой другой странице, куда вы хотите добавить (содержимое) шаблона, напишите в нужном месте текст {{שם התבנית הרצויה}}. Содержимое, которое вы внесли в шаблон, появится там в предварительном просмотре или после сохранения страницы.

Пример: если хотят написать шаблон под названием «חדש», нужно написать:

[[תבנית:חדש]]

После записи получаем следующий результат:

Шаблон:Новый

Нажатие на ссылку откроет новую страницу редактирования. Её нужно редактировать, как любую обычную страницу, и сохранить по окончании редактирования.

В каждом месте, куда хотят добавить шаблон, нужно написать текст: :{{חדש}}

Основные принципы проектирования шаблонов

  • Для создания нового шаблона в Хабадпедии или для внесения существенного изменения в существующий шаблон служит страница «Хабадпедия:Шаблон/Зал обсуждений».
  • Прежде чем открывать обсуждение, рекомендуется посоветоваться о существовании такого шаблона или о необходимости нового шаблона на странице «Хабадпедия:Справочный стол».
  • Как правило, навигационные шаблоны будут вноситься в пространство статей только тогда, когда от них есть польза для навигации, поэтому шаблон, в котором нет хотя бы 5 существующих (синих) статей, не будет отображаться в пространстве статей. Кроме того, они должны соответствовать правилам Хабадпедия:Петля темы.
  • Для параметров, распространённых во многих шаблонах, принято использовать одинаковые названия, чтобы облегчить работу редакторам и обеспечить единообразное использование, например:
    • תמונה, כיתוב תצלום, צילום מסך, תמונה מייצגת, כיתוב, כותרת תמונה, תיאור תמונה
    • סמל, כיתוב סמל לוגו, סמליל, תמונה, כיתוב, כיתוב לוגו
    • מפה, כיתוב מפה תצלום, תמונה, כיתוב, כותרת מפה, תיאור מפה
  • Рекомендации, касающиеся включения данных из Викиданных — и в особенности нужно давать возможность локально переопределять поля, берущиеся из Викиданных.
  • В навигационных шаблонах, которые принято включать внизу статей, принято использовать Шаблон:Навигация или Шаблон:Навигация по группам, которые позволяют достичь единообразия во внешнем виде навигации и дают чёткую рамку, создающую ясное различие между шаблоном и содержимым статьи.

После создания шаблона

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

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

Чтобы узнать, как добавить категорию только на страницы, в которые включён шаблон, нажмите на ссылку.

Сводка процесса

Примечание – это рекомендуемый порядок этапов. Не обязательно следовать установленному порядку, но для утверждения использования шаблона нужно получить одобрение в зале шаблонов.

  1. Проверка необходимости — справочный стол
  2. Предложение в Хабадпедия:Шаблон/Зал обсуждений – обязательно (важное замечание – для открытия обсуждения не обязательно нужны технические знания. Обсуждение предназначено для решения проблемы)
  3. Создание технического решения (желательно сначала на странице черновика или на подстранице)
  4. Документация для участников и других редакторов
  5. Подготовка к широкому использованию – адаптация к системе проверки параметров
  6. Обеспечение доступности шаблона – адаптация к мастеру шаблонов, публикация на соответствующих страницах

Различные способы добавления шаблона на страницу и ссылки на него

Ссылка вида {{שם התבנית הרצויה}} вставит содержимое шаблона на страницу, тогда как ссылка вида [[תבנית:שם התבנית הרצויה]] будет внутренней ссылкой, ведущей на страницу шаблона.

Копирование исходного кода шаблона

Добавление надписи ס: перед названием шаблона (или названием страницы, когда оно заключено в фигурные скобки) приводит к копированию страницы целиком со страницы-источника, однократно и без обновления, так что при повторном просмотре страницы редактирования невозможно будет узнать, что использовался какой-либо шаблон. Например, если взять шаблон {{@}}, добавление ס: будет выглядеть так:

{{ס:@}}

А результат будет выглядеть так:

-at-

А код во время редактирования будет выглядеть так:

[[קובץ:@@@.svg| -at- |link=|13px]]

Чтобы проиллюстрировать идею, можно зайти в песочницу, добавить туда шаблон {{@}}, а затем сохранить страницу. Этот шаблон добавляет небольшое изображение в виде знака «@». Если мы снова откроем песочницу для правки, то найдём добавленный нами текст (то есть название шаблона) без изменений. Теперь добавим ס: после фигурных скобок и перед названием шаблона (в данном случае название шаблона — «@») и сохраним страницу во второй раз. Страница по-прежнему отображается и выглядит без изменений, однако если мы снова войдём в режим редактирования страницы, то обнаружим, что сохранённый текст изменился, и теперь появляется сам текст, который вызывает появление изображения, – текст, который находится в исходном коде на странице шаблона {{@}}.

Этой возможностью можно пользоваться в случаях, когда нет необходимости снова обновлять текст и вся цель – сэкономить действие «копировать-вставить». Массовое использование ס: там, где нет необходимости в обновляемом шаблоне, может уменьшить нагрузку на серверы Хабадпедии. С другой стороны, недостаток – отсутствие динамичности у этой функции: если на странице шаблона будет произведена правка, изменение не отразится (не обновится) на странице, куда был скопирован шаблон. Поэтому использовать эту функцию в навигационных шаблонах в статьях не рекомендуется.

Существует также небольшое число шаблонов, которые требуют использования этой возможности, например {{הבהרת חשיבות}} или {{ציר זמן}}, — без использования этой возможности они не будут отображаться должным образом.

Исходное иностранное название ס: — subst:.

Сравнение

Ниже приводится сравнение обычного шаблона и шаблона с префиксом ס::

Способ записи Отображение при просмотре Вид страницы редактирования

{{אחרי התנגשות}}

Добавил после конфликта правок —

{{אחרי התנגשות}}

{{ס:אחרי התנגשות}}

Добавил после конфликта правок —

<span style="font-size: 75%">הוספתי לאחר התנגשות עריכה -</span>

Страницы-перенаправления

Как только создают страницу-перенаправление с одного шаблона на другой шаблон, Хабадпедия будет обращаться к шаблону, являющемуся целью страницы-перенаправления. Например, запись шаблона {{עריכה}} или шаблона {{לעריכה}}, перенаправляющего на него, приведёт к одному и тому же результату.

Использование обычной страницы как шаблона

Любую страницу можно использовать так, как если бы она была шаблоном, посредством Заключение его названия в две фигурные скобки и добавление : (двоеточия) перед названием:

{{:שם ערך}}

Например, если вы хотите скопировать всё содержимое статьи «Иврит» на определённую страницу, напишите на целевой странице текст:

{{:עברית}}

Обратите внимание на знак двоеточия ( : ), стоящий перед названием статьи («Иврит», в данном случае). Если в статье «Иврит» будет произведено изменение, изменение отразится (обновится) автоматически и на целевой странице, без того чтобы в ней было сделано какое-либо изменение.

Подобным образом можно копировать содержимое других страниц, которые не находятся в основном пространстве (пространстве статей). Например, чтобы скопировать всё содержимое страницы справочного стола на определённую страницу, нужно написать на ней следующий текст:

{{חב"דפדיה:דלפק יעוץ}}

Обратите внимание, что в этом случае не было добавлено двоеточие перед словом «Хабадпедия:». Подобным образом можно копировать тексты из других пространств имён, таких как «Участник:», «Категория:», «Обсуждение Хабадпедии:» и тому подобное.

Включение подстраницы в родительскую страницу

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

Например, чтобы включить в страницу «Шаблон:Навигация по группам» содержимое подстраницы «Шаблон:Навигация по группам/Инструкция по использованию», достаточно написать в ней:

{{/הוראות שימוש}}

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

Мастер шаблонов

Основная статья – Справка:Мастер шаблонов

Один из самых простых способов добавить (сложный) шаблон на какую-либо страницу — с помощью «Мастера шаблонов»; в особенности если к шаблону добавлены специальная документация и поддержка для мастера (см. «Мастер шаблонов» в разделе «Документация шаблона»):

  • Чтобы воспользоваться мастером, находясь в режиме редактирования, нужно нажать на кнопку на верхней панели инструментов. Мастер откроет окно, позволяющее ввести название нужного шаблона из списка. После нажатия на «Подтвердить» вы попадёте в сам мастер.
  • Либо можно выделить весь шаблон, включая все уже заполненные в нём параметры. Мастер соберёт эти значения со страницы, заполнит соответствующие поля и покажет вам мастер.

Дополнительные сведения можно прочитать в основной статье.

Редактирование шаблона

Существующий шаблон можно отредактировать, найдя страницу шаблона и нажав «Править код» вверху страницы, как и любую страницу, открытую для редактирования в Хабадпедии.

Ещё один способ редактирования шаблона – редактирование страницы, содержащей шаблон: под областью редактирования (под кнопками сохранения и предварительного просмотра) нажатие на заголовок «Шаблоны, используемые на этой странице:» откроет список всех шаблонов, встречающихся на странице (в том числе тех, которые не включены и не написаны явно на странице! То есть шаблонов, находящихся внутри кода шаблонов, написанных на странице).

Обратите внимание: следует учитывать, что внесение изменения в существующий шаблон повлияет на многие страницы, поэтому нужно хорошо убедиться, что изменение не нарушает отображение шаблона или его работу!

Специальные знаки

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

Знак Способ записи в шаблоне
:
&#58;
;
&#59;
*
&#42;
#
&#35;

Знак | (вертикальная черта) разделяет параметры в шаблоне (см. ниже). Когда нужно добавить этот знак в содержимое шаблона, вместо него следует написать сочетание {{!}}. Пример: чтобы включить в шаблон текст «האולימפיאדה || מדליית זהב לספורטאי ישראלי», нужно написать האולימפיאדה {{!}}{{!}} מדליית זהב לספורטאי ישראלי.

Ещё один способ – использовать тег <nowiki>XXXXX</nowiki>, так:Олимпиада <nowiki>||</nowiki> золотая медаль израильскому спортсмену.

Когда в содержимое шаблона входит знак =, его нужно писать в виде {{=}}.

Определение параметров шаблона

Можно создавать простые шаблоны, включающие заданный постоянный текст, без возможности участника влиять на их содержимое и способ их отображения. Более продвинутая возможность – создавать шаблоны с параметрами, для более общего использования, на содержимое или оформление которых можно по-разному влиять на каждой странице, где появляется шаблон (точнее – в каждом «вхождении» шаблона, поскольку один и тот же шаблон может использоваться и появляться несколько раз на одной странице). Способ создания параметрического шаблона идентичен созданию обычного шаблона, и поэтому нужно выполнить все шаги, описанные в разделе «Создание нового шаблона». Существуют два типа параметров: именованный параметр и нумерованный параметр.

Именованный параметр

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

Обратите внимание: добавление двух фигурных скобок приведёт к созданию ещё одного нового шаблона, поэтому за этим нужно следить и тщательно считать количество скобок). Пример формы записи параметра:

{{{שם הפרמטר}}}

Использование параметра на целевой странице будет производиться в следующем порядке:

  1. Две открывающие фигурные скобки (правые) (}})
  2. Название шаблона
  3. Символ-разделитель — вертикальная черта (|)
  4. Название параметра
  5. Знак равенства (=)
  6. Значение параметра
  7. Две закрывающие фигурные скобки (левые) ({{)

Для каждого дополнительного параметра нужно повторить шаги 3–6.

Пример синтаксиса шаблона с тремя параметрами:

{{שם תבנית|פרמטר1=ערך1|פרמטר2=ערך2|פרמטר3=ערך3}}

Практический пример шаблона с двумя параметрами:

{{חדש|תמונה=פרפר.jpg|שם=משפחת הפרפרים}}

Приведённый выше текст можно развернуть и вертикально — в случае, когда параметров много или их значения длинные, — чтобы улучшить читаемость кода и облегчить ориентацию в нём. Это никак не влияет на результат и на окончательный вид шаблона. Рекомендуется следить за тем, чтобы разделительные черты (|) располагались в начале каждой строки параметра. Пример синтаксиса:

{{שם תבנית
|פרמטר1=ערך1
|פרמטר2=ערך2
|פרמטר3=ערך3
}}

Нумерованный параметр

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

{{{1}}}

В шаблоне, в котором есть параметры {{{1}}}, {{{2}}} и {{{3}}}, обычная форма записи на целевой странице (за исключением особых случаев (см. ниже)) не будет:

{{שם התבנית|1=ערך1|2=ערך2|3=ערך3}}

а так:

{{שם תבנית|ערך1|ערך2|ערך3}}

Например:

{{חדש|פרפר.jpg|משפחת הפרפרים}}

Недостаток использования такого шаблона в том, что при большом количестве параметров трудно запомнить назначение и правильное место каждого параметра, и легко перепутать порядок. С другой стороны, такой шаблон быстрее в использовании (нужно набирать меньше символов) и избавляет от лишней «бюрократии». Рекомендуется использовать эту форму только тогда, когда используются немногочисленные параметры. Ещё один недостаток использования нумерованных параметров — невозможно ввести знак равенства (=). Например, в шаблоне {{חדש|פרפר.jpg|משפחת הפרפרים=butterfly family}} нет именованных параметров, однако шаблон воспримет «משפחת הפרפרים» как название параметра, а «butterfly family» — как введённое в него значение, но, разумеется, не найдёт параметра с названием «משפחת הפרפרים» и выдаст сообщение об ошибке. Чтобы обойти эту проблему, можно вместо знаков равенства ввести следующий код:

&#61;

Или использовать шаблон с названием «=»:

{{=}}

В качестве альтернативы можно обращаться с нумерованным параметром так, как если бы он был именованным параметром, и указывать его явно при использовании шаблона: {{חדש|פרפר.jpg|‏2=משפחת הפרפרים = butterfly family}}

В одном шаблоне можно сочетать именованные и нумерованные параметры вместе. Например:

{{שם תבנית|חיה=חתול|2=שחור|מין=זכר|מבוית}}

Задание значения по умолчанию для параметра

Для параметра можно задать значение по умолчанию, так что если в параметр не будет введено значение, появится текст по умолчанию. Чтобы задать значение по умолчанию для какого-либо параметра, например для {{{שם הסרט}}}, нужно добавить вертикальную черту (|) после названия параметра, а за ней — текст по умолчанию следующим образом:

{{{שם הסרט|טקסט ברירת מחדל}}}

Распространённый пример использования значения по умолчанию — использование постоянных системных шаблонов, таких как {{שם הדף בלי הסוגריים|}}, возвращающий название страницы. Код:

{{{שם הסרט| {{שם הדף בלי הסוגריים|}} }}}

Позволяет редакторам заполнить название фильма, а если этот параметр остался пустым, вместо параметра будет использовано название страницы (без скобок).

Проверка наличия параметра

Основная статья – Справка:Условные операторы#Условие

Чтобы проверить, был ли шаблону передан параметр, можно произвести проверку с помощью следующего условного оператора:

{{#if: {{{param|}}} | Hooray...! | Darn...! }}

Результат: Darn...!

Или на иврите:

{{#תנאי: {{{פרמטר|}}} | יש ערך...! | אין ערך...! }}Результат: אין ערך...!

В первом параметре получаем результат, когда значение есть, а во втором — когда значения нет.

Изменение параметров в существующем шаблоне

Обратите внимание: если в существующем шаблоне изменяют число параметров или изменяют их порядок, изменение проявится на всех страницах, в которые шаблон был вставлен до изменения, и это может привести к непредвиденным и нежелательным результатам, таким как: вырывание вещей из контекста, появление лишнего текста, нарушения в компоновке шаблона и текста и даже ошибка и полное неотображение шаблона. Стоит серьёзно обдумать это во время изменения шаблона, и тем самым можно предотвратить проблему прежде, чем она возникла. Согласно правилам Хабадпедии, также требуется посоветоваться об этом на странице Хабадпедия:Шаблон/Зал обсуждений.

Задание шаблона в качестве параметра

Если есть параметры, повторяющиеся в нескольких шаблонах, или технически сложная часть (например, карта местоположения), можно создать новый шаблон, который будет служить параметром и тем самым облегчит работу пользователям шаблона. Новый шаблон фактически является модулем, своего рода «чёрным ящиком», в который можно вставлять параметры, и пользователям не важно, как он работает. Шаблон, принимающий шаблон в качестве параметра, называется модульным шаблоном (например: модульный шаблон {{משגר}} с модулем {{שלב במשגר}}).

Содержимое, которое будет отображаться только на странице шаблона или только на страницах, содержащих шаблон

Содержимое, которое будет отображаться только на странице шаблона

Иногда нужно, чтобы определённое содержимое отображалось только на странице шаблона, а не на страницах, содержащих его (например, объяснения по использованию шаблона, категория шаблона, интервики-ссылки или голосование за удаление шаблона). В этих случаях нужно использовать тег <noinclude> (на иврите: не/не включай) следующим образом:

<noinclude>Содержимое, которое отображается только в шаблоне, а не на страницах, содержащих его.</noinclude>

Обратите внимание: при использовании тега <noinclude> следует убедиться, что он расположен вплотную к последнему символу, который должен быть включён в страницы, содержащие шаблон. Например, размещение тега <noinclude> после перевода строки приведёт к включению лишней пустой строки в страницы, содержащие шаблон, и может даже вызвать проблемы вёрстки между текстом статьи и таблицей, взятой из шаблона.

Скрытый комментарий в шаблоне

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

<noinclude><!-- текст примечания --></noinclude>

И это для того, чтобы предотвратить включение скрытого текста (предназначенного для программиста) при каждом встраивании шаблона в страницы Хабадпедии.

Содержимое, которое будет отображаться только на страницах, содержащих шаблон

Иногда нужно обратное положение: чтобы определённое содержимое отображалось или включалось в страницы, содержащие шаблон, но не на самой странице шаблона (например, категории обслуживания – нет необходимости, чтобы сам шаблон появлялся в списке страниц, которые нужно обслуживать, а только страницы, в которые он добавлен (для этого можно воспользоваться также шаблоном: {{קטגוריה בתבנית}})). В этих случаях нужно использовать тег <includeonly> (на иврите: включай только) следующим образом:

<includeonly>Содержимое, которое не отображается на странице шаблона, но отображается на страницах, содержащих его.</includeonly>

Рекомендация: как правило, поскольку страницу шаблона принято открывать сразу кодом шаблона (до документации и инструкций по использованию), рекомендуется начинать всякую запись шаблона с тега <includeonly>.

Проверка влияния изменений в шаблоне на другие страницы ещё до его сохранения

Иногда, а может быть, даже в большинстве случаев, рекомендуется быть осторожными и проверять, как изменения, внесённые в шаблон, влияют и отражаются на разных страницах Хабадпедии (включая саму страницу шаблона, которая должна содержать документацию шаблона и показывать примеры, использующие его). Для этого в Хабадпедии разработаны два инструмента, помогающие проверить код шаблона до его сохранения:

  1. Предварительный просмотр страницы с этим шаблоном — новая возможность, добавленная при редактировании страниц в пространстве шаблонов и появляющаяся внизу страницы редактирования (под обычными кнопками сохранения). Эта возможность — самая простая и быстрая из двух.
  2. Песочница шаблонов — это служебная страница, позволяющая проверять шаблоны, сохранённые в личном черновике участника. Эта возможность сложнее, но особенно полезна для проверки изменений во многих шаблонах одновременно.

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

Дополнительные сведения и инструкции по использованию также и второго инструмента см. в основной статье: «Справка:Песочница для шаблонов».

Таблицы

Этот раздел неполон. Пожалуйста, внесите вклад в Хабадпедию и дополните его. Возможно, подробности об этом есть на странице обсуждения. Причина: приведённые примеры слишком сложны. Нужно добавить к каждой строке объяснение её составных частей и их назначения.
Основная статья – Справка:Таблицы

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

{{{שם הסרט}}}
Жанр {{{ז'אנר}}}
Длина {{{אורך}}}
Дата выхода {{{תאריך השקה}}}
{{{אתר אינטרנט}}}

Таблица использует два основных средства: шаблон {{!}}, который отображает вертикальную черту (|), и условный оператор вида {{#תנאי:הפרמטר לבדיקה|מה לכתוב אם הפרמטר קיים|מה לכתוב אם הפרמטר אינו קיים}} (см. раздел «Проверка наличия параметра»).

Покажем на примере, как построить упорядоченную таблицу: мы хотим создать таблицу слева для статей о фильмах. Как видно, в этой таблице отображаются все ячейки. Теперь изменим все параметры, кроме параметра «название фильма», так, чтобы, если они будут пустыми, их строка вообще не отображалась.

• Для каждой строки, в которой два столбца, нужно использовать следующий код:

{{#תנאי:{{{פרמטר|<noinclude>-</noinclude>}}} |
{{!}} פרמטר
{{!}} {{{פרמטר}}}
{{!}}-
}}

При этом надпись «параметр» нужно заменить названием параметра.

• В последней строке, с параметром «אתר אינטרנט», есть только один столбец, содержимое которого выровнено по центру. Для строк такого типа используем следующий код:

{{#תנאי:{{{פרמטר|<noinclude>-</noinclude>}}} |
{{!}} colspan="2" סגנון {{!}} {{{פרמטר}}}
{{!}}-
}}

При этом надпись «параметр» нужно заменить названием параметра, а надпись «стиль» — нужным стилем; в нашем случае — выравниванием по центру.

• Наконец, что касается первого параметра, используем значение по умолчанию, так что если название фильма не задано, мы используем вместо него название статьи. Полный код для этого примера и его результат – ниже:

{| class="wikitable" align="right"
! colspan="2" | {{{שם הסרט| {{שם הדף בלי הסוגריים|}} }}}
{{!}}-
{{#תנאי:{{{ז'אנר|<noinclude>-</noinclude>}}} |
{{!}} ז'אנר
{{!}} {{{ז'אנר}}}
{{!}}-
}}
{{#תנאי:{{{אורך|<noinclude>-</noinclude>}}} |
{{!}} אורך
{{!}} {{{אורך}}}
{{!}}-
}}
{{#תנאי:{{{תאריך השקה|<noinclude>-</noinclude>}}} |
{{!}} תאריך השקה
{{!}} {{{תאריך השקה}}}
{{!}}-
}}
{{#תנאי:{{{אתר אינטרנט|<noinclude>-</noinclude>}}} |
{{!}} colspan="2" style="text-align: center;" {{!}} {{{אתר אינטרנט}}}
}}
|}
Шаблоны
Жанр {{{ז'אנר}}}
Длина {{{אורך}}}
Дата выхода {{{תאריך השקה}}}
{{{אתר אינטרנט}}}

Если вы используете этот код внутри шаблона, а затем используете этот шаблон, то увидите, что если не заполнить параметры «жанр», «продолжительность», «дата выхода» и «веб-сайт», их строка не будет отображаться. «Живой» пример такого использования можно найти в шаблоне {{סרט}}. Обратите внимание, что в этом шаблоне во всех ячейках используются стили (у всех ячеек пунктирная верхняя граница).

Проверка параметров

Основная статья – Хабадпедия:Система проверки параметров

Хабадпедия:Система проверки параметров позволяет добавить к шаблону описание параметров, которые он ожидает получить, и таким образом обнаруживать неверное использование шаблона (неправильное число параметров, пропуск параметра, о котором обязательно сообщать, и др.).

Обновления шаблонов, категорий и связанных страниц

Иногда при обновлении шаблонов могут возникнуть три неполадки:

  1. Шаблоны, особенно если это шаблоны, включённые в шаблоны, не обновляются.
  2. Страница появляется в категориях, из которых она была удалена.
  3. Страница появляется в списке страниц, ссылающихся на страницу или на изображение, ссылка на которые была удалена из шаблона. Это также приводит к тому, что невозможно узнать, насколько на самом деле используются устаревшие изображения, такие как Stop hand.png.

Проблема возникает в результате необновления необходимых списков.

Она будет решена после того, как будет произведена ещё одна правка страницы, а если вы не хотите ждать, откройте страницу редактирования, ничего не меняйте в тексте и отправьте её. Ваше изменение не должно появиться в истории страницы, но оно должно исправить проблему. А если возникнет проблема, в крайнем случае вы откатите (или другие откатят) вашу правку, но статья всё равно обновится.

Документация шаблона

Неотъемлемая часть создания шаблона — его документация, ведь без документации не будут знать, как им пользоваться. Эта проблема обостряется, чем сложнее шаблон (как правило, в зависимости от количества параметров в нём). Если вы столкнулись с шаблоном без документации, можно спросить на странице обсуждения шаблона или обратиться к создателю шаблона (ищите его имя на странице «Предыдущие версии») с просьбой написать документацию.

Документация делится на документацию для программиста, объясняющую код и встроенную в него в виде скрытых комментариев (см. раздел «Скрытый комментарий в шаблоне»), и документацию для («простого») пользователя шаблона, описывающую и демонстрирующую различные способы его использования.

Принятый способ – создать подстраницу под названием Шаблон:Название шаблона/Документация и в ней объяснить, для чего предназначен шаблон, способ его использования и так далее.

На самой странице шаблона нужно добавить под тегом noinclude (который обычно уже существует) и в нём добавить {{תיעוד}}.

В качестве части объяснения можно использовать теги «<code>» и «<nowiki>» (ищите сведения на странице «Справка:Вики-синтаксис»), чтобы продемонстрировать различные способы использования шаблона, как это сделано на этой странице. Можно также воспользоваться шаблоном {{אופן השימוש}}.

Желательно разместить

Хабадпедия:Букмарклеты

Шаблон, адаптированный для использования в букмарклетах, рекомендуется отметить в документации с помощью шаблона {{יש בוקמרקלט}}, и так же поощрять использование букмарклетов.

См. также

Сообщить об ошибке на этой странице