Extension:CharInsert/ja

From MediaWiki.org
Jump to: navigation, search
MediaWiki 拡張機能マニュアルManual:Extensions
Crystal Clear action run.png
CharInsert

リリースの状態:Extension status 安定

実装Template:Extension#type Tag, Page action
説明Template:Extension#description JavaScriptの文字挿入ボックスの作成を有効にする。
作者Template:Extension#username Brion Vibber
ライセンスTemplate:Extension#license GPL
ダウンロード
使用するフックTemplate:Extension#hook
ParserFirstCallInitManual:Hooks/ParserFirstCallInit

translatewiki.net で翻訳を利用できる場合は、CharInsert 拡張機能の翻訳にご協力ください

使用状況とバージョン マトリクスを確認してください。

問題点Phabricator

未解決のタスク · バグを報告

CharInsertJavaScriptリンクの作成を有効にする拡張機能です。クリックされたときに、あらかじめ定義されたテキストがtext boxに挿入されます。

These links are usually used in MediaWiki:Edittools system message (for an example, see MediaWiki:Edittools on this wiki).

構文[edit]

CharInsertは<charinsert>タグを使用します。 タグは挿入を許可したい文字列もしくはタグのスペースで切り分けられたリストを含みます。

場所を定義するためにタグ内部で+記号を使うことができます:

  • 選択したテキストを挿入するもしくは
  • テキストが選択されていない場合はカーソルを設置する

You have to enclose templates and spaces inside <nowiki>:

<charinsert><nowiki>== + ==</nowiki> <nowiki>{{stub}}</nowiki></charinsert>

使用法とサンプル出力[edit]

<charinsert>Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź</charinsert>

Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź

テキストボックスが存在しないため、リンクをクリックしても効果がないことにご注意ください。

注記[edit]

  • Generated JavaScript links also work in other areas around edit window, e.g. in MediaWiki:Copyrightwarning or MediaWiki:Newarticletext, on the page preloaded with Inputbox, and even from the text preview.
  • They can also be used in MediaWiki:Uploadtext to insert image description templates.
  • Unlike toolbar buttons on top, this extension doesn't provide a way to specify inserted "sample text".
  • Use &#13; to add new lines (\n).
  • Add <charinsert></charinsert> tags into Mediawiki:Edittools.

ダウンロード[edit]

拡張機能は、Git から直接取得できる場合があります [?]:

  • コードを参照
  • 一部の拡張機能には安定版リリースのタグがあります。
    • タグを参照
    • タグを選択します
    • 「スナップショット」をクリックします
  • 各ブランチは過去の MediaWiki リリースと関連付けられています。 最新のアルファ バージョンを含む「master」ブランチもあります (MediaWiki のアルファ バージョンが必要な場合用)。

スナップショットを展開して、MediaWiki インストレーション内の extensions/CharInsert/ ディレクトリに配置します。

git に馴染みがあり、かつサーバーにシェルでアクセスできる場合は、拡張機能を以下のようにして取得することもできます:

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

インストール[edit]

  • ダウンロードして、ファイルを extensions/ フォルダー内の CharInsert という名前のディレクトリ内に配置します。
  • 以下のコードを LocalSettings.php の末尾に追加します:
    require_once "$IP/extensions/CharInsert/CharInsert.php";
    
  • YesY 完了 - ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

高度なインストール[edit]

重要: You must have Extension:Gadgets for this to work.

スタイル[edit]

Charinsert-sample-edittools-box.png

To give the charinsert lists additional styling, wrap the contents of your Edittools between <div class="mw-charinsert-buttons"> and </div> and add styling for them to your Mediawiki:Common.css. This site (www.mediawiki.org) does that to make the links appear like buttons (as shown in the screenshot to the side). The below stylesheet was used for that, copy it to your Mediawiki:Common.css to apply the same styling.

 
/**
 * Styling for links generated by [[MediaWiki:Edittools]]
 * @source www.mediawiki.org/wiki/Extension:CharInsert#Styling
 * @updated 2012-02-29
 */
.mw-charinsert-buttons {
	margin-top: 10px;
	border: 1px solid #aaaaaa;
	padding: 1px;
	text-align: center;
	font-size: 110%;
}
.mw-charinsert-buttons a {
	color: black;
	background-color: #cde !important;
	font-weight: bold;
	font-size: .9em;
	text-decoration: none;
	border: thin #069 outset;
	padding: 0 .1em .1em;
}
.mw-charinsert-buttons a:hover,
.mw-charinsert-buttons a:active {
	background-color: #bcd;
	border-style: inset;
}
.client-js .mw-edittools-section {
	display: inline;
}
.client-js .mw-edittools-section input[type="button"] {
	font-size: 0.9em;
	padding-left: 1px;
	padding-right: 1px;
	margin-left: 1px;
}

スクリプト[edit]

If you have many CharInsert links, one could use Javascript to put them in separate groups and allow dynamic switching with a dropdown menu. For example to separate diacritical characters from wikisyntax etc. Several sites (such as mediawiki.org, de.wikipedia.org and en.wikipedia.org) have done this. They all implemented it in different ways though. Documented below is the way it is done on mediawiki.org:

1. Wrap the all the charinsert tags on MediaWiki:Edittools into a <div> container and give it a descriptive, unique, ID (for example "mw-edittools-charinsert"):

<div id="mw-edittools-charinsert" class="mw-charinsert-buttons" title="Click on the wanted special character.">
...
</div>
2. Wrap each individual block of charinserts into p tags like this:
<p class="mw-edittools-section" data-section-title="Wiki-Syntax" style="display: none;">
...
</p>
Note:
  • Don't change the word 'mw-edittools-section'
  • The text behind "data-section-title=" will identify this group in the dropdown menu.
  • Make sure there is one group without the 'style="display: none;"' directive: That will be the default choice in the dropdown menu. On this site, it is called 'Standard' while the other groups are named by the language for which the characters are significant.
3. Copy the contents of MediaWiki:Gadget-Edittools.js to an equally named page on your own wiki
4. Add the following code to your Mediawiki:Gadgets-definition:
* Edittools[ResourceLoader|default]|Edittools.js


言語:Project:Language policy English  • Deutsch • 日本語 • русский