[doc] Revision of fileio help pages (Russian). 02/21502/6
Stanislav KROTER [Sun, 14 Jun 2020 16:38:05 +0000 (21:38 +0500)]
Change-Id: I9a449dc3c4db2306c8e0bbc203500dcd55fd9427

scilab/modules/fileio/help/ru_RU/directory/chdir.xml
scilab/modules/fileio/help/ru_RU/directory/createdir.xml
scilab/modules/fileio/help/ru_RU/directory/isdir.xml
scilab/modules/fileio/help/ru_RU/file_system/copyfile.xml
scilab/modules/fileio/help/ru_RU/file_system/listfiles.xml
scilab/modules/fileio/help/ru_RU/getURL.xml [new file with mode: 0644]
scilab/modules/fileio/help/ru_RU/io.xml
scilab/modules/fileio/help/ru_RU/mopen.xml
scilab/modules/fileio/help/ru_RU/path_filename/dirname.xml
scilab/modules/fileio/help/ru_RU/path_filename/splitURL.xml [new file with mode: 0644]

index 4045e50..7719499 100644 (file)
@@ -18,9 +18,6 @@
           xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML"
           xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org"
           xml:lang="ru" xml:id="chdir">
-    <info>
-        <pubdate>$LastChangedDate$</pubdate>
-    </info>
     <refnamediv>
         <refname>chdir</refname>
         <refpurpose>меняет текущую директорию Scilab'а</refpurpose>
index 5b37ae5..bc85c42 100644 (file)
@@ -14,9 +14,6 @@
  *
  -->
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:mml="http://www.w3.org/1998/Math/MathML" xmlns:db="http://docbook.org/ns/docbook" xmlns:scilab="http://www.scilab.org" xml:lang="ru" xml:id="createdir">
-    <info>
-        <pubdate>$LastChangedDate$</pubdate>
-    </info>
     <refnamediv>
         <refname>createdir</refname>
         <refpurpose>создаёт новую директорию</refpurpose>
index 6597a16..0c11b87 100644 (file)
@@ -83,8 +83,9 @@ isdir SCI/etc/scilab.start
             <revision>
                 <revnumber>6.0.2</revnumber>
                 <revdescription>
-                  isdir("w:") and isdir("w:\") and isdir("w:/") now return %F when the drive W:
-                  does not exist.
+                    <literal>isdir("w:")</literal> и <literal>isdir("w:\")</literal> и
+                    <literal>isdir("w:/")</literal> теперь возвращает <constant>%f</constant>,
+                    когда отсутствует диск <literal>W:</literal>.
                 </revdescription>
             </revision>
         </revhistory>
index 37ed4d5..2ff388e 100644 (file)
  *
  -->
 <refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:svg="http://www.w3.org/2000/svg" xmlns:ns3="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="copyfile" xml:lang="ru">
-    <info>
-        <pubdate>$LastChangedDate$
-        </pubdate>
-    </info>
     <refnamediv>
         <refname>copyfile</refname>
         <refpurpose>копирование файла</refpurpose>
index 09a8ce4..9e07eb2 100644 (file)
@@ -121,8 +121,8 @@ files=listfiles(['SCI/modules/core/macros/*.sci';'SCI/modules/core/macros/*.bin'
             <revision>
                 <revnumber>6.0.2</revnumber>
                 <revremark>
-                    Under Windows, up to 6.0.1, <literal>listfile("test")</literal> actually
-                    performed <literal>listfile("test.*")</literal>. It is no longer the case.
+                    В Windows, вплоть до 6.0.1, <literal>listfile("test")</literal> фактически
+                    выполняет <literal>listfile("test.*")</literal>. Теперь это не так.
                 </revremark>
             </revision>
         </revhistory>
diff --git a/scilab/modules/fileio/help/ru_RU/getURL.xml b/scilab/modules/fileio/help/ru_RU/getURL.xml
new file mode 100644 (file)
index 0000000..17c80bb
--- /dev/null
@@ -0,0 +1,196 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) - S/E - Sylvestre Ledru
+ *
+ * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ *
+ * This file is hereby licensed under the terms of the GNU GPL v2.0,
+ * pursuant to article 5.3.4 of the CeCILL v.2.1.
+ * This file was originally licensed under the terms of the CeCILL v2.1,
+ * and continues to be available under such terms.
+ * For more information, see the COPYING file which you should have received
+ * along with this program.
+ *
+ -->
+<refentry xml:id="getURL" xml:lang="ru"
+          xmlns="http://docbook.org/ns/docbook"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg"
+          xmlns:ns3="http://www.w3.org/1999/xhtml"
+          xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:scilab="http://www.scilab.org"
+          xmlns:db="http://docbook.org/ns/docbook">
+
+    <refnamediv>
+        <refname>getURL</refname>
+
+        <refpurpose>Загрузка по URL (HTTP, HTTPS, FTP...) </refpurpose>
+    </refnamediv>
+
+    <refsynopsisdiv>
+        <title>Синтаксис</title>
+
+        <synopsis>filename = getURL(URL);
+            [filename, [content]] = getURL(URL [, targetDir [, username [, password]]]]);
+            [filename, [content]] = getURL(URL [, targetFile [, username [, password]]]]);
+        </synopsis>
+    </refsynopsisdiv>
+
+    <refsection>
+        <title>Аргументы</title>
+        <variablelist>
+            <varlistentry>
+                <term>URL</term>
+                <listitem>
+                    <para>строка: ссылка URL. Поддерживаются и тестируются: HTTP, HTTPS, FTP (IPv4 и IPv6)</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>targetDir</term>
+                <listitem>
+                    <para>
+                        Необязательный строковый параметр: указывает в какой директории будет
+                        сохранён файл (если пустой, то текущая директория)
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>targetFile</term>
+                <listitem>
+                    <para>
+                        Необязательный строковый параметр: указывает где (и под каким именем)
+                        данный файл будет сохранён (если пустой, то текущая директория)
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>username</term>
+                <listitem>
+                    <para>
+                        Необязательный строковый параметр: имя пользователя для вебсайтов,
+                        которые запрашивают аутентификацию
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>password</term>
+                <listitem>
+                    <para>
+                        Необязательный строковый параметр: пароль для вебсайтов,
+                        которые запрашивают аутентификацию
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>filename</term>
+                <listitem>
+                    <para>строка: путь до загруженного файла</para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>content</term>
+                <listitem>
+                    <para>строка: содержимое загруженного файла</para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+
+    <refsection>
+        <title>Описание</title>
+
+        <para>Загрузка файла по ссылке URL.</para>
+
+        <para>
+            Функция <literal>getURL</literal> загрузит файл по удалённой ссылке URL.
+            Однако, в некоторых обстоятельствах (например,
+            <emphasis role="italic">http://www.scilab.org/</emphasis>), имя файла
+            не предоставляется самой ссылкой URL и <literal>getURL</literal>
+            переименует файл в <emphasis role="italic">index.html</emphasis>.
+        </para>
+
+        <para>
+            <varname>content</varname> содержит содержимое страницы, указанной в URL.
+        </para>
+
+        <para>
+            Эта функция основана на <ulink url="http://curl.haxx.se/libcurl/">библиотеке curl</ulink>.
+        </para>
+
+        <para>
+            <varname>username</varname> and <varname>password</varname> могут быть
+            определены для тех вебсайтов, которые запрашивают аутентификацию.
+            Используемый метод аутентификации <literal>CURLAUTH_ANY</literal>,
+            указываемый параметром <literal>CURLOPT_HTTPAUTH</literal> библиотеки
+            <literal>libcurl</literal>.
+        </para>
+
+        <para>
+            <literal>getURL</literal> поддерживает IPv6 (и, очевидно, IPv4) по умолчанию.
+        </para>
+
+        <para>
+            В этой версии доступна настройка прокси, она может быть изменена в настройках в
+            разделе "Интернет".
+        </para>
+
+        <para>
+            Опция curl <emphasis role="italic">CURLOPT_FOLLOWLOCATION</emphasis>
+            активируется для того, чтобы убедиться в загрузке по ссылке URL.
+        </para>
+
+        <para>
+            <literal>getURL</literal> основана на libcurl. Версия этой библиотеки в официальном двоичном файле Scilab, скомпилированным с поддержкой HTTP, HTTPS, FTP и FTPS. Если Scilab установлен через систему пакетов в дистрибутиве, вероятно, что будут работать <ulink url="http://curl.haxx.se/docs/features.html">и иные протоколы</ulink>, а не только HTTP, HTTPS и FTPS. Однако, они недостаточно протестированы.
+        </para>
+
+    </refsection>
+
+    <refsection>
+        <title>Примеры</title>
+
+        <programlisting role="example">
+
+            // Будет загружен URL с именем файла maths_simulation
+            getURL("http://www.scilab.org/products/scilab/features/maths_simulation");
+
+            // Сохранить домашнюю страницу Scilab в текущей директории (и переименуем файл)
+            getURL("http://www.scilab.org","scilab_homepage.html");
+
+            // Загрузка примера Scilab и исполнение его
+            myFile = getURL("http://fileexchange.scilab.org/toolboxes/contour3d/10.03/files/contour3d.sci",TMPDIR)
+            exec(myFile);
+            contour3d();
+
+            // Используем аутентификацию
+            getURL("http://httpbin.org/basic-auth/user/passwd",TMPDIR+"/testfile.html","user","passwd")
+
+            // Необходимо подключение IPv6
+            getURL("http://ipv6.google.com/intl/en_com/images/srpr/logo3w.png")
+
+            // Получение контента
+            [myFile, content] = getURL("http://fileexchange.scilab.org/toolboxes/contour3d/10.03/files/contour3d.sci",TMPDIR)
+        </programlisting>
+    </refsection>
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="splitURL">splitURL</link>
+            </member>
+        </simplelist>
+    </refsection>
+
+    <refsection>
+        <title>История</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.5.0</revnumber>
+                <revremark>
+                    Введена функция <literal>getURL()</literal>
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
+
+</refentry>
index 171fab1..762b8f2 100644 (file)
@@ -81,7 +81,7 @@ write(0,'Scilab stderr (Fortran)');
             <revision>
                 <revnumber>6.0.0</revnumber>
                 <revdescription>
-                   <literal>%io</literal> is now protected (read-only).
+                   <literal>%io</literal> теперь защищена (только для чтения).
                 </revdescription>
             </revision>
         </revhistory>
index 6923e10..1c49928 100644 (file)
             соответствовать формату IEEE процессора.
         </para>
         <para>
-            Параметр <varname>mode</varname> управляет типом            доступа к потоку. Этот параметр может иметь одно из
+            Параметр <varname>mode</varname> управляет типом
+            доступа к потоку. Этот параметр может иметь одно из
             следующих значений:
         </para>
         <variablelist>
index 4995f4a..260cc5d 100644 (file)
@@ -21,7 +21,7 @@
     <refnamediv>
         <refname>dirname</refname>
         <refpurpose>
-           получает имя директории из имён файлов <emphasis role="bold">(obsolete)</emphasis>
+           получает имя директории из имён файлов <emphasis role="bold">(устарела)</emphasis>
         </refpurpose>
     </refnamediv>
     <refsynopsisdiv>
@@ -71,8 +71,8 @@
     <refsection>
         <title>Описание</title>
         <warning>
-          <literal>dirname(…)</literal> is obsolete and will be removed from Scilab 6.1.x.
-          Please use <literal>fileparts(…)</literal> instead.
+          Функция <literal>dirname(…)</literal> устарела и будет удалена из Scilab 6.1.x.
+          Пожалуйста, используйте вместо неё <literal>fileparts(…)</literal>.
         </warning>
         <para>
             Функция <function>dirname</function> возвращает путь директории, составленный
@@ -132,8 +132,8 @@ dirs=dirname(['SCI/etc/scilab.start', 'SCI/etc/scilab.quit'])
             <revision>
                 <revnumber>6.0.2</revnumber>
                 <revdescription>
-                    dirname() is tagged obsolete, to be removed from Scilab 6.1.x.
-                    fileparts() replaces it.
+                    dirname() отмечена, как устаревшая, которую удалят из Scilab 6.1.x.
+                    Её заменит fileparts().
                 </revdescription>
             </revision>
         </revhistory>
diff --git a/scilab/modules/fileio/help/ru_RU/path_filename/splitURL.xml b/scilab/modules/fileio/help/ru_RU/path_filename/splitURL.xml
new file mode 100644 (file)
index 0000000..a5400a7
--- /dev/null
@@ -0,0 +1,172 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--
+ * Scilab ( http://www.scilab.org/ ) - This file is part of Scilab
+ * Copyright (C) - S/E - Sylvestre Ledru
+ *
+ * Copyright (C) 2012 - 2016 - Scilab Enterprises
+ *
+ * This file is hereby licensed under the terms of the GNU GPL v2.0,
+ * pursuant to article 5.3.4 of the CeCILL v.2.1.
+ * This file was originally licensed under the terms of the CeCILL v2.1,
+ * and continues to be available under such terms.
+ * For more information, see the COPYING file which you should have received
+ * along with this program.
+ *
+ -->
+<refentry xml:id="splitURL" xml:lang="ru"
+          xmlns="http://docbook.org/ns/docbook"
+          xmlns:xlink="http://www.w3.org/1999/xlink"
+          xmlns:svg="http://www.w3.org/2000/svg"
+          xmlns:ns3="http://www.w3.org/1999/xhtml"
+          xmlns:mml="http://www.w3.org/1998/Math/MathML"
+          xmlns:scilab="http://www.scilab.org"
+          xmlns:db="http://docbook.org/ns/docbook">
+
+    <refnamediv>
+        <refname>splitURL</refname>
+
+        <refpurpose>разбивает ссылку URL (HTTP, HTTPS, FTP...) </refpurpose>
+    </refnamediv>
+
+    <refsynopsisdiv>
+        <title>Синтаксис</title>
+
+        <synopsis>
+            [proto, server, path, query, username, port, fragment] = splitURL(URL);
+        </synopsis>
+    </refsynopsisdiv>
+
+    <refsection>
+        <title>Аргументы</title>
+        <variablelist>
+            <varlistentry>
+                <term>URL</term>
+                <listitem>
+                    <para>
+                        строка: ссылка URL. Поддерживаются и тестируются: HTTP, HTTPS, FTP (IPv4 и IPv6)
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>proto</term>
+                <listitem>
+                    <para>
+                        строка: протокол (например: <emphasis role="italic">http, ftp, и т.д.</emphasis>)
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>server</term>
+                <listitem>
+                    <para>
+                        строка: сервер (например: <emphasis role="italic">www.scilab.org</emphasis>)
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>path</term>
+                <listitem>
+                    <para>
+                        строка: путь (например: <emphasis role="italic">/products/scilab</emphasis>)
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>query</term>
+                <listitem>
+                    <para>
+                        строка: запрос (например: <emphasis role="italic">?SearchText=plot3d</emphasis>)
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>username</term>
+                <listitem>
+                    <para>
+                        строка: имя пользователя (например: <emphasis role="italic">username:pass</emphasis>)
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>port</term>
+                <listitem>
+                    <para>
+                        целое число: порт (например: <emphasis role="italic">80</emphasis>)
+                    </para>
+                    <para>
+                        <note>
+                            Заметьте, что, если порт не указан в URL, то это значение будет 0.
+                        </note>
+                    </para>
+                </listitem>
+            </varlistentry>
+            <varlistentry>
+                <term>fragment</term>
+                <listitem>
+                    <para>
+                        строка: фрагмент (например: <emphasis role="italic">#chapter1</emphasis>)
+                    </para>
+                    <para>
+                        Фрагмент, также называемый якорем, используется для создания 
+                        закладок внутри HTML-документа.
+                    </para>
+                </listitem>
+            </varlistentry>
+        </variablelist>
+    </refsection>
+
+    <refsection>
+        <title>Описание</title>
+
+        <para>Разделяет ссылку URL на составляющие.</para>
+
+        <para>
+            Эта функция основана на <ulink url="http://xmlsoft.org/html/libxml-uri.html#xmlParseURI">библиотеке libxml2 (в частности, функции xmlParseURI)</ulink>.
+        </para>
+
+    </refsection>
+
+    <refsection>
+        <title>Примеры</title>
+
+        <programlisting role="example">
+            [proto, server, path, query, username, port, fragment] = splitURL("http://xmlsoft.org/html/libxml-uri.html#xmlParseURI")
+
+            [proto, server, path] = splitURL("ftp://ftp.free.fr/pub/Distributions_Linux/debian/README")
+
+            [a,b,c,d]=splitURL("http://www.scilab.org/content/search?SearchText=plot")
+
+        </programlisting>
+        <!--
+// This example fails for now (probably a bug on evstr)
+// Retrieve the content and execute it
+[f,content]=getURL("http://fileexchange.scilab.org/toolboxes/161000/1.0/files/cshift.sci")
+evstr(content);
+M = grand(3,4,"uin",0,9);
+cshift(M,1);
+-->
+
+    </refsection>
+
+    <refsection role="see also">
+        <title>Смотрите также</title>
+        <simplelist type="inline">
+            <member>
+                <link linkend="getURL">getURL</link>
+            </member>
+        </simplelist>
+    </refsection>
+
+    <refsection>
+        <title>История</title>
+        <revhistory>
+            <revision>
+                <revnumber>5.5.0</revnumber>
+                <revremark>
+                    Введена функция <literal>splitURL()</literal>.
+                </revremark>
+            </revision>
+        </revhistory>
+    </refsection>
+
+</refentry>