ブロック文法プラグインについて

段落単位の文法を規定するプラグインです。

$::block_syntax_plugin{'010_hogehoge'} = sub {
    処理内容
};

のように定義します。

ハッシュ %::block_syntax_plugin には、ブロック文法実現のために、テキストを処理する関数へのリファレンスが格納されています。

処理はハッシュのキーの辞書順に行われますので、キーの先頭の数字３桁に適当な数字を選ぶことにより、任意のタイミングで置換処理を実行させることができます。

第一引数	テキスト文字列既にサニタイズ済み。
第二引数	セッション情報を含むハッシュへのリファレンス。
戻り値	渡されたブロックが自関数の対応ブロックであり、処理を実施した場合、非0 を返す。そうすると、後のブロック文法関数では評価されない。渡されたブロックが自関数の対応ブロックでない場合、0 を返す。そうすると、後のブロック文法関数に処理・データが引き渡される。

ブロック文法プラグインでは、もはや置換処理は行いません。アクションプラグインのように与えられた文字列を適当に処理し、 &::puts , &::putenc などを使い、出力処理まで実行してください。

なお、そのままではインライン文法は処理されませんので、必要に応じて、ブロックプラグイン関数内で、

変換後文字列 = &::preprocess(被変換文字列,$session)

で変換する必要があります。