跳转到内容

Template:Ambox/doc:修订间差异

勤求古训,博采众方
删除的内容 添加的内容
开篇添加 Mbox templates 导航
无编辑摘要
 
(未显示1个用户的3个中间版本)
第1行: 第1行:
{{Mbox templates}}
{{Documentation subpage}}
{{Documentation subpage}}
{{Uses Lua|Module:Message box}}
{{Uses Lua|Module:Message box}}
{{Uses TemplateStyles|Module:Message box/ambox.css}}
{{Mbox templates}}


'''{{tlx|Ambox}}'''(Article message box,条目消息框)用于在条目创建各类提示和维护模板。
'''{{tlx|Ambox}}'''(Article message box,条目消息框)条目信息框的元模板,用于创建各类条目提示和维护模板。此模板只应在条目名字空间使用


== 常用参数 ==
== 常用参数 ==
{| class="wikitable"
{| class="wikitable" style="background:transparent;"
! 参数 !! 说明
! 参数 !! 说明
|-
|-
第17行: 第18行:
| <code>fix</code> || 改进指引
| <code>fix</code> || 改进指引
|-
|-
| <code>date</code> || 标记日期
| <code>sect</code> || 指定章节(如「章节」),改变所指的条目部分
|-
| <code>date</code> || 标记日期,用于按月分类
|-
| <code>time</code> || 配合 <code><nowiki>{{#time:c}}</nowiki></code> 显示精确时间
|-
|-
| <code>small</code> || <code>left</code> 时显示为小型右浮框
| <code>small</code> || <code>left</code> 时显示为小型右浮框
第26行: 第31行:
|-
|-
| <code>all</code> || 全部分类名称
| <code>all</code> || 全部分类名称
|-
| <code>name</code> || 模板名称(不含 Template: 前缀),用于检测错误替换引用
|}
|}


== type 类型 ==
== type 类型 ==
<code>type</code> 参数指定模板默认的左侧色条颜色和图片,根据消息类型选择:
{{Ambox|nocat=true|type=speedy|text=type=<u>speedy</u> — 快速删除}}

{{Ambox|nocat=true|type=delete|text=type=<u>delete</u> — 删除请求}}
{{Ambox|nocat=true|type=content|text=type=<u>content</u> — 内容问题}}
{{Ambox|nocat=true|type=speedy|text=type=<u>speedy</u> 快速删除}}
{{Ambox|nocat=true|type=style|text=type=<u>style</u> — 格式问题}}
{{Ambox|nocat=true|type=delete|text=type=<u>delete</u> 删除请求}}
{{Ambox|nocat=true|type=notice|text=type=<u>notice</u> — 默认}}
{{Ambox|nocat=true|type=content|text=type=<u>content</u> 内容问题}}
{{Ambox|nocat=true|type=move|text=type=<u>move</u> — 移动/合并提议}}
{{Ambox|nocat=true|type=style|text=type=<u>style</u> 格式问题}}
{{Ambox|nocat=true|type=protection|text=type=<u>protection</u> — 页面保护}}
{{Ambox|nocat=true|type=notice|text=type=<u>notice</u> 默认值}}
{{Ambox|nocat=true|type=move|text=type=<u>move</u> 移动/合并提议}}
{{Ambox|nocat=true|type=protection|text=type=<u>protection</u> 页面保护}}

未指定 <code>type</code> 时默认使用 <code>notice</code>。


== 小尺寸模式 ==
== 小尺寸模式 ==
<code>|small=left</code> 产生小型浮动框:
<code>|small=left</code> 产生小型浮动框:

{{Ambox|nocat=true|small=left|text=这是一个靠左显示的小型消息框。}}
{{Ambox|nocat=true|small=left|text=这是一个靠左显示的小型消息框。}}

标准尺寸效果:

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

== image 参数 ==
使用 <code>image</code> 参数可指定模板中显示的图片。语法与普通图片相同,建议宽度 40-50px。如果 <code>image</code> 设为 <code>none</code> 则不显示图片。

== sect 参数 ==
许多条目信息框开头为「此条目…」,如果用于章节则应显示「此章节…」。使用 <code>|sect={{{1|}}}</code> 实现此功能,编辑者可在第一个无名参数中输入「章节」来改变所指的条目部分。

== issue & fix 参数 ==
<code>issue</code> 用于描述条目问题,建议 10-20 字内,并包含相关方针指引的链接。<code>fix</code> 包含改进指导文字,比 issue 可稍长。当模板以整合状态(如放在 {{tlx|Multiple issues}} 中)或小型状态显示时,仅显示 <code>issue</code> 中的文字。

== talk 参数 ==
<code>|talk={{{talk|}}}</code> 可让编辑者指定讨论页章节链接。当讨论页不存在时不显示链接。

== date 参数 ==
<code>|date={{{date|}}}</code> 让编辑者或机器人标记模板放置日期,以小字显示在主文字后。配合 <code>cat</code> 参数可实现按月自动分类。

== cat & all 参数 ==
* <code>cat</code>:配合 <code>date</code> 可将条目分类至「Category:自 DATE 起 CATEGORY」
* <code>all</code>:指定所有包含模板的条目的分类名

== 完整参数列表 ==
<syntaxhighlight lang="wikitext">
{{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 =
}}
</syntaxhighlight>

== 技术细节 ==
如需在 <code>text</code> 参数中使用特殊字符,需如下转义:
<syntaxhighlight lang="wikitext">
{{Ambox
| text =
等号 = 与前后大括号 { } 可以正常使用。
但管道符 {{!}} 与两个后大括号 <nowiki>}}</nowiki> 不能直接使用。
同时使用需加 nowiki 标记 <nowiki>|}}</nowiki>。
}}
</syntaxhighlight>

此模板使用 CSS 类确定显示风格,可更换为其他皮肤。内部使用 HTML 表格标记而非维基式表格标记,这是元模板常见做法。


== 参见 ==
== 参见 ==
其他 mbox 家族模板:
{{Mbox templates}}
* {{tlx|Tmbox}} — 讨论页消息框
* {{tlx|Tmbox}} — 讨论页消息框
* {{tlx|Mbox}} — 自动检测命名空间的消息框
* {{tlx|Imbox}} — 文件页消息框
* {{tlx|Cmbox}} — 分类消息框
* {{tlx|Ombox}} — 其他页面消息框
* {{tlx|Fmbox}} — 页眉和页脚消息框
* {{tlx|Mbox}} — 自动检测命名空间


<includeonly>
<includeonly>

2026年6月25日 (四) 00:20的最新版本

消息框模板

{{Ambox}}(Article message box,条目消息框)是条目信息框的元模板,用于创建各类条目提示和维护模板。此模板只应在条目名字空间使用。

常用参数

参数 说明
type 消息类型,决定左侧色条颜色和默认图标
image 自定义左侧图标
issue 问题简述(必填)
fix 改进指引
sect 指定章节(如“章节”),改变所指的条目部分
date 标记日期,用于按月分类
time 配合 {{#time:c}} 显示精确时间
small left 时显示为小型右浮框
talk 讨论页链接
cat 按月分类名称
all 全部分类名称
name 模板名称(不含 Template: 前缀),用于检测错误替换引用

type 类型

type 参数指定模板默认的左侧色条颜色和图片,根据消息类型选择:

未指定 type 时默认使用 notice

小尺寸模式

|small=left 产生小型浮动框:

标准尺寸效果:

image 参数

使用 image 参数可指定模板中显示的图片。语法与普通图片相同,建议宽度 40-50px。如果 image 设为 none 则不显示图片。

sect 参数

许多条目信息框开头为“此条目…”,如果用于章节则应显示“此章节…”。使用 |sect= 实现此功能,编辑者可在第一个无名参数中输入“章节”来改变所指的条目部分。

issue & fix 参数

issue 用于描述条目问题,建议 10-20 字内,并包含相关方针指引的链接。fix 包含改进指导文字,比 issue 可稍长。当模板以整合状态(如放在 {{Multiple issues}} 中)或小型状态显示时,仅显示 issue 中的文字。

talk 参数

|talk= 可让编辑者指定讨论页章节链接。当讨论页不存在时不显示链接。

date 参数

|date= 让编辑者或机器人标记模板放置日期,以小字显示在主文字后。配合 cat 参数可实现按月自动分类。

cat & all 参数

  • cat:配合 date 可将条目分类至“Category:自 DATE 起 CATEGORY”
  • all:指定所有包含模板的条目的分类名

完整参数列表

{{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        = 
}}

技术细节

如需在 text 参数中使用特殊字符,需如下转义:

{{Ambox
| text  = 
等号 = 与前后大括号 { } 可以正常使用。
但管道符 {{!}} 与两个后大括号 <nowiki>}}</nowiki> 不能直接使用。
同时使用需加 nowiki 标记 <nowiki>|}}</nowiki>}}

此模板使用 CSS 类确定显示风格,可更换为其他皮肤。内部使用 HTML 表格标记而非维基式表格标记,这是元模板常见做法。

参见

其他 mbox 家族模板:

  • {{Tmbox}} — 讨论页消息框
  • {{Imbox}} — 文件页消息框
  • {{Cmbox}} — 分类消息框
  • {{Ombox}} — 其他页面消息框
  • {{Fmbox}} — 页眉和页脚消息框
  • {{Mbox}} — 自动检测命名空间