CharInsert
?張機能は
JavaScript
リンクの作成を有?にする?張機能です。クリックされたときに、あらかじめ定義されたテキストが
テキストボックス
に?入されます。
これらのリンクは
MediaWiki:Edittools
のシステムメッセ?ジに使われます。
構文
<
charinsert
>
タグを使用し、?入できるようにしたい
文字
またはタグの空白?切りのリストを指定します。
場所を定義するためにタグ?部で + 記?を使用できます:
- 選?したテキストを?入する、または
- テキストが選?されていない場合はカ?ソルを設置する。
You have to enclose templates and spaces inside
<
nowiki
>
:
<
charinsert
><
nowiki
>
== + ==
</
nowiki
>
<
nowiki
>
{{stub}}
</
nowiki
></
charinsert
>
使用法とサンプル出力
Individual characters
Individual characters are just listed between the "charinsert" tags.
<
charinsert
>
A a ? ? E e I i ? ? ? ? O o ? ? ? ? U u Y y ? ?
</
charinsert
>
A
a
?
?
E
e
I
i
?
?
?
?
O
o
?
?
?
?
U
u
Y
y
?
?
入力や編集のフィ?ルドが存在しないため、リンクをクリックしても?果がないことにご注意ください。
Combined characters
Combined characters are listed between the "charinsert" tags and connected by the "+" sign.
<
charinsert
>
“+” ‘+’ ≪+≫ ?+? ?+“ ?+‘ [[+]] {{+}}
</
charinsert
>
“”
‘’
≪≫
??
?“
?‘
[[]]
{{}}
Clicking the links will have no effect since there is no input or edit field.
Overriding display text
A different display text can be specified in the
label
attribute (if you use this, you should use separate
<
charinsert
>
tags for each character in order to specify different display texts).
<
charinsert
label
=
"Latin A"
>
A
</
charinsert
>
<
charinsert
label
=
"Cyrillic А"
>
А
</
charinsert
>
<
charinsert
label
=
"Greek Alpha"
>
Α
</
charinsert
>
Latin A
Cyrillic А
Greek Alpha
Clicking the links will have no effect since there is no input or edit field.
注記
- 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
to add new lines (\n).
- Enclose white spaces in
<
nowiki
>
...
</
nowiki
>
tags when needed.
- Add
<
charinsert
>
...
</
charinsert
>
tags into MediaWiki:Edittools.
インスト?ル
- ダウンロ?ド
して、ファイルを
extensions/
フォルダ??の
CharInsert
という名前のディレクトリ?に配置します。
開?者とコ?ド寄稿者は、上記の代わりに以下を使用して
Gitから
インスト?ルします:
cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CharInsert
- 以下のコ?ドを
LocalSettings.php
ファイルの末尾に追加します:
wfLoadExtension
(
'CharInsert'
);
- If you use the
gadget
Edittools
, update its code to the
latest version
(≥ April 3, 2020)
完了
? ウィキの「
Special:Version
」に移動して、?張機能が正しくインスト?ルされたことを確認します。
高度なインスト?ル
重要:
You must have
Extension:Gadgets
for this to work.
スタイル
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 https://www.mediawiki.org/wiki/Extension:CharInsert#Styling
* @updated 2020-03-17
*/
.
mw-charinsert-buttons
{
border
:
1
px
solid
#aaa
;
margin-top
:
10
px
;
padding
:
1
px
;
font-size
:
1.1
em
;
text-align
:
center
;
}
.
mw-charinsert-buttons
a
{
background-color
:
#cde
!important
;
color
:
#000
;
border
:
thin
#069
outset
;
padding
:
0
1
px
1
px
;
font-weight
:
bold
;
font-size
:
0.9
em
;
text-decoration
:
none
;
}
.
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.9
em
;
margin-left
:
1
px
;
padding-left
:
1
px
;
padding-right
:
1
px
;
}
Alternatively, you can choose a style closer to the
Wikimedia Design Style Guide
and the
WikimediaUI theme
:
/**
* Styling for links generated by [[MediaWiki:Edittools]] in WikimediaUI inspired theme.
* @source https://www.mediawiki.org/wiki/Extension:CharInsert#Styling
* @updated 2020-03-17
*/
.
mw-charinsert-buttons
{
margin-top
:
8
px
;
border
:
1
px
solid
#c8ccd1
;
padding
:
2
px
4
px
4
px
;
font-size
:
1.1
em
;
text-align
:
center
;
}
.
mw-charinsert-buttons
a
{
background-color
:
#f8f9fa
!important
;
color
:
#202122
;
border
:
thin
#36c
outset
;
padding
:
0
1
px
2
px
;
font-size
:
0.9
em
;
font-weight
:
bold
;
text-decoration
:
none
;
}
.
mw-charinsert-buttons
a
:
hover
{
background-color
:
#fff
;
color
:
#404244
;
}
.
mw-charinsert-buttons
a
:
active
{
background-color
:
#c8ccd1
;
border-style
:
inset
;
}
.
client-js
.
mw-edittools-section
{
display
:
inline
;
}
.
client-js
.
mw-edittools-section
input
[
type
=
"button"
]
{
background-color
:
#f8f9fa
;
color
:
#202122
;
margin-left
:
1
px
;
border-radius
:
2
px
;
padding
:
1
px
6
px
;
font-size
:
0.9
em
;
/* Apply pointer cursor to all interactive elements. */
cursor
:
pointer
;
}
.
client-js
.
mw-edittools-section
input
[
type
=
"button"
]
:
hover
{
background-color
:
#fff
;
color
:
#404244
;
}
.
client-js
.
mw-edittools-section
input
[
type
=
"button"
]
:
active
{
background-color
:
#c8ccd1
;
color
:
#000
;
}
スクリプト
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 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
>
注:
:
- 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
For implementing
CharInsert
menu like the one used on the English Wikipedia, either export gadgets:
Charinsert-core
,
Charinsert-styles
, and
Charinsert
and then import them on your own wiki through
Special:Import
or if you want to do it manually, copy the following four interface pages to your wiki:
- In your
MediaWiki:Gadgets-definition
, add the following definitions:
* charinsert[ResourceLoader|default|peers=charinsert-styles]|charinsert.js
* charinsert-core[ResourceLoader|hidden|dependencies=jquery.textSelection,user,mediawiki.storage]|charinsert-core.js
* charinsert-styles[ResourceLoader|hidden|type=styles]|charinsert-styles.css
- MediaWiki:Edittools (Wikipedia)
-
Only for users with JavaScript turned off or unsupported (which disables the WikiEditor extension too), therefore not really necessary or useful either.
It only shows symbols/characters as simple text below the editor window, which can then be copy-pasted and thus be of some help to editors.
Apparently, it does not get activated in English Wikipedia for disabled JavaScript.
注:
This particular English Wikipedia character set also contains templates, which will need to be defined separately, if they are to be used on your Wiki.
English Wikipedia Solution checked on:
November 6, 2018
 | この?張機能は以下のウィキ ファ?ム/ウィキ ホスト/パッケ?ジに含まれています:
これは正式な一?ではありません。
一部のウィキ ファ?ム/ウィキ ホスト/パッケ?ジは、ここに記載されていなくてもこの?張機能を含んでいる場合があります。
必ずご利用のウィキ ファ?ム、ウィキ ホスト、バンドルで確認してください。
|