Wrapプラグイン

文字列や段落に対し、枠を付ける、文字色を変える、右寄せにする、などの整形を行うプラグイン。見やすいページを作る上では助かる。

入手はplugin:wrapまたはja:plugin:wrapから。

<WRAP></WRAP>、<block></block>、<div></div>のいずれかで囲うと段落(div要素)、
<wrap></wrap>、<inline></inline>、<span></span>のいずれかで囲うと文字列(span要素)。

さらにオプションをスペース区切りで追加していく。オプションの内容は上記の配布先に解説がある。

<WRAP box 80% centeralign round>
This is a wrap plugin test.
It is <wrap em>the truth</wrap> that I just wanted to tell you clearly.
</WRAP>

wrapプラグインは、note, boxなどのプラグインの実質的な上位互換である。設定を細かくできる分だけ簡便さは失われるが。

Dokuwikiの仕様として、有効になっているプラグインのスクリプトやスタイルシートは、そのページでは使わないものであっても全て読み込まれる。積み重なればページの表示速度に関わってくるため、できれば機能のかぶるプラグインは1つに絞りたい。

個人的に、alertやimportantやtipなどのボックスに表示されるアイコンはwrapプラグインよりnoteプラグインの方が可愛くて好きである。また、wrapプラグインのボックスはmin-heightが68pxと少々高めで、1行だけ書きたいのに…という場合でも縦にスペースを消費してしまう。これらの見た目にまつわる点ではnoteプラグインの方に軍配が上がるので、noteプラグインのアイコンやスタイルをwrapプラグインに移植することにする。

まずはimageフォルダの中を入れ替える。

また、“note”というオプションで、メモ書きであることを示すボックススタイルを追加する。アイコンはnoteプラグインを流用。

注意:ファイルの上書きをすると、セーフモードが有効のサーバではアップデートに問題が生じる。 ⇒インストールとアップデート

オプションを追加するには、conf/userstyle.cssを作成・編集する。wrapプラグインのcssを編集してもよいが、将来的にアップデートがあると上書きされ変更点は失われるため、一般論としては別ファイルに分けた方がよい。ただ、設定項目は元のcssと重複する部分が多く、アップデートも頻繁には行わないということであれば、元のcssを編集した方がすっきりする面もある。