Template:Update monitor/doc

致幽默維基人：請查看下方隱藏說明。

介绍

{{Update monitor}}是一個用於顯示頁面最後更新時間的模板。它會根據距離最後一次編輯的時間長短，自動切換提示框的顏色與圖標（藍、綠、黃、紅）。

机制/原理

本模板透過MediaWiki內建的1794114866函數，計算當前時間與該頁面的最後修訂時間戳記（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}}