Help:Extension:TemplateWizard
Что такое TemplateWizard?
TemplateWizard — это расширение MediaWiki, которое создаёт контекстное меню для панели WikiEditor для вставки шаблонов в Вики-текст .
Как использовать TemplateWizard?
Как мне найти шаблон?
- Start typing a template's name, and you will be presented with a list of templates to choose from.
- Note: Only templates which have TemplateData will have descriptions. You are encouraged to add TemplateData to templates.
- When you find the template you're looking for, click on it (or navigate to it with your arrow keys) and press ↵ Enter. This will take you to the data-entry form.
Как мне добавить данные в выбранный шаблон?
- Верхняя панель, которую вы теперь видите, содержит заголовок шаблона, описание, ссылку на вики-страницу шаблона и кнопку закрытия , чтобы закрыть форму шаблона и вернуться к поиску.
- The left-side list of parameters, divided into up to three parts for required, suggested, and optional parameters. This area also has a button at the bottom with which to add or remove all non-required fields at once. Note that some templates have no parameters, and in these cases nothing will be listed here. When you click on a template parameter, it gets added to the right side.
- Форма справа, содержащая фактические поля ввода данных, в которые вы вставляете значения, которые будут добавлены в викитекст. В области редактирования будут вставлены только перечисленные здесь параметры (включая те, которые не содержат значения, поскольку шаблоны могут рассматривать это по-разному, чем параметр, отсутствующий вообще).
- Вы можете нажать на значки информации над полями шаблона, чтобы прочитать больше информации о них.
- TemplateWizard works most effectively with templates that have TemplateData defined: i.e. their parameters have been documented in a detailed and structured way, including default values etc. (information about how to do that is in the TemplateData help pages). It also works without TemplateData definitions, although with some reduced functionality. These two modes are described in the next two sections.
Использование 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
If a template does not have any TemplateData, then an attempt will be made to guess the names of its parameters, and these will be presented as standard text entry form fields with labels as they are guessed.
Обратите внимание, что в этом списке, вероятно, будут дублированные, устаревшие или отсутствующие параметры, поскольку авторы шаблонов будут делать такие вещи, как следующее, чтобы разрешить различные формы имени параметра: {{{полное имя|{{{{Полное имя}}}}}}}
(обратите внимание на разницу в регистре букв)
Обычно для параметра существует предпочтительная форма, и ее можно найти, только просмотрев документацию по шаблону (и, пока вы там, возможно, добавьте TemplateData, чтобы другие люди не запутались в будущем!).
Как мне вставить шаблон?
Когда вы добавили все желаемые параметры к форме шаблона и дали им их значения (включая вообще никакое значение, если вам нужен пустой параметр), нажмите кнопку "Отправить" в правой части диалогового окна, и шаблон wikitext будет вставлен в текущем месте курсора в поле редактирования главной страницы.
Template text will be inserted according to the format defined in TemplateData; if none is given then the 'inline' format will be used. It is not possible to have a different custom format for one template (but of course the template wikitext can always be edited after insertion).
Смотрите также
- Help talk:Extension:TemplateWizard – форум помощи продвинутым пользователям по расширению.
- Расширение:TemplateWizard – основная страница расширения, предназначенная для администраторов и разработчиков.
- Phabricator:tag/TemplateWizard – система отслеживания ошибок и отсутствующих функций.