Skip to content

Commit db9717b

Browse files
saundefinedsaundefined
committed
docs(ru): Updated to English revision
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@350615 c90b9560-bf6c-de11-be94-00142212c4b1
1 parent 1986587 commit db9717b

7 files changed

+175
-13
lines changed

‎reference/xmlwriter/functions/xmlwriter-open-uri.xml

Lines changed: 30 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 343917 Maintainer: mch Status: ready -->
2+
<!-- EN-Revision: 350601 Maintainer: mch Status: ready -->
33
<!-- $Revision$ -->
44
<!-- Reviewed: yes Maintainer: sergey -->
55
<!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
@@ -52,6 +52,35 @@
5252
</para>
5353
</refsect1>
5454

55+
<refsect1 role="examples">
56+
&reftitle.examples;
57+
<example xml:id="xmlwriter-open-uri.example.basic">
58+
<title>Прямой вывод XML</title>
59+
<para>
60+
Можно напрямую выводить XML, используя
61+
<link linkend="wrappers.php.output">обертку потока php://output</link>.
62+
</para>
63+
<programlisting role="php">
64+
<![CDATA[
65+
<?php
66+
$out =new XMLWriter();
67+
$out->openURI('php://output');
68+
?>
69+
]]>
70+
</programlisting>
71+
</example>
72+
</refsect1>
73+
74+
<refsect1 role="notes">
75+
&reftitle.notes;
76+
<note>
77+
<para>
78+
В Windows файлы, открытые с помощью этой функции, блокируются до тех пор, пока средство записи
79+
не будет освобождено.
80+
</para>
81+
</note>
82+
</refsect1>
83+
5584
<refsect1 role="seealso">
5685
&reftitle.seealso;
5786
<para>

‎reference/xmlwriter/functions/xmlwriter-set-indent-string.xml

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 322205 Maintainer: mch Status: ready -->
2+
<!-- EN-Revision: 350602 Maintainer: mch Status: ready -->
33
<!-- $Revision$ -->
44
<!-- Reviewed: yes Maintainer: sergey -->
55
<!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
@@ -43,14 +43,26 @@
4343
</variablelist>
4444
</para>
4545
</refsect1>
46-
46+
4747
<refsect1 role="returnvalues">
4848
&reftitle.returnvalues;
4949
<para>
5050
&return.success;
5151
</para>
5252
</refsect1>
53-
53+
54+
<refsect1 role="notes">
55+
&reftitle.notes;
56+
<note>
57+
<para>
58+
Отступ сбрасывается при открытии xmlwriter.
59+
</para>
60+
</note>
61+
&note.language-construct;
62+
&note.not-bin-safe;
63+
&note.registerglobals;
64+
</refsect1>
65+
5466
<refsect1 role="seealso">
5567
&reftitle.seealso;
5668
<para>
@@ -59,7 +71,7 @@
5971
</simplelist>
6072
</para>
6173
</refsect1>
62-
74+
6375
</refentry>
6476

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

‎reference/xmlwriter/functions/xmlwriter-set-indent.xml

Lines changed: 13 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 322205 Maintainer: mch Status: ready -->
2+
<!-- EN-Revision: 350602 Maintainer: mch Status: ready -->
33
<!-- $Revision$ -->
44
<!-- Reviewed: yes Maintainer: sergey -->
55
<!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
@@ -49,6 +49,18 @@
4949
&return.success;
5050
</para>
5151
</refsect1>
52+
53+
<refsect1 role="notes">
54+
&reftitle.notes;
55+
<note>
56+
<para>
57+
Отступ сбрасывается при открытии xmlwriter.
58+
</para>
59+
</note>
60+
&note.language-construct;
61+
&note.not-bin-safe;
62+
&note.registerglobals;
63+
</refsect1>
5264

5365
<refsect1 role="seealso">
5466
&reftitle.seealso;

‎reference/xmlwriter/functions/xmlwriter-start-attribute.xml

Lines changed: 29 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 343917 Maintainer: mch Status: ready -->
2+
<!-- EN-Revision: 350603 Maintainer: mch Status: ready -->
33
<!-- $Revision$ -->
44
<!-- Reviewed: yes Maintainer: sergey -->
55
<!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
@@ -50,6 +50,34 @@
5050
</para>
5151
</refsect1>
5252

53+
<refsect1 role="examples">
54+
&reftitle.examples;
55+
<example xml:id="xmlwriter-start-attribute.example.basic">
56+
<title>Пример базового использования <methodname>XMLWriter::startAttribute</methodname></title>
57+
<programlisting role="php">
58+
<![CDATA[
59+
<?php
60+
$writer = new XMLWriter;
61+
$writer->openURI('php://output');
62+
$writer->startDocument('1.0', 'UTF-8');?>
63+
$writer->startElement('element');
64+
$writer->startAttribute('attribute');
65+
$writer->text('value');
66+
$writer->endAttribute();
67+
$writer->endElement();
68+
$writer->endDocument();
69+
]]>
70+
</programlisting>
71+
&example.outputs.similar;
72+
<screen>
73+
<![CDATA[
74+
<?xml version="1.0" encoding="UTF-8"?>
75+
<element attribute="value"/>
76+
]]>
77+
</screen>
78+
</example>
79+
</refsect1>
80+
5381
<refsect1 role="seealso">
5482
&reftitle.seealso;
5583
<para>

‎reference/xmlwriter/functions/xmlwriter-text.xml

Lines changed: 8 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 322205 Maintainer: mch Status: ready -->
2+
<!-- EN-Revision: 350604 Maintainer: mch Status: ready -->
33
<!-- $Revision$ -->
44
<!-- Reviewed: yes Maintainer: sergey -->
55
<!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
@@ -36,6 +36,13 @@
3636
<listitem>
3737
<para>
3838
Содержимое текста.
39+
Символы <literal>&lt;</literal>, <literal>&gt;</literal>,
40+
<literal>&amp;</literal> и <literal>"</literal> записываются как
41+
ссылки на сущности (т.е. <literal>&amp;lt;</literal>, <literal>&amp;gt;</literal>,
42+
<literal>&amp;amp;</literal> и <literal>&amp;quot;</literal>, соответственно).
43+
Все остальные символы в том числе <literal>&apos;</literal> записываются буквально.
44+
Чтобы записывать специальные символы XML буквально или записывать буквальные ссылки на сущности,
45+
необходимо использовать <function>xmlwriter_write_raw</function>.
3946
</para>
4047
</listitem>
4148
</varlistentry>

‎reference/xmlwriter/functions/xmlwriter-write-attribute.xml

Lines changed: 38 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 343917 Maintainer: mch Status: ready -->
2+
<!-- EN-Revision: 350605 Maintainer: mch Status: ready -->
33
<!-- $Revision$ -->
44
<!-- Reviewed: yes Maintainer: sergey -->
55
<!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
@@ -52,14 +52,48 @@
5252
</variablelist>
5353
</para>
5454
</refsect1>
55-
55+
5656
<refsect1 role="returnvalues">
5757
&reftitle.returnvalues;
5858
<para>
5959
&return.success;
6060
</para>
6161
</refsect1>
62+
63+
<refsect1 role="examples">
64+
&reftitle.examples;
65+
<example xml:id="xmlwriter-write-attribute.example.intermix">
66+
<title>Перемешивание подэлементов и атрибутов</title>
67+
<para>
68+
Если запись подэлементов и атрибутов смешана, любая попытка записи
69+
атрибутов после первого подэлемента завершится ошибкой и вернет false.
70+
</para>
71+
<programlisting role="php">
72+
<![CDATA[
73+
<?php
74+
$xml = new XMLWriter();
75+
$xml->openMemory();
76+
77+
$xml->startElement('element');
78+
$xml->writeAttribute('attr1', '0');
79+
$xml->writeElement('subelem', '0');
80+
var_dump($xml->writeAttribute('attr2', '0'));
81+
$xml->endElement();
6282
83+
echo $xml->flush();
84+
?>
85+
]]>
86+
</programlisting>
87+
&example.outputs;
88+
<screen>
89+
<![CDATA[
90+
bool(false)
91+
<element attr1="0"><subelem>0</subelem></element>
92+
]]>
93+
</screen>
94+
</example>
95+
</refsect1>
96+
6397
<refsect1 role="seealso">
6498
&reftitle.seealso;
6599
<para>
@@ -71,8 +105,8 @@
71105
</simplelist>
72106
</para>
73107
</refsect1>
74-
75-
108+
109+
76110
</refentry>
77111

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

‎reference/xmlwriter/functions/xmlwriter-write-cdata.xml

Lines changed: 41 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
<?xml version="1.0" encoding="utf-8"?>
2-
<!-- EN-Revision: 343350 Maintainer: mch Status: ready -->
2+
<!-- EN-Revision: 350606 Maintainer: mch Status: ready -->
33
<!-- $Revision$ -->
44
<!-- Reviewed: yes Maintainer: sergey -->
55
<!-- Generated by xml_proto.php v2.4. Found in /scripts directory of phpdoc. -->
@@ -50,6 +50,46 @@
5050
</para>
5151
</refsect1>
5252

53+
<refsect1 role="examples">
54+
&reftitle.examples;
55+
<example xml:id="xmlwriter-write-cdata.example.basic">
56+
<title>Базовое использование <function>xmlwriter_write_cdata</function></title>
57+
<programlisting role="php">
58+
<![CDATA[
59+
<?php
60+
// настроить документ
61+
$xml = new XmlWriter();
62+
$xml->openMemory();
63+
$xml->setIndent(true);
64+
$xml->startDocument('1.0', 'UTF-8');
65+
$xml->startElement('mydoc');
66+
$xml->startElement('myele');
67+
68+
// вывод CData
69+
$xml->startElement('mycdataelement');
70+
$xml->writeCData("текст для включения как CData");
71+
$xml->endElement();
72+
73+
// завершить документ и вывести
74+
$xml->endElement();
75+
$xml->endElement();
76+
echo $xml->outputMemory(true);
77+
?>
78+
]]>
79+
</programlisting>
80+
&example.outputs;
81+
<screen>
82+
<![CDATA[
83+
<mydoc>
84+
<myele>
85+
<mycdataelement><![CDATA[текст для включения как CData]​]></mycdataelement>
86+
</myele>
87+
</mydoc>
88+
]]>
89+
</screen>
90+
</example>
91+
</refsect1>
92+
5393
<refsect1 role="seealso">
5494
&reftitle.seealso;
5595
<para>

0 commit comments

Comments
 (0)