檢視模板:Ref/doc 的原始碼

==描述==
此模板功能為在文章中為某段敘述標記註腳或參照來源，與pukiwiki的雙小括號「((參照來源))」效果相同。
使用標籤<code><nowiki><ref>參照來源</ref></nowiki></code>可達到相同效果。

與<code><nowiki><ref></nowiki></code>標籤不同之處在於：MediaWiki碼翻譯成瀏覽器可用的HTML碼時，<code><nowiki><ref></nowiki></code>標籤可能出現轉譯先後順序的問題而無法正常顯示參照內容，但<code><nowiki>{{ref}}</nowiki></code>模板不存在此一問題。
===注意===
*註腳/參照應盡量避免巢狀構造（例如<code><nowiki><ref></nowiki></code>標籤的內容裡還有其他<code><nowiki><ref></nowiki></code>標籤），否則可能會產生異常。
*如果參照文字當中存在等號，且無法使用<code>&lt;nowiki></code>標籤時（例如連結中的等號），請在參照文字前面輸入<code>1=</code>、參照群組名稱前輸入<code>2=</code>或<code>name=</code>，使後方等號不會引發錯誤
**例如：<code>{{color|red||<nowiki>{{ref|翻譯轉自[https://forum.gamer.com.tw/C.php?bsn=26742&snA=13244 巴哈姆特]<nowiki/>|fgo-translate-baha}}</nowiki>}}</code>
*:改成→<code><nowiki>{{ref|</nowiki>'''1='''<nowiki>翻譯轉自[https://forum.gamer.com.tw/C.php?bsn=26742&snA=13244 巴哈姆特]<nowiki/>|</nowiki>'''2='''<nowiki>fgo-translate-baha}}</nowiki></code>

==語法==
<code><nowiki>{{ref | 欄位1}}</nowiki></code>–一般情況

<code><nowiki>{{ref | 欄位1 | 欄位2 }}</nowiki></code>或<code><nowiki>{{ref | 欄位1 | name= }}</nowiki></code>–需要被重複參照時（每個代號限制只能有一次參照/註腳具備內容）

<code><nowiki>{{ref | | 欄位2}}</nowiki></code>或<code><nowiki>{{ref | name= }}</nowiki></code>–重複利用舊有參照（註腳）時

*欄位1：參照來源（或註腳內容）
*欄位2：組別代號，為選擇性，當有兩個以上ref模板的欄位2具備相同的值時，會被歸為同一組
**同一組ref中，只有欄位1非空白的第一個ref的內容會顯示
*name：組別代號，功能與欄位2完全相同，但同時存在的狀況下會優先取name的值
**當使用name時，欄位1可以放在name之後而不影響功能（<code><nowiki>{{ref | name= | 欄位1 }}</nowiki></code>）
*與[[Template:reflist]]或<nowiki><references />標籤</nowiki>搭配使用，可以在頁中插入另一個參照（註腳）列表
**MediaWiki預設會在頁尾自動補上<nowiki><references /></nowiki>（不會出現在文件中），因此即使不手動追加也沒問題

==範例==
<pre>
保安<ref>ref標籤</ref>！可以讓時臣{{ref|此世全部之錯（欄位2空白）}}錯{{ref|一錯再錯（欄位2為"mistake"）|mistake}}了又錯{{ref|| mistake}}錯{{ref|欄位2為「大錯」|大錯}}了又錯{{ref|name=大錯}}的嗎？

組別0{{ref||組別0}}{{ref|組別0內容A|組別1}}{{ref||組別2|name=組別0}}

組別1{{ref||組別1|group=group0}}{{ref|組別1內容A|組別1|group=group0}}{{ref||組別2|name=組別1|group=group0}}

組別2（會出錯）{{ref|組別2內容B|組別2}}{{ref||組別2}}{{ref|組別2內容A|組別2}}
<references group="group0" />
----
{{reflist}}
</pre>

保安<ref>ref標籤</ref>！可以讓時臣{{ref|此世全部之錯（欄位2空白）}}錯{{ref|一錯再錯（欄位2為"mistake"）|mistake}}了又錯{{ref|| mistake}}錯{{ref|欄位2為「大錯」|大錯}}了又錯{{ref|name=大錯}}的嗎？

組別0{{ref||組別0}}{{ref|組別0內容A|組別1}}{{ref||組別2|name=組別0}}

組別1{{ref||組別1|group=group0}}{{ref|組別1內容A|組別1|group=group0}}{{ref||組別2|name=組別1|group=group0}}

組別2（會出錯）{{ref|組別2內容B|組別2}}{{ref||組別2}}{{ref|組別2內容A|組別2}}
<references group="group0" />
----
{{reflist}}

[{{fullurl:{{FULLPAGENAME}}}}?action=purge 點此連結重新整理]<includeonly>[[Category:模板]][[Category:引用模板]]</includeonly><noinclude>[[Category:模板文件]]</noinclude>