2022年11月26日 (六) 07:00 入我相思门

2022-11-26T07:00:34Z

←上一版本		2022年11月26日 (六) 15:00的版本
第257行：		第257行：
	<includeonly>{{sandbox other\|\|		<includeonly>{{sandbox other\|\|
	<!-- 本行下加入模板的分类 -->		<!-- 本行下加入模板的分类 -->
	[[Category:元模板\|Ambox]]		[[Category:中医百科元模板\|Ambox]]
	[[Category:条目信息模板\|Ambox]]		[[Category:条目信息模板\|Ambox]]
	}}</includeonly>		}}</includeonly>

入我相思门：创建页面，内容为“{{NoteTA |G1 = IT |G2 = MediaWiki }} {{Documentation subpage}} {{lua|Module:Message box}} {{Mbox templates}} 本模板 '''{{Tl|ambox}}''' 是条目信息框的元模板。用于创造文章信息框模板，如 {{Tl|wikify}} 等。此外本模板具有自由选择不同颜色、显示特定预设图片等功能。 '''请注意：'''这个模板只用于在条目名字空间使用的模板，其他名字空间使用的模…”

2022-11-23T16:34:50Z

创建页面，内容为“{{NoteTA |G1 = IT |G2 = MediaWiki }} {{Documentation subpage}} {{lua|Module:Message box}} {{Mbox templates}}  本模板 '''{{Tl|ambox}}''' 是条目信息框的元模板。用于创造文章信息框模板，如 {{Tl|wikify}} 等。此外本模板具有自由选择不同颜色、显示特定预设图片等功能。 '''请注意：'''这个模板只用于在条目名字空间使用的模板，其他名字空间使用的模…”

新页面

{{NoteTA
|G1 = IT
|G2 = MediaWiki
}}
{{Documentation subpage}}
{{lua|Module:Message box}}
{{Mbox templates}}

本模板 '''{{Tl|ambox}}''' 是条目信息框的元模板。用于创造文章信息框模板，如 {{Tl|wikify}} 等。此外本模板具有自由选择不同颜色、显示特定预设图片等功能。

'''请注意：'''这个模板只用于在条目名字空间使用的模板，其他名字空间使用的模板请不要使用。

== 常用参数 ==
右侧的方框内为 {{tl|ambox}} 模板最常用的参数。每种参数的說明如下：
{| class="wikitable" align="right" style="background:transparent;" width="40%"
! 常用参数
|-
|<pre style="font-size:90%; ">
{{Ambox
| name =
| subst = <includeonly>{{subst:substcheck}}</includeonly>
| small = {{{small|}}}
| type =
| image =
| sect = {{{1|}}}
| issue =
| talk = {{{talk|}}}
| fix =
| date = {{{date|}}}
| time = {{{time|}}}
| cat =
| all =
}}
</pre>
|}

=== ''name'' ===
''name'' 参数指定模板的名字，不需要加上模板名字空间前缀。例如 {{tl|Wikify}} 中填入的参数为 {{para|name|Wikify}}。

本参数应该模板被移动时更新。本参数的指定有两个目的：
* 如果模板被错误的替换引用（substituded），这个参数能让元模板显示一段警告文字，将可帮助编辑者修复问题。
* 能让模板在模板页中更有效地展示，例如在沒有填入日期的情況下自动显示日期，并能让模板准确分类。

=== ''subst'' ===
''subst'' 参数让元模板能检测此模板是否被错误替代引用的，并显示一段警告文字。同时也会将页面加入 [[:Category:错误使用替换引用的页面]] 分类. 完全复制上述方框中的代码即可。一般情況下，请勿更改本参数内容，直接复制上方的模板代码即可。

=== ''small'' ===
''small'' 参数可让编辑者在条目中使用模板时输入 {{para|small|left}} 来产生一个小型的模板。

{{ambox|nocat=true|small=left|text=这是一个靠左显示的小型模板。}}

一般情況下本模板的显示效果如下：

{{ambox|nocat=true|text=这是一个标准的信息框格式。}}

其他参数设定方式：
* 如果模板「永远」不应以缩小的方式显示，请在模板源代码中使用 {{para|small|no}}。
* 如果模板应「总是」以缩小的方式显示，请在模板源代码中使用 {{para|small|left}}。
* 如果模板「预设为缩小显示」，请在模板源代码中使用 {{para|small|<nowiki>{{{small|left}}}</nowiki>}}。可让编辑者在条目中输入 {{para|small|no}} 参数时无效。

=== ''type'' ===
''type'' 参数能指定的模板预设的左侧直条颜色和图片。本参数的选择并非依据编辑者对颜色的偏好，而是根据模板内信息的类型来決定。以下是七种可在「<code>type</code>」参数中填入的值：

{{ambox
| type = speedy
| text = type=speedy－请求快速刪除，如 {{tl|delete}}。
}}
{{ambox
| type = delete
| text = type=delete－请求删除，如 {{tl|afd}} 与 {{tl|vfd}} 。
}}
{{ambox
| type = content
| text = type=content－内容问题，如 {{tl|POV}} 与 {{tl|globalize}} 。
}}
{{ambox
| type = style
| text = type=style－格式问题，如 {{tl|cleanup}} 与 {{tl|wikify}}。
}}
{{ambox
| type = move
| text = type=move－合并、拆分及跨维基提议，如 {{tl|split}} 与 {{tl|splitsection}}。
}}
{{ambox
| type = protection
| text = type=protection－页面保护，如 {{tl|Protected}}。
}}
{{ambox
| type = notice
| text = type=notice－条目注意，如 {{tl|current}} 与 {{tl|inuse}}。
}}

如果没有指定 ''type'' 参数，默认为 {{para|type|notice}}。

=== ''image'' ===
您可以使用 ''image'' 参数来指定模板中显示的图片。图片的指定语法与维基百科放置图片的预设语法相同（参看：[[Help:图像|如何放置图片]]）。一般来说，图片的宽度约为 40-50px。范例如下：

* {{tl|POV}} 中参数设定为 {{para|image|<nowiki>[[File:Unbalanced scales.svg|40px|link=|alt=]]</nowiki>}}，其显示效果如下：
{{POV|time={{#time:c}}|nocat=true}}

* {{tl|wikify}} 中参数设定为 {{para|image|<nowiki>[[File:Wikitext.svg|50px|link=|alt=]]</nowiki>}}，其显示效果如下：
{{Wikify|time={{#time:c}}|nocat=true}}

请注意：
* 如果沒有指定图片，模板将会配合「type」参数的内容选择适当的图片（参看：[[#type]]）
* 如果参数设定为 {{para|image|none}} 时将不会显示任何图片，信息框内将仅显示文字。
* 如果图片仅为装饰功能，并属于[[公共领域]]，可如在参数中加上 "{{para|link}}'' 以产生连往图片描述页的链接，以及 ''{{para|alt}}" 来产生替代文字；以上两种做法可提升[[中医百科:格式手冊/亲和力|页面亲和力]]。

=== ''sect'' ===
许多条目信息模板开头文字为「'''此条目⋯⋯'''」，如果此模板用于章节，则应该更适当地使用「'''此章节⋯⋯'''」。其他可能性包括「'''此列表⋯⋯'''」和「'''此人物传记⋯⋯'''」。

为了实现这个功能。请使用 {{para|sect|<nowiki>{{{1|}}}</nowiki>}} 参数。这将使编辑者能在第一个无名的参数中输入「'''章节''''」来改变模板所指的条目部分。例如：{{tlx|Advert|章节}} 将会显示：
{{Advert|章节|time={{#time:c}}}}

在使用这个功能时，在模板源代码中应移除开头的几个字（例如：本条目），否则会造成重复显示。

=== ''issue'' & ''fix'' ===
''issue'' 参数用于描述条目的问题。请尽量保持文字敘述简洁有力（約在 10-20 个字内），并包含一个链接至有关的[[中医百科:方針与指引|方針与指引]]页面。

''fix'' 参数包含描述如何改进条目的指导文字。文字内容可比 ''issue'' 参数中所填入的字数多，在大多数情況下，请保持在两句话内敘述完毕。

当模板以整合状态（例如放置在 {{tl|multiple issues}} 中）或小型状态（使用 {{para|small|left}} 参数）显示时，只有 ''issue'' 参数中的文字会显示。例如在 {{tl|citation style}} 模板中的参数设定为：

* <code>|issue = <nowiki>本条目的'''引用需要进行清理。'''</nowiki></code>
* <code>| fix = <nowiki>参考文献应符合正确的[[中医百科:列明来源|引用]]、[[中医百科:脚注|脚注]]及[[中医百科:外部链接|外部链接]]格式。</nowiki></code>

当单独使用时显示效果如下：
{{Citation style}}

但当与 {{tl|article issues}} 模板整合使用或以小型模式（{{para|small|left}}）显示时，效果则如下：
{{Multiple issues  |{{Citation style}}}}
{{Citation style|small=left}}

=== ''talk'' ===
某些条目信息框模板包含了一个通往其讨论页的链接，并让编辑者能指定相关议题所在的章节位置。如要达成这项功能，请使用 ''talk'' 参数，使用方式为 {{para|talk|<nowiki>{{{talk|}}}</nowiki>}}。

这项参数将可被编辑者以下述方式使用：
* {{para|talk|章节标题}} - 链接可通往条目讨论页中的特定章节。例如：{{para|talk|西瓜}}
* {{para|talk|完整页面名称}} - 链接将通往指定的页面。例如：{{para|talk|Talk:香蕉#西瓜}}

请注意：
* 当模板中使用本参数时，模板本身将会显示一个通往讨论页的链接（为了显示支援此功能），但仅有在参数被确实定义时才会在条目中的模板内显示。
* 如果要让模板永远显示一个通往讨论页的链接，请使用 {{para|talk|<nowiki>{{{talk|#}}}</nowiki>}} 参数。
* 如果讨论页面不存在，无论参数设定为何，都将不会显示任何链接。

=== ''date'' ===
将 ''date'' 直接传送至元模板可让编辑者（或[[WP:bot|機器人]]）自行输入模板被放置在条目中的日期。日期将会以較小的字体在主要文字后显示。

在 ''cat'' 参数同时获得定义时，将 ''date'' 参数传送至元模板可实现将条目自动[[:Category:按月分类的维基百科维护分类|按月分类]]的功能。
=== ''time'' ===
''time''和''date''用法差不多，但是time可以配合<nowiki>{{#time:c}}</nowiki>，例如：

<nowiki>{{ambox|issue=内容|fix=附加文字|date={{subst:#time:c}}}}</nowiki>会显示为：{{ambox|issue=内容|fix=附加文字|date={{#time:c}}}}

<nowiki>{{ambox|issue=内容|fix=附加文字|time={{subst:#time:c}}}}</nowiki>会显示为：{{ambox|issue=内容|fix=附加文字|time={{#time:c}}}}

=== ''cat'' ===
这个参数定义了清理分类的名称。使用 {{para|cat|CATEGORY}} 参数：

* 并同时使用 {{para|date|DATE}}，则条目会被自动分类至 '''Category:自DATE起CATEGORY''' 中。
* 若无指定日期，条目会被自动分类至 '''Category:CATEGORY''' 中。

=== ''all'' ===
''all'' 参数可用来指定所有包含模板之条目的分类。

== 其他参数 ==
右侧方框内展示了此模版的所有参数。由于几乎不可能同时用到所有参数，因此不建议复制此处的空白模版。
{| class="wikitable" align="right" style="background:transparent; width=40%"
!完整的所有参数
|-
|<pre style="font-size:90%; width=40%">
{{Ambox
| name =
| subst = <includeonly>{{subst:substcheck}}</includeonly>
| small = {{{small|}}}
| type =
| image =
| imageright =
| smallimage =
| smallimageright =
| class =
| style =
| textstyle =
| sect = {{{1|}}}
| issue =
| talk = {{{talk|}}}
| fix =
| date = {{{date|}}}
| time = {{{time|}}}
| text =
| smalltext =
| cat =
| all =
| cat2 =
| all2 =
| cat3 =
| all3 =
}}<noinclude>
{{Documentation}}
</noinclude>
</pre>
|}

=== ''imageright'' ===
在信息框右侧显示图片。填入方式与 ''image'' 参数相同，预设为不显示任何图片。

=== ''smallimage'' & ''smallimageright'' ===
可在此参数指定模板缩小显示后所使用的图片。仅在定义 {{para|small|left}} 时有效。

=== ''class'' ===
可自行定义使用在信息框的[[Cascading Style Sheets|CSS]]型別选择器（Class）。

=== ''style'' & ''textstyle'' ===
可选择定义CSS样式，不需加上引号 <code>" "</code>，但必須在结尾加上分号 <code>;</code>。
* ''style'' 为套用至整个信息框的样式
* ''textstyle'' 为仅套用在文字上的样式

=== ''text'' & ''smalltext'' ===
除了指定 ''issue'' 和 ''fix'' 参数外，也可使用 ''text'' 参数来定义要显示的文字（不建议使用''text''，不支持移动版）

''smalltext'' 则用来定义要以较小字体显示的文字

=== 其他分类相关参数 ===
* ''cat2'' 和 ''cat3'' 可增加按月分类时所用的分类名称，用法与 ''[[#cat]]'' 参数相同。
* ''all2'' 和 ''all3'' 可增加所有包含模板之条目的分类名称，用法与 ''[[#all]]'' 参数相同。

== 技术细节 ==
如果你需要在text参数中使用一些特殊字符的话，那么就需要像这样将它们换码：

<pre>
{{ambox
| text =
等号 = 与前后大括号{ }可以正常地使用。
但是管道符{{!}}与两个连着的后大括号<nowiki><nowiki>}}</nowiki></nowiki>则不能直接使用。
一起用同样要带nowiki标记<nowiki><nowiki>|}}</nowiki></nowiki>。
}}
</pre>

{{ambox
| text =
等号 = 与前后大括号{ }可以正常地使用。
但是管道符{{!}}与两个连着的后大括号<nowiki>}}</nowiki>则不能直接使用。
一起用同样要带nowiki标记<nowiki>|}}</nowiki>。
}}

此模板使用CSS类来确定显示风格，因此可被更换到其他风格。

在此元模板内使用了HTML的表格标示法，而没有使用维基式的表格标示法。在制作元模板时这是一个常见的方法，因为维基式标示法存在一些缺陷。譬如，维基式标示法会加大[[Help:模板扩展语法|模板扩展语法]]及参数中特殊字符使用的难度。

此元模板所用的缺省图片用的是png格式的，而不是svg格式。其主要原因是在处理MediaWiki为svg图片所渲染的透明背景时，一些老版本的网络浏览器会遇到一些麻烦。这里的png格式图片有手工优化过的透明背景颜色，因而在所有的浏览器中它们看上去都是好的。请注意，svg图标只会在一些老版本的浏览器中看上去有点不对头，因此只有那些非常广泛使用的图标才值得费些功夫去做那种手工优化。

更多的技术细节参见[[{{TALKPAGENAME}}|讨论页]]以及下方的[[#参看]]一节。

== 参看 ==
{{mbox templates see also}}

<includeonly>{{sandbox other||

[[Category:元模板|Ambox]]
[[Category:条目信息模板|Ambox]]
}}</includeonly>

Template:Ambox/doc - 版本历史

2022年11月26日 (六) 07:00 入我相思门