/ 
YATT-0.0.10
River stage zero No dependents
/ web/cgi-bin/yatt.lib/YATT/LRXML.ja.pod

NAME (ja)

YATT::LRXML - Loose But Recursive XML.

SYNOPSIS

require YATT::LRXML;
my $tree = read YATT::LRXML($filename, %opts);

or

my $tree = read_string YATT::LRXML(q{foo<yatt:bar>..</yatt:bar>baz}
              , namespace => ['yatt', 'perl']);
for (my $cursor = $tree->open; $cursor->readable; $cursor->next) {
   print $cursor->stringify, "\n";
}

DESCRIPTION

LRXML は、XML よりも HTMLのテンプレートを記述しやすくするために 設計された、独自の構文です。 LRXML は XML の整形式を逸脱するため、 XML Parser ではパースできません。また、(現段階では) シリアライズ用に使う仕組みも持っていません。しかしその分、 元々の XML よりも豊かな再帰性と、 DTD を一切不要にする柔軟性を持っています。

SYNTAX

LRXML は、LRXML の構文要素と、それ以外の印字可能テキスト(PCDATA)の 並びです。いずれの構文要素も、予め定めた 名前空間マーカー で始まります。 PCDATA は (LRXML の構文要素と誤解されない限り) エスケープの必要はありません。 これはテンプレートシステムとしての使用を主眼に設計されたためです。

以下の説明では、名前空間マーカーとして yatt を用います。

Element (タグ, 要素)

タグは HTML や XML と同様、

<yatt:NAME ATTLIST>  ..BODY.. </yatt:NAME>

又は

<yatt:NAME ATTLIST />

と書けます。XML と異なり、..BODY.. 部分にも属性情報を書けるよう、 "Attribute Element (属性要素)" の構文が定義されています。

Attribute Element (属性要素)

属性要素は XML と LRXML の最大の相違点です。タグ名の直前に : を加えて

<:yatt:ATT_NAME SUB_ATTLIST> ..ATT_VALUE.. </:yatt:ATT_NAME>

又は

<:yatt:ATT_NAME SUB_ATTLIST />
..ATT_VALUE..

と書きます。(Common Lisp の :keyword 構文と同じように読んでください。)

この構文を使うと、属性の中にタグを書きたいケースでも、 もっと HTML らしく書く事が出来ます。例えば

<yatt:mynews title="<b>H</b>eadline">
  ...
</yatt:mynews>

のような情報を書きたいときに、

<yatt:mynews>
  <:yatt:title>
     <b>H</b>eadline
  </:yatt:title>
  ...
</yatt:mynews>

あるいは

<yatt:mynews>
  ...
<:yatt:title />
  <b>H</b>eadline
</yatt:mynews>

と書くことが出来ます。

Attribute List (属性リスト)

ATTLIST には XML と同様の

NAME = VALUE
NAME = 'VALUE'
NAME = "VALUE"

に加えて、NAME を省略した

VALUE
'VALUE'
"VALUE"

と、VALUE を省略した

NAME

を書けます。(NAME だと解釈可能な文字のみからなる場合は NAME, それ以外は VALUE).

Quoted Value

XML と異なり、'VALUE', "VALUE" の引用符の中でも <> を (escape せずに)使って構いません。これは、テンプレートとして用いる場合に、 条件式を

<yatt:event if="x > 0">....</yatt:event>

のように書けた方が、はるかに読みやすいからです。

Entity (実体参照, 又は単に参照)

&yatt:NAME;

Entity Path

テンプレートを書く人になるべく大きな自由を与えつつ、 部品化への動機付けも残すため、 Entity の中にある程度までの複雑な式を 書くことが可能になっています。

&yatt:NAME:NAME;   (名前空間か、hash の要素参照)
&yatt:NAME{};      (hash の要素参照)
&yatt:NAME[];      (配列の要素参照)
&yatt:NAME();      (関数の呼び出し)

(括弧内は、記法の用途の一例で、最終的には Translator の自由です)

カッコの中に再び Entity Path を書くには、先頭に : を書きます。 : が無い場合は、通常の文字列として扱われます。 カッコの中では , で要素を区切ります。

&yatt:foo:bar(:baz(),bang,:hoe):moe();

上記では、真ん中の bang が文字列を表します。

, は省略可能な終端子の扱いです。つまり、

&yatt:foo(bar);
&yatt:foo(bar,);

の二つは等価です。また、空文字列を明示的に渡したい場合は

&yatt:foo(,);

と書きます。

Declarator (宣言子)

宣言子は要素の並びに、メタな意味情報を付け加える時に使います。 典型的には、 widget の区切りに使います。

<!yatt:NAME DECL_ATTLIST>

Declaration Attribute

宣言子の中には、タグの属性リストと同じものに加えて、

  • NAME = [TYPE NAME=VALUE NAME=VALUE ...]

  • -- コメント --

  • %NAME;

を書く事が出来ます。

Processing Instruction (処理指令)

<?perl ... ?>

php などでお馴染みの、プログラム指令を書ける場所です。

Comment (注釈)

<!--#yatt ... -->

XXX: ここは議論の余地あり。

AUTHOR

"KOBAYASI, Hiroaki" (小林 弘明) hkoba at cpan.org