本頁不屬於有獸檔案館的條例或規則;若本頁內容與相關條例不一致的,以條例內容為準。
引用可以讓你在一個頁面中加入腳註,這是有獸檔案館實現參考資料的基本方式。這是由MediaWiki的Cite擴展提供的。
用法
<ref>
標籤的基本概念是,插入由ref標籤包含的文本,並作為用<references />
標籤指定的腳註部分,此格式不能與舊格式互換使用——您必須選擇其中一種。
可以在文中插入多個佔位符標籤<references />
,到那個點的所有<ref>
在那個組內都會插入到這裏。
如果你忘記在文章中包含一個<references />
,那麼腳註不會顯示,但是參考仍會在頁面結尾顯示。
該頁面本身使用腳註,例如這句話末尾的腳註。[note 1]
太阳很大。<ref>E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–25.</ref> 然而月亮不大。<ref>R. Smith, "Size of the Moon", ''Scientific American'', 46 (April 1978): 44–46.</ref>
== 注释 ==
<references />
同一腳註的多種用法
如要給腳註一個單獨的標識符,請使用name
屬性。你可以使用帶有這個name的ref標籤來復用統一腳註。第二個標籤內的文本不起作用,因為文本已存在與第一個引用中。你可以複製整個腳註,或者直接使用自我閉合的標籤:<ref name="name" />
。
在下面的例子中,相同的來源引用了三次。
这是多个参考使用一个脚注的例子。<ref name="multiple">记住当你多次引用相同的脚注时,会使用第一个引用中的文本。</ref>
有多个语句来自相同来源时,这样引用来源会十分有用。<ref name="multiple" /> 任何复用标签都不应该包含额外文本,否则会产生错误。 仅使用空标签。
进行多次引用的简洁方法是使用空的ref标签,在末尾加上斜杠。
尽管这样子减少繁杂工作,但是请注意,如果以后有个编辑者移除了第一个引用,后面使用空的ref标签的引用都会丢失。<ref name="multiple" />
== 注释 ==
<references />
<references />
標籤
<references />
標籤會將所有用<ref>
定義的引用的文本插入在頁面的這個位置。
例如,基於上面的引用,note組中應該有引用。
<references group="note"/>
- ↑ 此腳註用作「如何使用」部分中的示例。
在有獸檔案館,你可以使用{{reflist}}模板來顯示長的引用。引用的內容會自動分欄。
如果頁面包含多個<references />
列表,每個列表都會包含在先前的引用列表之後定義的<ref>
標籤。如果這些引用列表是由模板產生的,每個都會列表在第一個引用列表之前定義的ref標籤,因此會產生錯誤消息,顯示有ref標籤但是沒有引用列表。
分組參考
以下示例為引用和雜項的腳註生成單獨的引用列表:
科学家称,太阳很大。<ref>E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–25.</ref> 事实上,非常大。<ref group="footnotes"> 相信他们的话。 千万不要直视太阳!</ref>
== 注释 ==
<references group="footnotes" />
== 参考资料 ==
<references />
科學家稱,太陽很大。[1] 事實上,非常大。[footnotes 1]
- ↑ 相信他們的話。 千萬不要直視太陽!
- ↑ E. Miller, The Sun, (New York: Academic Press, 2005), 23–25.
匿名組會像之前的那樣運作,而指向命名的組的引用只會顯示在指定的<references />
元素中。
如需在wiki自定義指定組的渲染,可以創建MediaWiki:Cite_link_label_group-<$name>
,並按照出現的順串行舉出使用的符號,用空格或新行隔開。例如,如果MediaWiki:Cite_link_label_group-lower-alpha
創建了如下內容:
a b c d e f g h i j k l m n o p q r s t u v w x y z
那麼第一個<ref group="lower-alpha">...</ref>
渲染為[a],第二個渲染為[b],以此類推,第26個渲染為[z]。如果使用超過定義的符號的個數的組,就會發生錯誤,所以該組內第27個腳註發生錯誤。
以下組名稱通常分別被以下消息定義為自定義組:
組名 | 消息 |
---|---|
upper-alpha |
MediaWiki:Cite link label group-upper-alpha |
lower-alpha |
MediaWiki:Cite link label group-lower-alpha |
upper-roman |
MediaWiki:Cite link label group-upper-roman |
lower-roman |
MediaWiki:Cite link label group-lower-roman |
lower-greek |
MediaWiki:Cite link label group-lower-greek |
<ref group="lower-alpha">...</ref>
這樣的標記就會渲染為lower-alpha 1。引用相同來源的不同部分
在一篇文章中,一個來源的多個部分用作參考時,你可以在引用段落中將其聚集。這讓讀者能夠識別哪些參考文獻來自同一來源。同時你也能夠引用同一個來源的不同部分,而不需要每次重複整個來源。
科学家称,太阳很大。<ref name="Miller">E. Miller, ''The Sun'', (New York: Academic Press, 2005).</ref> 事实上,非常大。<ref extends="Miller">p. 123</ref> 相信他们的话。 千万不要直视太阳!<ref extends="Miller">p. 42</ref>
== 参考数据 ==
<references />
科學家稱,太陽很大。[1] 事實上,非常大。[1.1] 相信他們的話。 千萬不要直視太陽![1.2]
1. E. Miller, The Sun, (New York: Academic Press, 2005)
1.1 ↑ p. 123
1.2 ↑ p. 42
從文本中拆分參考資料
文內引用可以輕鬆地將文本複製到另一個頁面,另一方面又會使閱讀變得困難。包含大量數據、引述或精心設計的引文模板的參考文獻在來源中所佔的比例可能比實際可見的文本要大得多。為了避免這種情況,擴展進程允許將部分或全部引用移動到<references />
部分,到它們實際出現在讀者面前的位置。
科学家称,太阳很大。<ref name="miller" /> 然而月亮不大。<ref name="smith" />
== 注释 ==
<references>
<ref name="miller">E. Miller, ''The Sun'', (New York: Academic Press, 2005), 23–25.</ref>
<ref name="smith">R. Smith, "Size of the Moon", ''Scientific American'', 46 (April 1978): 44–46.</ref>
</references>
這樣,上面的代碼輸出的效果和第一個例子相同,儘管參考的標號和順序並不總是一樣的。
替換引用和嵌入解析器函數
由於Cite擴展進程的<ref>
標籤是在MediaWiki的解析器函數和變量或subst:
之前解析的,因此在引用參考內不會起效果。這種情況下,你應該使用{{#tag:}}
魔術字。
Foo<ref>这不起作用,参见 {{cite journal|url=https://www.google.com |author= |date= |accessdate={{subst:#time:Y-m-d|now}}|title=Search}}</ref> bar baz…
Foo{{#tag:ref|而这样就会起作用,参见 {{cite journal|url=https://www.google.com |author= |date= |accessdate={{subst:#time:Y-m-d|now}}|title=Search}}}} bar baz…
<references />
將兩個文本合併至一個參考文獻中
有時候引用會佔用同一材料的多個頁面。對於第一部分引用,可以通過<ref name="name">...</ref>
標籤合併,然後使用標籤<ref follow="name">...</ref>
用相同名稱標記後面的部分。
例子:
这是将多个文本合并到相同脚注的例子。<ref name="main">记住所有的文本都会包含在含有name="…"属性的参考中。</ref>
<ref follow="main">在带有follow="…"属性的标签内,简单包含额外文本,并符合第一个参考的名称。</ref>
== 参考数据 ==
<references/>
使用這種語法時,注意腳註的follow部分會作為參考的第一部分包含在相同頁面。
注意參考的名稱不能以數字開頭,所以始終要包含一些文本,比如<ref name="p32">
和<ref follow="p32">
。
自定義
<ref>
和<references>
的輸出格式是完全可定製的,可以通過MediaWiki消息進行根據wiki配置通過MediaWiki命名空間進行修改。
- 不完整列表
cite_reference_link_key_with_num
- key
- num
cite_reference_link_prefix
cite_reference_link_suffix
cite_references_link_prefix
cite_references_link_suffix
cite_reference_link
- ref ID
- backlink ID
- 顯示個數
cite_references_link_one
- 用來格式化
<references />
輸出的來源列表,會配置:backlink ID、ref ID和注釋文本。
- backlink ID — 用來創建來源列表的數字順序
- ref ID — 用來往回連結到文本中的實際參考來源,這裏你可以配置
^
符號。 - 注釋文本 — 用於描述來源信息的文本
- 用來格式化
cite_references_link_many
- backlink ID
- list of links
- 注釋文本
cite_references_link_many_format
- ref ID
- 用作反向連結的數值
- 自定義值(
cite_references_link_many_format_backlink_labels
中定義,用作反向連結)
cite_references_link_many_format_backlink_labels
cite_references_link_many_sep
cite_references_link_many_and
cite_references_suffix
設置參考文獻使用^和字母
要將默認的向上箭頭(↑)替換為^,可修改以下系統消息,其所有頁面可以在Special:AllMessages找到。
從 | 至 |
---|---|
<li id="$1"$4><span class="mw-cite-backlink">[[#$2|↑]]</span> $3</li>
|
<li id="$1"$4><span class="mw-cite-backlink">[[#$2|^]]</span> $3</li>
|
從 | 至 |
---|---|
<li id="$1"$4><span class="mw-cite-backlink">↑ $2</span> $3</li>
|
<li id="$1"$4><span class="mw-cite-backlink">^ $2</span> $3</li>
|
將$2替換為$3會將1.0、1.1、1.2這樣的連結替換為a、b、c等…
從 | 至 |
---|---|
<sup>[[#$1|$2]]</sup>
|
<sup>[[#$1|$3]]</sup>
|
第一次搜索這些頁面會沒有任何匹配。簡單創建「創建此頁面」來編輯代碼。這個改變不會生效,直到帶有引用的頁面被重建。
受損參考
如果不恰當使用<ref>
和<references />
標籤,Cite擴展就會給頁面添加一個錯誤消息,並加入到「有參考文獻錯誤的頁面」分類。這些錯誤消息將以用戶界面語言顯示在文章內容或參考部分中。例如:
这是参考资料错误消息的一个例子。<ref broken>预期文本。</ref>
== 注释 ==
<references />
這是參考資料錯誤消息的一個例子。引用錯誤:無效的 <ref>
標籤,無效的 name 屬性值,可能名稱過長
參見
- mw:Help:Cite/zh:本頁來源