svn: /phpdoc/ru/trunk/language/ basic-syntax.xml

Modified: phpdoc/ru/trunk/language/basic-syntax.xml
===================================================================
--- phpdoc/ru/trunk/language/basic-syntax.xml	2020-11-19 08:40:57 UTC (rev 351448)
+++ phpdoc/ru/trunk/language/basic-syntax.xml	2020-11-19 11:30:40 UTC (rev 351449)
@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 351112 Maintainer: shein Status: ready -->
+<!-- EN-Revision: 351340 Maintainer: shein Status: ready -->
 <!-- Reviewed: yes -->
 <!-- $Revision$ -->
 <chapter xml:id="language.basic-syntax" xmlns="http://docbook.org/ns/docbook">
@@ -15,17 +15,46 @@
    открывающих и закрывающих тегов, будет проигнорировано парсером PHP.
   </para>

-   <para>
-    PHP включает в себя короткий echo-тег <literal>&lt;?=</literal>, который является сокращением для более многословного <code>&lt;?php echo</code>.
-   </para>
+  <para>
+   PHP включает в себя короткий echo-тег <literal>&lt;?=</literal>, который является сокращением для более многословного <code>&lt;?php echo</code>.
+  </para>

   <para>
-   PHP также допускает короткий открывающий тег <literal>&lt;?</literal>,
-   однако использовать их нежелательно, так как они доступны только если включены с помощью
-   конфигурационной директивы &php.ini; <link linkend="ini.short-open-tag">short_open_tag</link>,
-   либо если PHP был сконфигурирован с опцией <option>--enable-short-tags</option>.
+   <example>
+    <title>Открывающие и закрывающие теги PHP</title>
+    <programlisting role="php">
+<![CDATA[
+1.  <?php echo 'если вы хотите хранить код PHP в документах XHTML или XML,
+                то используйте эти теги'; ?>
+
+2. Вы можете использовать короткий 'echo'-тег чтобы <?= 'напечатать эту строку' ?>.
+    Этот тег эквивалентен такому коду
+    <?php echo 'напечатать эту строку' ?>.
+
+3.  <? echo 'этот код с короткими тегами, но он будет работать только если '.
+                'включена опция "short_open_tag"'; ?>
+]]>
+    </programlisting>
+   </example>
   </para>
+
   <para>
+   Короткие теги (третий пример) доступны по умолчанию, но их можно отключить
+   с помощью директивы <link linkend="ini.short-open-tag">short_open_tag</link> в
+   конфигурационном файле &php.ini; или отключены по умолчанию, если
+   PHP был скомпилирован с опцией <option>--disable-short-tags</option>.
+  </para>
+  <para>
+   <note>
+    <para>
+     Поскольку короткие теги можно отключить, рекомендуется использовать только обычные
+     теги (<code>&lt;?php ?&gt;</code> and <code>&lt;?= ?&gt;</code>)
+     для максимальной совместимости.
+    </para>
+   </note>
+  </para>
+
+  <para>
    Если файл содержит только код PHP, предпочтительно опустить закрывающий тег в
    конце файла. Это помогает избежать добавления случайных символов пробела или перевода
    строки после закрывающего тега PHP, которые могут послужить причиной нежелательных
@@ -47,6 +76,7 @@
    </informalexample>
   </para>
  </sect1>
+
  <sect1 xml:id="language.basic-syntax.phpmode">
   <title>Изолирование от HTML</title>
   <para>
@@ -60,22 +90,22 @@
 <?php echo 'А это будет обработано.'; ?>
 <p>Это тоже будет проигнорировано PHP и отображено браузером.</p>
 ]]>
-     </programlisting>
-    </informalexample>
-    Это работает так, как и ожидается, потому что когда интерпретатор PHP встречает закрывающие теги ?&gt;,
-    он просто начинает выводить все что найдет (за исключением сразу следующего
-    символа перевода строки - смотрите раздел
-    <link linkend="language.basic-syntax.instruction-separation">разделение инструкций</link>)
-    пока не встретит другой открывающий тег за исключением случая с
-    содержащимся внутри кода условным оператором, в котором интерпретатор определяет результат
-    условия перед принятием решения что пропустить.
-    Ознакомьтесь со следующим примером.
-   </para>
-   <para>
-    Использование структур с условиями
-    <example>
-     <title>Продвинутое изолирование с использованием условий</title>
-     <programlisting role="php">
+    </programlisting>
+   </informalexample>
+   Это работает так, как и ожидается, потому что когда интерпретатор PHP встречает закрывающие теги ?&gt;,
+   он просто начинает выводить все что найдет (за исключением сразу следующего
+   символа перевода строки - смотрите раздел
+   <link linkend="language.basic-syntax.instruction-separation">разделение инструкций</link>)
+   пока не встретит другой открывающий тег за исключением случая с
+   содержащимся внутри кода условным оператором, в котором интерпретатор определяет результат
+   условия перед принятием решения что пропустить.
+   Ознакомьтесь со следующим примером.
+  </para>
+  <para>
+   Использование структур с условиями
+   <example>
+    <title>Продвинутое изолирование с использованием условий</title>
+    <programlisting role="php">
 <![CDATA[
 <?php if ($expression == true): ?>
   Это будет отображено, если выражение истинно.
@@ -83,73 +113,62 @@
   В ином случае будет отображено это.
 <?php endif; ?>
 ]]>
-     </programlisting>
-    </example>
-    В этом примере PHP пропускает блоки, где условие не соблюдается. Даже
-    несмотря на то, что они находятся вне пары открывающих/закрывающих тегов, PHP
-    пропустит их в соответствии с условием, так как интерпретатор PHP будет перепрыгивать через
-    блоки, содержащиеся внутри условия, которое не соблюдается.
-   </para>
-   <para>
-    При выводе больших блоков текста выход из режима синтаксического разбора PHP
-    обычно более эффективен, чем отправка текста с помощью функций
-    <function>echo</function> или <function>print</function>.
-   </para>
-   <para>
-    Также есть короткий echo-тег <code>&lt;?= ?&gt;</code>.
-   </para>
-   <para>
-    <note>
-     <para>
-      Кроме того, если вы намереваетесь вставлять PHP-код в XML или XHTML,
-      чтобы соответствовать XML стандартам, вам следует использовать форму
-      &lt;?php ?&gt;.
-     </para>
-    </note>
-   </para>
+    </programlisting>
+   </example>
+   В этом примере PHP пропускает блоки, где условие не соблюдается. Даже
+   несмотря на то, что они находятся вне пары открывающих/закрывающих тегов, PHP
+   пропустит их в соответствии с условием, так как интерпретатор PHP будет перепрыгивать через
+   блоки, содержащиеся внутри условия, которое не соблюдается.
+  </para>
+  <para>
+   При выводе больших блоков текста выход из режима синтаксического разбора PHP
+   обычно более эффективен, чем отправка текста с помощью функций
+   <function>echo</function> или <function>print</function>.
+  </para>
+  <para>
+   <note>
+    <para>
+     Кроме того, если вы намереваетесь вставлять PHP-код в XML или XHTML,
+     чтобы соответствовать XML стандартам, вам следует использовать форму
+     &lt;?php ?&gt;.
+    </para>
+   </note>
+  </para>
+ </sect1>
+
+ <sect1 xml:id="language.basic-syntax.instruction-separation">
+  <title>Разделение инструкций</title>
+  <para>
+   Как в C или Perl, PHP требует окончания инструкций точкой запятой в конце
+   каждой инструкции. Закрывающий тег блока PHP-кода автоматически применяет
+   точку с запятой; т.е. нет необходимости ставить точку с запятой в конце последней
+   строки блока с PHP-кодом. Закрывающий тег блока "поглотит" немедленно следующий
+   за ним переход на новую строку, если таковой будет обнаружен.
+  </para>

-   <para>
+  <para>
     <example>
-     <title>Открывающие и закрывающие теги PHP</title>
+     <title>Пример, показывающий закрывающий тег, охватывающий завершающую новую строку</title>
      <programlisting role="php">
 <![CDATA[
-1.  <?php echo 'если вы хотите хранить код PHP в документах XHTML или XML,
-                то используйте эти теги'; ?>
-
-2. Вы можете использовать короткий 'echo'-тег чтобы <?= 'напечатать эту строку' ?>.
-    Этот тег эквивалентен такому коду
-    <?php echo 'напечатать эту строку' ?>.
-
-3.  <? echo 'этот код с короткими тегами, но он будет работать только если '.
-                'включена опция "short_open_tag"'; ?>
+<?php echo "Какой-то текст"; ?>
+Нет новой строки
+<?= "А сейчас, новая строка" ?>
 ]]>
      </programlisting>
+     &example.outputs;
+     <screen>
+<![CDATA[
+Какой-то текстНет новой строки
+А сейчас, новая строка
+]]>
+     </screen>
     </example>
    </para>
-   <para>
-    Короткие теги (третий пример) доступны по умолчанию, но их можно отключить
-    с помощью директивы <link linkend="ini.short-open-tag">short_open_tag</link> в
-    конфигурационном файле &php.ini; или отключены по умолчанию, если
-    PHP был скомпилирован с опцией <option>--disable-short-tags</option>.
-   </para>
-   <para>
-    <note>
-     <para>
-      Поскольку короткие теги можно отключить, рекомендуется использовать только обычные
-      теги (<code>&lt;?php ?&gt;</code> and <code>&lt;?= ?&gt;</code>)
-      для максимальной совместимости.
-     </para>
-    </note>
-   </para>
- </sect1>
- <sect1 xml:id="language.basic-syntax.instruction-separation">
-  <title>Разделение инструкций</title>
+
   <para>
-   Как в C или Perl, PHP требует окончания инструкций точкой запятой в конце
-   каждой инструкции. Закрывающий тег блока PHP-кода автоматически применяет
-   точку с запятой; т.е. нет необходимости ставить точку с запятой в конце последней
-   строки блока с PHP-кодом. Закрывающий тег блока "поглотит" немедленно следующий
-   за ним переход на новую строку, если таковой будет обнаружен.
+   Примеры входа и выхода из парсера PHP:
+
    <informalexample>
     <programlisting role="php">
 <![CDATA[
@@ -210,8 +229,8 @@
 <h1>Это <?php # echo "простой";?> пример</h1>
 <p>Заголовок вверху выведет 'Это пример'.</p>
 ]]>
-     </programlisting>
-    </informalexample>
+    </programlisting>
+   </informalexample>
    </para>
    <simpara>
     'C'-комментарии заканчиваются при первой же обнаруженной последовательности
@@ -229,8 +248,8 @@
  */
 ?>
 ]]>
-     </programlisting>
-    </informalexample>
+    </programlisting>
+   </informalexample>
    </para>
  </sect1>
 </chapter>