Extension:Cite/Cite.php/ja

マニュアル - 一覧 - スナップショット

Cite Release status: stable
実装	タグ
説明	ドキュメントに脚注を追加する。
作者	Ævar Arnfjörð Bjarmason
MediaWiki	1.11 以降
ライセンス	No license specified
ダウンロード	スナップショットをダウンロード (Git master) Git [ヘルプ]: リポジトリの要約 ツリー ソースコードの変更履歴 Cite.php Cite.i18n.php Cite_body.php
例	Wikipedia:Footnotes
パラメーター $wgAllowCiteGroups $wgCiteCacheReferences $wgCiteEnablePopups
タグ <ref>, <references />
使用されているフック ParserFirstCallInit
拡張機能 (結果) 1.13.3 1.14.0 trunk MediaWiki 1.13.3 Yes - No 1.14.0 - - No trunk - - - Configure Supported from latest. MediaWiki Testing
使用法とバージョン一覧を確認してください。統計
バグ: 未解決一覧 すべての一覧 報告

このページは拡張機能に関するものです。英語版ウィキペディアでの使用に関してはHelp:Footnotes/ja:Help:脚注も参照してください。

Cite.phpは2つのパーサフック、<ref>と<references />をMediaWikiに追加するCite拡張機能です。これはページに脚注を追加するために動作します。

インストール

1. MediaWiki のバージョンに適合したスナップショットをダウンロード し、extension ディレクトリに入れます。
2. 以下の行をLocalSettings.phpに追加します (though not after trailing ?>, if it is present):

   require_once("$IP/extensions/Cite/Cite.php");

3. Installation can now be verified through Special:Version of your wiki.

Cite also has an option $wgCiteEnablePopups which can be enabled by adding $wgCiteEnablePopups = true; after the require_once line.

使い方

<ref>タグの基本的なコンセプトは目的のセクションに脚注としてのrefタグで閉じられたテキストに挿入することです。<references />タグでプレイスホルダを示します。新しいフォーマットは古いフォーマットと交換可能ではありません - どちらかを選ばなければなりません。

記事の最後に<references />を含めることを忘れた場合、脚注は表示されず、ページの末尾に赤文字のエラーメッセージが表示されます。

このページ自体、この文章の終わりなどで脚注を利用しています。 "このページを編集"ボタンをクリックしてこのページのソースを閲覧する場合、脚注が動作している例を見ることができます。

例

According to scientists, the Sun is pretty big.<ref>E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.</ref>
The Moon, however, is not so big.<ref>R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44-6.</ref>

==Notes==
<references />

同じ脚注を複数回使用

脚注にユニークな識別子を与えるには、<ref name="name">を利用します。 同じ名前とrefタグを使用することで同じ脚注を再び参照することが出来ます。 2番目のタグ内部にあるテキストは問題ありません。テキストが既に最初の参照で存在するからです。脚注全体をコピーする、次のようなもしくは終わりの空のrefタグを使用できます: <ref name="name" />。The quotes are not required (but not incorrect) if the name contains no embedded spaces. The space before the closing "/" may be omitted.

次の例において、同じソースは3回引用されます。

This is an example of multiple references to the same footnote.<ref name="multiple">Remember that when you refer to the same footnote multiple times, the text from the first reference is used.</ref>

Such references are particularly useful when citing sources, if different statements come from the same source.<ref name="multiple">This text is superfluous, and won't show up anywhere. We may as well just use an empty tag.</ref>

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.<ref name="multiple" />

==Notes==
<references />

上記のテキストは次のような結果になります(下記のセクションもご覧下さい):

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

Such references are particularly useful when citing sources, when different statements come from the same source.

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.

Note: name= identifiers require alphabetic characters; solely relying on numerals will generate an error message

Merging two texts into a single reference (wikisource issue)

A typical wikisource issue is, how to merge into one reference texts split into different pages. This can be done using a <ref name="name"> tag for the first part of the reference, and tagging the following parts into different pages with a tag <ref follow="name">.

Here an example, deriving the text used into previous section:

This is an example of merging multiple texts into the same footnote.<ref name="main">Remember that all the texts will be
included into the reference containing the ''name='' attribute.<br /></ref>

<ref follow="main">Simply include the text to be merged into the first <ref name="name"> reference with a tag <ref follow="name"><br />This paragraph is included into a similar tag and it will be merged into the reference in former paragraph. </ref>

Result: This is an example of merging multiple texts into the same footnote.

When using this syntax into Page: namespace, take care that the ref follow part of the footnote is transcluded too into the same ns0 page, where the first part of footnote is transcluded. Use appropriately section tags to get this result. To also remind users that reference names should not solely be numbers, eg. <ref name="p32"> and <ref follow="p32">.

<references />

<references />を設置することで<ref>で定義されたすべての保留のインラインの引用の全文をページのどこにでも挿入できます。 例えば、上記の引用に基づくと、コードは以下の通りです:

<references />

は次の内容を出力します:

Wikipediaのいくつかの言語において、長い参照リストは<references />を内蔵する{{Reflist}}テンプレートを使用することで置き換えられることがあります。複数のカラムで参照リストを表示するためのオプションパラメータが提供されます。例えば、英語版、 ヒンディー語、インターリングアのWikipediaは参照テキストを通常よりも小さく表示するreferences-smallCSSセレクタを利用します。

In the case of multiple references-tags on a page, each gives the references defined in the ref-tags from the previous references-tag. In the case that these references-tags are produced by templates, each gives the references defined in the ref-tags before the first references-tag, and there is an error message that there is a ref-tag but not a references-tag.

List-defined references

Instead of using a self-closing <references /> (void element) to display pending inline citations, one can use paired tags – <references>...</references> – containing named references, as in:

<references>
<ref name=foo>...</ref>
<ref name=bar>...</ref>
</references>

These can then be referenced via <ref name=foo /> tags, and allow one to define references at the, instead of inline. Pending inline references will also be displayed. See Help:List-defined references for an example of this use.

Grouped references

This may be disabled by $wgAllowCiteGroups = false; if desired. However, it is enabled on the Foundation wikis.

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

According to scientists, the Sun is pretty big <ref>E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.</ref>.
In fact, it is very big <ref group="footnotes">Take their word for it. Don't look directly at the sun!</ref>.

==Notes==
<references group="footnotes" />
==References==
<references />

The anonymous group works as before, while the named group reference will show up as , and the references will look like this:

Separating references from text

In-text references make it easy to copy the text to another page; on the other hand, they make it hard to read. References containing a lot of data, quotes or elaborate citation templates can make up a significantly larger fraction of the source than the text that will actually be visible. To avoid this, recent versions of the extension allow moving some or all of the references into the <references /> section, to the place where they will actually appear to the reader. Thus,

According to scientists, the Sun is pretty big.<ref name="miller" />
The Moon, however, is not so big.<ref name="smith" />

==Notes==
<references>
<ref name="miller">E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.</ref></br> <ref name="smith">R. Smith, "Size of the Moon", Scientific American, 46 (April 1978): 44-6.</ref>
</references>

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 <ref> is parsed before substitution (i.e., subst:) or parser functions (i.e., {{#if:}}), they will not work inside of citation references. Instead, you have to use the マジックワード #tag.

This non-working example

<ref name="Resource">Content that can include subst: and parser functions (like {{#if:}} and {{PAGENAME}})</ref></code>

could be made to work using

<code>{{#tag:ref|Content that can include subst: and parser functions (like {{#if:}} and {{PAGENAME}})|name="resource"}}</code>

At this time, there is no way to create an "empty" tag (i.e., <code><ref name="resource" /></code>) without triggering Cite's complaint about empty content. The workaround is to simply redefine the full tag each time you use this feature. Since such usage is likely limited to templates or other semi-automated process, this may not be too onerous.

カスタマイズ

<code><ref></code>と<code><references></code>の出力フォーマットはMediaWikiのメッセージを通してほとんど完全にカスタマイズすることが出来ます。MediaWikiのメッセージは例えばwikiのコンフィギュレーションによるMediaWikiの名前空間を通して修正できます。

<code><ref></code>と<code><references></code>と値の出力をコントロールする、もしあれば、それら($1, $2, $3 ...)に渡されるメッセージのリストのためです。see the code in CVS for an up-to-date listing of their default contents.

• 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. count to display
• cite_references_link_one
  • <references />が出力するソースリストをフォーマットするために使用され、3つを設定します: backlink ID、ref ID、とtext of noteです。
  1. backlink ID - ソースリストの順番の数字を作成するために使用されます。
  2. ref ID - テキストの実際の参照に戻るリンクに使用されます。これは<bold>^</bold>記号を設定することができる場所です
  3. text of note - 上記でソース情報を説明するために使用されるテキスト
• cite_references_link_many
  1. backlink ID
  2. リンクのリスト
  3. 注のテキスト
• cite_references_link_many_format
  1. ref ID
  2. numeric value to use as a backlink
  3. custom value (as defined in cite_references_link_many_format_backlink_labels to use as a backlink)
• cite_references_link_many_format_backlink_labels
• cite_references_link_many_sep
• cite_references_link_many_and
• cite_references_prefix
• cite_references_suffix

^とWikipediaのような文字列を使用するためにリファレンスを設定する

Modify the following system messages. All of these pages can be found on Special:Allmessages:

On the page MediaWiki:Cite references link one change:

<li id="$1">[[#$2|↑]] $3</li>

to

<li id="$1">[[#$2|^]] $3</li>

On the page MediaWiki:Cite references link many change:

<li id="$1">↑ $2 $3</li>

to

<li id="$1">^ $2 $3</li>

On the page MediaWiki:Cite references link many format change:

[[#$1|^$2]]

to:

[[#$1|^$3]]

説明:

The ^ replaces the up arrows.

Putting $3 between the  tags changes the links from 1.0, 1.1, 1.2 to a, b, c etc...

Searching for these 3 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 like Wikipedia

Add the following code to the MediaWiki:Common.css page.

/* make the Cite extension list of references look smaller and highlight clicked reference in blue */
ol.references { font-size: 90%; }
ol.references li:target { background-color: #ddeeff; }
sup.reference:target { background-color: #ddeeff; }

Source: Wikipedia's MediaWiki:Common.css

批判

Cite.phpに関する主な批判はリファレンスの編集をより退屈にレンダーすることです。さらに、多くの一般的なWikipediaのユーザーは不可解なWikitextのタグに慣れていないので、Cite.phpの純粋な効果は新しいユーザーが参照のセクションを編集することを阻害すするだけだということです。Wikipediaの名前の由来であるハワイ語の"wiki-wiki"は"速い-速い"を意味していますが、一般的なWikipediaのユーザーにとってCite.phpは速くも簡単でもありません。

This can now be solved by separating references from the text.

However, at least one editor, Ta bu shi da yu, finds it useful to have the references embedded within the text when splitting articles and shifting text with footnotes around the article. With the old system, or when using Cite.php with separated references, when a paragraph with a footnote needs to be moved, multiple footnotes in the Notes section may need to be shifted. This is very difficult to do. With Cite.php and in-line references, reorganising text and splitting articles is considerably easier.

Cite.phpを利用することでページ番号を引用することが難しくなります。それぞれのリファレンスは通常book/journal/articleの異なるページを参照しますが、セルフクロージングタグを利用するときは異なるページを表示する方法がありません。そういうものとして、すべての<ref name="xyz" />は作品にある特定のページ番号よりも全体として作品を参照します。恐らくCite.phpの将来のリビジョンでは<ref name="xyz" page="42-43" />のような参照に渡されるページ番号の引数が可能になります。引用が確認/認証され、引用はより便利なリソースになるので、これによって劇的に引用の評価が増大します。

This can be solved by using the {{rp|page}} template on en.wikipedia to append^:20 the specific^:30 page number^:33 to each reference. The formatting has been simulated here because the MediaWiki site does not contain the {{rp}} template. If this had been an actual Wikipedia page, the full template with its many options could have been utilized.

ref/noteスタイルとCite.phpスタイルの比較

これは実際によく似ています。

• 単独の脚注を使用するために:
  • Ref/note
    1. テキスト内で{{ref|foo}}。
    2. 注のリストの適切な場所で# {{note|foo}} 注のテキスト
  • Cite.php
    1. テキスト内で<ref>text of note</ref>
    2. (記事ごとに一回だけ必要) 注の見出しの下で<references/>。
• 複数の脚注を使用するために:
  • Ref/note
    • 厳密なref/noteスタイルではこれは不可能ですが、代替的なフォームはたくさん作成されました。詳細に関して、該当するページをご覧下さい
  • Cite.php
    1. それぞれのテキスト内の場所で<ref name=foo>text of note</ref>
       1. Alternatively <ref name=foo /> name=fooが定義された後、自己閉じタグをすべて使用
    2. (記事ごとに一回だけ必要)<references/> 注の見出しの下で; 使い捨ての注を作成するのとまったく同じです。

Harvard references extension

Sample of the HarvardReferences extension.

There is an Extension:HarvardReferences that can be used to support "Harvard" ("author - date") system of references, e.g. [Smith 2010:1]. This reference system is often used in scientific literature. Both extensions are compatible. Moreover, links in "Harvard" system can be inserted into body of ref-link, and vice versa. It may be helpful to support book-style comments/subnotes with a "scientific" source references. For example:

<ref>This is a test subnote. [Smith 2010:121]</ref>

Language:	English  • 日本語