svn: /phpdoc/ru/trunk/reference/com/ book.xml com.xml dotnet.xml error-handling.xml examples.xml ini.xml reference.xml setup.xml variant.xml
[email protected] (Sergey Panteleev)
| Newsgroups | php.doc.ru |
|---|---|
| Message-ID | <[email protected]> |
sergey Tue, 01 Oct 2019 13:09:32 +0000
Revision: http://svn.php.net/viewvc?view=revision&revision=348114
Log:
docs(ru): Review
Changed paths:
U phpdoc/ru/trunk/reference/com/book.xml
U phpdoc/ru/trunk/reference/com/com.xml
U phpdoc/ru/trunk/reference/com/dotnet.xml
U phpdoc/ru/trunk/reference/com/error-handling.xml
U phpdoc/ru/trunk/reference/com/examples.xml
U phpdoc/ru/trunk/reference/com/ini.xml
U phpdoc/ru/trunk/reference/com/reference.xml
U phpdoc/ru/trunk/reference/com/setup.xml
U phpdoc/ru/trunk/reference/com/variant.xml
svn-diffs-348114.txt
(text/x-diff, 19.8 KB)
Modified: phpdoc/ru/trunk/reference/com/book.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/book.xml 2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/book.xml 2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 347691 Maintainer: mch Status: ready-->
<!-- $Revision$ -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<book xml:id="book.com" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="bundled" ?>
@@ -26,13 +26,13 @@
Подмножество COM, известное как OLE Automation, включает набор
COM-интерфейсов, которые позволяют осуществлять легкое связывание COM-объектов, также любой
объект можно проанализировать и вызывать во время работы без знания о деталях его работы
- на этапе компиляции. PHP-расширение COM использует интерфейсы OLE Automation,
+ на этапе компиляции. PHP-модуль COM использует интерфейсы OLE Automation,
позволяющие вам создавать и вызывать совместимые объекты из ваших скриптов.
- Говоря техническим языком, это следовало бы назвать "<literal>Расширение OLE Automation для PHP</literal>",
+ Говоря техническим языком, это следовало бы назвать "<literal>Модуль OLE Automation для PHP</literal>",
так как не все COM-объекты являются OLE-совместимыми.
</para>
<para>
- Теперь, почему вам следует использовать COM ? COM — один из основных способов
+ Теперь, почему вам следует использовать COM? COM — один из основных способов
склеить вместе приложения и компоненты на платформе Windows. Используя
COM, вы можете запустить Microsoft Word, заполнить шаблон документа и сохранить
результаты как документ Word, и затем отправить посетителю вашего веб-сайта. Вы также можете
@@ -40,7 +40,7 @@
вашего IIS-сервера. Это только обычные применения, с COM вы сможете больше.
</para>
<para>
- Дополнительно расширение поддерживает создание экземпляра
+ Дополнительно модуль поддерживает создание экземпляра
класса и создание .NET-сборок, используя слой взаимодействия с COM,
предоставляемый Miсrosoft.
</para>
Modified: phpdoc/ru/trunk/reference/com/com.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/com.xml 2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/com.xml 2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 347690 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<!-- splitted from ./en/functions/com.xml, last change in rev 1.12 -->
<phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.com" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
@@ -52,7 +52,7 @@
<title>Перегруженные методы</title>
<para>
Возвращаемые объекты являются перегруженными, то есть PHP
- не видит каких либо фиксированных методов, как это происходит
+ не видит каких-либо фиксированных методов, как это происходит
с обычными классами. Вместо этого свойства и доступ к методам
передается через COM.
</para>
@@ -60,13 +60,13 @@
PHP автоматически определяет методы, которые
обращаются к свойствам по ссылкам и автоматически преобразуют
стандартные переменные PHP в вид, который можно передавать по ссылке.
- Это означает, что вы можете вызывать методы не внося каких либо
+ Это означает, что вы можете вызывать методы не внося каких-либо
дополнений в свой код.
</para>
</section>
<section xml:id="class.com.examples">
- <title>Примеры COM</title>
+ <title>Примеры использования COM</title>
<para>
<example xml:id="example.com1">
<title>Первый пример</title>
@@ -74,8 +74,8 @@
<![CDATA[
<?php
// запускаем word
-$word = new COM("word.application") or die("Unable to instantiate Word");
-echo "Loaded Word, version {$word->Version}\n";
+$word = new COM("word.application") or die("Невозможно создать экземпляр Word");
+echo "Загружен Word, версия {$word->Version}\n";
//делаем его активным окном
$word->Visible = 1;
@@ -84,8 +84,8 @@
$word->Documents->Add();
//Что то с ним делаем
-$word->Selection->TypeText("This is a test...");
-$word->Documents[1]->SaveAs("Useless test.doc");
+$word->Selection->TypeText("Это проверка...");
+$word->Documents[1]->SaveAs("Бесполезный тест.doc");
//закрываем word
$word->Quit();
Modified: phpdoc/ru/trunk/reference/com/dotnet.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/dotnet.xml 2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/dotnet.xml 2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 347690 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.dotnet" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<titleabbrev>DOTNET</titleabbrev>
@@ -57,7 +57,7 @@
<title>Перегруженные методы</title>
<para>
Возвращаемый объект является перегруженным, то есть PHP
- не видит каких либо фиксированных методов, как это происходит
+ не видит каких-либо фиксированных методов, как это происходит
с обычными классами; вместо этого свойства и доступ к методам
передается через COM, а оттуда в
DOTNET. Другими словами, объект .Net отображается через уровень взаимодействия COM,
@@ -79,7 +79,7 @@
<?php
$stack = new DOTNET("mscorlib", "System.Collections.Stack");
$stack->Push(".Net");
-$stack->Push("Hello ");
+$stack->Push("Привет ");
echo $stack->Pop() . $stack->Pop();
?>
]]>
Modified: phpdoc/ru/trunk/reference/com/error-handling.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/error-handling.xml 2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/error-handling.xml 2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,14 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 347691 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<chapter xml:id="com.error-handling" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Ошибки и их обработка</title>
<para>
- Это расширение вызывает исключения класса <classname>com_exception</classname>
+ Модуль выбрасывает исключения класса <classname>com_exception</classname>
в случае потенциальной фатальной ошибки возвращенной COM.
- Исключения COM имеют четко определенное свойство<literal>code</literal>,
+ Исключения COM имеют четко определенное свойство <literal>code</literal>,
соответствующее возвращенному из различных операций COM значению HRESULT.
На основании этого кода вы можете построить логику обработки данных ошибок.
</para>
Modified: phpdoc/ru/trunk/reference/com/examples.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/examples.xml 2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/examples.xml 2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 347687 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<chapter xml:id="com.examples" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.examples;
@@ -9,7 +9,7 @@
<title>For Each</title>
<para>
Вы можете использовать конструкцию &foreach; для итерации
- контента стандартного COM/OLE IEnumVariant. Другими словами,
+ контента стандартного COM/OLE IEnumVariant. Другими словами,
это означает, что вы можете использовать foreach там, где вы использовали
<literal>For Each</literal> в коде VB/ASP.
</para>
@@ -56,7 +56,7 @@
<itemizedlist>
<listitem>
<para>
- Доступ к многомерным массивам или свойствам COM используя
+ Доступ к многомерным массивам или свойствам COM, используя
синтаксис доступа к массивам. Также вы можете записывать и
создавать свойства таким же образом.
</para>
@@ -63,7 +63,7 @@
</listitem>
<listitem>
<para>
- Итерация SafeArray ("настоящие" массивы) используя &foreach;.
+ Итерация SafeArray ("настоящие" массивы), используя &foreach;.
Это работает, поскольку SafeArrays включает в себя информацию о своем размере.
Если свойство реализует IEnumVariant, то вы также можете использовать
для него foreach. Более подробно читайте в разделе
Modified: phpdoc/ru/trunk/reference/com/ini.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/ini.xml 2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/ini.xml 2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 347687 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<section xml:id="com.configuration" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
@@ -86,7 +86,7 @@
Если включено, PHP попробует зарегистрировать константы
библиотеки типов создаваемых объектов <classname>COM</classname>,
если эти объекты реализуют
- интерфейс, требуемый лоя получения данной информации.
+ интерфейс, требуемый для получения данной информации.
Регистрозависимость регистрируемых констант контролируется
<xref
linkend="ini.com.autoregister-casesensitive"/> директивой конфигурации.
@@ -129,7 +129,7 @@
<listitem>
<para>
Контролирует кодировку по умолчанию при передаче строк объектам COM.
- Если задано пустой строкой, PHP будет считать, что вы хотите использовать
+ Если задана пустая строка, PHP будет считать, что вы хотите использовать
<constant>CP_ACP</constant> - системная кодировка ANSI по умолчанию.
</para>
<para>
@@ -136,8 +136,8 @@
Если текст в вашем скрипте содержится в кодировке отличной от
кодировки по умолчанию, то установка этого параметра позволит вам не указывать
кодировку каждый раз при создании объекта класса <xref
- linkend="class.com"/> в его конструкторе. Пожалуйста помните, что
- исполь этой директивы (как и любой другой директивы конфигурации) делает
+ linkend="class.com"/> в его конструкторе. Пожалуйста помните, что
+ использование этой директивы (как и любой другой директивы конфигурации) делает
ваш скрипт менее переносимым, так что все же рекомендуется указывать кодировку
при каждом создании объекта COM.
</para>
@@ -150,7 +150,7 @@
</term>
<listitem>
<para>
- Значение должно соответствовать пути на файловой системе до
+ Значение должно соответствовать пути в файловой системе до
файла, содержащего список библиотек типов, которые необходимо
загрузить при запуске. Каждая строка файла будет рассматриваться
как имя библиотеки типов, которая будет загружена как только
Modified: phpdoc/ru/trunk/reference/com/reference.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/reference.xml 2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/reference.xml 2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 341294 Maintainer: mch Status: ready -->
<!-- $Revision$ -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<reference xml:id="ref.com" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
- <title>COM &Functions;</title>
+ <title>&Functions; COM</title>
<partintro>
<section xml:id="com.seealso">
Modified: phpdoc/ru/trunk/reference/com/setup.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/setup.xml 2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/setup.xml 2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 347693 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<chapter xml:id="com.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
@@ -21,12 +21,12 @@
<section xml:id="com.installation">
&reftitle.install;
<para>
- С PHP 5.3.15 / 5.4.5, это расширение требует разрешение
+ С PHP 5.3.15 / 5.4.5, модуль требует включение
<filename>php_com_dotnet.dll</filename> в &php.ini;. В предыдущих версиях
- PHP это расширение было включено по умолчанию.
+ PHP модуль был включен по умолчанию.
</para>
<para>
- Поддержку для различных вариантов объектов COM (например MS Word) необходимо
+ Поддержку для различных вариантов объектов COM (например, MS Word) необходимо
устанавливать самостоятельно. Мы не можем и не будем включать все эти модули в PHP.
</para>
</section>
Modified: phpdoc/ru/trunk/reference/com/variant.xml
===================================================================
--- phpdoc/ru/trunk/reference/com/variant.xml 2019-10-01 11:04:59 UTC (rev 348113)
+++ phpdoc/ru/trunk/reference/com/variant.xml 2019-10-01 13:09:32 UTC (rev 348114)
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 347688 Maintainer: rjhdby Status: ready -->
-<!-- Reviewed: no -->
+<!-- Reviewed: yes Maintainer: sergey -->
<!-- $Revision$ -->
<phpdoc:classref xmlns:phpdoc="http://php.net/ns/phpdoc" xml:id="class.variant" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
<titleabbrev>VARIANT</titleabbrev>
@@ -13,8 +13,8 @@
<para>
VARIANT - это эквивалент zval для COM; это структура, которая может
содержать значения различных допустимых типов. Класс VARIANT
- входит в расширение COM и позволяет более полно контролировать
- значения передаваемые от PHP к COM и обратно.
+ входит в модуль COM и позволяет больше контролировать
+ значения, передаваемые от PHP к COM и обратно.
</para>
</section>
<!-- }}} -->
@@ -67,8 +67,8 @@
к потере информации. Во всех остальных случаях результат вернется в виде
экземпляра класса VARIANT. Вы можете принудительно указать PHP
конвертировать значения в типы PHP используя оператор приведения типов
- или же преобразовывать их в строку используя функцию <function>print</function>.
- Вы можете использовать множество функций класса для арефметических
+ или же преобразовывать их в строку, используя функцию <function>print</function>.
+ Вы можете использовать множество функций класса для арифметических
операций без приведения значений к типам PHP с риском потери информации.
</para>
</note>