Extension:Cite/Cite.php/ja


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

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

インストール

 * 1) MediaWiki のバージョンに適合したスナップショットをダウンロード し、extension ディレクトリに入れます.
 * 2) 以下の行をLocalSettings.phpに追加します (though not after trailing ?>, if it is present):
 * 3) Installation can now be verified through Special:Version of your wiki.
 * 1) 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.

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

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

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

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

&#61;=Notes==

'''&lt;references /> 

同じ脚注を複数回使用
脚注にユニークな識別子を与えるには、&lt;ref name="name">を利用します. 同じ名前とrefタグを使用することで同じ脚注を再び参照することが出来ます. 2番目のタグ内部にあるテキストは問題ありません. テキストが既に最初の参照で存在するからです. 脚注全体をコピーする、次のようなもしくは終わりの空のrefタグを使用できます: &lt;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. &lt;ref name&#61;"multiple">Remember that when you refer to the same footnote multiple times, the text from the first reference is used.&lt;/ref>

Such references are particularly useful when citing sources, if different statements come from the same source. &lt;ref name&#61;"multiple">This text is superfluous, and won't show up anywhere. We may as well just use an empty tag.&lt;/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. &lt;ref name&#61;"multiple" />

&#61;=Notes==

&lt;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: 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 &lt;ref name="name"> tag for the first part of the reference, and tagging the following parts into different pages with a tag &lt;ref follow="name">.

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

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. and.

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

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

を内蔵する テンプレートを使用することで置き換えられることがあります. 複数のカラムで参照リストを表示するためのオプションパラメータが提供されます. 例えば、英語版、 ヒンディー語、インターリングアのWikipediaは参照テキストを通常よりも小さく表示する CSSセレクタを利用します.

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  (void element) to display pending inline citations, one can use paired tags –   – containing named references, as in: These can then be referenced via  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  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 &lt;ref>E. Miller, The Sun, (New York: Academic Press, 2005), 23-5.&lt;/ref>.

In fact, it is very big &lt;ref group="footnotes">Take their word for it. Don't look directly at the sun!&lt;/ref>.

&#61;=Notes==

'''&lt;references group="footnotes" />

&#61;=References==

'''&lt;references />  The anonymous group works as before, while the named group reference will show up as, and the references will look like this: section, to the place where they will actually appear to the reader. Thus,

 According to scientists, the Sun is pretty big. &lt;ref name="miller" />

The Moon, however, is not so big. &lt;ref name="smith" />

&#61;=Notes==

&lt;references>

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

&lt;/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  is parsed before substitution (i.e.,  ) or parser functions (i.e., ), they will not work inside of citation references. Instead, you have to use the  magic word.
 * This non-working example:


 * could be made to work using:

At this time, there is no way to create an "empty" tag (i.e., ) 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.

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

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

Source: Wikipedia's MediaWiki:Common.css
 * 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

批判
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の異なるページを参照しますが、セルフクロージングタグを利用するときは異なるページを表示する方法がありません. そういうものとして、すべての は作品にある特定のページ番号よりも全体として作品を参照します. 恐らくCite.phpの将来のリビジョンでは のような参照に渡されるページ番号の引数が可能になります. 引用が確認/認証され、引用はより便利なリソースになるので、これによって劇的に引用の評価が増大します.


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

Harvard references 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: