Extension:Cite/ja

Cite拡張機能によって、利用者がページの脚注として参考文献を作成することができます. それはMediaWikiに2つのパーサーフック、 と   を追加し、これらはページに引用を加えるために連動します.

使用法
&lt;references/&gt;タグを記して脚注を表示するよう指定された節に&lt;ref&gt;タグで囲まれた文書を挿入するのが基本的な考えです. この書式は古い書式とは互換性がありません. どちらか一方を選ぶ必要があります.

文書に複数の &lt;references/&gt; を記述することもできます. その場合、 &lt;references/&gt; タグを記した箇所よりも上にあるすべての &lt;ref&gt; タグの内容が挿入されます.

記事の中に &lt;references/&gt; を記述し忘れた場合、脚注がなくなることはなくページの最後に脚注が表示されます.

このページ自体でもこの文の末尾にあるような脚注を使っています. （英語ページで）「編集」をクリックして[ ソースを見る]と、脚注がどのように動作しているのかをみることができます.

{| class="wikitable" ! width="50%" | ウィキテキスト ! レンダリング 太陽はかなり大きい. しかし、月はそれほど大きくはない.

注記
 * This is an example of multiple references to the same footnote.

Such references are particularly useful when citing sources, if different statements come from the same source. Any reused tag should not contain extra content, that will spawn an error. Only use empty tags in this role.

A concise way to make multiple references is to use empty ref tags, which have a slash at the end. Although this may reduce redundant work, please be aware that if a future editor removes the first reference, this will result in the loss of all references using the empty ref tags.

注記 This is an example of merging multiple texts into the same footnote.

References tag inserts the text of all the citations which have defined in  tags up to that point in the page. For example, based on the citations above, there should be reference for the note group.

{| class="wikitable" ! width="50%" | ウィキテキスト ! 結果 In some language editions of Wikipedia, long reference lists may be placed using the template, which incorporates. It provides an optional parameter to display the reference list in multiple columns. For instance, the English, Hindi and Interlingua Wikipedias use the CSS selector  to make the reference text smaller than normal text. Using templates in this way is strongly discouraged, for compatibility, performance, and functionality reasons.
 * attribute is used to configure that behavior.
 * attribute is used to configure that behavior.
 * attribute is used to configure that behavior.

If a page includes more than one  list, each list includes the   tags defined after the previous references list. If these references lists are produced by templates, each one lists the ref tags defined before the first references list, and there is an error message saying that there is a ref tag but not a references list.

Grouped references
This may be disabled by  if desired.

The following example generates separate reference lists for citations and miscellaneous footnotes:

{| class="wikitable" ! width="50%" | ウィキテキスト ! 結果
 * According to scientists, the Sun is pretty big In fact, it is very big
 * According to scientists, the Sun is pretty big In fact, it is very big
 * According to scientists, the Sun is pretty big In fact, it is very big

注記 element.

文書から参照情報を分離する
文書中に書かれた参照情報は別のページにたやすくコピーできますが、読みにくくなります. 多くのデータ、引用情報、手の込んだ引用テンプレートを含む参照があると、ソースに書かれた文書は実際ページに表示される内容よりもかなり多いものになることがあります. これを避けるため、この拡張機能の最近のバージョンでは参照情報の一部または全部を  を書いた節（ページで実際に脚注が表示される位置）に移動することができるようになっています.

Thus, the code above will have the same output as the first example above, although the numbering and order of the references will not in general be the same.

Substitution and embedded parser functions
Since Cite's tag is parsed before MediaWiki's parser functions (e.g.  ) or variables (e.g.  ) or before , these will not work inside of citation references. Instead, you have to use the magic word.

{| class="wikitable" ! width="50%" | ウィキテキスト ! 結果 Foo bar baz… Foo bar baz…

to define a wiki-wide heading which would be automatically inserted before each references list. In MediaWiki 1.29, this system message was removed. A hacky way to enter a headline now is to add the following code to MediaWiki:Common.js:

If you only need a text heading (no link or other active elements) you could add the following to MediaWiki:common.css (Chrome 4, IE9, FF 3.5, Safari 3.1, Opera 7):

カスタマイズ
The format of the output of  and   is almost completely customizable through MediaWiki messages, that can be modified, for example, through the MediaWiki namespace depending on the configuration of the wiki.

For a list of messages that control the output of  and   and the values, if any, that are passed to them ($1, $2, $3 ...), see here for an up-to-date listing of their default contents.


 * Incomplete list
 * 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
 * count to display
 * cite_references_link_one
 * Used to format the source list that
 * }
 * }


 * MediaWiki:Cite references link many

Replacing $2 with $3 changes the links from 1.0, 1.1, 1.2 to a, b, c etc…
 * MediaWiki:Cite references link many format

Searching for these pages for the first time will result in no matches. Simply click "Create this page" to edit the code. The changes will not show up until a page with references is rebuilt.

Set reference and reference number highlighting
Add the following code to the MediaWiki:Common.css page.

API
An API is available when correctly configured by the following. a Raw JSON for a given page will now be accessible via: /wiki/Special:ApiSandbox?useformat=desktop#action=query&format=json&prop=references&titles=Doctor+Who

関連項目

 * Help:Extension:Cite
 * (互換)