svn: /phpdoc/bg/trunk/reference/strings/functions/ get-html-translation-table.xml

Modified: phpdoc/bg/trunk/reference/strings/functions/get-html-translation-table.xml
===================================================================
--- phpdoc/bg/trunk/reference/strings/functions/get-html-translation-table.xml	2016-03-16 23:55:22 UTC (rev 338761)
+++ phpdoc/bg/trunk/reference/strings/functions/get-html-translation-table.xml	2016-03-17 00:09:57 UTC (rev 338762)
@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: n/a Maintainer: stanprog Status: ready -->
+<!-- EN-Revision: 334762 Maintainer: stanprog Status: ready -->
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.get-html-translation-table">
  <refnamediv>
   <refname>get_html_translation_table</refname>
@@ -12,7 +12,8 @@
   <methodsynopsis>
    <type>array</type><methodname>get_html_translation_table</methodname>
    <methodparam choice="opt"><type>int</type><parameter>table</parameter><initializer>HTML_SPECIALCHARS</initializer></methodparam>
-   <methodparam choice="opt"><type>int</type><parameter>quote_style</parameter><initializer>ENT_COMPAT</initializer></methodparam>
+   <methodparam choice="opt"><type>int</type><parameter>flags</parameter><initializer>ENT_COMPAT | ENT_HTML401</initializer></methodparam>
+   <methodparam choice="opt"><type>string</type><parameter>encoding</parameter><initializer>"UTF-8"</initializer></methodparam>
   </methodsynopsis>
   <para>
    <function>get_html_translation_table</function> връща
@@ -25,7 +26,9 @@
     Специалните знаци могат да бъдат преобразувани по няколко начина, като например
     <literal>"</literal> може да бъде преобразувано до <literal>&amp;quot;</literal>,
     <literal>&amp;#34;</literal> или <literal>&amp;#x22</literal>.
-    <function>get_html_translation_table</function> връща само най-общия им вид.
+    <function>get_html_translation_table</function> връща само вида използван
+    от <function>htmlspecialchars</function> и
+    <function>htmlentities</function>.
    </para>
   </note>
  </refsect1>
@@ -38,25 +41,73 @@
      <term><parameter>table</parameter></term>
      <listitem>
       <para>
-       Има две нови константи (<constant>HTML_ENTITIES</constant>,
-       <constant>HTML_SPECIALCHARS</constant>), които позволяват указването на нужната
-       таблица за преобразуване. Стойността по подразбиране
-       на <parameter>table</parameter> е <constant>HTML_SPECIALCHARS</constant>.
+       Коя таблица да бъде върната. Или <constant>HTML_ENTITIES</constant> или
+       <constant>HTML_SPECIALCHARS</constant>.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
-     <term><parameter>quote_style</parameter></term>
+     <term><parameter>flags</parameter></term>
      <listitem>
       <para>
-       Както при <function>htmlspecialchars</function> и
-       <function>htmlentities</function>, така и тук можете по желание да
-       укажете <parameter>quote_style</parameter> (стила на кавичките).
-       Режимът по подразбиране е <constant>ENT_COMPAT</constant>.
-       Вж. също описанието на тези режими в <function>htmlspecialchars</function>.
+       Побитова маска на един или повече от флаговете по-долу, които указват кои кавички ще
+       съдържа таблицата, както и за кой тип на документ е предназначен. Стойността по подразбиране е
+       <literal>ENT_COMPAT | ENT_HTML401</literal>.
+<table>
+        <title>Available <parameter>flags</parameter> constants</title>
+        <tgroup cols="2">
+         <thead>
+          <row>
+           <entry>Име на константата</entry>
+           <entry>Описание</entry>
+          </row>
+         </thead>
+         <tbody>
+          <row>
+           <entry><constant>ENT_COMPAT</constant></entry>
+           <entry>Таблицата ще съдържа единиците за двойни кавички, но не и за единични кавички.</entry>
+          </row>
+          <row>
+           <entry><constant>ENT_QUOTES</constant></entry>
+           <entry>Таблицата ще съдържа единиците за двойни и единични кавички.</entry>
+          </row>
+          <row>
+           <entry><constant>ENT_NOQUOTES</constant></entry>
+           <entry>Таблицата няма да съдържа единиците нито за двойните, нито за единичните кавички.</entry>
+          </row>
+          <row>
+           <entry><constant>ENT_HTML401</constant></entry>
+           <entry>Таблица за HTML 4.01.</entry>
+          </row>
+          <row>
+           <entry><constant>ENT_XML1</constant></entry>
+           <entry>Таблица за XML 1.</entry>
+          </row>
+          <row>
+           <entry><constant>ENT_XHTML</constant></entry>
+           <entry>TТаблица за XHTML.</entry>
+          </row>
+          <row>
+           <entry><constant>ENT_HTML5</constant></entry>
+           <entry>Таблица за HTML 5.</entry>
+          </row>
+         </tbody>
+        </tgroup>
+       </table>
       </para>
      </listitem>
     </varlistentry>
+    <varlistentry>
+     <term><parameter>encoding</parameter></term>
+     <listitem>
+      <para>
+       Кодирането, което да се използва.
+       Ако тази стойност не е зададена, ще се използва ISO-8859-1 (при
+       версии до PHP 5.4.0) и UTF-8 от PHP 5.4.0 нагоре.
+      </para>
+      &reference.strings.charsets;
+     </listitem>
+    </varlistentry>
    </variablelist>
   </para>
  </refsect1>
@@ -64,10 +115,49 @@
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>
-   Връща таблицата за преобразуване като масив.
+   Връща таблицата за преобразуване като масив с първоначалните знаци
+   като ключове и единици като стойности.
   </para>
  </refsect1>

+ <refsect1 role="changelog">
+  &reftitle.changelog;
+  <para>
+   <informaltable>
+    <tgroup cols="2">
+     <thead>
+      <row>
+       <entry>&Version;</entry>
+       <entry>&Description;</entry>
+      </row>
+     </thead>
+     <tbody>
+      <row>
+       <entry>5.4.0</entry>
+       <entry>
+        Стойността по подразбиране за <parameter>encoding</parameter> е
+        променена на UTF-8.
+       </entry>
+      </row>
+      <row>
+       <entry>5.4.0</entry>
+       <entry>
+        Добавени са константите <constant>ENT_HTML401</constant>, <constant>ENT_XML1</constant>,
+        <constant>ENT_XHTML</constant> и <constant>ENT_HTML5</constant>.
+       </entry>
+      </row>
+      <row>
+       <entry>5.3.4</entry>
+       <entry>
+        Добавен е параметърът <parameter>encoding</parameter>.
+       </entry>
+      </row>
+     </tbody>
+    </tgroup>
+   </informaltable>
+  </para>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
@@ -76,24 +166,39 @@
     <programlisting role="php">
 <![CDATA[
 <?php
-$trans = get_html_translation_table(HTML_ENTITIES);
-$str = "Hallo & <Frau> & Krämer";
-$encoded = strtr($str, $trans);
-
-echo $encoded;
+var_dump(get_html_translation_table(HTML_ENTITIES, ENT_QUOTES | ENT_HTML5));
 ?>
 ]]>
     </programlisting>
-    &example.outputs;
+    &example.outputs.similar;
     <screen>
 <![CDATA[
-Hallo &amp; &lt;Frau&gt; &amp; Kr&auml;mer
+array(1510) {
+  ["
+"]=>
+  string(9) "&NewLine;"
+  ["!"]=>
+  string(6) "&excl;"
+  ["""]=>
+  string(6) "&quot;"
+  ["#"]=>
+  string(5) "&num;"
+  ["$"]=>
+  string(8) "&dollar;"
+  ["%"]=>
+  string(8) "&percnt;"
+  ["&"]=>
+  string(5) "&amp;"
+  ["'"]=>
+  string(6) "&apos;"
+  // ...
+}
 ]]>
     </screen>
    </example>
   </para>
  </refsect1>
-
+
  <refsect1 role="seealso">
   &reftitle.seealso;
   <para>
@@ -104,7 +209,7 @@
    </simplelist>
   </para>
  </refsect1>
-
+
 </refentry>

 <!-- Keep this comment at the end of the file