added Japanese translation files.

docs/ja/language-snippets.ent

@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- $Revision$ -->
+<!-- EN-Revision: 1.7 Maintainer: takagi Status: ready -->
+<!-- CREDITS: mat-sh,daichi,joe -->
+
+<!ENTITY note.parameter.merge '<note>
+ <title>テクニカルノート</title>
+ <para>
+  <parameter>merge</parameter> パラメータは配列のキーを尊重するので、
+  インデックスが数値である２つの配列をマージする場合、
+  それらはお互い上書きされるか不連続なキーの配列になるかもしれません。
+  これは、数値のキーを全て削除した後に再びキーに番号付けを行う、PHP
+  の <ulink url="&url.php-manual;array_merge"><varname>array_merge()</varname></ulink>
+  関数とは違っています。
+ </para>
+</note>'>
+
+<!ENTITY parameter.compileid '<para>
+ 任意の第３パラメータとして <parameter>$compile_id</parameter>
+ を渡すことができます。
+ 異なる言語でコンパイルされた別々のテンプレートが存在するような、
+ 同じテンプレートの異なるバージョンをコンパイルしたい場合に利用します。
+ <parameter>$compile_id</parameter> の別の利用法としては、複数の
+ <link linkend="variable.template.dir"><parameter>$template_dir</parameter></link>
+ を持っているが
+ <link linkend="variable.compile.dir"><parameter>$compile_dir</parameter></link>
+ は１つしかない場合などがあります。各
+ <link linkend="variable.template.dir"><parameter>$template_dir</parameter></link>
+ に別々の <parameter>$compile_id</parameter> をセットしなければ、
+ 同名のテンプレートはお互いに上書きされてしまいます。
+ この関数をコールする度に compile_id を渡す代わりに、一度
+ <link linkend="variable.compile.id">
+ <parameter>$compile_id</parameter></link> 変数をセットすることもできます。
+</para>'>
+
+<!ENTITY api.register.snippet '<para>
+   PHP 関数のコールバック <parameter>function</parameter>
+   は、次のいずれかとなります。
+   <itemizedlist>
+       <listitem><para>
+       関数名を含んだ文字列
+       </para></listitem>
+
+       <listitem><para>
+       <literal>array(&amp;$object, $method)</literal> 形式の配列
+       （<literal>&amp;$object</literal> はオブジェクトの参照で、
+       <literal>$method</literal> はメソッド名を含む文字列）
+       </para></listitem>
+
+       <listitem><para>
+       <literal>array($class, $method)</literal> という形式の配列
+       （<literal>$class</literal> はクラス名であり、
+       <literal>$method</literal> はクラスのメソッド）
+       </para></listitem>
+   </itemizedlist>
+  </para>'>