Extension:Cite

このページでは拡張機能について記述しています。 その使用方法については引用のヘルプを参照してください。

MediaWiki 拡張機能マニュアル

Cite リリースの状態: 安定
実装	タグ
説明	情報源を挙げるための脚注を提供し、オフライン媒体の内容の正しい引用を支援する
作者	Ævar Arnfjörð Bjarmasonトーク
最新バージョン	継続的な更新
互換性の方針	スナップショットが MediaWiki とともにリリースされます。 master には後方互換性がありません。
PHP	7.0+
データベースの変更	いいえ
パラメーター $wgCiteDefaultBacklinkAlphabet $wgCiteReferencePreviewsConflictingNavPopupsGadgetName $wgCiteResponsiveReferencesThreshold $wgCiteResponsiveReferences $wgCiteSubReferencing $wgCiteBacklinkCommunityConfiguration $wgCiteRemoveSyntheticRefsUnsafe $wgCiteReferencePreviews $wgCiteUseLegacyBacklinkLabels $wgCiteVisualEditorOtherGroup $wgCiteReferencePreviewsConflictingRefTooltipsGadgetName
タグ ‎<ref> ‎<references>
使用するフック APIQuerySiteInfoGeneralInfo CommunityConfigurationProvider_initList ContentHandlerDefaultModelFor EditPage::showEditForm:initial GetPreferences MakeGlobalVariablesScript ParserAfterParse ParserClearState ParserFirstCallInit ResourceLoaderGetConfigVars ResourceLoaderRegisterModules UserGetDefaultOptions
ライセンス	GNU 一般公衆利用許諾書 2.0 以降
ダウンロード	拡張機能をダウンロード Git [?]: リポジトリを参照 (Phabricator · GitHub) Gerrit コード レビュー Git コミット ログ Download source tarball
例	Wikipedia:Footnotes
translatewiki.net で翻訳を利用できる場合は、Cite 拡張機能の翻訳にご協力ください
問題点	未解決のタスク · バグを報告

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

使用法

更に詳しい情報はヘルプ ページ Cite 拡張機能にあります。

インストール

この拡張機能は MediaWiki 1.21 以降に同梱されているため、ダウンロードする必要はありません。 残りの設定手順は必ず従ってください。

• ダウンロードして、ファイルをextensions/フォルダー内のCiteという名前のディレクトリ内に配置します。
  開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:

  cd extensions/
  git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/Cite
  

• 以下のコードを LocalSettings.php ファイルの末尾に追加します:

  wfLoadExtension( 'Cite' );
  

• 必要に応じて設定を変更
• 完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

Vagrantでのインストール:

• Vagrant を使用している場合は、vagrant roles enable cite --provisionでインストールしてください。

設定

Name	Description	Default
$wgCiteSubReferencing	true に設定すると補参照を使用できるようになります。詳細はヘルプページ参照してください。	false
$wgCiteReferencePreviews	Extension:Popups がインストールされており、true に設定されている場合に参照プレビューを有効にします。	true
$wgCiteReferencePreviewsConflictingRefTooltipsGadgetName	MediaWiki:Gadgets-definition で識別子として使用されるローカルの参照ツールチップ ガジェット名。 このガジェットは、参照プレビューと互換性がありません。 参照プレビューは、ガジェットが有効になっている利用者に対しては無効になります。
$wgCiteResponsiveReferences	脚注のレスポンシブ対応に関する既定の設定。 true に設定すると、脚注セクションが複数列で表示されます。 ユーザドキュメントも参照してください。	true
$wgCiteVisualEditorOtherGroup	true に設定すると、引用のツールバーボタンが挿入メニューの下に移動する。 これはウィキボヤージュのサイトで使用されています。 機能リクエストの元記事も参照してください。	false

MediaWiki:Cite-tool-definition.json に JSON 定義を追加することで、特定のテンプレートを含む参照を作成するツールを Cite メニューに追加できます。 定義の内容は、各ツールに対応する一連のオブジェクトを含む配列である必要があります。 各オブジェクトには name, icon, template プロパティを含める必要があります。 オプションの title プロパティを使用すると、プレーンテキストでツールタイトルを定義するために使用できます。 name 属性はツールのユニークの識別子であり、メッセージキーに変換されることでツールのフォールバックタイトルも提供します。 nameには visualeditor-cite-tool-name- が接頭辞として付加され、メッセージはウィキで定義できます。 web, book, news, journal, map などのツール名には、一般的なメッセージが事前に定義されています。

例:

[ { "name": "web", "icon": "browser", "template": "Cite web" }, ... ]

(出典: gerrit:plugins/gitiles/mediawiki/extensions/Cite/+/refs/heads/wmf/1.46.0-wmf.7/modules/ve-cite/ve.ui.MWReference.init.js#66)

制限

Phabricator で追跡中
タスク T4700
未解決

• パイプの裏技 などの事前保存変換 は、この拡張機能で作成された脚注内では機能しません。

関連項目

• Help:引用
• Extension:Semantic Cite
• Extension:CiteThisPage