Help:Extension:TemplateWizard
Что такое TemplateWizard?
TemplateWizard — это расширение MediaWiki, которое создаёт контекстное меню для панели WikiEditor для вставки шаблонов в Вики-текст .
Как использовать TemplateWizard?
- Чтобы использовать TemplateWizard, откройте вики-страницу для редактирования с помощью редактора викитекста (не редактора викитекста 2017 года).
- Поместите курсор в то место, куда вы хотите вставить шаблон. Затем нажмите на иконку пазла в панели инструментов -
- Появится диалоговое окно
Как мне найти шаблон?
- Примечание: Описания будут только у шаблонов с TemplateData. Рекомендуется добавить TemplateData в шаблоны.
- Когда вы найдете нужный шаблон, щелкните по нему (или перейдите к нему с помощью клавиш со стрелками) и нажмите ↵ Enter. Это приведет вас к форме ввода данных.
This will take you to the data-entry form.
Как мне добавить данные в выбранный шаблон?
- 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 – система отслеживания ошибок и отсутствующих функций.