模板:Refer/doc

本模板為特性介於{{註解}}和<ref>標籤之間的註解模板，需配合{{references}}使用。

參數

以下所有參數，名稱參數比位置參數優先。

• 被註解內容/位置參數1：被註解的文字。
• 註解/位置參數2：註解內容。將顯示在對應的{{references}}或{{AllReferences}}處。
• 組名/位置參數3：註解組名。不填默認為無。
• 註解顏色、註解背景、內容顏色、內容背景：顧名思義。

優缺點

優點

1. 和{{註解}}模板相比，本模板可以進行註解的分組、更加靈活地調節內容背景顏色。
2. 和<ref>標籤相比，本模板可以使用內容背景對被註解內容進行標註，從而避免了歧義的發生。
3. <ref>標籤無法嵌套（套娃）<ref>標籤，{{ref}}模板嵌套又會因為套娃導致閱讀體驗的降低，使用本模板即可比較美觀地實現對注釋進行二次注釋。

舉例

原始碼：

*这是被注释内容×1<ref>这是注释×1<ref>这是套娃注释×1</ref></ref>

{{reflist}}
----
*这是被注释内容×2{{ref|这是注释×2{{ref|这是套娃注释×2}}}}

{{reflist}}
----
*{{refer|这是被注释内容×3|这是注释×3{{ref|这是套娃注释×3}}|[注]}}

{{references|[注]}}
{{reflist}}

輸出↓

• 這是被注釋內容×1</ref>

---

• 這是被注釋內容×2

---

• 這是被注釋內容×3^[注]1

[注]. 這是注釋×3

缺點

1. 使用本模板生成的注釋沒有類似<ref>標籤的跳轉連結，即查看注釋內容只能滾動到{{references}}模板處。如果頁面內容過多，完全使用本模板取代<ref>標籤將會給瀏覽帶來極大的不便。
2. 本模板的註解組名默認為無。也就是說，在不指定注釋組名時，內容中的注釋標記是單一的數字，不夠明顯。

使用例

與{{references}}、{{AllReferences}}的聯合使用例：

原始碼：

{{refer|something|supp1|supp}}

{{refer|something|empty1}}

*{{refer|something|meow{{n}}|喵|内容背景=pink}}
*{{refer|something|ref|注}}
*{{refer|something|nyaaa{{n}}|喵|注解颜色=magenta}}
*{{refer|something|woof|汪}}
*{{refer|something|{{color|gold|references}}|注}}

以下为注解：

{{references|}}

{{references|supp}}

{{references|喵}}

{{references|注}}

以下是更多文字：
*{{refer|something|squeak|吱}}
*{{refer|something|meow{{n}}|喵}}
*{{refer|something|roar|吱}}

以下是上段文字的全部注解：
{{AllReferences}}

輸出↓

something^supp1

something¹

• something^喵1
• something^注1
• something^喵2
• something^汪1
• something^注2

以下為註解：

1. empty1

supp. supp1

喵1. meow1

喵2. nyaaa2

注1. ref

注2. references

以下是更多文字：

• something^吱1
• something^喵1
• something^吱2

以下是上段文字的全部註解：

汪. woof

吱1. squeak

吱2. roar

喵. meow3