[DOCUMENTATION] Japanese new Zend_Tag_Introduction

git-svn-id: http://framework.zend.com/svn/framework/standard/trunk@17790 44c647ce-9c0f-0410-b52a-842ac1e357ba

documentation/manual/ja/module_specs/Zend_Tag-Introduction.xml

@@ -0,0 +1,62 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!-- Reviewed: no -->
+<!-- EN-Revision: 17789 -->
+<sect1 id="zend.tag.introduction">
+    <title>導入</title>
+
+    <para>
+        <classname>Zend_Tag</classname>は、タグ付けできる項目で動作するための機能を与える
+        コンポーネント・スイートです。
+        その基盤として、タグで動作するクラスを２つ、
+        <classname>Zend_Tag_Item</classname>及び<classname>Zend_Tag_ItemList</classname>を
+        提供します。
+        さらに、それにインタフェース<classname>Zend_Tag_Taggable</classname>がついてきます。
+        そして、それは<classname>Zend_Tag</classname>と連携した、
+        タグ付けできる項目としてどのモデルでも利用できます。
+    </para>
+
+    <para>
+        <classname>Zend_Tag_Item</classname>は、
+        <classname>Zend_Tag</classname>スイートで動作する必要のある重要な機能に付属する、
+        基本的なタグ付けできる項目の実装です。
+        タグ付けできる項目は、常にタイトルと相対荷重（例えば反復回数）から成ります。
+        それも、<classname>Zend_Tag</classname>の異なるサブコンポーネントによって使われる
+        パラメータを格納します。
+    </para>
+
+    <para>
+        複数の項目をまとめるために、
+        <classname>Zend_Tag_ItemList</classname>は配列イテレータとして存在して、
+        その中で各項目の与えられた相対荷重に基づく絶対重み付け値を計算するために、
+        更なる機能を与えます。
+    </para>
+
+    <example id="zend.tag.example.using">
+        <title>Zend_Tagの利用</title>
+        <para>
+            この例は、タグの一覧を作成して、
+            絶対の重み付け値をそれらに行き渡らせる方法を例示します。
+        </para>
+        <programlisting language="php"><![CDATA[
+//項目一覧を作成
+$list = new Zend_Tag_ItemList();
+
+//タグをそれに割り当て
+$list[] = new Zend_Tag_Item(array('title' => 'Code', 'weight' => 50));
+$list[] = new Zend_Tag_Item(array('title' => 'Zend Framework', 'weight' => 1));
+$list[] = new Zend_Tag_Item(array('title' => 'PHP', 'weight' => 5));
+
+//絶対値をそれらに行き渡らせる
+$list->spreadWeightValues(array(1, 2, 3, 4, 5, 6, 7, 8, 9, 10));
+
+//それらの絶対値とともに項目を出力
+foreach ($list as $item) {
+    printf("%s: %d\n", $item->getTitle(), $item->getParam('weightValue'));
+}
+]]></programlisting>
+        <para>
+            これはCodeとZend Framework及び<acronym>PHP</acronym>を
+            絶対値の10、１及び２で出力します。
+        </para>
+    </example>
+</sect1>