Template:RefFoot/doc:修订间差异
外观
删除的内容 添加的内容
MStargazer(留言 | 贡献) 内容扩充 |
|||
(未显示12个用户的27个中间版本) | |||
第1行: | 第1行: | ||
{{Documentation subpage}} |
|||
<includeonly><!-- 在這裡加入模板的保護標識 --></includeonly><noinclude>{{template doc page viewed directly}}</noinclude> |
|||
{{esoteric}} |
{{esoteric}} |
||
__NOTOC__ |
|||
==模板說明== |
==模板說明== |
||
此組模板為「參註分組」,用來 |
此組模板為「參註分組」,用來把頁面的參考資料和註解兩列表分開顯示,構成該基礎模板有: |
||
*'''{{tl|RefTag}}''' |
*'''{{tl|RefTag}}''':標示參考來源上標。 |
||
*'''{{tl|NoteTag}}''' |
*'''{{tl|NoteTag}}''':標示備註上標。 |
||
*'''{{tl|RefFoot}}''' |
*'''{{tl|RefFoot}}''':參考來源列表。 |
||
*'''{{tl|NoteFoot}}''' |
*'''{{tl|NoteFoot}}''':備註列表。 |
||
==模板重定向== |
==模板重定向== |
||
*'''{{tl| |
*'''{{tl|NoteTag}}'''={{tl|注释}}={{tl|備註}}={{tl|备}}={{tl|註}} |
||
*'''{{tl| |
*'''{{tl|NoteFoot}}'''={{tl|註表腳}}={{tl|注释列表}}={{tl|备注表}} |
||
*'''{{tl|RefFoot}}''' = {{tl|參表腳}} |
|||
*'''{{tl|NoteFoot}}''' = {{tl|註表腳}} = {{tl|注释列表}} |
|||
==使用方法== |
==使用方法== |
||
於條目正文中: |
於條目正文中: |
||
*在欲標示參考 |
*在欲標示參考來源的位置加上「 <code>-{}-{{tlBh}}refTag{{!}}name=''同項名稱''{{!}}1=''參考資料文字''{{tlBf}}</code> 」。 |
||
*在欲標示備註的位置加上「 < |
*在欲標示備註的位置加上「 <code>-{}-{{tlBh}}noteTag{{!}}name=''同項名稱''{{!}}1=''註解文字''{{tlBf}}</code> 」。 |
||
*參數說明: |
*參數說明: |
||
**'''name'''(可選):註腳的名稱,用於顯示同項註腳 |
**'''name'''(可選):註腳的名稱,用於顯示同項註腳。 |
||
***name值'''無須加引號'''。 |
***name值'''無須加引號'''。 |
||
**參數'''1''':註腳 |
**匿名參數'''1''':註腳的文字內容。 |
||
***如有設定name參數值,且該name值為該之前的同項參考,則可省略參數1。 |
***如有設定name參數值,且該name值為該之前的同項參考,則可省略匿名參數1。 |
||
***另外,如果頁面採用把註腳原碼集中在頁底的方法,則正文中須設定name值,而匿名參數'''1'''則留空。 |
|||
*無須再用<code><nowiki><ref></ref></nowiki></code>標籤包住模板。 |
*無須再用<code><nowiki><ref></ref></nowiki></code>標籤包住模板。 |
||
於頁底註腳中: |
於頁底註腳中: |
||
*在欲列示參考來源的位置掛上「 < |
*在欲列示參考來源的位置掛上「 <code>{{tlBh}}refFoot{{tlBf}}</code> 」。 |
||
*在欲列示備註的位置則掛上「 < |
*在欲列示備註的位置則掛上「 <code>{{tlBh}}noteFoot{{tlBf}}</code> 」。 |
||
*參數說明: |
|||
*{{tl|RefFoot}} 和 {{tl|NoteFoot}} 均沒有參數。 |
|||
**匿名參數'''1''':註腳原碼內容集中存放附錄處專用。(詳見下文) |
|||
:*如需实现{{tl|reflist}}的分栏效果,可使用: |
|||
<pre> |
|||
{{ReflistH| ... }} |
|||
{{NoteFoot}} |
|||
{{ReflistF}} |
|||
</pre> |
|||
==範例== |
|||
假設有一段這樣的文本: |
|||
<div class="toccolours" style="border:1px dashed #296dad;padding:1em"><tt> |
|||
==內容== |
|||
<br />九子連橫{{tlBh}}refTag|1=參考a{{tlBf}}萬筒索{{tlBh}}noteTag|1=註x{{tlBf}}{{tlBh}}refTag|name=RefB|1=參考b{{tlBf}}, |
|||
<br />五門{{tlBh}}noteTag|1=註y{{tlBf}}風箭{{tlBh}}refTag|name=RefB{{tlBf}}皆盡齊{{tlBh}}refTag|1=參考c{{tlBf}}。 |
|||
<br /> |
|||
<br />==注释== |
|||
<br />{{tlBh}}ReflistH{{tlBf}} |
|||
<br />{{tlBh}}NoteFoot{{tlBf}} |
|||
<br />{{tlBh}}ReflistF{{tlBf}} |
|||
<br /> |
|||
<br />==参考文献== |
|||
<br />{{tlBh}}ReflistH{{tlBf}} |
|||
<br />{{tlBh}}RefFoot{{tlBf}} |
|||
<br />{{tlBh}}ReflistF{{tlBf}} |
|||
</tt></div> |
|||
則顯示的效果為: |
|||
<div class="toccolours" style="float:none; padding:0.3em 1em;">{{noEditH}} |
|||
如果使用註腳原碼內容集中存放附錄處的方法,請依以下方法使用: |
|||
==內容== |
|||
*正文內容使用「 <code>-{}-{{tlBh}}noteTag{{!}}name=''同項名稱x''{{tlBf}}</code> 」和「 <code>-{}-{{tlBh}}refTag{{!}}name=''同項名稱y''{{tlBf}}</code> 」。 |
|||
九子連橫{{refTag|1=參考a}}萬筒索{{noteTag|1=註x}}{{refTag|name=RefB|1=參考b}}, |
|||
**正文處請不要設定匿名參數'''1'''。 |
|||
*頁底請使用「 <code>-{}-{{tlBh}}noteFoot{{!}}1= {{tlBh}}noteTag{{!}}name=''同項名稱x''{{!}}1=''註解文字''{{tlBf}} {{tlBf}}</code> 」和「 <code>-{}-{{tlBh}}refFoot{{!}}1= {{tlBh}}refTag{{!}}name=''同項名稱y''{{!}}1=''參考資料文字''{{tlBf}} {{tlBf}}</code> 」 |
|||
==範例== |
|||
===一般式:註腳原碼內容分散在正文=== |
|||
以下文本: |
|||
<pre>==內容== |
|||
九子連環{{refTag|1=參考a}}萬筒索{{noteTag|1=註x}}{{refTag|name=RefB|1=參考b}}, |
|||
五門{{noteTag|1=註y}}風箭{{refTag|name=RefB}}皆盡齊{{refTag|1=參考c}}。 |
五門{{noteTag|1=註y}}風箭{{refTag|name=RefB}}皆盡齊{{refTag|1=參考c}}。 |
||
== |
==備註== |
||
{{ReflistH}} |
|||
{{noteFoot}} |
{{noteFoot}} |
||
{{ReflistF}} |
|||
== |
==參考資料== |
||
{{ReflistH}} |
|||
{{refFoot}} |
{{refFoot}} |
||
</pre> |
|||
{{ReflistF}} |
|||
{{noEditF}}</div> |
|||
顯示效果為: |
|||
<div class="toccolours" style="float:none; padding:0.3em 1em;">{{noEditH}} |
|||
==內容== |
|||
九子連環{{refTag|showcase=1|1=參考a}}萬筒索{{noteTag|showcase=1|1=註x}}{{refTag|showcase=1|name=RefB|1=參考b}}, |
|||
五門{{noteTag|showcase=1|1=註y}}風箭{{refTag|showcase=1|name=RefB}}皆盡齊{{refTag|showcase=1|1=參考c}}。 |
|||
==備註== |
|||
{{noteFoot|showcase=1}} |
|||
==參考資料== |
|||
{{refFoot|showcase=1}} |
|||
{{noEditF}} |
|||
</div> |
|||
===附錄式:註腳原碼內容集中在頁底=== |
|||
以下文本: |
|||
<pre>==內容== |
|||
東南西北{{noteTag|name=noteA}}大四喜{{noteTag|name=noteB}}{{refTag|name=ref1}}, |
|||
梅蘭{{noteTag|name=noteA}}菊竹{{refTag|name=ref2}}四花齊{{refTag|name=ref3}}。 |
|||
==備註== |
|||
{{noteFoot|1= |
|||
{{noteTag|name=noteA|1=註A}} |
|||
{{noteTag|name=noteB|1=註B}} |
|||
}} |
|||
==參考資料== |
|||
{{refFoot|1= |
|||
{{refTag|name=ref1|1=參考1}} |
|||
{{refTag|name=ref2|1=參考2}} |
|||
{{refTag|name=ref3|1=參考3}} |
|||
}} |
|||
</pre> |
|||
顯示效果為: |
|||
<div class="toccolours" style="float:none; padding:0.3em 1em;">{{noEditH}} |
|||
==內容== |
|||
東南西北{{noteTag|showcase=1|name=noteA}}大四喜{{noteTag|showcase=1|name=noteB}}{{refTag|showcase=1|name=ref1}}, |
|||
梅蘭{{noteTag|showcase=1|name=noteA}}菊竹{{refTag|showcase=1|name=ref2}}四花齊{{refTag|showcase=1|name=ref3}}。 |
|||
==備註== |
|||
{{noteFoot|showcase=1|refs= |
|||
{{noteTag|showcase=1|name=noteA|1=註A}} |
|||
{{noteTag|showcase=1|name=noteB|1=註B}} |
|||
}} |
|||
==參考資料== |
|||
{{refFoot|showcase=1|refs= |
|||
{{refTag|showcase=1|name=ref1|1=參考1}} |
|||
{{refTag|showcase=1|name=ref2|1=參考2}} |
|||
{{refTag|showcase=1|name=ref3|1=參考3}} |
|||
}} |
|||
{{noEditF}} |
|||
</div> |
|||
== |
==備註== |
||
#<code><nowiki>{{noteTag}}</nowiki></code>與<code><nowiki>{{noteFoot}}</nowiki></code>必須同時使用,'''請勿'''混用其他註腳標籤或模板,否則將導致一些專門處理註腳的小工具不能正常運作。 |
|||
如果編輯有noteTag卻無noteFoot模板的頁面,可能觸發「[[Wikipedia:防滥用过滤器|防濫用過濾器]]」在「編輯摘要」寫入「疑似noteTag與noteFoot使用錯誤」。在頁面適當位置加上{{Tl|noteFoot}}即可解決問題。 |
|||
#承上,<code><nowiki>{{refTag}}</nowiki></code>與<code><nowiki>{{refFoot}}</nowiki></code>也必須同時使用,'''不能'''混用其他註腳標籤或模板。 |
|||
#當使用了本系列的分組模板時,'''請避免同時使用不分組的<code><nowiki><ref></nowiki></code>''',以免[[Help:脚注#BUGNOGROUPMIX|註腳系統發生辨認失敗]]之狀況。 |
|||
== 其他类似脚注系列 == |
|||
如果編輯有noteFoot模板卻無noteTag使用的頁面,以前可能觸發「防濫用過濾器」在「編輯摘要」寫入「疑似noteTag與noteFoot使用錯誤」,於2012年9月已修改過濾器停止觸發。 |
|||
{{RefNoteTable}} |
|||
==參見== |
==參見== |
||
*[[Help:脚 |
*[[Help:脚注]] |
||
*[[Wikipedia:列明 |
*[[Wikipedia:列明來源]] |
||
==模板數據== |
|||
<includeonly> |
|||
{{#switch:{{lc:{{PAGENAME}}}} |
|||
|notefoot |
|||
|reffoot=<div></div> |
|||
|#default = |
|||
=== RefTag、NoteTag === |
|||
{{templatedataheader|RefTag、NteTag}} |
|||
<templatedata> |
|||
{ |
|||
"description": "此組模板為「參註分組」,用來把頁面的參考資料和註解兩列表分開顯示。", |
|||
"params": { |
|||
"name": { |
|||
"label": "註腳名", |
|||
"description": "用於顯示同項註腳", |
|||
"type": "string", |
|||
"required": false |
|||
}, |
|||
"1": { |
|||
"label": "註腳文字", |
|||
"description": "如有設定name參數值,且該name值為該之前的同項參考,則可省略本參數。", |
|||
"type": "content", |
|||
"required": false |
|||
} |
|||
} |
|||
} |
|||
</templatedata> |
|||
}} |
|||
{{#switch:{{lc:{{PAGENAME}}}} |
|||
|notetag |
|||
|reftag=<div></div> |
|||
|#default = |
|||
=== RefFoot、NoteFoot === |
|||
{{templatedataheader|RefFoot、NoteFoot}} |
|||
<templatedata> |
|||
{ |
|||
"description": "此組模板為「參註分組」,用來把頁面的參考資料和註解兩列表分開顯示。", |
|||
"params": { |
|||
"1": { |
|||
"label": "註腳集中處", |
|||
"description": "將refTag和noteTag的註腳內容集中存放", |
|||
"type": "content", |
|||
"required": false |
|||
} |
|||
} |
|||
} |
|||
</templatedata> |
|||
}} |
|||
<includeonly>{{sandbox other|| |
|||
<!-- 本行下加入模板的分類,跨維基連結加入Wikidata(參見[[Wikipedia:Wikidata]]) --> |
|||
[[Category:引用模板| ]] |
[[Category:引用模板| ]] |
||
[[Category:頁面訊息模板|註]] |
[[Category:頁面訊息模板|註]] |
||
}}</includeonly> |
|||
<!-- 本行下加入模板的跨語言鏈接 --> |
|||
</includeonly> |
2023年7月5日 (三) 07:48的最新版本
此頁面是Template:RefFoot的Template文档。 此頁面可能包含了模板的使用說明、分類和其他内容。 |
本模板含有複雜而精密的扩展语法。 編輯本模板前,建議您先熟悉解析器函數与本模板的设计思路、运作原理等。若您的編輯引發了意外的問題,請儘快撤銷編輯,因為本模板可能被大量頁面使用。 您所作的编辑可先在模板沙盒或您的个人页面中进行測試。 |
模板說明
[编辑]此組模板為「參註分組」,用來把頁面的參考資料和註解兩列表分開顯示,構成該基礎模板有:
模板重定向
[编辑]使用方法
[编辑]於條目正文中:
- 在欲標示參考來源的位置加上「
{{refTag|name=同項名稱|1=參考資料文字}}
」。 - 在欲標示備註的位置加上「
{{noteTag|name=同項名稱|1=註解文字}}
」。 - 參數說明:
- name(可選):註腳的名稱,用於顯示同項註腳。
- name值無須加引號。
- 匿名參數1:註腳的文字內容。
- 如有設定name參數值,且該name值為該之前的同項參考,則可省略匿名參數1。
- 另外,如果頁面採用把註腳原碼集中在頁底的方法,則正文中須設定name值,而匿名參數1則留空。
- name(可選):註腳的名稱,用於顯示同項註腳。
- 無須再用
<ref></ref>
標籤包住模板。
於頁底註腳中:
- 在欲列示參考來源的位置掛上「
{{refFoot}}
」。 - 在欲列示備註的位置則掛上「
{{noteFoot}}
」。 - 參數說明:
- 匿名參數1:註腳原碼內容集中存放附錄處專用。(詳見下文)
如果使用註腳原碼內容集中存放附錄處的方法,請依以下方法使用:
- 正文內容使用「
{{noteTag|name=同項名稱x}}
」和「{{refTag|name=同項名稱y}}
」。- 正文處請不要設定匿名參數1。
- 頁底請使用「
{{noteFoot|1= {{noteTag|name=同項名稱x|1=註解文字}} }}
」和「{{refFoot|1= {{refTag|name=同項名稱y|1=參考資料文字}} }}
」
範例
[编辑]一般式:註腳原碼內容分散在正文
[编辑]以下文本:
==內容== 九子連環{{refTag|1=參考a}}萬筒索{{noteTag|1=註x}}{{refTag|name=RefB|1=參考b}}, 五門{{noteTag|1=註y}}風箭{{refTag|name=RefB}}皆盡齊{{refTag|1=參考c}}。 ==備註== {{noteFoot}} ==參考資料== {{refFoot}}
顯示效果為:
附錄式:註腳原碼內容集中在頁底
[编辑]以下文本:
==內容== 東南西北{{noteTag|name=noteA}}大四喜{{noteTag|name=noteB}}{{refTag|name=ref1}}, 梅蘭{{noteTag|name=noteA}}菊竹{{refTag|name=ref2}}四花齊{{refTag|name=ref3}}。 ==備註== {{noteFoot|1= {{noteTag|name=noteA|1=註A}} {{noteTag|name=noteB|1=註B}} }} ==參考資料== {{refFoot|1= {{refTag|name=ref1|1=參考1}} {{refTag|name=ref2|1=參考2}} {{refTag|name=ref3|1=參考3}} }}
顯示效果為:
備註
[编辑]{{noteTag}}
與{{noteFoot}}
必須同時使用,請勿混用其他註腳標籤或模板,否則將導致一些專門處理註腳的小工具不能正常運作。- 承上,
{{refTag}}
與{{refFoot}}
也必須同時使用,不能混用其他註腳標籤或模板。 - 當使用了本系列的分組模板時,請避免同時使用不分組的
<ref>
,以免註腳系統發生辨認失敗之狀況。
其他类似脚注系列
[编辑]說明 | 分组名 | 標註模板 | 對應的列表模板 | 標註效果 | 備註 |
---|---|---|---|---|---|
参考模板 | |||||
无 | 无 | <ref>...</ref> |
{{reflist}} |
[1][2][3] | |
无 | 无 | {{refnest}} |
{{reflist}} |
[1][2][3] | 参考中需再嵌角标時使用 |
參 | 參 | {{RefGroupTag}} |
{{RefGroupFoot}} |
[參1][參2][參3] | |
參 | 參 | {{RefTag}} |
{{RefFoot}} |
[參 1][參 2][參 3] | |
注釋模板 | |||||
註 | 註 | {{NoteGroupTag}} |
{{NoteGroupFoot}} |
[註1][註2][註3] | |
註 | 註 | {{NoteTag}} |
{{NoteFoot}} |
[註 1][註 2][註 3] | |
小写字母 | lower-alpha | {{efn}} |
{{notelist}} |
[a] [b] [c] [d] [e] [f] [g] [h] [i] [j] | |
大写字母 | upper-alpha | {{efn-ua}} |
{{notelist-ua}} |
[A] [B] [C] [D] [E] [F] [G] [H] [I] [J] | |
小写羅馬數字 | lower-roman | {{efn-lr}} |
{{notelist-lr}} |
[i] [ii] [iii] [iv] [v] [vi] [vii] [viii] [ix] [x] | |
大写羅馬數字 | upper-roman | {{efn-ur}} |
{{notelist-ur}} |
[I] [II] [III] [IV] [V] [VI] [VII] [VIII] [IX] [X] | |
小写希臘字母 | lower-greek | {{efn-lg}} |
{{notelist-lg}} |
[α] [β] [γ] [δ] [ε] [ζ] [η] [θ] [ι] [κ] | IE7以下不支援 |
參見
[编辑]模板數據
[编辑]RefTag、NoteTag
此組模板為「參註分組」,用來把頁面的參考資料和註解兩列表分開顯示。
参数 | 描述 | 类型 | 状态 | |
---|---|---|---|---|
註腳名 | name | 用於顯示同項註腳 | 字符串 | 可选 |
註腳文字 | 1 | 如有設定name參數值,且該name值為該之前的同項參考,則可省略本參數。 | 内容 | 可选 |
RefFoot、NoteFoot
此組模板為「參註分組」,用來把頁面的參考資料和註解兩列表分開顯示。
参数 | 描述 | 类型 | 状态 | |
---|---|---|---|---|
註腳集中處 | 1 | 將refTag和noteTag的註腳內容集中存放 | 内容 | 可选 |