模組討論:Documentation

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

編輯請求 2021-05-07

請求已處理Hamish with w. 2021年5月7日 (五) 15:27 (UTC)

基於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)

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

目前討論狀態：

特殊頁面掛模板問題 進行中……：設立特殊頁面提刪制度 無共識：使用討論頁提刪模式 進行中……：引入能夠在特殊頁面掛模板的模組 已通過：特殊頁面懸掛模板之模組 已佈署：Module:Module wikitext 已佈署：Module:Special wikitext 已佈署：特殊頁面掛模板的頁面預覽工具 擱置：提刪工具（WT:TW）支持 進行中……：基於上述技術修訂方針 其他議題： 擱置：DOC提示 等待中：特殊頁面分類問題

-- 五歲抬頭雪菲（☎️·☘️） 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)

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

---

於Phabricator查看
編號T235798的工單

為了解決模板掛不上去或者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)

• 目前辦理狀況：等待工單phab:T235798佈署。-- 五歲抬頭雪菲（☎️·☘️） 2021年4月27日 (二) 14:58 (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)

公示期討論：技術案

• 公示：對於技術相關的反對意見已排除，將Module、JS、CSS掛模板方案 公示7日（通過後JSON其實也能掛模板，但頁面分類暫時無法更新，需要phab:T235798）根據結論，暫時不修改方針。-- 五歲抬頭雪菲（☎️·☘️） 2021年4月28日 (三) 12:15 (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)

• 非常感謝說明，但建議刪去重複的語句，太多重複語句會影響其他人閱讀。--蟲蟲飛♡♡→♡℃※留言 2021年4月28日 (三) 13:14 (UTC)
  • 感謝提醒，已刪去。-- 五歲抬頭雪菲（☎️·☘️） 2021年4月29日 (四) 08:04 (UTC)

• (～)補充模板掛法說明，「可以在原本的頁面掛」，但需要符合對應頁面的頁面內容模型，語法如下所示，可討論是否需要補充進指引（c.c. @蟲蟲飛：）：
  • JSON頁面：在最外層的{...}之內加入代碼：（上述模塊引入後，JSON頁面雖能顯示模板，但分類暫時不會自動歸檔，需等待phab:T235798佈署）

    "_addText":"{{Delete|快速刪除理由}}"

  • Array形式的JSON頁面：在最外層的[...]之內加入代碼：（如頁面開頭與結尾符號是中括號時[...]）

    {"_addText":"{{Delete|快速刪除理由}}"}

  • 位於模塊名字空間的頁面（文檔頁面除外）：加入代碼：

    require('Module:Module wikitext')._addText('{{Delete|快速刪除理由}}')

  • CSS頁面：加入代碼：

    ._addText{
    	content:"{{Delete|快速删除理由}}";
    }
    

  • JavaScript頁面：加入代碼：

    var _addText="{{Delete|快速刪除理由}}";

  同時提供給WP:TW開發者參考。-- 五歲抬頭雪菲（☎️·☘️） 2021年4月29日 (四) 08:33 (UTC)

  • (～)補充en:special:diff/978461935英文維基對應功能的WP:TW代碼實現請參考此處。-- 五歲抬頭雪菲（☎️·☘️） 2021年4月29日 (四) 08:39 (UTC)

  eslint: _addText沒被定義-- Sunny00217  2021年4月30日 (五) 07:34 (UTC)

  • @Sunny00217：那這樣不就得了？var _addText="{{Delete|快速刪除理由}}";-- 五歲抬頭雪菲（☎️·☘️） 2021年4月30日 (五) 07:50 (UTC)

    @A2569875：只是想到覺得好笑貼上去而已（因此也沒 ping），實際上不會有人要提刪了還用 eslint 的 xxdd-- Sunny00217  2021年4月30日 (五) 12:29 (UTC)

  • 嗯。這個做法也不錯，或許可以解決蟲蟲飛的顧慮。我到上面修改一下方針文本。--Tranve (✉) 2021年4月30日 (五) 10:30 (UTC)
    • (＆)建議@Tranve：要改方針建議先等技術通過再說，不然一起推行只會一起卡死。-- 五歲抬頭雪菲（☎️·☘️） 2021年4月30日 (五) 10:32 (UTC)
      • 感謝提醒！您的方案我再看了一下，對於 JSON 頁和模塊頁的處理我沒有意見，但是 CSS 的處理方式是不是有點 dirty，這樣相當於整了一個不存在的_addText class，JavaScript 我認為也有這樣的問題。萬一有腳本要用到 _addText 變量呢？另外，這個變量一定要是全局變量嗎？我的提案，也就是在頁面最開頭的註釋裏頭放進{{d}}模板的做法，也是可行的。--Tranve (✉) 2021年4月30日 (五) 10:37 (UTC)
        • @Tranve：完全沒有影響，也不認為有任何問題，加那樣只是讓模板可以被顯示，重點只是能否讓管理員標記要提刪，並且註明「模板能被顯示的方案」，你高興只寫/*{{Delete|快速刪除理由}}*/也能被加入速刪分類，只是模板不會顯示。因為技術限制/*{{Delete|快速刪除理由}}*/寫法無法讓模板被顯示。 我仍想推行能讓模板被顯示的方案或手段，因為可以用於插入DOC類的用途。由於是正則，以下的表達是都能識別：

          • /* var _addText="{{Delete|快速刪除理由}}"; */
          • /* _addText{content:"{{Delete|快速刪除理由}}";} */
          • wiki_addText="{{Delete|快速刪除理由}}";
          • []._addText = '{{Delete|快速刪除理由}}';
            註：此處原有文字，因為過多重複內容，已由五歲抬頭雪菲（☎️·☘️）於2021年4月30日 (五) 16:15 (UTC)刪除，尚祈見諒。若有異議請至互助客棧或向管理員反映。
            。-- 五歲抬頭雪菲（☎️·☘️） 2021年4月30日 (五) 11:25 (UTC)

            既然都是用regex來匹配，為何不採用最簡單的格式，即註解的格式。--Xiplus#Talk 2021年5月1日 (六) 00:53 (UTC)

            • 並不想讓所有的註解都被匹配。而且其他非wikitext 的註解也一同渲染會很凌亂。—- 五歲抬頭雪菲（☎️·☘️） 2021年5月1日 (六) 01:21 (UTC)

              您可以精準匹配 /* {{Delete|...}} */ ，而不僅是註解。--Xiplus#Talk 2021年5月1日 (六) 02:58 (UTC)

              (－)反對我希望能夠放不是模板的wikitext ，其他用途如DOC或說明文件，包括但不限於速刪之用，且英文維基的en:Module:Module wikitext也沒有限制能放的wikitext 種類，沒道理中文維基製作類似模組就要加入奇怪的限制；此外lua 正則不支援組的或模式（例如(A|B)），而且刪除模板也有許多重新導向，完全不建議精準匹配，如果只考慮刪除用途，亦會有AFD模板問題，且不建議用lua 簡化功能、功能不全的正則來匹配模板，因為很難解決模板嵌套問題，亦不建議限制用戶不能在提刪理據裏面以其他模板表示。—- 五歲抬頭雪菲（☎️·☘️） 2021年5月1日 (六) 03:39 (UTC)

              但是本提案只是想解決掛速刪模板的問題，目前來看/* {{Delete|...}} */可以被正確加到分類里，這對於管理員速刪頁面來說足夠了。至於速刪理由，我覺得可以通過方針強制規定註釋加到開頭即可，這樣管理員可以直接看見。如果真要解決掛 DOC 的問題的話，英文維基似乎可以顯示一個提示文本「This user script seems to have a documentation page at XXX」，範例見 en:User:Cacycle/wikEd.js。--Tranve (✉) 2021年5月5日 (三) 08:31 (UTC)

              • @Tranve：完全不認為有任何衝突，技術案是我提出的臨時動議，我認為統一讓JSON和其他頁面加入此方式沒甚麼問題，只見你一直試圖阻擋提案，甚至在通過的前三個小時故意推翻先前的協議，前幾天你明明已經在TG說可以接受了，又在通過的前三個小時惡意異議，涉嫌WP:遊戲維基規則，且你的提案在json中是無效的，需要性早已在WP:TG陳述，且未見有甚麼不妥之處，英文維基怎麼做事英文維基的事，WP:是英文維基說的！，(！)抗議追隨英文維基論；此外，作為視覺派使用者，我強烈支持模板顯示，(！)強烈抗議模板不顯示。-- 五歲抬頭雪菲（☎️·☘️） 2021年5月5日 (三) 08:43 (UTC)
                1. 你的提案在JSON中是無效的，我希望一個統一模式，且我這個統一的_addText模式適用於所有頁面內容模型，Antigng也有說，_addText以底線命名就是要避免變數命名衝突問題，因此未見我的提案有任何問題。
                2. 你的提案在JSON中是無效的，所以這對於管理員速刪頁面是完全無法操作的，無法解決蟲蟲飛的疑慮。
                3. 速刪理由問題，速刪模板本身有許多編輯提示，可以對要執行素珊的管理員做出提醒，避免誤操作，認為顯示模板是有好處的。
                4. 有模板能正常顯示的方案，為何使用提示文字? 有些使用者使用手機閱覽維基百科，會需要多一層操作來檢視模板顯然多此一舉，且提案明明可以正常顯示模板，未見為何故意還要多一道手續顯示模板。請照顧使用特殊裝置的維基使用者。
                5. 在公視到期臨界時間惡意反對被WP:VIP的例子詳見Wikipedia_talk:關注度_(虛構)#通過後討論，可以很明顯地看到，是唯一一個反對通過的人，而他現在這樣強行阻止條文通過的做法已經構成遊戲維基規則。

              以上-- 五歲抬頭雪菲（☎️·☘️） 2021年5月5日 (三) 08:59 (UTC)

              • （編輯衝突）再補充一點，en:User:Cacycle/wikEd.js顯示東西的原理跟本地提案相同，是透過介面編輯請求完成，同樣是Antigng提到的「介面黑魔法」，內部依然需要有模組程式碼去匹配對應頁面計算對應頁面的狀態，且過往許多從英文維基引入的提案也都會有本地特化，未見本地特化提案有任何問題。且要完成有關提案也需要進行本案相關編輯請求。持續(！)抗議中。-- 五歲抬頭雪菲（☎️·☘️） 2021年5月5日 (三) 09:09 (UTC)
                • @A2569875：Sorry，了解了。我覺得我們這樣談下去也沒完沒了。我希望您關於掛速刪模板的提案通過後可以試行一段時間，根據用戶和管理員的反饋再進行修正，可以嗎？--Tranve (✉) 2021年5月5日 (三) 09:15 (UTC)

  @Tranve：關於您的意見，en:User:Cacycle/wikEd.js涉及en:Template:Script doc auto的引入，已經不是本案處理範圍，應另提新案。-- 五歲抬頭雪菲（☎️·☘️） 2021年5月5日 (三) 09:28 (UTC)

  • (～)補充關於未來根據反饋修正可以，已在下方預留反饋章節。-- 五歲抬頭雪菲（☎️·☘️） 2021年5月5日 (三) 09:51 (UTC)
    • 說明已多等待一日，未見反方有更多意見，因此以「反對者的論述已由支持者回應，且反方無進一步論述」論。-- 五歲抬頭雪菲（☎️·☘️） 2021年5月6日 (四) 12:51 (UTC)
      • 又過了一天，未見新意見或異議，以通過論。-- 五歲抬頭雪菲（☎️·☘️） 2021年5月7日 (五) 13:41 (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)，公示已結束（3年前）(更新)-- 五歲抬頭雪菲（☎️·☘️） 2021年5月5日 (三) 10:00 (UTC)

---

• 通過：公示期已過，且已逾時超過一日（3年前），在公示期將結束至此刻（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)