使用說明:引用

本页使用了标题或全文手工转换,现处于台湾繁体模式
說明頁面

引用可以讓你在一個頁面中加入註腳,這是求聞百科實現參考資料的基本方式。這是由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 />
您所看到的

太陽很大。[1] 然而月亮不大。[2]

注釋
  1. E. Miller, The Sun, (New York: Academic Press, 2005), 23–25.
  2. R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44–46.

同一註腳的多種用法

如要給註腳一個單獨的標識符,請使用name屬性。你可以使用帶有這個name的ref標籤來復用統一註腳。第二個標籤內的文本不起作用,因為文本已存在與第一個引用中。你可以複製整個註腳,或者直接使用自我閉合的標籤:<ref name="name" />

在下面的例子中,相同的來源引用了三次。

您所輸入的
这是多个参考使用一个脚注的例子。<ref name="multiple">记住当你多次引用相同的脚注时,会使用第一个引用中的文本。</ref>

有多个语句来自相同来源时,这样引用来源会十分有用。<ref name="multiple" /> 任何复用标签都不应该包含额外文本,否则会产生错误。 仅使用空标签。

进行多次引用的简洁方法是使用空的ref标签,在末尾加上斜杠。
尽管这样子减少繁杂工作,但是请注意,如果以后有个编辑者移除了第一个引用,后面使用空的ref标签的引用都会丢失。<ref name="multiple" />

== 註釋 ==
<references />
您所看到的

這是多個參考使用一個註腳的例子。[1]

有多個語句來自相同來源時,這樣引用來源會十分有用。[1]任何復用標籤都不應該包含額外文本,否則會產生錯誤。 僅使用空標籤。

進行多次引用的簡潔方法是使用空的ref標籤,在末尾加上斜槓。 儘管這樣子減少繁雜工作,但是請注意,如果以後有個編輯者移除了第一個引用,後面使用空的ref標籤的引用都會丟失。[1]

註釋
  1. 1.0 1.1 1.2 記住當你多次引用相同的註腳時,會使用第一個引用中的文本。

<references />標籤

<references />標籤會將所有用<ref>定義的引用的文本插入在頁面的這個位置。 例如,基於上面的引用,note組中應該有引用。

您所輸入的
<references group="note"/>
您所看到的
  1. 此註腳用作「如何使用」部分中的範例。

在求聞百科,你可以使用模板連結:{{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]

註釋
  1. 相信他們的話。 千萬不要直視太陽!
參考資料
  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 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>
您所看到的

科學家稱,太陽很大。[1] 然而月亮不大。[2]

注釋
  1. E. Miller, The Sun, (New York: Academic Press, 2005), 23–25.
  2. R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44–46.

這樣,上面的代碼輸出的效果和第一個例子相同,儘管參考的標號和順序並不總是一樣的。

替換引用和嵌入解析器函式

由於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 />
您所看到的

Foo[1] bar baz… Foo[2] bar baz…

  1. 這不起作用,參見 Search. [{{subst:#time:Y-m-d|now}}]. 
  2. 而這樣就會起作用,參見 Search. [2021-03-11]. 

將兩個文本合併至一個參考文獻中

有時候引用會占用同一材料的多個頁面。對於第一部分引用,可以透過<ref name="name">...</ref>標籤合併,然後使用標籤<ref follow="name">...</ref>用相同名稱標記後面的部分。

例子:

您所輸入的
这是将多个文本合并到相同脚注的例子。<ref name="main">记住所有的文本都会包含在含有name="…"属性的参考中。</ref>

<ref follow="main">在带有follow="…"属性的标签内,简单包含额外文本,并符合第一个参考的名称。</ref>

== 參考資料 ==
<references/>
您所看到的

這是將多個文本合併到相同註腳的例子。[1]


參考資料
  1. 記住所有的文本都會包含在含有name="…"屬性的參考中。 在帶有follow="…"屬性的標籤內,簡單包含額外文本,並符合第一個參考的名稱。

使用這種語法時,注意註腳的follow部分會作為參考的第一部分包含在相同頁面。

注意參考的名稱不能以數字開頭,所以始終要包含一些文本,比如<ref name="p32"><ref follow="p32">

自訂

<ref><references>的輸出格式是完全可定製的,可以透過MediaWiki消息進行根據wiki配置透過MediaWiki命名空間進行修改。

不完整列表
  • cite_reference_link_key_with_num
    1. key
    2. num
  • cite_reference_link_prefix
  • cite_reference_link_suffix
  • cite_references_link_prefix
  • cite_references_link_suffix
  • cite_reference_link
    1. ref ID
    2. backlink ID
    3. 顯示個數
  • cite_references_link_one
    • 用來格式化<references />輸出的來源列表,會配置:backlink ID、ref ID和注釋文本。
    1. backlink ID — 用來建立來源列表的數字順序
    2. ref ID — 用來往回連結到文本中的實際參考來源,這裡你可以配置^符號。
    3. 注釋文本 — 用於描述來源資訊的文本
  • cite_references_link_many
    1. backlink ID
    2. list of links
    3. 注釋文本
  • cite_references_link_many_format
    1. ref ID
    2. 用作反向連結的數值
    3. 自訂值(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找到。

MediaWiki:Cite references link one
<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>
MediaWiki:Cite references link many
<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>
MediaWiki:Cite references link many format

將$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 屬性值,可能名稱過長

注釋

參見