boxプラグイン

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

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

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

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

使用例:

ラノベっぽく書いてみよう!


   / ̄\  
  | ^o^ |  「昼に食べたカツサンドはとっくの昔に別れを告げていて、俺の胃は今や開店休業状態だ。
   \_/   たった今でも次のお客さんを催促してしきりに呼び鈴を鳴らしてやがる。
   _| |_  つまり、俺のハラの虫はお怒りでグーグーグーグー唸ってるってことで、
  |     | 簡単に言えば俺は腹が減っているのだ。」
  ( 二⊃.| |

意味:「私はお腹がすいています。」

構文

簡単な例:

  <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;
}
 
dokuwiki/plugin/box.txt · 最終更新: 2009/10/16 22:54 by admin
 
特に明示されていない限り、本Wikiの内容は次のライセンスに従います:CC Attribution-Noncommercial-Share Alike 3.0 Unported
Recent changes RSS feed Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki