VisualEditor/Citation tool/ja

ビジュアルエディターの参照ツール（VisualEditor citation tool）はビジュアルエディターの利用者でもあなたのウィキの出典テンプレートを使うようにするためのツールです. 参照ツールを有効化するためにはビジュアルエディターとParsoidのインストール、テンプレートの使い方を指定するTemplateDataが含まれている出典テンプレート、ならびにビジュアルエディターと出典テンプレートを関連付けるための.jsonファイルが必要になります.

出典テンプレートをインポートする
出典機能を使うには出典テンプレートがあなたのウィキのデータベースに含まれている必要があります. 新しくインストールされたウィキなど出典テンプレートがない場合、それらを導入する必要があります. 最も簡単な導入方法はウィキペディアからコピーすることです. なお、すでに出典テンプレートがある場合は下記の手順を飛ばすことができます.


 * 1) Extension:Scribunto、Extension:ParserFunctions、Extension:Cite、Extension:TemplateDataをインストールします. ウィキペディアの出典テンプレートの大半はLuaというプログラミング言語を使っており（Scribunto拡張機能で使えるようになります）、また同拡張機能のパーサー関数も使っています. Citeは のタグを使えるようにするための拡張機能です.   これらの拡張機能はウィキペディアの全言語版、並びにウィキメディア財団の全ウィキですでにインストールされています.
 * 2) ウィキペディアから出典テンプレートを書き出す（Manual:Using_content_from_Wikipediaをご参照ください）. 最初はw:en:Template:Cite web、w:en:Template:Cite news、w:en:Template:Cite journal、w:en:Template:Cite bookの4テンプレートを書き出しましょう.  英語版ウィキペディアなど一部の言語版ではテンプレートの最新版を使うにはLuaモジュールが使える必要もあります.
 * 3) あなたのウィキのSpecial:Importページでテンプレートをアップロードします（例：http://localhost/index.php/Special:Import ）.

テンプレートデータ
参照ツールがテンプレートのデータをビジュアルエディターの欄に読み込むにはExtension:TemplateDataを導入して、各テンプレートでテンプレートデータを指定する必要があります. テンプレートデータを定義する方法、およびテンプレートデータがある/ない場合の表示についてはWikipedia:ビジュアルエディター/TemplateDataをご参照ください.

参照ツールの定義
To enable the VisualEditor citation tool on your wiki, you need to create a special message on your wiki:. This is because each wiki is different and so needs to customise which features it wants to use; for example, the names of the templates used on your wiki might be different from those of other wikis.

Purpose of the configuration message
メッセージ:

Once the  configuration message is created, the citation tool will be live for all VisualEditor users on your wiki within a few minutes.
 * Says which templates your wiki uses for standard citations (you can state up to 5).
 * ご注意: どのテンプレートにも必ず テンプレートデータ が必要です. defined or the system will be very difficult for users to understand. If your wiki does not currently use citation templates, it is common to copy the templates from the English Wikipedia as a good general set.
 * Says which label you wish to use for each type of citation.
 * There are a standard four, "web", "book", "news" and "journal", which correspond to  etc.
 * Says which icon you wish to use for each type of citation.
 * There are a standard four, "ref-cite-web", "ref-cite-book", "ref-cite-news" and "ref-cite-journal", which correspond to CSS classes with the icon as a background SVG image called  etc.

Additional types
If you are considering adding an additional type, the development team would really like to talk with you first, to give advice, help create an appropriate icon, and so we can consider whether other wikis might also want this type defined for all wikis.

To add an additional type, you will need to:


 * 1) 作成したいタイプを決める
 * 2) * たとえば、データベースへのリファレンスを作成したい場合、そのタイプを"database"と名付けます.
 * 3) ラベルを作る
 * 4) * 例えば、ラベルの名前を"db"にして、 で"データベース"というラベルを追加することができます. これはあなたのウィキの言語で記述すべきです. あなたのウィキで複数の言語や文字が使われている場合、ラベルも複数作成する必要があります.
 * 5) アイコンを作る
 * 6) * For the example, you could make the icon label "ref-cite-dbase", and create the icon as an SVG file uploaded to commons, create the icon class " " in  and add the icon you want with " " or similar.

例
定義メッセージの例は英語版ウィキペディアとポーランド語版ウィキペディアをご参照ください.

トラブルシューティング
Special:VersionではTemplateDataがインストールされていると表示されるにもかかわらず、出典ダイアログに引数欄が表示されない場合、出典テンプレートを編集して、変更点なしで保存する必要があります（いわゆる「空編集」）. これはTemplateDataが（たとえば、Template:Cite_webではなくTemplate:Cite_web/docに存在するため）参照読み込みされるとき、親テンプレートが編集されるまでTemplateDataがデータベースにロードされないというバグによるものです. もご参照ください.

なお、標準の4テンプレート以外のテンプレートを使用する場合、ユーザー体験はやや違うものとなります. 例えば、出典ダイアログにおいて引数の一覧は最初には表示されないが、ボタンを押して引数の一覧を表示させることができます.