svn: /pear/peardoc/trunk/ja/package/text/ text-diff/intro.xml text-diff/usage-examples.xml text-diff.xml
[email protected] (TAKAGI Masahiro)
| Newsgroups | php.pear.doc |
|---|---|
| Message-ID | <[email protected]> |
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>