帮助:扩展:模板助手

From MediaWiki.org
Jump to navigation Jump to search
This page is a translated version of the page Help:Extension:TemplateWizard and the translation is 100% complete.
Other languages:
English • ‎dansk • ‎español • ‎français • ‎italiano • ‎oʻzbekcha/ўзбекча • ‎polski • ‎čeština • ‎русский • ‎українська • ‎中文 • ‎日本語

什么是模板助手?

模板助手是一个MediaWiki扩展,它为WikiEditor工具栏提供了一个弹出窗口,可以将模板插入维基文本

如何使用模板助手?

  • 要使用模板助手,请使用源代码编辑器(不是2017年版源代码编辑器)打开Wiki页面进行编辑
  • 将光标放在要插入模板的位置。 然后单击工具栏中的拼图图标OOjs UI icon puzzle-ltr.svg-TemplateWizard icon.png
  • 将弹出一个对话框窗口

我如何找到一个模板?

  • 开始输入模板的名称,您将看到一个可供选择的模板列表。

TemplateWizard help search en.png

  • 注意:只有具有模板数据的模板才会有描述。建议您将模板数据添加到模板中。
  • 当您找到所需的模板时,单击它(或使用箭头键导航到它)并按回车键。这将带您进入数据输入表单。

如何为我选择的模板添加数据?

  • 您现在看到的顶部栏包含模板标题,描述,链接OOjs UI icon link-ltr-progressive.svg到模板的维基页面,以及关闭按钮OOjs UI icon trash-destructive.svg以关闭模板表格并返回搜索。
  • 左侧参数列表,最多分为三个部分,包括必需参数,建议参数和可选参数。此区域底部还有一个按钮,可以一次添加或删除所有非必填字段。请注意,某些模板没有参数,在这些情况下,此处不会列出任何内容。当您点击模板参数时,它会被添加到右侧。
  • 包含实际数据输入字段的右侧表单,您将要添加到wiki文本中的值放入其中。只有那里列出的那些参数才会被插入编辑区域(包括那些不包含值的参数),因为模板可以根据不存在的参数来区别对待。
  • 您可以单击模板字段上方的信息图标以阅读有关它们的更多信息。

TemplateWizard help template en.png

  • 模板向导最有效地使用已定义模板向导的模板:即,他们的参数已经以详细和结构化的方式记录,包括默认值等(有关如何执行此操作的信息位于模板向导帮助页面 )。它也适用于没有模板向导定义,尽管有一些减少的功能。这两种模式将在接下来的两节中介绍。
  • 默认情况下仅添加必填字段
  • 用于现场信息的弹出窗口
  • 自动完成Wiki上的页面名称
  • 从维基共享资源自动完成文件
  • 日期、长格式文本字段、数字等的自定义字段输入

使用模板助手和模板数据

模板助手中有七种不同类型的字段,基于模板数据中定义的参数类型。

名称[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 所有其他类型将显示为标准文本输入输入,并将接受任何文本。
  1. 模板数据表单中使用的名称。
  2. 这个类型用于模板数据的JSON。

模板数据本身支持的字段类型比上面列出的要多。 其中一些可能会添加到任务T200664中。

不依赖模板数据使用模板助手

如果模板不具有任何模板数据,则将尝试猜测其参数的名称,并且这些将在标准文本输入表单字段中显示,并且在猜测时使用标签。

请注意,此列表中可能存在重复,已弃用或缺少的参数,因为模板作者将执行以下操作以允许不同形式的参数名称:{{{full name|{{{Full Name}}}}}}(请注意字母大小写的差异)。通常有一个参数的首选形式,这只能通过查看模板文档找到(并且,当你在那里时,可能会添加模板数据,所以其他人将来不会混淆)。

我如何插入这个模板?

当您已将所有所需参数添加到模板表单并为其指定值(如果需要空参数时根本不包含任何值),请单击对话框窗口右上角的“提交”按钮,模板将插入主页面编辑框中光标的当前位置。

模板文本将根据模板数据中定义的格式插入,如果没有给出,那么将使用inline格式。一个模板不可能有不同的自定义格式(当然,插入后总是可以编辑模板wikitext)。

参见