模板:Update monitor/doc

致幽默维基人：请查看下方隐藏说明。

介绍

{{Update monitor}}是一个用于显示页面最后更新时间的模板。它会根据距离最后一次编辑的时间长短，自动切换提示框的颜色与图标（蓝、绿、黄、红）。

机制/原理

本模板透过MediaWiki内建的1794148319函数，计算当前时间与该页面的最后修订时间戳记（20260828095422）之间的秒数差，并与自定义或默认的时间阈值进行比较，从而动态改变外层{{ombox}}的样式框颜色与图标。

用法

直接将以下代码插入至需要监视更新的页面顶部：

{{Update monitor}}

参数

所有参数均为选填：

{{Update monitor
| 1            = <!-- 目標頁面名稱（選填，預設為當前頁面） -->
| green        = <!-- 正常狀態時間 -->
| yellow       = <!-- 警告狀態時間 -->
| red          = <!-- 過期狀態時間 -->
| tittle       = <!-- 附加於首行後方的自訂文字 -->
| text         = <!-- 自訂次行說明小字，會直接覆蓋自動生成的文字 -->
| tl           = <!-- 是否套用 tl 模板樣式連結（yes/no） -->
| this         = <!-- 指定 purge 重新整理的目標頁面 -->
| small        = <!-- 是否顯示為右側迷你框（yes/no） -->
| badcat       = <!-- 警告或過期狀態時自動加入的分類 -->
| cat          = <!-- 永久自動加入的分類 -->
| demo         = <!-- 測試用：模擬最後編輯距今時間（如 5 hour） -->
}}

注意事项

• 输入自定义时间单位时必须使用英文单位（如 min、minute、hour、hours、day、days）。
• 由于维基百科的页面快取机制，提示框的颜色与倒数说明可能不会即时更新，可以点击提示框右侧的(更新快取)链接来重新整理服务器快取。

技术细节

• 本模板基于标准的{{ombox}}进行样式与衍生开发。
• 内部时间核心采用倒序判断（红➔黄➔绿➔蓝），当特定颜色参数被设定为disable或none时，系统会将其过期阈值设为遥远的未来（9999999999），使其永远无法触发，从而达到忽略该阶段的效果。

参数说明

参数	说明	默认值	备注
1 或 target	要监控的目标页面名称。	当前页面名称（{{subst:FULLPAGENAME}}）
green	变为绿色状态的时间。若低于此时间，框体显示为蓝色。	1hour	支援单位包括：min（分钟）、hour（小时）、day（天）等。
yellow	变为黄色状态的时间。若低于此时间，框体显示为绿色。	8hour	同上。
red	变为红色状态时间。若低于此时间，框体显示为黄色。	24hour	同上。可设为none或disable以停用红色状态。
tittle	附加在第一行主要文字后方的自定义文字。	（无）	输入后会以逗号，与前文串接。
text	自定义第二行的说明小字。	（依时间自动生成）	若填写此参数，将会覆盖原说明。
tl	当设定为yes时，目标页面的链接将会呈现{{[[Template:{{{1}}}|{{{1}}}]]}}模板样式。	no	仅在填入1 或 target时生效。
this	显示此字；用于指定(更新快取)链接所重新整理（purge）的目标页面。	（当前页面）
small	当设定为yes时，提示框将缩小为右侧迷你框，适用于条目或排版空间受限处。	no
badcat 或badcategory	当页面处于黄色或红色状态时，自动为页面加入的分类。	（无）	仅在条目、项目、模板、分类及主题命名空间生效。
cat 或category	页面会加入的分类。	（无）	限制空间同上。
demo	模拟参数，用于测试。	（无）	传入如5 hours、2 days可模拟该页面在该时间前已被编辑。

示例

基础

监控{{Template:Itn}}更新状态，黄色8小时，红色24小时：

{{Update monitor|Template:Itn|green=0min|yellow=8hour|red=24hour}}

套用{{tl}}样式并自定义标题与小字

{{Update monitor|Template:Itn
| green  = 0min
| yellow = 8hour
| red    = 24hour
| tl     = yes
| tittle = 請儘速更新
| text   = 這裡放置自訂的小字說明文字，覆蓋預設說明。
}}

精简模式

{{Update monitor|Template:Itn|green=0min|yellow=8hour|red=24hour|small=yes}}

模板数据

以下是该模板的模板数据，适用于可视化编辑器等工具。

Update monitor模板数据

一个用于显示页面最后更新时间的模板。它会根据距离最后一次编辑的时间长短，自动切换提示框的颜色与图标（蓝、绿、黄、红）。

模板参数

此模板首选参数不换行的行内格式。

参数		描述	类型	状态
目标页面	target 1	监视对象的完整页面名称。若留空，则使用当前页面。	页面名称	推荐
绿色触发时间	green	蓝色提示框维持的时间。超过此时间后会变为绿色提示框。支援sec（秒）、min（分钟）、hour（小时）、day（天）、week（周）、month（个月）、year（年）。填入disable或none则忽略此阶段。 默认值 1 hour 示例值 30 min, 1 week	字符串	可选
黄色触发时间	yellow	绿色提示框维持的时间。超过此时间后会变为黄色提示框。支援英文时间单位（如hours, months）。填入disable或none则忽略此阶段。 默认值 8 hours 示例值 12 hours, 2 months	字符串	可选
红色触发时间	red	黄色提示框维持的时间。超过此时间后会变为红色警告框。支援英文时间单位（如days, years）。填入disable或none则忽略此阶段。 默认值 24 hours 示例值 2 days, 1 year	字符串	可选
自定义标题附加文字	tittle	附加在第一行主要文字后方的自定义文字。输入后会以逗号“，”与前文串接。	字符串	可选
自定义说明小字	text	自定义第二行的说明小字。若填写此参数，将会完全覆盖模块自动生成的变色时间说明。	字符串	可选
套用 tl 样式	tl	当设定为yes时，目标页面的链接将会呈现tl模板样式。 默认值 no	布尔	可选
目标为放置模板的页面	this	填入yes时，会在提示主文字前加上“此”字（例如：“此模板...”、“此条目...”）。 自动值 no	布尔	可选
精简模式	small	当设定为yes时，提示框将缩小为右侧精简模式，适用于条目或排版空间受限处。 默认值 no	布尔	可选
超时分类	badcategory badcat	当页面处于黄色或红色状态时，自动为页面加入的分类。	字符串	可选
分类	category cat	页面会加入的分类。	字符串	可选
示例模式（模拟时间）	demo	用于测试或在沙盒展示示例。传入一段相对时间（如10hours或2days），系统将模拟该页面最后编辑于该时间之前。 示例值 10 hours	字符串	可选
幽默模式	funny	仅在幽默页面加入。 默认值 no 示例值 yes	布尔	可选
目标对象为用户讨论页	user	当模板用于旧版讨论页时的参数。 默认值 no 示例值 yes	布尔	弃用

参见

• {{Module:Update monitor}}
• {{Time ago}}
• {{Purge}}