Help:VisualEditor/User guide/ja

 記事そのものの編集ではなくて、ビジュアルエディターを試してみたい場合は、[ こちらのサンドボックスのページ]でご自由にどうぞ. &#32; サンドボックスのページではアカウントを登録していなくてもビジュアルエディターを使用できます.

編集を始める: ビジュアルエディターのツールバー
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
 * まず挿入したいテンプレートの名前を記入します. 一覧にそれが表示されたら、名前を押し、次に「」を押します.
 * VisualEditor_Template_Search.png
 * colspan=2 |
 * 既存のテンプレートを編集する方法もあります. 変更するテンプレートを押すと青みがかった色に変わり、ボックス内に「$」アイコン (訳注：パズルのピース形) が現れます.  次に「」を押すか、テンプレート自体をダブルクリックし、開きます.
 * VisualEditor_Template_Context_Menu.png
 * colspan=2 |
 * テンプレートにはページの閲覧者によって表示されないものがあります. そのようなテンプレートをビジュアルエディターではパズルのかけらのアイコンにまとめました. パズルのアイコンの脇に、テンプレートの名称を表示します.
 * VisualEditor_Hidden_Templates.png
 * VisualEditor_Template_Context_Menu.png
 * colspan=2 |
 * テンプレートにはページの閲覧者によって表示されないものがあります. そのようなテンプレートをビジュアルエディターではパズルのかけらのアイコンにまとめました. パズルのアイコンの脇に、テンプレートの名称を表示します.
 * VisualEditor_Hidden_Templates.png
 * テンプレートにはページの閲覧者によって表示されないものがあります. そのようなテンプレートをビジュアルエディターではパズルのかけらのアイコンにまとめました. パズルのアイコンの脇に、テンプレートの名称を表示します.
 * VisualEditor_Hidden_Templates.png


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

テンプレートの引数

 * You’ll see this dialog box when you’re adding a new template or editing one already in place. What you see in the box depends on whether the template in question contains, helpful metadata added by other editors to make it easier to edit templates in the Visual Editor.
 * You’ll see this dialog box when you’re adding a new template or editing one already in place. What you see in the box depends on whether the template in question contains, helpful metadata added by other editors to make it easier to edit templates in the Visual Editor.

When a template contains TemplateData, the VisualEditor can use it to present annotated fields for you to fill in.

For templates that have some community-provided TemplateData, the VisualEditor displays a list of the named parameters and, often, descriptions and instructions explaining the meaning and required format for each parameter’s values.
 * 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 |

Adding undocumented parameters

 * If you’re inserting or editing a template whose author hasn’t laid out its parameters in TemplateData, it has what we call “undocumented” or “unnamed parameters”. In these cases, you should consult the page for the template itself.  There you can learn how to correctly employ and work with all of the template’s parameters.  This includes learning the exact names of the parameters as written by the template author.
 * If you’re inserting or editing a template whose author hasn’t laid out its parameters in TemplateData, it has what we call “undocumented” or “unnamed parameters”. In these cases, you should consult the page for the template itself.  There you can learn how to correctly employ and work with all of the template’s parameters.  This includes learning the exact names of the parameters as written by the template author.

If you find in the documentation that the template expects parameters without have names, fill in numbers as placeholders for the parameter names using the undocumented parameter input, then add next to the values you want to provide as you normally would.

Example: * first unnamed parameter: “1” * first unnamed parameter’s value: “en_US” * second unnamed parameter: “2” * second unnamed parameter’s value: “yes”

If you accidentally include nonexistent, misspelled or erroneous parameters, the values you enter for those parameters won’t show up on the page you’re editing.
 * Template_without_TemplateData_in_VisualEditor_(old_UI).png
 * colspan=2 |
 * colspan="2" |
 * colspan="2" |
 * colspan="2" |

Autogenerated parameters

 * In this example, the template in question lacks TemplateData but it was possible to autogenerate the parameters. This means that the undocumented parameters have already been added for you, but the names may not be easily understandable and the dialog cannot display any directions or descriptions. As a result the dialog box provides a link to the template’s documentation, which should help you deduce and fill in the template’s various parameters.
 * Autogenerated_parameters_in_the_VisualEditor.png
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Editing multi-part template content

 * During editing, you may open template content consisting of multiple templates or a single template linked to some wikitext. This differs from the nested templates described below. In this case, the templates are better visualized as being stacked or connected.
 * During editing, you may open template content consisting of multiple templates or a single template linked to some wikitext. This differs from the nested templates described below. In this case, the templates are better visualized as being stacked or connected.

This content often contains “unbalanced templates,” templates which are incomplete on their own and need to be paired with some wikitext or another template in order to function. 入れ子のテンプレート
 * 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 |

Completing your edit

 * テンプレートの編集が完了したら、「」を押してダイアログを閉じ、通常の編集画面に戻ります. Then you can preview your edit and make sure it looks the way you want and expect.
 * テンプレートの編集が完了したら、「」を押してダイアログを閉じ、通常の編集画面に戻ります. Then you can preview your edit and make sure it looks the way you want and expect.

You may also see an error message, which (like the other TemplateData mentioned above) is community-provided content and may vary in usefulness. You may need to consult the template’s own documentation to get to the bottom of some errors. If you’re still having trouble, consider posting about your problem on the template’s talk page.
 * border|center|150px
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |
 * colspan=2 |

Editing on mobile

 * When editing a template on a page using the VisualEditor on a mobile device, you’ll see that the sidebar starts out hidden. You can make it visible by pressing the “Show/hide options” button.
 * When editing a template on a page using the VisualEditor on a mobile device, you’ll see that the sidebar starts out hidden. You can make it visible by pressing the “Show/hide options” button.


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

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

 * When you insert a template in a wiki page, its content and appearance are reevaluated every time the page loads, based on the template code and the values of its parameters. This means if someone updates the code of a template, then every page which uses that template will also get updated when they publish.
 * When you insert a template in a wiki page, its content and appearance are reevaluated every time the page loads, based on the template code and the values of its parameters. This means if someone updates the code of a template, then every page which uses that template will also get updated when they publish.

There’s another, much less common way to use templates, though, and that’s to substitute a template. Doing this permanently includes the template content just as it appears at the moment you insert it. It will not update if the template code is later changed.

Most users won’t ever need to resort to substitution. Substitution is typically only useful when you need to capture the exact appearance of one version of a template, such as when content is under development and needs evaluation.

To substitute a template in the VisualEditor, insert a template using the name syntax. (Autocomplete doesn’t work in this case.) Then press the blue “Add template” button.

When you’re finished, press “Insert”, which will insert the template content as you see it.
 * SUBST_in_VE.png
 * }

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