BBコード
- このセクションのオリジナルドキュメント
- ..（ユーザードキュメント）
- BBコード
- nl2brプラグインを同時に使う時のメモ
- BBコードをエスケープする時のメモ
- 視覚的フォーマットにおけるメモ
- テキスト配置のメモ
- codeタグとPHPタグのメモ
- リストのメモ
- 引用
- URLと画像とメール
BBコード
BBコードのオフィシャルガイドであるhttp://www.phpbb.com/phpBB/faq.php?mode=bbcodeがあるので参考にしてください。 「こんな時はどうしたらいいか」といった例はhttp://blogit.claymountain.com/sf/index.php?/archives/2-BBcode-plugin-cheat-sheet....htmlをのぞいてみてください。
nl2brプラグインを同時に使う時のメモ
もしnl2brプラグインを使っていて、それがBBコードプラグインより呼び出し順が下だった場合、リスト要素の後に余分な改行がつきます。
もしBBコードプラグインより前にnl2brプラグインを持ってくれば、codeタグとphpタグに余分な<br />タグが付いてしまいます。
nl2brプラグインを無効にすればcodeタグとphpタグ中の余分な改行はきちんと消えます。
拡張エントリプラグインを導入すれば、nl2brプラグインはエントリごとに無効にできます。
個人的には、BBコードの前にnl2brプラグインを持ってくることでcodeタグとphpタグが改行される方が好みです。
BBコードをエスケープする時のメモ
BBコードをエスケープするにはBBコードの前に '\' を記入します。 この結果はおそらくこの [size] のようになるはずですが、いくつかのケースでは、タグはきちんとエスケープされるのにタグの前のエスケープ文字が残ってしまいます。 \[color=red] のようなケースです。 これはタグの中に '=' が含まれている場合に起こるようです。 おそらく正規表現のバグでしょう。 他の正規表現のバグとして、[php]と[code]をエスケープすると、'['php] のようになるようです。
視覚的フォーマットにおけるメモ
次のタグをサポートしています。
[color=red]テキスト色[/color] の変更： 色のプロパティに利用できる値はhttp://www.w3.org/TR/CSS21/colors.html#colorsを見てください。
[size=6]テキストサイズ[/size] の変更： テキストサイズのプロパティに利用できる値はhttp://www.w3.org/TR/CSS21/fonts.html#font-size-propsを見てください。
[font=Courier]利用フォント[/font] の変更： フォントファミリーのプロパティに利用できる値はhttp://www.w3.org/TR/CSS21/fonts.html#font-family-propを見てください。
アンダーライン [u]テキスト[/u]
太字 [b]テキスト[/b]
斜体 [i]テキスト[/i]
テキスト配置のメモ
[center]テキストの中央揃え[/center]を使うと中央揃えになります。
また、[align=right]テキストを右揃え[/align]にもできますし、
http://www.w3.org/TR/CSS21/text.html#alignment-propでサポートされているテキスト揃えのプロパティは何でも使えます。
codeタグとPHPタグのメモ
コードをフォーマットするタグは2つあります。 まず、[code]タグです。
[code]
echo "Foobar\n"
[/code]
次に [php]タグです。
[php]
require ('pear.php');
echo "Foobar";
[/php]
後者はシンタックスハイライティングをします。
覚えておいて欲しいのは、nl2brプラグインを使っている場合、BBコードプラグインより前にnl2brプラグインがあると、BBコードがエスケープされた<br />タグを足すより前に、新しい行に<br />タグが追加されるということです。
リストのメモ
誰もが知っているとおり、リストには3つのタイプがあります。 HTML内の番号付きリスト、番号無しリスト、定義リストです。 番号付きリストと番号無しリストだけがサポートされています。
番号無しリストは [list] タグで開始され、全てのリスト項目は [*] タグで表します。 そして閉じタグには [/list] か [/list:u] を使います。
番号付きリストは [list=a] または [list=1] タグで開始され、リスト項目は同様に [*] タグで表します。
このリストは [/list] では上手く動かないようなので [/list:o] を使って閉じなければいけません。
一例です。
[list=1]
[*]first one
[*]second one
[/list:o]
リストに関しては多くの問題があるように思えます。
例については以下を参照ください。
http://blogit.claymountain.com/sf/index.php?/archives/2-BBcode-plugin-cheat-sheet....html
引用
[quote] タグを使えば引用ができます。
一例です。
[quote]
このプラグインが修正されたら私の既存エントリはどうなるのだろうか？
[/quote]
URLと画像とメール
メールは [email=メールアドレス]メールをください[/email] または [email]メールアドレス[/email] となります。
URLも同様、タグの中か外にリンク先を記入します。
[url=http://www.ninemiles.net/s9y_docs/]s9y日本語ドキュメント[/url] または [url]http://www.ninemiles.net/s9y_docs/[/url] となります。
画像は [img={width}x{height}]画像のURL[/img] で呼び出せます。
例えば [img=64x64]http://www.claymountain.com/logot/cms-pieni.gif [/img] では縮小された画像を表示し、
[img]http://www.claymountain.com/logot/cms-pieni.gif [/img] ではその元画像を表示します。
