Extension:Cite/Cite.php/ja


 * ''このページは拡張機能に関するものです. 使い方に関してはHelp:Footnotes, and ja:Help:脚注もご覧下さい.

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

インストレーション
注: The require_once行はファイルの終わり 近くに セットする必要があります.
 * 1) Cite.phpとCite.i18n.php拡張機能ファイルをextensions/Citeディレクトリに設置します. Subversionリポジトリから直接チェックアウトすることが出来ます:
 * 2) 次の行をLocalSettings.phpに追加します:

使い方
&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" />.

次の例において、同じソースは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.

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

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

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

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

と と値の出力をコントロールする、もしあれば、それら($1, $2, $3 ...)に渡されるメッセージのリストのためです. 最新のデフォルトの値に関してはSVNをご覧下さい.


 * 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

The ^ は上の矢印を置き換え、sup /supタグの間の$3を最後の行に設置することでw/ a b c...リンクを修正して、代わりに2.1、2.2、2.3、...となります.

Apacheのエラー
PHPがApacheのエラーログにエラーのログを記録します: (MediaWiki 1.6.8, PHP 4.4.4, Apache 1.3.37) [error] PHP Notice: Use of undefined constant __METHOD__ - assumed '__METHOD__' in extensions/Cite/Cite.php on line 609 [error] PHP Notice: Use of undefined constant __METHOD__ - assumed '__METHOD__' in extensions/Cite/Cite.php on line 612
 * 両方の行(609 & 612)上の__METHOD__周辺のシングルクォートを置き換えることでこれを修正することが出来ました
 * 原因は__METHOD__ はPHP5のみで利用できるからです. '__METHOD__'を利用することは正しい修正ではありません. --Løde

バージョン1.6.8
バージョン1.6.8では動作しませんでした. "13826"ではなくリビジョン"13660"でcite.phpを動かすことが出来ました. エラーメッセージはページのトップに表示されました:

Warning: Cannot modify header information - headers already sent by (output started at /****/wiki/extensions/Cite.i18n.php:399) in /****/OutputPage.php on line 575

Warning: Cannot modify header information - headers already sent by (output started at /****/wiki/extensions/Cite.i18n.php:399) in /****/wiki/includes/OutputPage.php on line 576

アンカーのリンク文字が間違ってレンダーされる
↑の代わりに???がレンダーされたページに表示します &mdash; これは上向きの矢印記号を&amp;#8593; に置き換えることで修正出来るかもしれません (対応するHTMLエンティティ; レンダーされた &#8593;). 代替的な方法としては、恐らくキャレット (^) が代用品として利用できます.

テンプレート

 * テンプレートで を利用することで番号付けが壊れます:解析されたものの順番に関するMediaWikiに関する問題です
 * テンプレートの範囲内で が番号付けされた参照マークを正しく作成しますが、呼び出すページ上で の出力から見失います. (例です)
 * といったテンプレートの引数を に渡すことは不可能です:MediaWikiに関する問題です. bug 4529をご覧下さい
 * テンプレートの代用品は タグ内部で誤ってレンダーします

HTMLパラメータ

 * &lt;ref&gt; によって生成された引用リンクと&lt;references&gt; によって生成されたバックリンクは空の 属性を持ちます
 * この拡張機能ではなくMediaWikiに関する問題です. のような入力が与えられた時、IMediaWikiは のような出力を生成します


 * 後方互換性のためにname=アンカーが見つからない ( 5567 )
 * 生成された&lt;a href="#_note-n"&gt;リンクはname="_ref-n"</tt>を含みます.
 * 生成された&lt;a href="#_ref-n"&gt;</tt>リンクはname="_note-n"</tt>を含みます.
 * これは現在動作するようです.

HTMLコメントアウトが動作しない
HTMLコメントの をコメントアウトします は引用を隠しますが参照はリスト上に表示されます
 * これによってパーサエラーが表示されることがあります…

ParserFunctions
ParserFunctionsの内部でCite.phpが適切にネストされません. 例えば、" " はParserFunctionの結果に関わらず"true"と"false"の両方を参照として返します. しかしながら、ParserFunctionsは&lt;ref&gt;タグの内部では完璧に動作します.

Special:Versionが空白
'author' => 'Ævar Arnfjörð Bjarmason',
 * バージョン1.9.2のSpecial:versionページを空白にしてしまいます. これは次の問題を引き起こしているようです:
 * これを修正するために次のように変更します(ラテン文字への置き換えが間違っていたらごめんなさい)

'author' => 'Evar Arnfjoro Bjarmason',

レンダリング
同じ名前を持つ先のタグのすべてが空である場合でもファーストネームではない の内容がレンダーされません.

プレビューが見つからない
インライン引用のためのプレビューが存在しません、ページのセクションのみを編集をするときにとりわけ面倒です. (Bug 5492)

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


 * 可能な解決方法は実際の参照セクションが与えられた名前を持つ参照のすべてを含むようにすること、記事全体で、完全な引用の代わりに、名前による単純な参照することです. このことによって異なるテキストを持つが最初の例のみを表示する、参照の複数の使用に関する混乱を減らします(セクションに関する混乱の原因は移り変わり、テキストが変更されない一方で、表示された参照は変更されることがあります). すなわち:

Some text that needs a ref. Another sentence that uses a ref, followed by another usage of the first ref.


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

過去の問題

 * 拡張機能はCSS2属性セレクタで均一に表されるid属性を生成しませんでした: Cite.phpの問題で、bug 4579をご覧下さい
 * マルチバイト、コロン、スペースとHTMLスペックに従ってエンコードが必要な他の値を使用することで内部リンクが壊れます:この拡張機能の問題ではなくMediaWikiの問題です. bug 4461をご覧下さい
 * 画像のキャプションで を使用することでXHTMLの出力が壊れます:MediaWikiの問題で、この拡張機能の問題ではありません. bug 1887をご覧下さい.

ref/noteスタイルとCite.phpスタイルの比較
これは実際によく似ています.


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