プラグインマニュアル

このページは編集中です

プラグインについていろいろ解説するページです(中上級者向け)
全5章に分けて解説します。したいです。

どこかの誰かさんが作った記法マニュアルと作りが似ていますが、気にしないでください。気にしたら負けです。

※プログラマブルプラグインについて、作者は詳しくないので一切の記述がありません。他ページを見ることをおすすめします。

一部皆の補集合氏のコテハンページから拝借したものが含まれます。ご了承ください。この場で感謝申し上げます。

凡例

このような見た目の文…プラグイン記述例

青文字…旧構文(PukiWiki/WIKIWIKI)からの変更点
赤文字…注意点
見出しの★の数…重要度(★★★…最重要、★★☆…重要、★☆☆…知ってたら便利、☆☆☆…知らなくていい)
◇…編集時に上のボタンから直接呼び出せる

1章前提編

プラグインの先頭の文字 ★☆☆

プラグインの先頭の文字には、「&」「%」「@」の大きく分けて3種類がある。
&は同じ行に複数個使えるもの(文字装飾など)、%は複数行を使うもの(何かを囲む要素など)、@は同じ行に一つしか使えないもの(埋め込みなど)という区別があるっぽい。ただし一部例外あり。
&から始まるプラグインの末尾に;は不要になった。また、#から始まるプラグインは%と@に分割されたので注意。

行と列 ★☆☆

←横→　が行、
↑
縦　が列。
↓

16進数 ★★☆

面倒な話だが、このWikiのプラグインにおいてカラーコードは16進数で表される。
通常、数字は0,1,2,3,4,5,6,7,8,9と表され、その次は10,11,12...99のようになる(10進数)。
ただ、16進数では0,1,2,3,4,5,6,7,8,9,a,b,c,d,e,fとなり、その次が10,11,12...ffのように、10～15を表す数字がアルファベットとして表され、桁が変わるのは16からとなる。
ここらへんは中学「技術」や高校「情報」で習うので、中高生はしっかり履修し、うっかり履修しなかった場合や小学生諸君は今のうちに覚えておいたほうがいい。
なお、ほかにも「2進数」(0,1の2つの文字のみで数字を表す)などがあるが、それはこのWikiの編集ではあまり使わないので、知らなくても何とかなる。^*1

2章文字装飾編

この項で解説するもののほとんどは組み合わせができる。

太字・斜体・取り消し線・下線 BISU ★★★ ◇

&B{太字}
&I{斜字Aa1!}
&S{取り消し線}
&U{下線}

太字
斜字Aa1!
~~取り消し線~~
下線

このようにできる。書き方が変わっている。
~~なお、日本語は斜体に対応していないので注意。これはメイリオというフォントに斜体がないかららしい。~~追記：対応したらしいです

''太字''
'''斜字Aa1!'''
%%取り消し線%%
%%%下線%%%

太字
斜字Aa1!
~~取り消し線~~
下線

旧記法にも一応対応しているが、おすすめしない。

文字色 color ★★★ ◇

&color(red){①赤文字}
&color(white,black){②黒背景白文字}
&color(#f0f){③ピンク文字(3桁カラーコード#f0f)}
&color(#ff00ff){④ピンク文字(6桁カラーコード#ff00ff)}
&S{&color(red){⑤取り消し線だけ黒}}

①赤文字
②黒背景白文字
③ピンク文字(3桁カラーコード#f0f)
④ピンク文字(6桁カラーコード#ff00ff)
~~⑤取り消し線だけ黒~~

上から順に解説。
①王道の単色指定。色名単体の場合、そのままその色が文字色になる。
②背景色指定。先に文字色、そのあとに背景色を書く。
③カラーコード指定。16進数表記でRGB指定できる。
④カラーコードである点は③と同じだが、桁数が倍になることで細かい色を表現できる。
⑤取り消し線プラグインを外側に出すことで、取り消し線だけをそのままの色にできる。
「red」などの英字でのカラーコードはhttps://www.colordic.org/
「#f00」16進数のカラーコードはhttps://colorchart.masa-cr.com/websafe.htmlが参考になる。おそらく。

文字サイズ size ★★★ ◇

&size(1){文字サイズ1}
&size(5){文字サイズ5}
&size(10){文字サイズ10}
&size(15){文字サイズ15}
&size(20){文字サイズ20}
&size(25){文字サイズ25}
&size(30){文字サイズ30}
&size(35){文字サイズ35}
&size(100){文字サイズ100}

文字サイズ1
文字サイズ5
文字サイズ10
文字サイズ15
文字サイズ20
文字サイズ25
文字サイズ30
文字サイズ35
文字サイズ100

文字サイズを変更できる。1～ほぼ∞まで指定できる。数字が大きいほど文字サイズが大きくなる。
あまりにも小さい/大きいと読みにくいので、10～30くらいまでがおすすめ。
このプラグインを使わない、標準の文字サイズは16である。

注釈 ★★☆

((注釈))

^*2

注釈をつけられる。
タップすることで表示される。
注釈の一覧はページ最下部にある。

ルビ振り(ふりがな) ruby ★★☆ ◇

&ruby(ぼうだい){膨大}
とある科学の&ruby(レールガン){超電磁砲}
&ruby(家族と離れ離れにはなりたくはないよね){グレーチングが開かない}
&ruby(マゾヒスト){M}

膨大ぼうだい
とある科学の超電磁砲レールガン
グレーチングが開かない家族と離れ離れにはなりたくはないよね
Mマゾヒスト

ふりがなを振れる。
ふりがながカタカナであろうと漢字であろうと英語であろうと読みが違おうと使える。
colorなどの文字装飾と併用不可。

流れる文字 ★★☆

横長流れる文字
高速流れる文字
右向き流れる文字
【膨大線遅延】膨大線は、人身事故の影響で遅れが出ております。

()内は少しややこしいかもしれないが、横のサイズ、流れる速度、背景色、文字色、流れる向きの順で指定する。
横のサイズはautoにすることで画面いっぱいにできる。
sizeプラグインと併用すると大きな文字にできる。
()内の順番が変わっているので注意。

縦書き ★☆☆

&tategaki{縦書き文字text}

&tategaki{芭蕉}　&tategaki{水の音}&tategaki{蛙飛び込む}&tategaki{古池や　　}

縦書き文字text

芭蕉　水の音蛙飛び込む古池や　　

縦書きにできる。なお、同じ行に連続して使った場合、文字は一般的な書式と異なり下揃えになる(上揃えにはならない)。

フォント変更 ★☆☆

&font(Inmu){text123あいう永}
&font(Kaiwai){text123あいう永}
&font(Reisho){text123あいう永}
&font(Raptor){text123あいう永}
&font(RaptorSquare){text123あいう永}
&font(Taisyo){text123あいう永}
&font(Thicc){text123あいう永}

text123あいう永
text123あいう永
text123あいう永
text123あいう永
text123あいう永
text123あいう永
text123あいう永

フォントを変えられるやつ。現状7種類に変更可能。

実体参照・数値参照 ★☆☆

&amp;
&copy;
&spades;

&#38;
&#64;
&#9824;

&color(red){テキスト}
&amp;color(red){テキスト}

&
©
♠

&
@
♠

テキスト
&color(red){テキスト}

HTMLとかで、文字コードから文字を表示できるやつだったと思う。多分。
上が実体参照、下が数値参照。
コードを探すとき、このサイトが参考になるかもしれない

TipとSecret ★☆☆

&tip(注釈){文字}
&secret(注釈){文字}

文字
文字

^*3以外の方法でも注釈をつけることができる。カーソルを合わせると表示される。
tipは下線がついているが、secretは下線がついていない。secretは隠し要素におすすめである。

3章整列編

見出し ★★★ ◇

*見出し名1
**見出し名2
***見出し名3
****見出し名4

見出し名1

見出し名2

見出し名3

見出し名4

このように、*の数を変えると、見出しの大きさ(種類)を変えられる。
4段までできるようになった。

*見出し名1 [#Midashi1]

このようにアンカーをつけることで、見出しの下の項目ごとに編集できるようになるほか、目次プラグインcontentsに見出しが表示されるようになる。そのほかにも、

[ページ名#Midashi1]

のような形のリンクにすることで、リンクから直接、目的の見出しに飛べるようになる。
旧構文ではアンカーが自動でついていたが、新構文ではアンカーを手動でつける方式になった。目次を利用したいときは注意。
(アンカーをつけないと、旧構文#shadowheaderのような動作になる、と言えばわかりやすいか)

箇条書き ★★★

-1
--2
---3
----4
+1-1
+1-2
++2-1
++2-2
+++3-1
+++3-2
++++4-1
++++4-2
あ

あ

-あ
;;
あ

1
- 2
  - 3
    - 4

1-1
1-2
1. 2-1
2. 2-2
  1. 3-1
  2. 3-2
    1. 4-1
    2. 4-2
      あ

あ

見ての通り、箇条書きができる。
リストの後ろに「;;」を付けると、新しい行を作成せずにリストを閉じることができます。コンテンツをコンパクトに表示したい場合に便利です。
この例の「あ」のように、1回改行してから文字を書くと、箇条書きに連なってしまうので注意。
こちらも4段までできるようになった。

表組み ★★★

□で囲まれた表を作れるやつ。Excelみたいな見た目になる。

| |~太郎さん|~次郎さん|
|+(red)リンゴの個数|1|3|
|+(orange)ミカンの個数|2|0|

	太郎さん	次郎さん
リンゴの個数	1	3
ミカンの個数	2	0

~をつけると色が変わるので、見出し風にできる。
＋(color)で背景色を変えられる。

|>|>|~◯◯市の概要|
|面積|>|25km^2|
|人口|>|1,000,000人|
|-|市の植物|アサ|
|&align(center){&tategaki{シンボル}}|&align(right){市の鳥}|ドードー鳥|

◯◯市の概要
面積	25km^2
人口	1,000,000人
シンボル	市の植物	アサ
シンボル	市の鳥	ドードー鳥

このようにすることで、枠を統合することができる。
上下で統合する際、下に"~"→上に"-"となった。

改行 ★★★

新記法あ@;あ
旧記法あ&br;あ

新記法あ
あ
旧記法あ
あ

このプラグインを使うことで、改行ができる。また、2回改行を入れることでも改行ができる。
プラグインが変更になった(ただし、旧記法も暫定的に利用できる)。また、1回の改行では改行されなくなった。

水平線 ★★☆

-----
@divider(10,,100%,black)
@divider(1,,70%,red)

マイナス5つで簡易的な水平線を、dividerプラグインでカスタム水平線を作れる。
dividerプラグインの()内は線の太さ,線の形式,透明度,線の色の順で書く。
線の形式(style)変数に書けるものがわからないので現在問い合わせ中です。

左右に寄せる ★★☆

&align(left){左}
&align(right){右}
&align(center){真ん中}

左

右

真ん中

LEFT:、CENTER:、RIGHT:から変更になった。
プラグインと併用できる。
左寄せ設定もできるがあまり使う機会はない。

折りたたみ Expand・Accordion・Trapdoor ★★☆

%expand(折り畳み)[
文字
]
%accordion(-)[
文字
]
%accordion(+)[
文字
]
&trapdoor{文字}

%expand(折り畳み)[ 文字
]

Toggle Content

文字

さまざまな折り畳みの方法があるので、使い分けるとよい。
accordionは、-を入れると最初は閉じている状態に、+を入れると最初から開いている状態になる。
trapdoorは改行プラグインを使わないと改行できない。(通常の改行が使えない)

タブで切り替えられる表示 TabContainer・TabHeader ★☆☆

%tabcontainer()[
tab(タブ名1){
中身1
}
tab(タブ名2){
中身2
}
tab(タブ名3){
中身3
}
]
%tabcontainer(justify)[
tab(タブ名1){
中身1
}
tab(タブ名2){
中身2
}
tab(タブ名3){
中身3
}
]
%tabheader(1)[
tab(タブ名1){
中身1
}
tab(タブ名2){
中身2
}
tab(タブ名3){
中身3
}

中身1

中身2

中身3

中身1

中身2

中身3

中身1

中身2

中身3

この二つのプラグインの違いは、簡単に言ってしまえばタブの見え方である。
tabcontainerの()内には、何も入れないとタブが左寄せ、justifyを入れるとタブが全幅にわたって表示されるようになる。
tabheaderの()内には1,2,3の数字を入れられる。これは*の数と同じで、見出しのレベルを変えられる。

4章ページのギミック編

動画埋め込み ★★☆

@embed(https://www.youtube.com/watch?v=HUrLhRzfAn4)
@embed(https://www.nicovideo.jp/watch/sm43570098)

動画のURLを()内に入れることで、記事上に動画を表示できる。

記事内容の呼び出し ★☆☆

@include(プラグインマニュアル/includeテスト)
[[プラグインマニュアル/includeテスト]]

デデーン！
うんこ！

プラグインマニュアル/includeテスト

記事内容を埋め込むことができる。
いろいろな記事に同じものを載せたいとき、ページを分割したいとき、凍結したページの特定の部分だけ編集させたいときに便利。
()内にはページ名の記載のみでよくなった。

5章その他編

ページのスキン色変更 ★★☆

@skin(スキン名)

スキン名の部分にスキン名を入れると、デフォルトのページの色を変更できる。
右上の「Theme」を押すと、「Dark」など様々なテーマが出てくるので、その中から好きなテーマを選ぶとよい。好きなテーマの名前を()内に入れればデフォルトで表示が変わる。
なお、このThemeボタンから自分の好きな色にすることもできる。

例えば、もみじ（編集者）のページは「Dark-Blue」スキンにしている。

コメント行(見えない文字) ★★☆

//見えない文字
見える文字

見える文字

編集画面で編集者に注意を出したいときに使える。例えば、「ここを編集して」とか、「この内容は書かないで」とか。

ページ名見た目変更 ★☆☆

@pageName(ページ名)

上記のプラグインをページのどこかに配置すると、見かけ上のページ名が「ページ名」に変わる。
ただし、内部的なページ名は変更がない。よって、URLも変わらない。
「TITLE:」から変更になった。

例文(？) ★☆☆

(記法の限界で表示不可能なため画像より表示)

あああ
@comment

この記事ではおなじみのやつ。プラグインが作動しなくなるので、プラグインの例文などにおすすめ。あとはAA(アスキーアート)なんかにも。
`は、Spaceキーを押しながら@キーを押すと打てる。断じて'ではない。
半角スペースだけでは動かなくなった。

Tags:Z-1-共用ページ Z-管理用

目次

凡例

1章 前提編