svn: /pear/peardoc/trunk/ja/package/text/ text-diff/intro.xml text-diff/usage-examples.xml text-diff.xml

takagi Sun, 06 Dec 2009 03:55:01 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=291758 Log: added Japanese translation (contributed by iogi [http://github.com/iogi/peardoc-ja/tree/master/package/text]). Changed paths: A pear/peardoc/trunk/ja/package/text/text-diff/ A pear/peardoc/trunk/ja/package/text/text-diff/intro.xml A pear/peardoc/trunk/ja/package/text/text-diff/usage-examples.xml A pear/peardoc/trunk/ja/package/text/text-diff.xml Added: pear/peardoc/trunk/ja/package/text/text-diff/intro.xml =================================================================== --- pear/peardoc/trunk/ja/package/text/text-diff/intro.xml (rev 0) +++ pear/peardoc/trunk/ja/package/text/text-diff/intro.xml 2009-12-06 03:55:01 UTC (rev 291758) @@ -0,0 +1,156 @@ +<?xml version="1.0" encoding="utf-8"?> +<chapter xmlns="http://docbook.org/ns/docbook" version="lillet" + xml:id="package.text.text-diff.intro" + xmlns:phd="http://www.php.net/ns/phd" +> + <info> + <title>Text_Diff の導入</title> + </info> + + <para> + <classname>Text_Diff</classname> は、 2 つもしくは + 3 つのテキストファイル間での差分表示の生成を支援します。 + </para> + + <programlisting role="text"><![CDATA[ +@@ -1,3 +1,3 @@ + この行は同じです。 +-この行は 1.txt のみにあります。 ++この行は 2.txt のみにあります。 + この行は同じです。 +]]></programlisting> + + <para> + 差分は、2つのステップで生成します。 + </para> + <orderedlist> + <listitem> + <simpara>ファイル間の差分を算出する。</simpara> + </listitem> + <listitem> + <simpara>差分の出力を生成する。</simpara> + </listitem> + </orderedlist> + + <para> + <phd:pearapi phd:package="Text_Diff" + phd:linkend="Text_Diff">Text_Diff</phd:pearapi> では、 + ファイル、文字列間の差分を計算するために <emphasis>エンジン</emphasis> が利用されます。 + このパッケージでは、 + <phd:pearapi phd:package="Text_Diff" + phd:linkend="Text_Diff_Engine_native">native</phd:pearapi>、 + <phd:pearapi phd:package="Text_Diff" + phd:linkend="Text_Diff_Engine_shell">shell</phd:pearapi>、 + <phd:pearapi phd:package="Text_Diff" + phd:linkend="Text_Diff_Engine_string">string</phd:pearapi>、 + そして <phd:pearapi phd:package="Text_Diff" + phd:linkend="Text_Diff_Engine_xdiff">xdiff</phd:pearapi> + のエンジンを含んでいます。 + + <literal>auto</literal> を使用すると、 + <classname>Text_Diff</classname> は、システムに最適なものを決定します。 + </para> + + <para> + 2 つ目のパートでは、レンダラによって出力を生成します。 + Text_Diff は + <link linkend="package.text.text-diff.intro.renderers.context"> + context + </link>、 + <link linkend="package.text.text-diff.intro.renderers.inline"> + inline + </link> + そして <link linkend="package.text.text-diff.intro.renderers.unified"> + unified + </link> + レンダラを同梱しています。 + </para> + + <section xml:id="package.text.text-diff.intro.renderers"> + <info> + <title>レンダラの例</title> + </info> + + <example xml:id="package.text.text-diff.intro.renderers.context"> + <title>Context レンダラ</title> + + <programlisting role="php"> + <xi:include parse="text" + xmlns:xi="http://www.w3.org/2001/XInclude" + href="&package.text.text-diff.examples.rend-context.php;" + > + <xi:fallback>FIXME:MISSING XINCLUDE CONTENT</xi:fallback> + </xi:include> + </programlisting> + + <simpara> + 以下の出力を生成します: + </simpara> + + <programlisting role="diff"> + <xi:include parse="text" + xmlns:xi="http://www.w3.org/2001/XInclude" + href="&package.text.text-diff.examples.rend-context.txt;" + > + <xi:fallback>FIXME:MISSING XINCLUDE CONTENT</xi:fallback> + </xi:include> + </programlisting> + </example> + + + <example xml:id="package.text.text-diff.intro.renderers.inline"> + <title>Inline レンダラ</title> + + <programlisting role="php"> + <xi:include parse="text" + xmlns:xi="http://www.w3.org/2001/XInclude" + href="&package.text.text-diff.examples.rend-inline.php;" + > + <xi:fallback>FIXME:MISSING XINCLUDE CONTENT</xi:fallback> + </xi:include> + </programlisting> + + <simpara> + 以下の出力を生成します: + </simpara> + + <programlisting role="diff"> + <xi:include parse="text" + xmlns:xi="http://www.w3.org/2001/XInclude" + href="&package.text.text-diff.examples.rend-inline.txt;" + > + <xi:fallback>FIXME:MISSING XINCLUDE CONTENT</xi:fallback> + </xi:include> + </programlisting> + </example> + + + <example xml:id="package.text.text-diff.intro.renderers.unified"> + <title>Unified レンダラ</title> + + <programlisting role="php"> + <xi:include parse="text" + xmlns:xi="http://www.w3.org/2001/XInclude" + href="&package.text.text-diff.examples.rend-unified.php;" + > + <xi:fallback>FIXME:MISSING XINCLUDE CONTENT</xi:fallback> + </xi:include> + </programlisting> + + <simpara> + 以下の出力を生成します: + </simpara> + + <programlisting role="diff"> + <xi:include parse="text" + xmlns:xi="http://www.w3.org/2001/XInclude" + href="&package.text.text-diff.examples.rend-unified.txt;" + > + <xi:fallback>FIXME:MISSING XINCLUDE CONTENT</xi:fallback> + </xi:include> + </programlisting> + </example> + + </section> + +</chapter> Added: pear/peardoc/trunk/ja/package/text/text-diff/usage-examples.xml =================================================================== --- pear/peardoc/trunk/ja/package/text/text-diff/usage-examples.xml (rev 0) +++ pear/peardoc/trunk/ja/package/text/text-diff/usage-examples.xml 2009-12-06 03:55:01 UTC (rev 291758) @@ -0,0 +1,50 @@ +<?xml version="1.0" encoding="utf-8"?> +<chapter xmlns="http://docbook.org/ns/docbook" version="lillet" + xml:id="package.text.text-diff.usage-example" +> + <info> + <title>使用例</title> + </info> + + <section xml:id="package.text.text-diff.usage-examples.shell"> + <info> + <title>シェル上に色付けしたdiffを出力する</title> + </info> + + <para> + <link linkend="package.console.console-color">Console_Color</link> + とあわせて + <classname>Text_Diff</classname> を使用することで + ANSI ターミナル上で色付けしたdiffを表示することが可能になります。 + </para> + + <programlisting role="php"> + <xi:include parse="text" + xmlns:xi="http://www.w3.org/2001/XInclude" + href="&package.text.text-diff.examples.shell-inline.php;" + > + <xi:fallback>FIXME:MISSING XINCLUDE CONTENT</xi:fallback> + </xi:include> + </programlisting> + + <simpara> + シェル上にこのように表示されます: + </simpara> + + <figure> + <screenshot> + <mediaobject> + <alt>スクリーンショット</alt> + <imageobject> + <imagedata + align="center" format="png" + fileref="en/package/text/text-diff/images/shell-inline.png" + /> + </imageobject> + </mediaobject> + </screenshot> + </figure> + + </section> + +</chapter> Added: pear/peardoc/trunk/ja/package/text/text-diff.xml =================================================================== --- pear/peardoc/trunk/ja/package/text/text-diff.xml (rev 0) +++ pear/peardoc/trunk/ja/package/text/text-diff.xml 2009-12-06 03:55:01 UTC (rev 291758) @@ -0,0 +1,16 @@ +<?xml version="1.0" encoding="utf-8"?> +<book xmlns="http://docbook.org/ns/docbook" version="lillet" + xml:id="package.text.text-diff" +> + <info> + <title>Text_Diff</title> + <abstract> + <para> + テキストベースのファイル間の差分を解析、表示します。 + </para> + </abstract> + </info> + + &package.text.text-diff.intro; + &package.text.text-diff.usage-examples; +</book>