added translation of new files in xml module. 32/14432/2
Rui Hirokawa [Thu, 17 Apr 2014 12:45:34 +0000 (21:45 +0900)]
Change-Id: Ic91422237e58ec7b75c263ce47cfedaa38773ce6

scilab/modules/xml/help/ja_JP/htmlDump.xml [new file with mode: 0644]
scilab/modules/xml/help/ja_JP/htmlRead.xml [new file with mode: 0644]
scilab/modules/xml/help/ja_JP/htmlReadStr.xml [new file with mode: 0644]
scilab/modules/xml/help/ja_JP/htmlWrite.xml [new file with mode: 0644]

diff --git a/scilab/modules/xml/help/ja_JP/htmlDump.xml b/scilab/modules/xml/help/ja_JP/htmlDump.xml
new file mode 100644 (file)
index 0000000..107f35e
--- /dev/null
@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+* Copyright (C) 2013 - Scilab Enterprises - Calixte DENIZET
+*
+* This file must be used under the terms of the CeCILL.
+* This source file is licensed as described in the file COPYING, which
+* you should have received as part of this distribution.  The terms
+* are also available at
+* http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+*
+-->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="htmlDump" xml:lang="ja">
+    <refnamediv>
+        <refname>htmlDump</refname>
+        <refpurpose>HTML文書をダンプ</refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>呼び出し手順</title>
+        <synopsis>
+            str = htmlDump(xmlDoc [, indent])
+        </synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>引数</title>
+        <variablelist>
+            <varlistentry>
+                <term>xmlDoc</term>
+                <listitem>
+                    <para>xmlDoc, XML文書</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>indent</term>
+                <listitem>
+                    <para>indent, 論理値</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>str</term>
+                <listitem>
+                    <para>str, 文字列の行列</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>説明</title>
+        <para>HTML文書をダンプします. indentがfalseの場合 (デフォルト値: true), インデントは行われず, 復改が追加されます.</para>
+    </refsection>
+    <refsection>
+        <title>例</title>
+        <programlisting role="example"><![CDATA[
+    doc = htmlReadStr(["<!DOCTYPE html PUBLIC ""-//W3C//DTD HTML 4.01//EN""";
+                       """http://www.w3.org/TR/html4/strict.dtd"">";
+                       "<html lang=""en"">";
+                       "  <head>";
+                       "    <meta http-equiv=""content-type"" content=""text/html; charset=utf-8"">";
+                       "    <title>title</title>";
+                       "    <link rel=""stylesheet"" type=""text/css"" href=""style.css"">";
+                       "    <script type=""text/javascript"" src=""script.js""></script>";
+                       "  </head>";
+                       "  <body>";
+                       "  </body>";
+                       "</html>"]);
+
+    // HTML文書をダンプ
+    htmlDump(doc)
+
+    // インデントせずにHTML文書をダンプ
+    htmlDump(doc, %f)
+
+    // 文書に関連するリソースを開放
+    xmlDelete(doc);
+    ]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>参照</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="xmlWrite">htmlWrite</link>
+            </member>
+        </simplelist>
+    </refsection>
+    <refsection>
+        <title>履歴</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.5.0</revnumber>
+                <revremark>HTML機能追加.</revremark>
+            </revision>
+        </revhistory>
+    </refsection>
+</refentry>
diff --git a/scilab/modules/xml/help/ja_JP/htmlRead.xml b/scilab/modules/xml/help/ja_JP/htmlRead.xml
new file mode 100644 (file)
index 0000000..1f6db84
--- /dev/null
@@ -0,0 +1,112 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+* Copyright (C) 2012 - Scilab Enterprises - Calixte DENIZET
+*
+* This file must be used under the terms of the CeCILL.
+* This source file is licensed as described in the file COPYING, which
+* you should have received as part of this distribution.  The terms
+* are also available at
+* http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+*
+-->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="htmlRead" xml:lang="ja">
+    <refnamediv>
+        <refname>htmlRead</refname>
+        <refpurpose>ローカルまたはリモートファイルからHTMLストリームを読み込む</refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>呼び出し手順</title>
+        <synopsis>
+            doc = htmlRead(path [, encoding])
+        </synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>引数</title>
+        <variablelist>
+            <varlistentry>
+                <term>path</term>
+                <listitem>
+                    <para>文字列, 読み込むファイルのパス.</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>encoding</term>
+                <listitem>
+                    <para>文字列, ファイルエンコーディング.</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>doc</term>
+                <listitem>
+                    <para>XMLDoc型のmlist</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>説明</title>
+        <para>HTMLファイルを読込み, パースします. 返される文書により,
+         メモリ上に保持したDOMツリーにアクセスできます.
+       </para>
+        <para>一般に, HTMLファイルは,整形式であることがまれのため,
+         XMLパーサーにより読み込むことはできません.
+         このため,HTMLパーサが必要となり,より適合したものになります.
+       </para>
+        <para>HTMLファイルが一度パースされると, メモリ上でXMLファイルとして参照でき,
+         通常の操作が適用可能になります.
+       </para>
+        <para>encoding引数はファイルエンコーディングを明確に
+         指定する際に使用されます.
+       </para>
+        <para>
+         (メモリーリークを回避するために)<link linkend="xmlDelete">xmlDelete</link>
+         によりツリーを解放することはできません.
+        </para>
+    </refsection>
+    <refsection>
+        <title>例</title>
+        <programlisting role="example"><![CDATA[
+    doc = htmlRead("http://www.scilab.org");
+    e = doc.root.children(1).children(1)
+    e.name
+    e.content
+
+    // 'href'属性を有する全ノードを取得
+    q = xmlXPath(doc, "//*[@href]");
+    q(1).attributes
+
+    // 文書を削除
+    xmlDelete(doc);
+    ]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>参照</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="htmlReadStr">htmlReadStr</link>
+            </member>
+            <member>
+                <link linkend="xmlGetOpenDocs">xmlGetOpenDocs</link>
+            </member>
+            <member>
+                <link linkend="xmlDelete">xmlDelete</link>
+            </member>
+            <member>
+                <link linkend="xmlDocument">xmlDocument</link>
+            </member>
+            <member>
+                <link linkend="xmlXPath">xmlXPath</link>
+            </member>
+        </simplelist>
+    </refsection>
+    <refsection>
+        <title>履歴</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.5.0</revnumber>
+                <revremark>HTML機能が追加されました.</revremark>
+            </revision>
+        </revhistory>
+    </refsection>
+</refentry>
diff --git a/scilab/modules/xml/help/ja_JP/htmlReadStr.xml b/scilab/modules/xml/help/ja_JP/htmlReadStr.xml
new file mode 100644 (file)
index 0000000..56e792c
--- /dev/null
@@ -0,0 +1,102 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+* Copyright (C) 2012 - Scilab Enterprises - Calixte DENIZET
+*
+* This file must be used under the terms of the CeCILL.
+* This source file is licensed as described in the file COPYING, which
+* you should have received as part of this distribution.  The terms
+* are also available at
+* http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+*
+-->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="htmlReadStr" xml:lang="ja">
+    <refnamediv>
+        <refname>htmlReadStr</refname>
+        <refpurpose>文字列からHTMLツリーを読み込む</refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>呼び出し手順</title>
+        <synopsis>
+            doc = htmlReadStr(string)
+        </synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>引数</title>
+        <variablelist>
+            <varlistentry>
+                <term>string</term>
+                <listitem>
+                    <para>文字列, XMLコードを保持.</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>doc</term>
+                <listitem>
+                    <para>XMLDoc型のmlist</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>説明</title>
+        <para>
+         HTML文字列を読み込んでパースします.
+         返される文書によりメモリ上に保持したDOMツリーにアクセスできます.
+       </para>
+        <para>
+         重要なことですが,
+         関数<link linkend="xmlDelete">xmlDelete</link>により
+         (メモリリークを回避するために)ツリーを開放する必要があります.
+        </para>
+    </refsection>
+    <refsection>
+        <title>例</title>
+        <programlisting role="example"><![CDATA[
+    doc = htmlReadStr(["<!DOCTYPE html PUBLIC ""-//W3C//DTD HTML 4.01//EN""";
+                       """http://www.w3.org/TR/html4/strict.dtd"">";
+                       "<html lang=""en"">";
+                       "  <head>";
+                       "    <meta http-equiv=""content-type"" content=""text/html; charset=utf-8"">";
+                       "    <title>title</title>";
+                       "    <link rel=""stylesheet"" type=""text/css"" href=""style.css"">";
+                       "    <script type=""text/javascript"" src=""script.js""></script>";
+                       "  </head>";
+                       "  <body>";
+                       "  </body>";
+                       "</html>"]);
+
+    // HTML文書をダンプ
+    htmlDump(doc)
+
+    // 文書に関連するリソースを開放
+    xmlDelete(doc);
+    ]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>参照</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="htmlRead">htmlRead</link>
+            </member>
+            <member>
+                <link linkend="xmlGetOpenDocs">xmlGetOpenDocs</link>
+            </member>
+            <member>
+                <link linkend="xmlDelete">xmlDelete</link>
+            </member>
+            <member>
+                <link linkend="xmlDocument">xmlDocument</link>
+            </member>
+        </simplelist>
+    </refsection>
+    <refsection>
+        <title>履歴</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.5.0</revnumber>
+                <revremark>HTML機能を追加.</revremark>
+            </revision>
+        </revhistory>
+    </refsection>
+</refentry>
diff --git a/scilab/modules/xml/help/ja_JP/htmlWrite.xml b/scilab/modules/xml/help/ja_JP/htmlWrite.xml
new file mode 100644 (file)
index 0000000..37d0a88
--- /dev/null
@@ -0,0 +1,94 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+* Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+* Copyright (C) 2012 - Scilab Enterprises - Calixte DENIZET
+*
+* This file must be used under the terms of the CeCILL.
+* This source file is licensed as described in the file COPYING, which
+* you should have received as part of this distribution.  The terms
+* are also available at
+* http://www.cecill.info/licences/Licence_CeCILL_V2.1-en.txt
+*
+-->
+<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns5="http://www.w3.org/1999/xhtml" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:id="htmlWrite" xml:lang="ja">
+    <refnamediv>
+        <refname>htmlWrite</refname>
+        <refpurpose>HTML文書をファイルに書き込む</refpurpose>
+    </refnamediv>
+    <refsynopsisdiv>
+        <title>呼び出し手順</title>
+        <synopsis>
+            htmlWrite(doc [, filename] [, indent])
+            htmlWrite(doc [, indent])
+        </synopsis>
+    </refsynopsisdiv>
+    <refsection>
+        <title>引数</title>
+        <variablelist>
+            <varlistentry>
+                <term>doc</term>
+                <listitem>
+                    <para>XMLDoc型のmlist</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>filename</term>
+                <listitem>
+                    <para>filename, 文字列</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>indent</term>
+                <listitem>
+                    <para>indent, インデント</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+    <refsection>
+        <title>説明</title>
+        <para>HTML文書をファイル名または文書URLを指定したファイルに
+         書き込みます.
+         indentがtrueの場合,文書はインデントされます.
+         デフォルトでindentはtrueです.
+       </para>
+    </refsection>
+    <refsection>
+        <title>例</title>
+        <programlisting role="example"><![CDATA[
+    doc = htmlRead("http://www.scilab.org");
+    htmlWrite(doc, TMPDIR+"/scilab.html", %f);
+
+    // ここで前のファイルを開き, 修正後に保存
+    doc1 = htmlRead(TMPDIR+"/scilab.html");
+    xp = xmlXPath(doc1, "//title");
+    e = xp(1);
+    e.content = "Hello Scilab World";
+    htmlWrite(doc1);
+
+    // 修正が行われたことを確認
+    doc2 = htmlRead(TMPDIR+"/scilab.html");
+    xp = xmlXPath(doc2, "//title");
+    xp(1).content
+
+    xmlDelete("all");
+    ]]></programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>参照</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="xmlDump">xmlDump</link>
+            </member>
+        </simplelist>
+    </refsection>
+    <refsection>
+        <title>履歴</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.5.0</revnumber>
+                <revremark>HTML機能追加.</revremark>
+            </revision>
+        </revhistory>
+    </refsection>
+</refentry>