documentation/manual/ja/module_specs/Zend_Markup-Parsers.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <!-- EN-Revision: 20827 -->
   4 <sect1 id="zend.markup.parsers">
   5     <title>Zend_Markup パーサー</title>
   6
   7     <para>
   8         <classname>Zend_Markup</classname> には現在 BBCode パーサーと Textile パーサー
   9         という２つのパーサーが同梱されています。
  10     </para>
  11
  12     <sect2 id="zend.markup.parsers.theory">
  13         <title>パーサーの仕組み</title>
  14
  15         <para>
  16             <classname>Zend_Markup</classname> のパーサは、マークアップによる文をトークン木へと
  17             変換するクラス群です。ここの例では BBCode パーサーを用いますが、
  18             全てのパーサーにおいてトークン木の見解は変わりません。
  19             例として BBCode のこの要素で始めます:
  20         </para>
  21
  22         <programlisting><![CDATA[
  23 [b]foo[i]bar[/i][/b]baz
  24 ]]></programlisting>
  25
  26         <para>
  27             BBCode パーサーは、要素を分離し以下の木構造を生成した値を持つことでしょう:
  28         </para>
  29
  30         <itemizedlist>
  31             <listitem>
  32                 <para>[b]</para>
  33
  34                 <itemizedlist>
  35                     <listitem>
  36                         <para>foo</para>
  37                     </listitem>
  38
  39                     <listitem>
  40                         <para>[i]</para>
  41
  42                         <itemizedlist>
  43                             <listitem>
  44                                 <para>bar</para>
  45                             </listitem>
  46                         </itemizedlist>
  47                     </listitem>
  48                 </itemizedlist>
  49             </listitem>
  50
  51             <listitem>
  52                 <para>baz</para>
  53             </listitem>
  54         </itemizedlist>
  55
  56         <para>
  57             クローズタグは消えていることにお気づきになったでしょう、それらは木構造の
  58             内容として出現しません。これは、クローズタグは実際の内容のものではないからです。
  59             ですが、これは単にクローズタグを消失したことを意図するものではなく、
  60             タグ自身のタグ情報内で保持されています。さらに、これは木構造自身の簡潔な概観で
  61             あるだけということに注意してください。実際の木構造は、タグの属性とその名について
  62             より多くの情報を含んでいます。
  63         </para>
  64     </sect2>
  65
  66     <sect2 id="zend.markup.parsers.bbcode">
  67         <title>BBCode パーサー</title>
  68
  69         <para>
  70             BBCode パーサーは BBCode をトークン木へ変換する
  71             <classname>Zend_Markup</classname> パーサーです。 全ての BBCode タグの文法は:
  72         </para>
  73
  74         <programlisting language="text"><![CDATA[
  75 [name(=(value|"value"))( attribute=(value|"value"))*]
  76 ]]></programlisting>
  77
  78         <para>
  79             有効な BBCode タグのいくつかの例は:
  80         </para>
  81
  82         <programlisting><![CDATA[
  83 [b]
  84 [list=1]
  85 [code file=Zend/Markup.php]
  86 [url="http://framework.zend.com/" title="Zend Framework!"]
  87 ]]></programlisting>
  88
  89         <para>
  90             標準で、 '[/tagname]' フォーマットを用いて閉じられます.
  91         </para>
  92     </sect2>
  93
  94     <sect2 id="zend.markup.parsers.textile">
  95         <title>Textile パーサー</title>
  96
  97         <para>
  98             Textile パーサーは、Textile からトークン木へと変換する <classname>Zend_Markup</classname>
  99             パーサーです。 Textile はタグ構造を持っていないため、
 100             以下は見本例のタグのリストです:
 101         </para>
 102
 103         <table id="zend.markup.parsers.textile.tags">
 104             <title>基本的な Textile タグのリスト</title>
 105
 106             <tgroup cols="2" align="left" colsep="1" rowsep="1">
 107                 <thead>
 108                     <row>
 109                         <entry>入力例</entry>
 110
 111                         <entry>出力例</entry>
 112                     </row>
 113                 </thead>
 114
 115                 <tbody>
 116                     <row>
 117                         <entry>*foo*</entry>
 118
 119                         <entry><![CDATA[<strong>foo</strong>]]></entry>
 120                     </row>
 121
 122                     <row>
 123                         <entry>_foo_</entry>
 124
 125                         <entry><![CDATA[<em>foo</em>]]></entry>
 126                     </row>
 127
 128                     <row>
 129                         <entry>??foo??</entry>
 130
 131                         <entry><![CDATA[<cite>foo</cite>]]></entry>
 132                     </row>
 133
 134                     <row>
 135                         <entry>-foo-</entry>
 136
 137                         <entry><![CDATA[<del>foo</del>]]></entry>
 138                     </row>
 139
 140                     <row>
 141                         <entry>+foo+</entry>
 142
 143                         <entry><![CDATA[<ins>foo</ins>]]></entry>
 144                     </row>
 145
 146                     <row>
 147                         <entry>^foo^</entry>
 148
 149                         <entry><![CDATA[<sup>foo</sup>]]></entry>
 150                     </row>
 151
 152                     <row>
 153                         <entry>~foo~</entry>
 154
 155                         <entry><![CDATA[<sub>foo</sub>]]></entry>
 156                     </row>
 157
 158                     <row>
 159                         <entry>%foo%</entry>
 160
 161                         <entry><![CDATA[<span>foo</span>]]></entry>
 162                     </row>
 163
 164                     <row>
 165                         <entry>PHP(PHP Hypertext Preprocessor)</entry>
 166
 167                         <entry>
 168                             <![CDATA[<acronym title="PHP Hypertext Preprocessor">PHP</acronym>]]>
 169                         </entry>
 170                     </row>
 171
 172                     <row>
 173                         <entry>"Zend Framework":http://framework.zend.com/</entry>
 174
 175                         <entry>
 176                             <![CDATA[<a href="http://framework.zend.com/">Zend Framework</a>]]>
 177                         </entry>
 178                     </row>
 179
 180                     <row>
 181                         <entry>h1. foobar</entry>
 182
 183                         <entry><![CDATA[<h1>foobar</h1>]]></entry>
 184                     </row>
 185
 186                     <row>
 187                         <entry>h6. foobar</entry>
 188
 189                         <entry><![CDATA[<h6>foobar</h6>]]></entry>
 190                     </row>
 191
 192                     <row>
 193                         <entry>!http://framework.zend.com/images/logo.gif!</entry>
 194
 195                         <entry>
 196                             <![CDATA[<img src="http://framework.zend.com/images/logo.gif" />]]>
 197                         </entry>
 198                     </row>
 199                 </tbody>
 200             </tgroup>
 201         </table>
 202
 203         <para>
 204             さらに、 Textile パーサーは全てのタグを段落へとラップします;
 205             段落は2行の新しい行で終わり、よりタグがあった場合、新しい段落が加えられます。
 206         </para>
 207
 208         <sect3 id="zend.markup.parsers.textile.lists">
 209             <title>リスト</title>
 210
 211             <para>
 212                 Textile パーサーは2種類のリストをサポートします。"#"記号を用いた数値型と
 213                 "*"記号を用いた <!-- TODO : to be translated -->bullit リストです。両方のリストの例:
 214             </para>
 215
 216             <programlisting><![CDATA[
 217 # Item 1
 218 # Item 2
 219
 220 * Item 1
 221 * Item 2
 222 ]]></programlisting>
 223
 224             <para>
 225                 上記は2つのリストを生成します: 一つは、数値型; 2つ目は、 <!-- TODO : to be translated -->bulleted 。
 226                 リスト内で、太 (*)、と 強調 (_)のように標準タグを用いることができます。タグは、
 227                 （'h1'などのように）新しい行にて始まっている必要があり、リスト内で用いることは
 228                 できません。
 229             </para>
 230         </sect3>
 231     </sect2>
 232 </sect1>