boxプラグイン

boxプラグインを使うと、ページ内に文章強調用の枠（box）を挿入出来るようになる。

• 背景に色がついている
• 角が丸くなっている
• タイトルやキャプションがついている

といったボックスも簡単に作成出来る。

Noteプラグインと似ているが、こちらは横幅、角の形、色などをかなり細かく指定出来る。

使用例：

簡単な例：

  <box> 枠の内容 </box>

複雑な例：

  <box 80% round orange|タイトル> 横幅80％・丸い角・オレンジ・タイトル付きの枠</box>
  <box 50% left blue>横幅50％・左寄せ・青・キャプション付きの枠</box|キャプション>

文法：
<box 横幅 クラス 色 | タイトル> コンテンツ </box | キャプション >

• 横幅 — CSSと同じ書式で横幅指定
• クラス — 枠のデザインをCSSのクラス名で指定。テンプレートやboxプラグインのCSS内にあるクラスなら、いくつでも指定出来る。boxプラグインでは以下のクラスを用意している:
  • round — 角が丸くなっているボックス
  • blue — 青系
  • red — 赤系
  • green — 緑系
  • orange — オレンジ系
  • left — ページの左の方に寄せられる
  • right — ページの右の方に寄せられる

何も指定しなければ、枠の角は四角になりDokuWiki本体の色指定を使う。

• 色 — 1つ～4つの色を、HexかRGBで指定。例： #F00 #fcab94 rgb(255,255,0)。指定した色は、以下の順で使われる：
  1. コンテンツの背景
  2. タイトルの背景
  3. 一番外側の枠の背景
  4. 枠線

指定した色が4つ以下なら、最初に指定した色が未指定の場所で使われる。

• タイトル — コンテンツの上に表示される文字（DokuWiki文法が使える）
• キャプション — コンテンツの下に表示される文字（DokuWiki文法は使えない）

<box … >部分は、1行で書く事。コンテンツは複数行でもよい。

タイトルを書くと、押しつぶされたような表示になる事がある。

これは、clearhistoryプラグインのスタイルが、DokuWiki本体のスタイルやboxプラグインのスタイルと干渉しているため。defaultテンプレートでは気づきにくいが、sidebarプラグインなどでコンテンツ部分の横幅を詰めると顕在化する。特に、

• 日本語など、1文字ごとに折り返し可能な文字
• boxプラグインのように、文字表示部分の幅をDokuWiki本来より限定し、さらに内部でpタグを使うようなプラグイン

で発生しやすい。

clearhistoryプラグインを使わないか、普段は無効にしておくか、clearhistoryプラグインのstyle.cssから以下の部分を削除する。

div.dokuwiki div.page p {
	margin-right:350px;
	margin-left:30px;
}