ヘルプ:専用の編集ボタン

このヘルプには更新、または翻訳されていないコンテンツがあります。どなたでも翻訳にご協力いただくことができます。

原文 : w:Help:Custom edit buttons。

Fandomのクラシックソースモードのエディタを利用していると、エディタのツールバーにあるカスタム編集ボタンに目が行くことでしょう。これらのボタンは、特殊な文字や文を編集ボックスに挿入するために使います。

注意：ビジュアルモードでの編集中（個人設定にて「使用するエディタ」に「ビジュアル・エディア」を選んでいる場合）はこのボタンは表示されません。

基本的なツールバー

既定のツールバーは下記のとおりです。

個人用のwikia.jsを編集することで、自分だけに表示されるボタンを追加したり、MediaWiki:Common.jsを編集することで、Wiki上のすべてのユーザーに表示されるボタンを追加したりできます。

カスタムされた編集バーは以下のようになります。

ボタンの利用法

ソースモードでの編集中にボタンをクリックすると、シンボルやテキストの一部が挿入されます。例えば、 をクリックすると、カーソルのある部分に以下の文が挿入されます： '''太字''' 。太字にしたいテキストをハイライトしてこのボタンを押すと、ハイライトした文の前後に'''が追加され、その状態でページを保存するとハイライトした部分が太字で表示されるようになります。他のボタンも同じような仕組みです。いくつかクリックして、何が挿入されるか確認してみてください。

ボタン画像の作成とアップロード

まず、23x22の画像を作成し（テンプレートとして Image:Button_blank.pngを使えます）、アップロードします。

注意：他のWikiでも活用できそうな画像であれば、コミュニティ・セントラルからアップロードしてください（この際、[[カテゴリ:Custom edit buttons]]とタグを付けるようにしてください）。他の人がアップロードしたボタン画像はCategory:Custom_edit_buttons（英語）で確認できます。

JavaScriptファイルの編集

編集すべき正しいJavaScript (.js)ページを探してください ― こちらについての詳しい情報はヘルプ:CSSとJavaScriptに関する高度な情報をご覧ください。

JavaScriptページに新しいmwCustomEditButtonsの項目を作ってください。追加したいカスタムボタン1つにつき、配列の要素を1つ増やしてください。以下は、JavaScriptページの編集例です:

if (mwCustomEditButtons.length) {
	mwCustomEditButtons[mwCustomEditButtons.length] = {
		"imageFile": "http://images.wikia.com/central/images/c/c8/Button_redirect.png",
		"speedTip": "Redirect",
		"tagOpen": "#REDIRECT [[",
		"tagClose": "]]",
		"sampleText": "Insert text"
	};

	mwCustomEditButtons[mwCustomEditButtons.length] = {
		"imageFile": "http://images.wikia.com/central/images/c/c9/Button_strike.png",
		"speedTip": "Strike",
		"tagOpen": "<s>",
		"tagClose": "</s>",
		"sampleText": "Strike-through text"
	};

	mwCustomEditButtons[mwCustomEditButtons.length] = {
		"imageFile": "http://images.wikia.com/central/images/1/13/Button_enter.png",
		"speedTip": "Line break",
		"tagOpen": "<br />",
		"tagClose": "",
		"sampleText": ""
	};

	mwCustomEditButtons[mwCustomEditButtons.length] = {
		"imageFile": "http://images.wikia.com/central/images/7/74/Button_comment.png",
		"speedTip": "Comment visible only for editors",
		"tagOpen": "<!-- ",
		"tagClose": " -->",
		"sampleText": "Insert comment here"
	};
}

上記の内容にさらにボタンを追加したいときは、以下の内容をコピーし、

	mwCustomEditButtons[mwCustomEditButtons.length] = {
		"imageFile": "http://images.wikia.com/central/images/7/74/Button_comment.png",
		"speedTip": "Comment visible only for editors",
		"tagOpen": "<!-- ",
		"tagClose": " -->",
		"sampleText": "Insert comment here"
	};

これを最後の右中括弧とセミコロン }; のあとにペーストしてください。そして、追加したいボタンを完成させるために、それぞれの値を変更しましょう。値は:

imageFile

画像のフルURL。

フルURLを確認するには、画像記述ページで画像下のハイパーリンクをクリックし、フルサイズの画像を表示させてください。画像のみが表示されるはずですので、そのページのURLを使いましょう。

画像はあなたのWikiあるいはコミュニティ・セントラルに保存してください ― Wikia.com URLが必須です。

speedTip

ツールチップテキストです（マウスをボタンにかざしたときに表示されます）。

tagOpen

開始タグです。

tagClose

終了タグです（サンプルテキストが必要ない場合は省略されます）。

sampleText

挿入時に（他のふたつのタグに囲まれて）自動的にハイライトされるテキストで、挿入後にユーザーが内容を書き換えることを想定するものです。開始タグを終了タグの間に何も置きたくない場合は、この項目を空にしてください。

ページを保存しブラウザをリフレッシュすると、ソースモードのページ編集画面にカスタムボタンが表示されるようになります。

参考

• Category:Custom edit buttons - コミュニティセントラルにアップロードされた、利用可能な画像
• commons:Special:PrefixIndex/File:Buttonおよびwikipedia:Special:Prefixindex/Image:Button - 利用可能な画像が集まったレポジトリ（実際の利用には、画像のFandomのWikiへの持ち込みが必要です）
• wikipedia:MediaWiki:Gadget-extra-toolbar-buttons-core.js - カスタム編集ボタンの例

その他のヘルプとフィードバック

• ヘルプ:コンテンツでは、他のヘルプページを閲覧、検索することができます。
• 最新の情報やヘルプについては、コミュニティセントラルをご覧ください。
• この記事で不明確な点や、曖昧な点がございましたら、Fandomとの連絡方法をご確認ください。
• このヘルプはコミュニティセントラル内にて管理されています。