Help:Extension:TemplateWizard
Что такое TemplateWizard?
TemplateWizard — это расширение MediaWiki, которое создаёт контекстное меню для панели WikiEditor для вставки шаблонов в Викитекст .
Как использовать TemplateWizard?
- Чтобы использовать TemplateWizard, откройте вики-страницу для редактирования с помощью редактора викитекста (не редактора викитекста 2017 года).
- Поместите курсор в то место, куда вы хотите вставить шаблон. Затем нажмите на иконку пазла
в панели инструментов -
- Появится диалоговое окно
Как мне найти шаблон?
There are the following ways to find a template:
- searching for it through the search box
- select from your favourites list
- browse the template categories
For details see the template discovery documentation .
- Примечание: Описания будут только у шаблонов с TemplateData. Рекомендуется добавить TemplateData в шаблоны.
- Когда вы найдете нужный шаблон, щелкните по нему (или перейдите к нему с помощью клавиш со стрелками) и нажмите ↵ Enter. Это приведет вас к форме ввода данных.
This will take you to the data-entry form.
- If you use a template often, and have previously favourited it, you can select it from the list of your favourited templates, which can be found in the
Избранное
tab below the search field.
Как мне добавить данные в выбранный шаблон?
- The title bar of the dialog window shows a 'back' button
with which to close the template form and return to search.
- Below that is the top bar, which contains the template title, description, and a link
to the template's wiki page.
- Слева находится список параметров, разделенный на три части: обязательные, рекомендуемые и необязательные параметры. В нижней части этой области также есть кнопка, с помощью которой можно добавить или удалить все необязательные поля одновременно. Обратите внимание, что некоторые шаблоны не имеют параметров, и в этих случаях здесь ничего не будет указано. Когда вы нажимаете на параметр шаблона, он добавляется справа.
- Форма справа, содержащая фактические поля ввода данных, в которые вы вставляете значения, которые будут добавлены в викитекст. В области редактирования будут вставлены только перечисленные здесь параметры (включая те, которые не содержат значения, поскольку шаблоны могут рассматривать это иначе, чем параметр, отсутствующий вообще).
- Вы можете нажать на значки информации над полями шаблона, чтобы прочитать больше информации о них.
- TemplateWizard наиболее эффективно работает с шаблонами, в которых определены TemplateData: т. е. Их параметры были задокументированы подробным и структурированным образом, включая значения по умолчанию и т.д. (информация о том, как это сделать, находится на страницах справки TemplateData). Он также работает "без" определений TemplateData, хотя и с несколько ограниченной функциональностью. Эти два режима описаны в следующих двух разделах.
Использование TemplateWizard вместе с TemplateData
Существует семь различных типов полей, используемых в мастере шаблонов, в зависимости от типа параметра, определенного в TemplateData.
Название[fn 1] | Тип[fn 2] | Используется поле | Примечания | |
---|---|---|---|---|
1. | Число | number |
NumberInputWidget | |
2. | Дата | date |
DateInputWidget | |
3. | Участник | wiki-user-name |
UserInputWidget | |
4. | Страница | wiki-page-name |
TitleInputWidget | Для любого названия страницы (включая файлы). |
5. | Файл | wiki-file-name |
TitleInputWidget | Ограничено названиями в пространстве имён Файл и отображает миниатюры изображений. |
6. | Шаблон | wiki-template-name |
TitleInputWidget | Ограничено названиями а пространстве имён Шаблон. |
7. | Что-то другое | TextInputWidget | Все остальные типы будут отображаться как стандартные входные данные для ввода текста и будут принимать любой текст. | |
Сам TemplateData поддерживает больше типов полей, чем перечислено выше. Некоторые из них могут быть добавлены в T200664.
Использование TemplateWizard вместе с TemplateData
Если в шаблоне "нет" каких-либо TemplateData, то будет предпринята попытка угадать названия его параметров, и они будут представлены в виде стандартных полей формы ввода текста с надписями по мере их угадывания.
Обратите внимание, что в этом списке, вероятно, будут дублированные, устаревшие или отсутствующие параметры, поскольку авторы шаблонов будут делать такие вещи, как следующее, чтобы разрешить различные формы имени параметра: {{{полное имя|{{{{Полное имя}}}}}}}
(обратите внимание на разницу в регистре букв)
Обычно для параметра существует предпочтительная форма, и ее можно найти, только просмотрев документацию по шаблону (и, пока вы там, возможно, добавьте TemplateData, чтобы другие люди не запутались в будущем!).
Как мне вставить шаблон?
Когда вы добавили все желаемые параметры к форме шаблона и дали им их значения (включая вообще никакое значение, если вам нужен пустой параметр), нажмите кнопку "Отправить" в правой части диалогового окна, и шаблон wikitext будет вставлен в текущем месте курсора в поле редактирования главной страницы.
Текст шаблона будет вставлен в соответствии с параметром format, определенным в TemplateData; если он не задан, то будет использоваться "встроенный" формат. Невозможно создать другой пользовательский формат для одного шаблона (но, конечно, вики-текст шаблона всегда можно отредактировать после вставки).
Смотрите также
- Help talk:Extension:TemplateWizard – форум помощи продвинутым пользователям по расширению.
- Расширение:TemplateWizard – основная страница расширения, предназначенная для администраторов и разработчиков.
- Phabricator:tag/TemplateWizard – система отслеживания ошибок и отсутствующих функций.