Skip to content

Commit ffc6d02

Browse files
leonardolaraleonardolara
committed
initial translation in reference/dom
1 parent 0e22a4e commit ffc6d02

13 files changed

+1071
-0
lines changed

Diff for: ‎reference/dom/dom/htmldocument/createempty.xml

+93
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,93 @@
1+
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: leonardolara Status: ready -->
2+
<refentry xml:id="dom-htmldocument.createempty" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
3+
<refnamediv>
4+
<refname>Dom\HTMLDocument::createEmpty</refname>
5+
<refpurpose>Cria um documento <acronym>HTML</acronym> vazio</refpurpose>
6+
</refnamediv>
7+
8+
<refsect1 role="description">
9+
&reftitle.description;
10+
<methodsynopsis role="Dom\\HTMLDocument">
11+
<modifier>public</modifier> <modifier>static</modifier> <type>Dom\HTMLDocument</type><methodname>Dom\HTMLDocument::createEmpty</methodname>
12+
<methodparam choice="opt"><type>string</type><parameter>encoding</parameter><initializer>"UTF-8"</initializer></methodparam>
13+
</methodsynopsis>
14+
<simpara>
15+
Cria um documento <acronym>HTML</acronym> vazio sem nenhum elemento.
16+
</simpara>
17+
</refsect1>
18+
19+
<refsect1 role="parameters">
20+
&reftitle.parameters;
21+
<variablelist>
22+
<varlistentry>
23+
<term><parameter>encoding</parameter></term>
24+
<listitem>
25+
<simpara>
26+
A codificação de caracteres do documento, usada para serialização ao
27+
chamar os métodos de salvamento.
28+
</simpara>
29+
</listitem>
30+
</varlistentry>
31+
</variablelist>
32+
</refsect1>
33+
34+
<refsect1 role="returnvalues">
35+
&reftitle.returnvalues;
36+
<simpara>
37+
Um documento <acronym>HTML</acronym> vazio.
38+
</simpara>
39+
</refsect1>
40+
41+
<refsect1 role="examples">
42+
&reftitle.examples;
43+
<example xml:id="dom-htmldocument.createempty.example.basic">
44+
<title>Exemplo de <methodname>Dom\HTMLDocument::createEmpty</methodname></title>
45+
<simpara>
46+
Cria um documento vazio e o serializa.
47+
</simpara>
48+
<programlisting role="php">
49+
<![CDATA[
50+
<?php
51+
$dom = Dom\HTMLDocument::createEmpty();
52+
var_dump($dom->saveHtml());
53+
?>
54+
]]>
55+
</programlisting>
56+
&example.outputs;
57+
<screen>
58+
<![CDATA[
59+
string(0) ""
60+
]]>
61+
</screen>
62+
</example>
63+
</refsect1>
64+
65+
<refsect1 role="seealso">
66+
&reftitle.seealso;
67+
<simplelist>
68+
<member><methodname>Dom\HTMLDocument::createFromString</methodname></member>
69+
<member><methodname>Dom\HTMLDocument::createFromFile</methodname></member>
70+
</simplelist>
71+
</refsect1>
72+
73+
</refentry>
74+
<!-- Keep this comment at the end of the file
75+
Local variables:
76+
mode: sgml
77+
sgml-omittag:t
78+
sgml-shorttag:t
79+
sgml-minimize-attributes:nil
80+
sgml-always-quote-attributes:t
81+
sgml-indent-step:1
82+
sgml-indent-data:t
83+
indent-tabs-mode:nil
84+
sgml-parent-document:nil
85+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
86+
sgml-exposed-tags:nil
87+
sgml-local-catalogs:nil
88+
sgml-local-ecat-files:nil
89+
End:
90+
vim600: syn=xml fen fdm=syntax fdl=2 si
91+
vim: et tw=78 syn=sgml
92+
vi: ts=1 sw=1
93+
-->

Diff for: ‎reference/dom/dom/htmldocument/createfromfile.xml

+105
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,105 @@
1+
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: leonardolara Status: ready -->
2+
<refentry xml:id="dom-htmldocument.createfromfile" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
3+
<refnamediv>
4+
<refname>Dom\HTMLDocument::createFromFile</refname>
5+
<refpurpose>Analisa um documento <acronym>HTML</acronym> a partir de um arquivo</refpurpose>
6+
</refnamediv>
7+
8+
<refsect1 role="description">
9+
&reftitle.description;
10+
<methodsynopsis role="Dom\\HTMLDocument">
11+
<modifier>public</modifier> <modifier>static</modifier> <type>Dom\HTMLDocument</type><methodname>Dom\HTMLDocument::createFromFile</methodname>
12+
<methodparam><type>string</type><parameter>path</parameter></methodparam>
13+
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
14+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>overrideEncoding</parameter><initializer>&null;</initializer></methodparam>
15+
</methodsynopsis>
16+
<simpara>
17+
Analisa um documento <acronym>HTML</acronym> a partir de um arquivo,
18+
de acordo com o padrão vigente.
19+
</simpara>
20+
</refsect1>
21+
22+
<refsect1 role="parameters">
23+
&reftitle.parameters;
24+
<variablelist>
25+
<varlistentry>
26+
<term><parameter>path</parameter></term>
27+
<listitem>
28+
<simpara>
29+
O caminho para o arquivo a ser serializado.
30+
</simpara>
31+
</listitem>
32+
</varlistentry>
33+
<varlistentry>
34+
<term><parameter>options</parameter></term>
35+
<listitem>
36+
&dom.parameter.compliant.options;
37+
</listitem>
38+
</varlistentry>
39+
<varlistentry>
40+
<term><parameter>overrideEncoding</parameter></term>
41+
<listitem>
42+
&dom.parameter.compliant.encoding;
43+
</listitem>
44+
</varlistentry>
45+
</variablelist>
46+
</refsect1>
47+
48+
<refsect1 role="returnvalues">
49+
&reftitle.returnvalues;
50+
<simpara>
51+
O documento analisado como uma instância de <classname>Dom\HTMLDocument</classname>.
52+
</simpara>
53+
</refsect1>
54+
55+
<refsect1 role="errors">
56+
&reftitle.errors;
57+
<itemizedlist>
58+
<listitem>
59+
<simpara>
60+
Lança uma exceção <exceptionname>ValueError</exceptionname> se
61+
<parameter>path</parameter> contiver bytes nulos ou contiver
62+
<literal>"%00"</literal>.
63+
</simpara>
64+
</listitem>
65+
&dom.errors.compliant.common;
66+
<listitem>
67+
<simpara>
68+
Lança uma <exceptionname>Exception</exceptionname> se
69+
o arquivo não puder ser aberto.
70+
</simpara>
71+
</listitem>
72+
</itemizedlist>
73+
</refsect1>
74+
75+
&dom.parser.compliant.note.whitespace;
76+
77+
<refsect1 role="seealso">
78+
&reftitle.seealso;
79+
<simplelist>
80+
<member><methodname>Dom\HTMLDocument::createEmpty</methodname></member>
81+
<member><methodname>Dom\HTMLDocument::createFromString</methodname></member>
82+
</simplelist>
83+
</refsect1>
84+
85+
</refentry>
86+
<!-- Keep this comment at the end of the file
87+
Local variables:
88+
mode: sgml
89+
sgml-omittag:t
90+
sgml-shorttag:t
91+
sgml-minimize-attributes:nil
92+
sgml-always-quote-attributes:t
93+
sgml-indent-step:1
94+
sgml-indent-data:t
95+
indent-tabs-mode:nil
96+
sgml-parent-document:nil
97+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
98+
sgml-exposed-tags:nil
99+
sgml-local-catalogs:nil
100+
sgml-local-ecat-files:nil
101+
End:
102+
vim600: syn=xml fen fdm=syntax fdl=2 si
103+
vim: et tw=78 syn=sgml
104+
vi: ts=1 sw=1
105+
-->

Diff for: ‎reference/dom/dom/htmldocument/createfromstring.xml

+126
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,126 @@
1+
<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: leonardolara Status: ready -->
2+
<refentry xml:id="dom-htmldocument.createfromstring" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
3+
<refnamediv>
4+
<refname>Dom\HTMLDocument::createFromString</refname>
5+
<refpurpose>Analisa um documento <acronym>HTML</acronym> a partir de uma string</refpurpose>
6+
</refnamediv>
7+
8+
<refsect1 role="description">
9+
&reftitle.description;
10+
<methodsynopsis role="Dom\\HTMLDocument">
11+
<modifier>public</modifier> <modifier>static</modifier> <type>Dom\HTMLDocument</type><methodname>Dom\HTMLDocument::createFromString</methodname>
12+
<methodparam><type>string</type><parameter>source</parameter></methodparam>
13+
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
14+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>overrideEncoding</parameter><initializer>&null;</initializer></methodparam>
15+
</methodsynopsis>
16+
<simpara>
17+
Analisa um documento <acronym>HTML</acronym> a partir de uma string,
18+
de acordo com o padrão vigente.
19+
</simpara>
20+
</refsect1>
21+
22+
<refsect1 role="parameters">
23+
&reftitle.parameters;
24+
<variablelist>
25+
<varlistentry>
26+
<term><parameter>source</parameter></term>
27+
<listitem>
28+
<simpara>
29+
A string contendo o <acronym>HTML</acronym> a ser analisado.
30+
</simpara>
31+
</listitem>
32+
</varlistentry>
33+
<varlistentry>
34+
<term><parameter>options</parameter></term>
35+
<listitem>
36+
&dom.parameter.compliant.options;
37+
</listitem>
38+
</varlistentry>
39+
<varlistentry>
40+
<term><parameter>overrideEncoding</parameter></term>
41+
<listitem>
42+
&dom.parameter.compliant.encoding;
43+
</listitem>
44+
</varlistentry>
45+
</variablelist>
46+
</refsect1>
47+
48+
<refsect1 role="returnvalues">
49+
&reftitle.returnvalues;
50+
<simpara>
51+
O documento analisado como uma instância de <classname>Dom\HTMLDocument</classname>.
52+
</simpara>
53+
</refsect1>
54+
55+
<refsect1 role="errors">
56+
&reftitle.errors;
57+
<itemizedlist>
58+
&dom.errors.compliant.common;
59+
</itemizedlist>
60+
</refsect1>
61+
62+
<refsect1 role="examples">
63+
&reftitle.examples;
64+
<example xml:id="dom-htmldocument.createfromstring.example.basic">
65+
<title>Exemplo de <methodname>Dom\HTMLDocument::createFromString</methodname></title>
66+
<simpara>
67+
Analisa um documento.
68+
</simpara>
69+
<programlisting role="php">
70+
<![CDATA[
71+
<?php
72+
$dom = Dom\HTMLDocument::createFromString(<<<'HTML'
73+
<!DOCTYPE html>
74+
<html>
75+
<body>
76+
<p>Hello, world!</p>
77+
</body>
78+
</html>
79+
HTML);
80+
echo $dom->saveHtml();
81+
?>
82+
]]>
83+
</programlisting>
84+
&example.outputs;
85+
<screen>
86+
<![CDATA[
87+
<!DOCTYPE html><html><head></head><body>
88+
<p>Hello, world!</p>
89+
90+
</body></html>
91+
]]>
92+
</screen>
93+
</example>
94+
</refsect1>
95+
96+
&dom.parser.compliant.note.whitespace;
97+
98+
<refsect1 role="seealso">
99+
&reftitle.seealso;
100+
<simplelist>
101+
<member><methodname>Dom\HTMLDocument::createEmpty</methodname></member>
102+
<member><methodname>Dom\HTMLDocument::createFromFile</methodname></member>
103+
</simplelist>
104+
</refsect1>
105+
106+
</refentry>
107+
<!-- Keep this comment at the end of the file
108+
Local variables:
109+
mode: sgml
110+
sgml-omittag:t
111+
sgml-shorttag:t
112+
sgml-minimize-attributes:nil
113+
sgml-always-quote-attributes:t
114+
sgml-indent-step:1
115+
sgml-indent-data:t
116+
indent-tabs-mode:nil
117+
sgml-parent-document:nil
118+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
119+
sgml-exposed-tags:nil
120+
sgml-local-catalogs:nil
121+
sgml-local-ecat-files:nil
122+
End:
123+
vim600: syn=xml fen fdm=syntax fdl=2 si
124+
vim: et tw=78 syn=sgml
125+
vi: ts=1 sw=1
126+
-->

0 commit comments

Comments
 (0)