跳至內容

模組討論:Documentation

頁面內容不支援其他語言。
新增話題
維基百科,自由的百科全書
由Addonian1123在話題編輯請求 2026-08-03上作出的最新留言:15 天前

軟重新導向Template talk:Documentation
此頁面為軟重新導向

編輯請求 2021-05-07

[編輯]

基於Special:Diff/65518725議案已公示8+1日通過,因此請求佈署,內容包括了在LUA包含提刪模板(依據共識,不應包含在DOC頁或討論頁)的方法。為了實作該方法依據英文維基做出了以下改動:(下面列出提議之Patch的所有改動)

  1. 依據英文維基定義了Module專用的載入點(en:Special:Diff/980010662),以便未來增刪功能。
  2. 讀取對應頁面的 _addText
  3. 修正message('other-pagetype')未定義問題,否則 _addText 在部分頁面會有錯誤訊息。

MediaWiki:Scribunto-doc-page-does-not-exist核心編輯請求相依於此編輯請求,故先申請此編輯請求。-- 五歲抬☎️·☘️2021年5月7日 (五) 14:06 (UTC)回覆

設計一個制度解決部分速刪模板掛不上去的頁面的刪除問題

[編輯]
目前討論狀態:

-- 五歲抬☎️·☘️2021年5月8日 (六) 19:10 (UTC)回覆

參見Wikipedia:互助客棧/求助/存檔/2021年4月#請幫忙刪除 User:Tranve/工坊/workshop.json,像 JSON 和 Module: 名字空間的頁面,速刪模板掛不上去。希望可以在方針制度層面解決這個問題。--Tranve () 2021年4月5日 (一) 13:07 (UTC)回覆

引入能夠在特殊頁面掛模板的模組

[編輯]
已通過:
公示期已過,且已逾時超過一日(49小時28分鐘),在公示期將結束至此刻(2021年5月7日 (五) 13:45 (UTC))未出現新的異議,期間反對者的論述已由支持者回應,且反方無進一步論述,因此提案通過-- 五歲抬☎️·☘️2021年5月7日 (五) 13:45 (UTC)回覆
下列討論已經關閉,請勿修改。如有任何意見,請在合適的討論頁提出,而非再次編輯本討論。

為了解決模板掛不上去或者TW不支持的問題,因此提議引入以下模組

  • Module掛模板問題
    引入en:Module:Module wikitext並提出編輯請求以編輯相關高風險模板與介面讓中文維基支持
  • json或css或js掛模板問題
    已開發完畢,待社群共識後才會提請編輯請求,見圖

此法如果引入成功,完全可以直接在原頁面申請速刪,不存在上方提到的任何疑慮!如果這個建起來,提刪過程會「跟提刪條目一模一樣」,不會陷管理員於不義。對應要提刪的頁面會有提刪模板,不會讓管理員的刪除操作欠缺提刪模板,不存在上方提到的任何疑慮!—- 五歲抬☎️·☘️2021年4月26日 (一) 18:51 (UTC)回覆

沒有什麼不好的。--安憶Talk 2021年4月27日 (二) 11:47 (UTC)回覆
  • 非常感謝幫忙!能在原頁面掛速刪模板,這樣就可以解決管理員刪去頁面後,其他管理員無法復檢刪除操作的問題,否則其他管理員就無法確定管理員是否濫權,在沒有提刪的情況下,直接刪了頁面,這是屬於嚴重濫權,因此在頁面能留下速刪模板是非常重要的,這件事不能馬虎。此外,既然技術上解決了問題,就沒必要改方針了。--蟲蟲飛♡♡→♡℃留言 2021年4月27日 (二) 12:15 (UTC)回覆

項目 辦理狀況 需編輯的頁面 頁面patch 效果預覽
Module 已完成測試 Module:Module wikitext (已佈署) Module:沙盒/a2569875/ModuleWikitextDemo
Module:Documentation Module:Documentation/sandbox
MediaWiki:Scribunto-doc-page-does-not-exist User:A25...-does-not-exist
(需要語言變種微調)
JS、CSS 已完成測試 Module:Special wikitext (已佈署) 留言WP:TG1) 、 互連群圖床
MediaWiki:Clearyourcache User:A25...yourcache
(需要語言變種微調)
JSON 等待工單phab:T235798佈署 phab:T235798 gerrit:r/c/543934
  • 本地已經準備完畢的部分(Module、JS、CSS)可考慮先行公示並佈署。-- 五歲抬☎️·☘️2021年4月27日 (二) 15:33 (UTC)回覆
  • 說明phab:T235798要解決的問題是,目前JSON可以用技術手段掛模板,且頁面中也確實能夠顯示掛上模板後的速刪分類
    (見測試圖留言WP:TG1) 、 互連群圖床),然而頁面分類的資料庫暫時無法更新資料
    所以雖然模板能掛了,但還是需要手動提醒/或找一個管理員,告知頁面需要刪除,
    這樣@蟲蟲飛您會不會又無法接受了? 當然,這個問題可以修復,只是phab:T235798不明原因擱置中(目前看起來是代碼合併衝突、需要更新),可能需要一點時間,當phab:T235798佈署完畢後就會完全沒有這問題了。 在這之前,有以下(&)建議
    ※目前的(&)建議是,在phab:T235798工單完工之前,先把沒問題的JS、CSS、Module 公示通過在本地佈署因為JSON掛模板工能本地需要修改的地方與JS、CSS、Module相同,當phab供單完工後,將會立即生效,而在JSON全域佈署前,JSON先暫時維持原本的提刪方式(模板掛,但頁面分類的資料庫暫時不會正常更新,看要不要方針註明一下,不是技術限制,而是phab工單工作中...最近課業繁忙,比較沒有時間去提供後台php代碼,可能無法像之前專題空間那像迅速完成,而已經OK的JS、CSS、Module我覺得可以先行佈署))。-- 五歲抬☎️·☘️2021年4月28日 (三) 11:41 (UTC)回覆
  • (※)注意:頁面能掛速刪模板就好了,就算不能掛模板,走去找管理員留言提刪,安憶那個編輯差異的小工具很好用,可以很容易就在刪除日誌中註明提刪的原由,復檢的管理員也能輕易瞭解刪除操作的管理員有沒有濫權,有沒有在沒提刪的情況下刪去頁面。沒有提刪,直接刪去頁面屬於嚴重濫權,因此刪除操作的處理一定要很審慎。此外,方針沒必要改,這些操作屬於技術性問題,與方針無關,而且現行方針已經很清楚。--蟲蟲飛♡♡→♡℃留言 2021年4月28日 (三) 12:00 (UTC)回覆

公示期討論:技術案

[編輯]
  • 如果提刪模板不能放在目標頁面,就不能放在子頁面或者討論頁,因為復檢的管理員如果看到被刪的頁面沒提刪模板,沒有人會檢查所有子頁面及討論頁,然後就容易誤會管理員在沒有提刪的情況下直接刪去頁面。--蟲蟲飛♡♡→♡℃留言 2021年4月28日 (三) 12:30 (UTC)回覆
註:此處原有用戶留言,因為過多重複內容,已由五歲抬☎️·☘️)於2021年4月30日 (五) 16:15 (UTC)刪除,尚祈見諒。若有異議請至互助客棧或向管理員反映。回覆
@蟲蟲飛上面的技術如果公示通過了CSS,JS,Module 才可以在原頁面掛模板,JSON也可以在原頁面掛模板,phab:T235798沒好只是頁面分類暫時不會歸檔。—- 五歲抬☎️·☘️2021年4月28日 (三) 12:53 (UTC)回覆
(!)意見:宇帆TG主羣的留言我看了,您誤會了我的意思,我沒有反對您技術修訂的提案,但前提是提刪的頁面須保留提刪模板。--蟲蟲飛♡♡→♡℃留言 2021年5月1日 (六) 02:14 (UTC)回覆
(:)回應關於這一點,沒有問題,此案確實能讓需要刪除的頁面擁有提刪模板,包括但不限於速刪、DRV、AFD或其他需要模板的提刪過程(如合併、移動、遷移至其他維基計劃或其他維護模板),故顯然不會有管理員執行操作時,缺乏模板標記的問題,惟須注意的是,由於模板掛法要符合特定頁面內容模型,故會需要一些特殊語法,建議在技術案通過後也同步在方針頁註記相應內容模型掛模板的語法。—- 五歲抬☎️·☘️2021年5月1日 (六) 08:45 (UTC)回覆
※註:根據Special:Diff/65395602 公示截止時間為2021年5月5日 (三) 20:17 (UTC+8),公示已結束(5年前)(更新)-- 五歲抬☎️·☘️2021年5月5日 (三) 10:00 (UTC)回覆

  • 通過:公示期已過,且已逾時超過一日(5年前),在公示期將結束至此刻(2021年5月6日 (四) 12:55 (UTC))未出現新的異議,期間反對者的論述已由支持者回應,且反方無進一步論述,因此提案通過,將開始準備佈署事宜。-- 五歲抬☎️·☘️2021年5月6日 (四) 12:55 (UTC)回覆

本討論已關閉,請勿修改。如有任何意見,請在合適的討論頁提出,而非再次編輯本討論。

移動版問題

[編輯]

在移動版下版面亂掉了,需要修復--百無一用是書生 () 2024年5月4日 (六) 11:34 (UTC)回覆

關於MediaWiki:Scribunto-doc-page-show的原理解釋

[編輯]

{{#if:{{#invoke:Redirect|isRedirect|{{FULLPAGENAME}}}}|{{Module_redirect|{{#invoke:Redirect|main|{{FULLPAGENAME}}}}}}}} {{#invoke:documentation|main|_content={{ {{#invoke:documentation|contentTitle}}}}|{{#ifexist:{{FULLPAGENAME}}/doc|{{FULLPAGENAME}}/doc|{{NAMESPACE}}:{{BASEPAGENAME}}/doc}}}} <span id="code"></span> 我想問{{#invoke:documentation|main|_content={{ {{#invoke:documentation|contentTitle}}}}|{{#ifexist:{{FULLPAGENAME}}/doc|{{FULLPAGENAME}}/doc|{{NAMESPACE}}:{{BASEPAGENAME}}/doc}}}} 是怎麼回事,如果我移植到其他維wiki,沒有這個模塊應該怎麼處理?--Hzt0208042508415531 tw留言2024年8月12日 (一) 20:38 (UTC)回覆

編輯請求 2024-09-03

[編輯]
請求已拒絕

根據Wikipedia:互助客棧/技術#2024年第36期技術新聞加入__EXPECTUNUSEDTEMPLATE__--SunAfterRain 2024年9月3日 (二) 02:05 (UTC)回覆

不太明白,模板文檔正常來說都是已有使用的啊,為何要加上這個?--百無一用是書生 () 2024年9月17日 (二) 10:30 (UTC)回覆
下面已更新--百無一用是書生 () 2024年10月14日 (一) 03:40 (UTC)回覆

編輯請求 2024-09-28

[編輯]
請求已處理

使用Module:Documentation/sandbox更新Module:Documentation,使用Module:Documentation/config/sandbox更新Module:Documentation/config,啟用模板樣式後可進一步精簡Common.css。--Dabao qian 2024年9月28日 (六) 18:14 (UTC)回覆

完成--百無一用是書生 () 2024年10月14日 (一) 03:39 (UTC)回覆

編輯請求 2025-06-14

[編輯]
請求已處理

確保p.message只回傳一個值,避免mw.ustring.gsub的第二個傳回值(總匹配次數)出現在結果內,修復{{Used in system}}中出現一個2字的問題。引用沙盒版本的模板請見{{Used in system/sandbox}}。副知@ImingHehua。--1F616EMO喵留言回覆請ping2025年6月14日 (六) 05:16 (UTC)回覆

(~)補充:目前所有調用此函數的模組都只取第一個傳回值,即將佔位符替換成正確文字後的信息。但在{{#invoke:Documentation/wrapper|wrapper}}內使用時,MediaWiki則將所有傳回值使用製表符連結在一起,造成此錯誤。雖然在wrapper內修復亦可,但既然其他地方都沒有使用此傳回值,私以爲從源頭修復更正確,也免得往後出現什麼奇怪的錯誤。--1F616EMO喵留言回覆請ping2025年6月14日 (六) 05:22 (UTC)回覆
 謝謝您--在下荷花請多指教歡迎簽到2025年6月14日 (六) 07:00 (UTC)回覆
@1F616EMO完成;請確保模板運作符合預期。—— Eric Liu 創造は生命(留言留名學生會 2025年6月14日 (六) 13:02 (UTC)回覆

編輯請求 2026-08-03

[編輯]
User:S8321414User:ManchiuUser:Ericliu1912User:HamishUser:1F616EMO

由於phab:T268900問題,模板頂端的分格線出現混亂問題。 建議將

	--]]
	local docTitle = data.docTitle
	-- yes, we do intend to purge the template page on which the documentation appears
	local purgeLink = makeWikilink("Special:Purge/" .. data.title.prefixedText, data.purgeLinkDisplay)
	
	if docTitle.exists then
		local viewLink = makeWikilink(docTitle.prefixedText, data.viewLinkDisplay)
		local editLink = makeWikilink("Special:EditPage/" .. docTitle.prefixedText, data.editLinkDisplay)
		local historyLink = makeWikilink("Special:PageHistory/" .. docTitle.prefixedText, data.historyLinkDisplay)
		return "&#91;" .. viewLink .. "&#93; &#91;" .. editLink .. "&#93; &#91;" .. historyLink .. "&#93; &#91;" .. purgeLink .. "&#93;"
	else
		local createLink = makeUrlLink(docTitle:canonicalUrl{action = 'edit', preload = data.preload}, data.createLinkDisplay)
		return  "&#91;" .. createLink .. "&#93; &#91;" .. purgeLink .. "&#93;"
	end
	return ret
end

所有的&#91;&#93;移除,改成套用css。這樣會變成:

    --]]
	local docTitle = data.docTitle

	local function wrap(link)
		return '<span class="doc-link">&#91;</span>' .. link .. '<span class="doc-link">&#93;</span>'
	end
	
	-- yes, we do intend to purge the template page on which the documentation appears
	local purgeLink = wrap(makeWikilink("Special:Purge/" .. data.title.prefixedText, data.purgeLinkDisplay))
	
	if docTitle.exists then
		local viewLink = wrap(makeWikilink(docTitle.prefixedText, data.viewLinkDisplay))
		local editLink = wrap(makeWikilink("Special:EditPage/" .. docTitle.prefixedText, data.editLinkDisplay))
		local historyLink = wrap(makeWikilink("Special:PageHistory/" .. docTitle.prefixedText, data.historyLinkDisplay))
		return viewLink .. editLink .. historyLink .. purgeLink
	else
		local createLink = wrap(makeUrlLink(docTitle:canonicalUrl{action = 'edit', preload = data.preload}, data.createLinkDisplay))
		return  createLink .. purgeLink
	end
	return ret
end

已可在Beta Cluster測試站(標準Minerva外觀Timeless外觀)上正常運作,此方法以英語維基百科的修復作法為基礎改進。

--原為Addonian1123 (討論|維基教科書) 2026年8月3日 (一) 05:00 (UTC)留言回覆

--編輯:Addonian1123 (討論|維基教科書) 2026年8月6日 (四) 08:48 (UTC)回覆

原來是這麼一回事......(+)支持此請求--象象🐘(留言|貢獻) 2026年8月3日 (一) 07:44 (UTC)回覆
此話題已經閒置數日,需要更多人加入討論--Addonian1123 (討論|維基教科書) 2026年8月10日 (一) 05:09 (UTC)回覆
或許也可以用css偽元素?
	local leftbracket = mw.text.tag("span", {["class"] = "documentation-leftbracket"}, "")
	local rightbracket = mw.text.tag("span", {["class"] = "documentation-rightbracket"}, "")
	local pipe = mw.text.tag("span", {["class"] = "documentation-pipe"}, "")

	if docTitle.exists then
		local viewLink = makeWikilink(docTitle.prefixedText, data.viewLinkDisplay)
		local editLink = makeWikilink("Special:EditPage/" .. docTitle.prefixedText, data.editLinkDisplay)
		local historyLink = makeWikilink("Special:PageHistory/" .. docTitle.prefixedText, data.historyLinkDisplay)
		return leftbracket .. viewLink .. pipe .. editLink .. pipe .. historyLink .. pipe .. purgeLink .. rightbracket
	else
		local createLink = makeUrlLink(docTitle:canonicalUrl{action = 'edit', preload = data.preload}, data.createLinkDisplay)
		return  leftbracket .. createLink .. pipe .. purgeLink .. rightbracket
	end
模板樣式:
body.skin-minerva .documentation-leftbracket::before,
body.skin-timeless .documentation-leftbracket::before {
	content: "[";
	display: inline-block;
	color: var(--color-subtle, #54595d);
	margin: 0 0.1em;
}

body.skin-minerva .documentation-pipe::after,
body.skin-timeless .documentation-pipe::after {
	content: "|";
	display: inline-block;
	color: var(--color-subtle, #54595d);
	margin: 0 0.1em;
}

body.skin-minerva .documentation-rightbracket::after,
body.skin-timeless .documentation-rightbracket::after {
	content: "]";
	display: inline-block;
	color: var(--color-subtle, #54595d);
	margin: 0 0.1em;
}
象象🐘(留言|貢獻) 2026年8月11日 (二) 13:59 (UTC)回覆
主要是怕附加小工具的顯示問題才沒有用" | "--Addonian1123 (討論|維基教科書) 2026年8月17日 (一) 07:01 (UTC)回覆

技術問題

[編輯]
(※)注意:根據phab:T268900,這項修改在Minerva及timeless的skin下會出現問題,導致分隔號消失:
需要近一步討論。--Addonian1123 (討論|維基教科書) 2026年8月3日 (一) 07:53 (UTC)回覆
目前一種解決方案是在css中手動為minerva和timeless加入間距:enwiki編輯紀錄
檢視編輯歷史清除快取-->檢視 編輯 歷史 清除快取

但這樣不會加入括號 - [檢視|編輯|歷史|清除快取]--Addonian1123 (討論|維基教科書) 2026年8月3日 (一) 08:06 (UTC)回覆
或許可以為"["和"]"加css class,然後只在minerva和timeless顯示? 象象🐘(留言|貢獻) 2026年8月4日 (二) 12:38 (UTC)回覆
或許可以當作熱修復(hotfix),phab:T405802正在着手修復此問題,未來需要移除。Addonian1123 (討論|維基教科書) 2026年8月4日 (二) 13:05 (UTC)回覆
Beta Cluster測試站上調整過後的外觀:標準Minerva外觀Timeless外觀。 -- Addonian1123 (討論|維基教科書) 2026年8月6日 (四) 06:54 (UTC)回覆
已經變更說明。Addonian1123 (討論|維基教科書) 2026年8月6日 (四) 08:48 (UTC)回覆
這算是臨時性的修復嗎?(等待phab:T268900徹底解決)--百無一用是書生 () 2026年8月14日 (五) 08:06 (UTC)回覆
Minerva和Timeless的部分算是。 象象🐘(留言|貢獻) 2026年8月14日 (五) 08:11 (UTC)回覆
這個修復在Minerva和Timeless的部分是作為臨時修復(但T268900已經一陣子了),而其他的skin是長期修復--Addonian1123 (討論|維基教科書) 2026年8月15日 (六) 05:20 (UTC)回覆