Help:VisualEditor/User guide/ja

編集を始める: ビジュアルエディターのツールバー
center|950px|alt=ビジュアルエディターのツールバーのスクリーンショット

border|950px|center

出典の編集
{| cellpadding="15"
 * colspan=2 |

導入されているシステムの見分け方

 * 3つある脚注のしくみのうち、どれか1つが利用可能になっています. 右の挿絵に示したものは一番シンプルで、「」メニューには引用テンプレートがひとつもありません.  もしご利用のウィキがこのシステムを使用しているなら、脚注についての説明は以上でおしまいです.
 * border|center|200px
 * colspan=2 |
 * 2番目のシステムもメニューは同じタイプですが、すぐにアクセスできるようによく使う引用テンプレートが用意されています. もしご使用のウィキがこのシステムを導入しているなら、詳細な説明はにあります.
 * border|center|200px
 * colspan=2 |
 * border|center|100px
 * 3番目のシステムでは、まず Cite ボタンを押します. するとボックスが開き、citoid サービスを使って自動的に出典作成の手順が示されます.  このシステムを採用しているウィキでは、 (出典の示し方) に詳しい説明があります.
 * border|center|400px
 * colspan=2 |
 * border|center|100px
 * 3番目のシステムでは、まず Cite ボタンを押します. するとボックスが開き、citoid サービスを使って自動的に出典作成の手順が示されます.  このシステムを採用しているウィキでは、 (出典の示し方) に詳しい説明があります.
 * border|center|400px
 * colspan=2 |
 * 3番目のシステムでは、まず Cite ボタンを押します. するとボックスが開き、citoid サービスを使って自動的に出典作成の手順が示されます.  このシステムを採用しているウィキでは、 (出典の示し方) に詳しい説明があります.
 * border|center|400px
 * colspan=2 |
 * colspan=2 |

既存の出典の編集

 * 既存の脚注を編集するには、テキスト内のマーク (ふつうは大カッコと数字のセット) を押します. すると「」アイコン (しおりマーク) または、その脚注を作ったテンプレートのアイコン (とその名前) が現われます. いずれにしろ「編集」ボタンを押すとダイアログボックスが開き、脚注を編集できます.
 * border|400px|center
 * colspan=2 |
 * 「」アイコンと対応する「編集」ボタンを押すと、脚注のダイアログボックスが開き、そこで内容を編集できます.
 * colspan=2 |
 * 「」アイコンと対応する「編集」ボタンを押すと、脚注のダイアログボックスが開き、そこで内容を編集できます.
 * 「」アイコンと対応する「編集」ボタンを押すと、脚注のダイアログボックスが開き、そこで内容を編集できます.

多くのウィキでは、脚注を整形するテンプレートを用いています. テンプレートを利用して脚注を付けた場合、脚注情報にカーソルを当てると、脚注フィールド内の情報が強調表示になります.

使用してあるテンプレートの出典の情報を押すと、アイコン (ジグソーパズルのかけら) とともに情報を表示します. 「編集」ボタンを押してテンプレート編集欄を開き、テンプレートの内容を編集します.
 * border|center|400px
 * colspan=2 |
 * もし出典を押して標準の出典テンプレートが表示されたら (右のサンプルを参照) 「編集」ボタンを押して編集欄を開きます.
 * border|center|400px
 * colspan=2 |
 * テンプレートの編集欄では、情報のタイプを加減したり、内容を編集したりします. 記述されたフィールド (テンプレートの変数) だけが表示されます. フィールドを追加するには、編集欄のいちばん下にある「」を押します.
 * border|center|400px
 * colspan=2 |
 * 完了したら、「」を押します.
 * border|center|150px
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * 完了したら、「」を押します.
 * border|center|150px
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

既存の出典の再使用

 * ページに既存の出典がある場合、あなたが出典を示したい文章にそれを再利用できます.
 * ページに既存の出典がある場合、あなたが出典を示したい文章にそれを再利用できます.

既存の出典を再利用するには、文中の出典 (と出典番号) を追加したい場所にカーソルを置いて「」メニューの「再利用」アイコンを押します.

(注記: 上記の3番目の脚注システムを採用するウィキでは、「」メニューに「再利用」アイコンが出る代わりに、編集欄に「再利用」のタブが表示されます. )
 * border|200px|center
 * colspan=2 |
 * 脚注を再利用するには ダイヤログボックスを開き、一覧からもう一度使うものを選びます. 多数ある場合には、検索バー (「」と表示) に特定のテキストを入力すると、しぼりこんだ結果のみ一覧できます.
 * border|400px|center
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

新しい出典の追加

 * 「」メニューを使って脚注を新たに追加するには、文中の脚注をつけたい位置をクリックします. そしてメニューから適した出典のタイプを選びます.
 * border|200px|center
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

「基本」の引用を使用

 * 基本の出典アイコンを押したときの画面表示はこうなります.  出典エディターでは、出典の追加と、既存の出典の整形ができます.
 * 基本の出典アイコンを押したときの画面表示はこうなります.  出典エディターでは、出典の追加と、既存の出典の整形ができます.

脚注を既存のグループに含めることもできますが、通常は空欄のままにします. (これは「」ツールを使ってグループ化した脚注を表示させるオプションを説明しています)
 * border|400px|center
 * colspan=2 |
 * 出典エディターのドロップダウンボックスを使い、新しい出典に出典あるいはその他のテンプレートを含めるには、出典エディターの「」ツールバー メニューにある アイコン (パズルのピース) を押します.
 * border|center|200px
 * colspan=2 |
 * それから、他のテンプレートの操作と同じように、使いたいテンプレートを探して追加してから望む通りに編集します. (テンプレートの詳しい解説は、以下に テンプレートの編集のセクションがありますので参照してください. )
 * colspan=2 |
 * それから、他のテンプレートの操作と同じように、使いたいテンプレートを探して追加してから望む通りに編集します. (テンプレートの詳しい解説は、以下に テンプレートの編集のセクションがありますので参照してください. )
 * それから、他のテンプレートの操作と同じように、使いたいテンプレートを探して追加してから望む通りに編集します. (テンプレートの詳しい解説は、以下に テンプレートの編集のセクションがありますので参照してください. )
 * それから、他のテンプレートの操作と同じように、使いたいテンプレートを探して追加してから望む通りに編集します. (テンプレートの詳しい解説は、以下に テンプレートの編集のセクションがありますので参照してください. )

新しいテンプレートの編集が終わったら、「」を押して引用エディターに戻り、もう一度「」を押して元の編集していたページに戻ります.
 * border|center|400px
 * colspan=2 |
 * ページにまだ「出典の一覧」がない場合（例: そのページで初の出典を追加するとき）、閲覧者に対して、どこに出典一覧および出典情報を表示するか、決める必要があります.
 * ページにまだ「出典の一覧」がない場合（例: そのページで初の出典を追加するとき）、閲覧者に対して、どこに出典一覧および出典情報を表示するか、決める必要があります.
 * ページにまだ「出典の一覧」がない場合（例: そのページで初の出典を追加するとき）、閲覧者に対して、どこに出典一覧および出典情報を表示するか、決める必要があります.

脚注の一覧を表示させたい場所 （通常はページ下部） にカーソルを置き、「」メニューを開いてから「」アイコン (3冊の本) を押します.
 * border|center|200px
 * colspan=2 |
 * ごくまれなケースとして、複数の出典グループを用いる場合は、このダイアログでグループを特定します. そのグループを作ったページの利用者が指定した箇所に、特定のグループに属する脚注のみ表示します.
 * ごくまれなケースとして、複数の出典グループを用いる場合は、このダイアログでグループを特定します. そのグループを作ったページの利用者が指定した箇所に、特定のグループに属する脚注のみ表示します.
 * ごくまれなケースとして、複数の出典グループを用いる場合は、このダイアログでグループを特定します. そのグループを作ったページの利用者が指定した箇所に、特定のグループに属する脚注のみ表示します.

脚注一覧ダイアログを終えるには「」を押します.
 * border|center|400px
 * colspan=2 |
 * colspan=2 |

標準の引用テンプレートの使用

 * もしご使用のウィキで独自の出典テンプレートを用意していると、「」メニューに表示します. よく使われる出典テンプレートにすばやくアクセスできます. (ご使用のウィキで出典テンプレートの追加は、 で方法を説明しています. )
 * border|200px|center
 * colspan=2 |
 * テンプレートの例えば「Cite book」アイコンを押すとテンプレートのミニ エディターが開き、必ず記入するべきフィールドに「*」(アスタリスク) が付いています. もっともよく使われるフィールドが表示されますが、すべてに記入する必要はありません.
 * border|430px|center
 * colspan=2 |
 * 変数を追加するには、ミニエディターのいちばん下までスクロールし、「」を押します.
 * border|430px|center
 * colspan=2 |
 * 変数を追加するには、ミニエディターのいちばん下までスクロールし、「」を押します.
 * 変数を追加するには、ミニエディターのいちばん下までスクロールし、「」を押します.
 * 変数を追加するには、ミニエディターのいちばん下までスクロールし、「」を押します.

完了したら、「」を押します.
 * border|200px|center
 * }

画像などメディアファイルの編集
{| cellpadding="15"
 * colspan=2 |
 * colspan=2 |

画像の編集

 * 新しい画像 (または別種のメディア) を挿入するには、「」メニューの「」 (山の絵) を押してください. カーソルがどこにあっても画像が追加されます.
 * border|200px|center
 * colspan=2 |
 * 「」アイコンを押すとダイアログが開き、編集中のページの名前と関連するメディア ファイルを自動的に検索します. 探す範囲は、ウィキメディア・コモンズやローカル ウィキです.
 * colspan=2 |
 * 「」アイコンを押すとダイアログが開き、編集中のページの名前と関連するメディア ファイルを自動的に検索します. 探す範囲は、ウィキメディア・コモンズやローカル ウィキです.
 * 「」アイコンを押すとダイアログが開き、編集中のページの名前と関連するメディア ファイルを自動的に検索します. 探す範囲は、ウィキメディア・コモンズやローカル ウィキです.

ダイアログの検索枠にあるテキストを変更すれば、また別のメディアファイルを探すことができます.

サムネイルを押してファイルを選択してください.

こうするとあなたが編集中のページに画像が配置されます.
 * border|center|500px
 * colspan=2 |
 * 選んだ画像がページに追加されると、続いて新しいダイアログが開きます. このメディア ダイアログで、画像のキャプションの追加および編集ができます. キャプションでは書式設定やリンクもできます.
 * border|center|400px
 * colspan=2 |
 * メディアダイアログでは、スクリーンリーダーを用いているユーザや画像表示をオフにしているユーザの助けになる代替テキストの追加もできます.
 * border|center|400px
 * colspan=2 |
 * 「」のウィンドウで様々なパラメータを設定できます. パラメータには画像の配置位置、タイプ、大きさなどがあります.
 * border|center|400px
 * colspan=2 |
 * キャプションを編集したら「」を押します. すると、ダイアログが閉じ、通常の編集画面に戻ります.
 * border|center|150px
 * colspan=2 |
 * すでに配置済みの画像に対しては、画像を押してキャプションを追加または編集したり、設定を変更したりして、それから「」を押します.
 * border|center|400px
 * colspan=2 |
 * キャプションを編集したら「」を押します. すると、ダイアログが閉じ、通常の編集画面に戻ります.
 * border|center|150px
 * colspan=2 |
 * すでに配置済みの画像に対しては、画像を押してキャプションを追加または編集したり、設定を変更したりして、それから「」を押します.
 * colspan=2 |
 * すでに配置済みの画像に対しては、画像を押してキャプションを追加または編集したり、設定を変更したりして、それから「」を押します.
 * すでに配置済みの画像に対しては、画像を押してキャプションを追加または編集したり、設定を変更したりして、それから「」を押します.
 * すでに配置済みの画像に対しては、画像を押してキャプションを追加または編集したり、設定を変更したりして、それから「」を押します.

既存の画像のサイズを変更するには、画像を押してサイズ変更アイコン（画像の隅に表示される両端がとがった矢印）を動かします.

画像をドラッグ&ドロップすることにより、画像を上または下に移動することができます.
 * center|360px
 * }

テンプレートの編集
MediaWiki のテンプレートシステムは強力であり、複雑なコンテンツを挿入したり、他のページから引用したりなど、さまざまな操作ができます. 詳細な説明と事例集は、テンプレートのヘルプページをご参照ください.

ビジュアルエディタを使うと、適切なテンプレートを探したり、編集しているページに関数の呼び出し (invocation) つまり参照読み込みのテンプレートを書き込んだりでき、必要に応じてパラメータを利用して特製のコンテンツを追加することもできます.

新しいテンプレートの追加
{| cellpadding="15"
 * ページにテンプレートを追加したい場合、ページ内のテンプレートを挿入したい箇所にカーソルを置きます. <-- 「$insert」メニューにある「$template」アイコン (パズルのピース) を押します. --> 次にメニューを開き、「[[File:OOjs_UI_icon_puzzle-ltr.svg]] 」アイコンを押します (訳注：パズルのピース).  代わりの方法として、希望の箇所に波カッコ2個{{を記入します.
 * border|300px|center
 * Find the template you want to insert by typing either its name or a relevant keyword. Results containing the search term in either the name or description will display in a dropdown. This should help you find a relevant template, even if you don’t know its exact name.
 * Find the template you want to insert by typing either its name or a relevant keyword. Results containing the search term in either the name or description will display in a dropdown. This should help you find a relevant template, even if you don’t know its exact name.
 * Find the template you want to insert by typing either its name or a relevant keyword. Results containing the search term in either the name or description will display in a dropdown. This should help you find a relevant template, even if you don’t know its exact name.

If you’re having trouble finding the kind of template you want by using keywords, you can look on other wiki pages with similar content and view or edit the page source to see which templates are in use. When you find the desired template’s name, you can type it into this field to insert it here.
 * VisualEditor_Template_Search.png
 * colspan=2 |
 * 既存のテンプレートを編集する方法もあります. 変更するテンプレートを押すと青みがかった色に変わり、ボックス内に「$」アイコン (訳注：パズルのピース形) が現れます.  次に「」を押すか、テンプレート自体をダブルクリックし、開きます.
 * VisualEditor_Template_Context_Menu.png
 * colspan=2 |
 * テンプレートにはページの閲覧者によって表示されないものがあります. ビジュアルエディターでは、そのようなテンプレートは可視化してあり、直接、クリックして編集したり除去したりできます.  パズルのアイコンと、その脇にテンプレートの名称が現れ、どちらも文字の色はグレーです.
 * VisualEditor_Hidden_Templates.png
 * colspan=2 |
 * テンプレートにはページの閲覧者によって表示されないものがあります. ビジュアルエディターでは、そのようなテンプレートは可視化してあり、直接、クリックして編集したり除去したりできます.  パズルのアイコンと、その脇にテンプレートの名称が現れ、どちらも文字の色はグレーです.
 * VisualEditor_Hidden_Templates.png
 * VisualEditor_Hidden_Templates.png


 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

テンプレートの引数

 * このダイアログボックスは、テンプレートを追加したり既存のものを編集するときに表示されます. ダイアログボックス内の項目は、対象のテンプレートにがあるか、他の編集者が記入した有用なメタデータがあるなら、ヴィジュアルエディタでのテンプレート編集が楽になります.
 * このダイアログボックスは、テンプレートを追加したり既存のものを編集するときに表示されます. ダイアログボックス内の項目は、対象のテンプレートにがあるか、他の編集者が記入した有用なメタデータがあるなら、ヴィジュアルエディタでのテンプレート編集が楽になります.

テンプレート内にTemplateDataが書いてあると、ビジュアルエディタは記入するべき欄を表示して説明を添えます.

コミュニティが合意して書き込んだTemplateDataを含む場合、ヴィジュアルエディタは名前付きパラメータの一覧を表示し、しばしば値ごとに意味の説明や必要な書式の指示が添えられます.
 * Template_parameters_in_VisualEditor.png
 * colspan="2" |
 * 既存のテンプレートの場合、ダイアログの既存の引数を編集することも、ボックスのいちばん下にある「」を押して追加することもできます.
 * Template_parameter_list_in_VE_(old_UI).png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

説明のないパラメータを追加する

 * テンプレートの追加もしくは編集をするとき、テンプレート執筆者がTemplateDataにパラメータの解説を述べていない場合、「説明なし」「名前なし」のパラメータという状態です. このような場合、テンプレートの解説ページを確認してください.  するとテンプレートのそれぞれのパラメータをどう正しく使うか、操作するか理解できます.  これは、パラメータ執筆者が与えた個々のパラメータの正しい名称を覚えることでもあります.
 * テンプレートの追加もしくは編集をするとき、テンプレート執筆者がTemplateDataにパラメータの解説を述べていない場合、「説明なし」「名前なし」のパラメータという状態です. このような場合、テンプレートの解説ページを確認してください.  するとテンプレートのそれぞれのパラメータをどう正しく使うか、操作するか理解できます.  これは、パラメータ執筆者が与えた個々のパラメータの正しい名称を覚えることでもあります.

もしテンプレート解説文書の中に、パラメータの name 要素は無しにすると書いてあったら、無名のパラメータを入力する方法でパラメータのプレースホルダに数字を記入し、通常どおりに編集対象の値の次に記入します.

例：
 * 1番目の名前なしパラメータ： “1”
 * 1番目の名前なしパラメータの値：“en_US”
 * 2番目の名前なしパラメータ：“2”
 * 2番目の名前なしパラメータの値：“yes”

もし実在しない、スペルが間違っている、またはエラーになるパラメータを書き込んだ場合は、それらのパラメータに値を入力しても、編集中の文の中に表示されません.
 * Template_without_TemplateData_in_VisualEditor_(old_UI).png
 * colspan=2 |
 * colspan="2" |
 * colspan="2" |
 * colspan="2" |

自動生成のパラメーター

 * この例では対象とするテンプレートには TemplateData が足りませんがパラメータの自動生成ができました. これはシステムが解説のないパタメータを利用者の代わりに入力したからで、その場合もパラメータの名前は簡単に理解できなかったり、ダイアログに指示や説明が表示できなかったりします. 結果として、ダイアログボックスにテンプレートの解説文書へのリンクが表示され、これはテンプレートのさまざまなパラメータを推測して入力するのに役立ちます.
 * Autogenerated_parameters_in_the_VisualEditor.png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

複雑な構成のテンプレートのコンテンツを編集する

 * 編集作業中に開いたテンプレートが、複数のテンプレートの組み合わせの場合、あるいは単体のテンプレートから複数のウィキテキストにリンクが張ってある場合に出会うかもしれません. これは、以下に説明する入れ子のテンプレート類とは異質なものです.  この事例では、テンプレートはまとまりとして、あるいは連携した形で資格化する方が良いです.
 * 編集作業中に開いたテンプレートが、複数のテンプレートの組み合わせの場合、あるいは単体のテンプレートから複数のウィキテキストにリンクが張ってある場合に出会うかもしれません. これは、以下に説明する入れ子のテンプレート類とは異質なものです.  この事例では、テンプレートはまとまりとして、あるいは連携した形で資格化する方が良いです.

このコンテンツにはしばしば「バランスの取れていないテンプレート」が含まれ、それは単体では不完全で、ウィキテキストとの組み合わせ、もしくは他のテンプレートと連携しないと作動しません. 入れ子のテンプレート
 * Multi-part_template_content_in_the_VisualEditor.png
 * colspan=2 |
 * colspan="2" |
 * colspan="2" |
 * colspan="2" |
 * テンプレートのパラメータに、別のテンプレートを組み込むことができます. テンプレートの書式を読むと、波カッコ2個で囲んだ値を見かけますが  、それが入れ子のテンプレートの箇所です.
 * テンプレートのパラメータに、別のテンプレートを組み込むことができます. テンプレートの書式を読むと、波カッコ2個で囲んだ値を見かけますが  、それが入れ子のテンプレートの箇所です.

ビジュアルエディタは、編集者の利便性を優先するために、この別のテンプレートに埋め込まれたもの (入れ子のテンプレート) を表示できません. そこで、入れ子のテンプレートをに書きたい場合は、ウィキテキストでテンプレートのどこに何を書くか、正しい方法を覚える必要があります.
 * Embedded_template_in_VisualEditor.png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

編集を完了する

 * テンプレートの編集が完了したら、「」を押します. 次に編集をプレビューし、希望したとおりの見た目になっているかどうか、確認してください.
 * テンプレートの編集が完了したら、「」を押します. 次に編集をプレビューし、希望したとおりの見た目になっているかどうか、確認してください.

このときエラ〜メッセージが表示される場合があり、それは (前述の他の TemplateData 同様に) コミュニティが提供したコンテンツであり、便利さには差があります. 特定のエラーを解消するには、そのテンプレートの開設文書までたどっておく必要があるかもしれません. まだトラブルが解決しない場合は、問題点をテンプレートのトークページに投稿することもご検討ください.
 * border|center|150px
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

テンプレートの除去

 * ビジュアルエディターから特定のテンプレートを除去するには、テンプレートボックス内でクリックします. すると文脈メニューが表示されますので、 「削除」ボタンを確認してください.  そのボタンをクリックすると、ページから当該のテンプレートを除去します.
 * Removing_templates_from_a_page_via_context_menu.png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

モバイル機器で編集する

 * モバイル端末の利用者が、ビジュアルエディタを使ってページにあるテンプレートを編集する場合は、最初はサイドバーが非表示になっています. 「表示／非表示」ボタンを押して切り替えてください.
 * モバイル端末の利用者が、ビジュアルエディタを使ってページにあるテンプレートを編集する場合は、最初はサイドバーが非表示になっています. 「表示／非表示」ボタンを押して切り替えてください.


 * VisualEditor_template_editing_on_mobile.png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

テンプレートをsubst展開する

 * ウィキページにテンプレートを挿入するには、その内容と見た目はそのページが読み込まれるときに毎回、評価され、その基準はテンプレートに含まれるパラメータのコードと値です. これはつまり、誰かがテンプレートのコードを更新すると、そのテンプレートを使用するすべてのページでも、そのページが表示されたときに更新されます.
 * ウィキページにテンプレートを挿入するには、その内容と見た目はそのページが読み込まれるときに毎回、評価され、その基準はテンプレートに含まれるパラメータのコードと値です. これはつまり、誰かがテンプレートのコードを更新すると、そのテンプレートを使用するすべてのページでも、そのページが表示されたときに更新されます.

それに加え、テンプレートの利用にはあまり浸透していない方法があり、それはテンプレートのサブスティチュート subsitution と呼びます. これを永久的に実行するには、特定のテンプレートを挿入した瞬間に表示された見た目そのままに、その内容も対象になります. テンプレートのコードが後日、変更されたとしても、見た目は変わりません.

ほとんどの利用者にとって、サブスティチュートは必要ありません. サブスティチュートが有効な場合は限定され、特定のテンプレートの特定のバージョンそのままの見た目を捉えたい場面のみであり、例えばコンテンツが開発途中とか、査読を受ける必要があるなどの場合が該当します.

ビジュアルエディタを使ってテンプレートをサブスティチュート (代入) するには、名前構文 を記入します. (自動補完機能はこの事例では無効にしてあります. ) 次に青色の「テンプレートを追加」ボタンを押します.

完了したら「挿入」を押すと、テンプレートの内容を見たまま挿入します.
 * SUBST_in_VE.png
 * }

キーボード ショートカット
多くの編集者はウィキテキストを直接記入するのに慣れています. とりわけ、太字、斜体、ウィキリンクなど. キーボードショートカットを使えば、ツールバーをクリックしなくても、同様な書式追加を迅速に行うことができます. ビジュアルエディターでも機能するショートカットがあります.