WMDE Technical Wishes/Sub-referencing/yue

子參考
Status	進行緊
Origin	技術願望調查2013, 2015, 2022同埋其他
Focus area	令重用參考文獻仲容易啲
Phabricator	項目板
Responsible	技術願望團隊
話畀我哋知你諗緊啲乜 我哋邀請你嚟「測試我哋嘅原型」，我哋會不斷更新緊。 監視 呢個頁面定係 申請呢個大量訊息清單 去學習並測試埋多啲新嘅嘢 閱讀更多有關測試同意見嘅資訊

目前，唔可能喺一篇文章入面輕易「重用同一個參考資料，但係有啲唔同嘅細節」。社群成員一再要求一個 mediawiki 解決方案，呢個解決方案唔需要範本，而且係基於現有嘅參考工作方式，適用返於 wikitext 同埋 Visual Editor 。 »了解多啲有關呢個問題嘅資訊

作為重點領域嘅一部分「令重複噉使用返晒啲參考資料更加容易」, 維基媒體德國嘅技術願望團隊引入緊「子參考」 - 呢個係一個可選功能，令你可以輕鬆噉將唔同嘅細節附加到現有嘅參考，而唔使重複佢。

我哋嘅計劃係喺2024年底將子引用帶到維基媒體維基。

• » 常見問題
• » 最近嘅變動同下一步

要引用多過一次有唔同細節嘅來源，你需要一個主要參考文獻同一個子參考文獻。

• 「主要參考文獻」包含主要嘅參考文獻資料。
• 「子參考文獻」包含詳情：頁號，或者任何種類嘅額外資料，而呢啲資料每個引文都唔同，例如章節、詩篇或者碌士。

• 喺參考文獻部分，「讀者」會睇到所有子參考文獻喺佢哋嘅主要參考文獻下面分組埋一齊。噉樣就可以更容易掌握嗰篇文章入面引用咗單一來源嘅頻率。
• 對於wikitext，你會用一個新嘅屬性嚟做子引用。嗰個屬性嘅目前名稱係「延伸」，但係喺部署功能之前個名可能會改變。我哋會收集更多有關個名嘅意見。
• 喺視覺編輯器入面，我哋會改變現有嘅引文對話框，令佢支援子參考文獻。

• 子參考係基於現有嘅參考工作方式。
• 佢適用於視覺編輯器同維基文字 – 令我哋更接近視覺編輯器同維基文字之間嘅特徵平等。
• 呢個解決方案將會整合到 MediaWiki 入面，所以可以喺所有維基媒體維基入面使用，而且唔需要基於模板嘅解決方法就可以使用。
• 子參考資料會喺參考資料預覽同埋流動參考資料彈出式視窗入面正確顯示。
• 呢個係選擇性嘅：你仍然可以用其他方法嚟參考。但係你可能會喺其他用戶寫嘅文章入面遇到子引用。

唔該話我哋知你點睇。重要嘅係，呢個新功能唔會打斷用戶嘅工作流程，而且係直覺嘅，而且對 wikitext 同 Visual Editor 用戶嚟講都好有效，無論佢哋嘅經驗水平或者對 wikitext 同範本嘅知識係點。為咗確保呢一點，我哋需要你嘅意見：

• 測試原型！ 閱讀更多有關點樣測試嘅資訊 。
• 喺 討論頁 提供一般意見。
• [1] 呢個頁面或者申請呢個大量訊息清單 去學習你可以測試嘅新嘢。

佢點樣運作

喺Wikitext入面

子引用嘅維基文字解決方案就快完成喇。不過，個屬性嘅名稱 可能會改變。呢個解決方案仲未部署，主要係因為我哋想避免 Visual Editor 用戶嘅體驗同 wikitext 用戶有好大分別。 支援視覺編輯器仲係開發緊。 你仲可以測試個原型同埋話畀我哋知佢對你嚟講係點樣運作。

維基文字專用嘅好處

• 解決方案係基於現有同已知嘅命名參考概念。
• 唔需要任何範本知識。
• 可以喺維基文字入面移除幾乎重複嘅參考，令到佢更乾淨、更少多餘同埋更易閱讀。

 

---

 

一步一步噉進行

1）你需要一個有主要參考文獻資料嘅參考文獻，即係「主要參考文獻」。呢個參考需要一個名稱：

<ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref>

呢個主要參考文獻應該係放喺參考文獻部分，如果唔係你會喺文章入面有一個參考文獻，但係唔會顯示任何詳情，例如頁號。喺參考文獻部分，用語法<references> … </references>。如果文章已經用緊 <references />，請移除咗佢。

2）你建立一個「子參考」，用主參考嘅名同埋屬性擴展。你可以喺 <ref> 標籤之間加入詳情：

<ref extends="Miller">Page 23.</ref>

佢嘅外觀係噉嘅：

According to scientists, the Sun is pretty big.<ref extends="Miller">Page 23.</ref> In fact, it is very big. Take their word for it.<ref extends="Miller">Page 48.</ref> Don't look directly at the sun!<ref extends="Miller">Page 23.</ref> ==References== <references> <ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> </references>

記住

如果你想用 wikitext 入面嘅子參考嚟引用一個「新」來源，你只需要確保喺參考文獻部分建立主要參考。

但係喺好多情況下，你可能想用文章入面已經存在嘅參考資料嚟使用子參考。喺呢啲情況下

1. 用<ref name>將原始參考變成主要參考。
2. 將主要參考資料移到參考資料部分。
3. 建立一個子參考，而原始參考之前喺文章文字入面。
4. 將主要參考文獻嘅詳情（頁號等）移入子參考文獻。確保佢哋唔再留喺主要參考資料入面，如果唔係嗰啲詳情會顯示兩次。
5. 喺你想喺文章入面引用唔同詳情嘅來源嘅地方，建立更多子參考文獻。

你亦可以透過為子參考命名，嚟「重用子參考本身」：

According to scientists, the Sun is pretty big.<ref extends="Miller" name="Miller, 23">Page 23.</ref> In fact, it is very big. Take their word for it.<ref extends="Miller">Page 48.</ref> Don't look directly at the sun!<ref name="Miller, 23" /> ==References== <references> <ref name="Miller">E. Miller, ''The Sun''. New York: Academic Press, 2005.</ref> </references>

請注意

• 將參考文獻轉換為主要同子參考文獻需要一啲清理；而主要參考文獻通常需要喺參考文獻部分(如上所述)。
• 你可以用引文範本嘅子引用。我哋已經測試咗最常用嘅範本，但係你最鍾意嘅範本可能需要一啲更新先可以配合我哋嘅解決方案。
• 部分同參考相關嘅小工具/腳本亦可能需要更新，以便正確使用新嘅子參考解決方案。
• 唔可能將子參考嘅子參考變成子參考。
• 如果用嘅係<ref group>，主引用同子引用需要喺同一組。

 測試個原型

我哋需要你嘅意見嚟確保我哋建立啱嘅嘢。歡迎喺呢個項目嘅 討論頁提供意見或者問題。

原型可以喺測試版 wiki 上面搵到。目前，我哋主要邀請你測試 wikitext 解決方案： 喺測試版 wiki 上面測試 反應

請注意 測試版 wiki 同你嘅普通 wiki 有啲唔同：

• 佢哋可能睇落唔同（例如唔用你鍾意嘅背景）。
• 佢哋可能會提供一啲仲喺測試緊嘅新功能。
• 佢哋只係包含一啲測試頁面同範本，而唔係你嘅整個 wiki 內容，亦都唔係你習慣嘅所有範本、模組、小工具等等。
• 你嘅常規維基媒體登入喺測試版維基上面唔適用。你可以註冊一個帳戶 - 確保用同你一般嘅維基媒體帳戶唔同嘅密碼 - 或者喺冇帳戶嘅情況下測試呢個功能，噉樣會導致建立一個臨時帳戶 （喺de-betawiki上面） – 或者顯示你嘅 IP 位址（喺en-betawiki上面）。

我哋解決緊嘅問題

喺維基百科嘅文章入面，通常會多次參考一個來源。但係雖然你可以「完全按照原樣」重複使用參考文獻，但係你宜家唔可以用「唔同嘅詳情」（例如唔同嘅頁號）重複使用同一個參考文獻。你唯一嘅選擇就係建立一個全新嘅參考資料或者使用解決方法。

現狀：重用維基文字同視覺編輯器入面嘅參考資料

如果你想重用 wikitext 入面嘅參考，你可以將佢變成 命名參考，然後喺文章嘅另一個地方參考嗰個名。命名嘅參考文獻可以放喺文章文字或者參考文獻部分。喺視覺編輯器入面，你可以用引文對話框入面嘅「重用」選項。喺參考文獻部分，同名嘅參考文獻會分組埋一齊。

• ">
  維基文字：文章文字入面嘅<ref name>
• ">
  維基文字：參考文獻部分入面嘅<ref name>
• 
  視覺編輯器：引文對話框
• 
  讀者睇法

現狀：重用維基文字入面有唔同詳情嘅參考文獻

如果你想喺 wikitext 入面重用一個有唔同詳情嘅現有參考，你而家需要複製同貼上現有嘅參考，然後更改重複嘅詳情，或者由頭開始建立一個新嘅（幾乎相同）嘅參考。有啲項目會用短引文之類嘅解決方法，或者縮短腳註之類嘅基於模板嘅解決方案。喺參考文獻部分，原始參考文獻同你建立嘅新參考文獻唔會分組埋一齊。

• 
  維基文入面有兩個幾乎相同嘅參考文獻。
• 
  讀者嘅睇法：幾乎相同嘅參考文獻唔會分組埋一齊
• 
  喺維基文字入面用短引文嘅解決方法
• 
  讀者嘅觀點：用短引文嘅解決方法
• 
  用維基文字入面嘅{{sfn}}解決方法
• 
  讀者嘅睇法：用 {{sfn}} 解決方法

現狀：重用維基文字入面有唔同詳情嘅參考文獻

如果你想喺 Visual Editor 重用現有嘅參考文獻，但係有唔同嘅細節，揀返引文對話方塊入面嘅「重用」 同埋複製貼上方法都唔會運作，因為兩者都會導致「相同」會重複使用，而改變重複使用/複製咗嘅參考資料嘅詳情會改變嗰個參考資料嘅「兩個」實例。相反，你需要由頭開始建立一個新嘅（幾乎相同）參考資料。喺參考文獻部分，原始參考文獻同你建立嘅新參考文獻唔會分組埋一齊。

由基於模板嘅解決方法（例如 {{sfn}} ）建立嘅參考文獻唔可以喺參考文獻部分入面編輯，亦都唔會顯示喺引文重用標籤入面；但係喺文章文字入面搵到佢哋嗰陣，可以手動編輯佢哋。

用 $ code 解決方法：

• 
  讀者睇法
• 
  撳一下「編輯」嗰陣，參考文獻就會喺參考文獻部分消失。
• 
  唔可以透過「重用」對話框使用{{sfn}}嘅參考資料。
• 
  淨係喺得文章文字入面搵到參考文獻嗰陣先可以編輯參考文獻

讀者嘅問題

基於範本嘅解決方法喺參考預覽、參考工具提示同埋流動參考彈出式視窗入面唔會正確顯示。

$Code解決方法，預覽參考資料：

• 
  參考預覽：主要資料唔包括喺彈出式視窗入面。
• 
  參考工具提示：主要資料唔包括喺最初嘅彈出式視窗入面。
• 
  參考預覽：主要資料唔包括喺彈出式視窗入面。
• 
  流動 參考彈出式視窗：主要資料唔包括。

現狀嘅主要問題

• 視覺編輯器同維基文字用戶嘅體驗係好唔同嘅。
• 大部分重用唔同細節嘅參考嘅解決方法喺 Visual Editor 入面都唔會正常運作。
• 建立好多幾乎相同嘅參考文獻，但係細節唔同，令到維基文字更長，亦可能更難閱讀。
• 基於範本嘅解決方法唔係所有社群都平等接受，所以唔係全球可用。
• 有啲用戶試圖避免呢個問題，將來源放入參考文獻部分，而完全唔用佢哋做參考，令到驗證文章嘅部分更加難。

最近嘅變動同下一步

我哋嘅團隊已經斷斷續續噉解決咗呢個問題一段時間。 呢度係呢個項目嘅歷史概覽，包括我哋嘅研究。
多謝晒所有參與測試同面試同埋表現出興趣嘅人，同埋所有多年來抽空喺我哋嘅討論頁面留言嘅人。呢個係深入啲嘅欣賞。如果你有多啲意見，請喺討論頁度分享。

• Y 「原型」可以喺測試版 wiki 上面搵到。 佢涵蓋咗維基文字解決方案同埋視覺編輯器解決方案嘅一啲基本功能。 你可以持續測試原型同埋提供意見。
• Y 我哋會喺所有 wiki 上面發出公告，話畀社群知呢個即將推出嘅功能，同埋邀請佢哋測試同埋提供意見。
• Y Our team presented sub-referencing at Wikimania 2024 and discussed with participants. (YouTube)
• Y Moderated users tests took place across different projects in 2024.
• As of October/November 2024, we are currently exploring possible changes to our wikitext approach, based on the community feedback we've received. We'll reach out to communities soon to get more feedback on possible changes to the sub-referencing feature.
• Pilot wiki deployment is stalled, pending discussions and potential changes to our feature.
• We are planning to deploy the sub-referencing feature to other Wikimedia wikis in 2025.
• 我哋會繼續收集緊啲意見，喺部署之後改善解決方案。

我哋知道重點領域「重用參考文獻」嘅其他問題，我哋會嘗試一路解決晒佢哋。 但係，我哋嘅重點仍然係創造一個子參考嘅解決方案。

常見問題

任何使用子參考嘅頁面都會加入一個叫做類別：使用擴充參考嘅頁面嘅追蹤類別，令你可以用新功能探索或者修正頁面。呢個類別嘅名稱可能會改變。

係，你可以用引文範本嘅子參考。 我哋測試咗最常見嘅引文範本（例如引文書或者引文網絡），而且唔會出現任何問題。 但係你最鍾意嘅範本可能需要一啲更新先可以配合我哋嘅解決方案。 部分同參考相關嘅小工具/脚本亦可能需要更新，以便正確使用新嘅子參考解決方案。 由於模板、小工具同脚本都喺 wiki 社群手上，所以我哋冇辦法改編晒佢哋。

如果你發現有任何問題，或者需要幫手更新多啲嘅引文範本，等佢哋可以配合新功能，請喺討論頁面同我哋講

亦都邀請埋你嚟我哋嘅 Wikimania 工作坊「$1全新嘅引文選項 – 呢個對引文範本嚟講係咩意思？」（混合型），或者遲啲先至睇返啲錄音。

我哋仲未知道。 目前，喺 wikitext 入面建立子參考嘅屬性名稱係extends 。 我哋幾年前喺維基媒體基金會同社區同利益相關者討論之後決定咗呢個名。不過，我哋收到一啲意見，話呢個名可能唔係最好嘅選擇。 喺我哋將呢個功能部署到 wiki之前，我哋想得到更多有關屬性名稱嘅意見，同埋計劃提出一啲替代方案嚟討論。當呢個情況發生嗰陣，我哋會話你知。

當我哋第一次開始研究呢個功能嘅維基文字實現嗰陣，我哋討論咗唔同嘅選項。 加入新標籤（例如 <subref> ）已經仔細討論過，但我哋想堅持現有嘅 <ref>方法，以將用戶要學習嘅新語法量減至最低。 另外，引入新嘅標籤需要對現有嘅社群軟件（工具、小工具、機器人等）進行好多更新，以便參考。

其中一個提議(2008年起) 係喺 $ code 標籤入面指定子參考嘅詳情：<ref page="page 2" name="Miller"> 或更高版本嘅 <ref detail="page 2" name="Miller">，用 name 屬性嚟參考主要參考。 呢個同用戶喺使用{{cite book}}。之類嘅範本入面所知道嘅嘢相似。

但係呢個方法嘅主要問題係，佢會引起「模板問題」，同埋「好有可能會引起錯誤」。 呢個語法嘅另一個問題係佢「唔允許重用子引用」，因為名稱嘅屬性已經用嚟引用主要引用，所以唔可以再用得第二次。

避免呢兩個問題嘅一個方法係建立一個新嘅參考屬性，然後將子參考嘅詳情放喺開頭同結尾<ref>標籤之間嘅區域，同參考文獻內容已經做嘅方法一樣。 呢個就係我哋嘅方法嘅作用。

技術願望團隊已經斷斷續續噉研究咗呢個功能好多年。 如果你想知多啲，呢度有個問題嘅歷史同複雜性概覽