Skip to content

Commit b976c2b

Browse files
Fan2ShrekFan2Shrek
authored
Translate new Dom\HTMLDocument (#1993)
1 parent 9be03bb commit b976c2b

File tree

7 files changed

+668
-0
lines changed

7 files changed

+668
-0
lines changed

‎reference/dom/dom/htmldocument/createempty.xml‎

Lines changed: 95 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,95 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: Fan2Shrek Status: ready -->
3+
<!-- Reviewed: yes -->
4+
<refentry xml:id="dom-htmldocument.createempty" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>Dom\HTMLDocument::createEmpty</refname>
7+
<refpurpose>Créer un document <acronym>HTML</acronym> vide</refpurpose>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis role="Dom\\HTMLDocument">
13+
<modifier>public</modifier> <modifier>static</modifier> <type>Dom\HTMLDocument</type><methodname>Dom\HTMLDocument::createEmpty</methodname>
14+
<methodparam choice="opt"><type>string</type><parameter>encoding</parameter><initializer>"UTF-8"</initializer></methodparam>
15+
</methodsynopsis>
16+
<simpara>
17+
Créer un document <acronym>HTML</acronym> vide sans aucun élément.
18+
</simpara>
19+
</refsect1>
20+
21+
<refsect1 role="parameters">
22+
&reftitle.parameters;
23+
<variablelist>
24+
<varlistentry>
25+
<term><parameter>encoding</parameter></term>
26+
<listitem>
27+
<simpara>
28+
Le jeu de caractères du document, utilisé pour la sérialisation lors
29+
de l'appel des méthodes de sauvegarde.
30+
</simpara>
31+
</listitem>
32+
</varlistentry>
33+
</variablelist>
34+
</refsect1>
35+
36+
<refsect1 role="returnvalues">
37+
&reftitle.returnvalues;
38+
<simpara>
39+
Un document <acronym>HTML</acronym> vide.
40+
</simpara>
41+
</refsect1>
42+
43+
<refsect1 role="examples">
44+
&reftitle.examples;
45+
<example xml:id="dom-htmldocument.createempty.example.basic">
46+
<title>Exemple de <methodname>Dom\HTMLDocument::createEmpty</methodname></title>
47+
<simpara>
48+
Créer un document vide et le sérialiser.
49+
</simpara>
50+
<programlisting role="php">
51+
<![CDATA[
52+
<?php
53+
$dom = Dom\HTMLDocument::createEmpty();
54+
var_dump($dom->saveHtml());
55+
?>
56+
]]>
57+
</programlisting>
58+
&example.outputs;
59+
<screen>
60+
<![CDATA[
61+
string(0) ""
62+
]]>
63+
</screen>
64+
</example>
65+
</refsect1>
66+
67+
<refsect1 role="seealso">
68+
&reftitle.seealso;
69+
<simplelist>
70+
<member><methodname>Dom\HTMLDocument::createFromString</methodname></member>
71+
<member><methodname>Dom\HTMLDocument::createFromFile</methodname></member>
72+
</simplelist>
73+
</refsect1>
74+
75+
</refentry>
76+
<!-- Keep this comment at the end of the file
77+
Local variables:
78+
mode: sgml
79+
sgml-omittag:t
80+
sgml-shorttag:t
81+
sgml-minimize-attributes:nil
82+
sgml-always-quote-attributes:t
83+
sgml-indent-step:1
84+
sgml-indent-data:t
85+
indent-tabs-mode:nil
86+
sgml-parent-document:nil
87+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
88+
sgml-exposed-tags:nil
89+
sgml-local-catalogs:nil
90+
sgml-local-ecat-files:nil
91+
End:
92+
vim600: syn=xml fen fdm=syntax fdl=2 si
93+
vim: et tw=78 syn=sgml
94+
vi: ts=1 sw=1
95+
-->

‎reference/dom/dom/htmldocument/createfromfile.xml‎

Lines changed: 107 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,107 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: a8b6f4dd3a23875b066d4e47ea4a4977a63e0655 Maintainer: Fan2Shrek Status: ready -->
3+
<!-- Reviewed: yes -->
4+
<refentry xml:id="dom-htmldocument.createfromfile" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>Dom\HTMLDocument::createFromFile</refname>
7+
<refpurpose>Analyse un document <acronym>HTML</acronym> à partir d'un fichier</refpurpose>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis role="Dom\\HTMLDocument">
13+
<modifier>public</modifier> <modifier>static</modifier> <type>Dom\HTMLDocument</type><methodname>Dom\HTMLDocument::createFromFile</methodname>
14+
<methodparam><type>string</type><parameter>path</parameter></methodparam>
15+
<methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam>
16+
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>overrideEncoding</parameter><initializer>&null;</initializer></methodparam>
17+
</methodsynopsis>
18+
<simpara>
19+
Analyse un document <acronym>HTML</acronym> à partir d'un fichier,
20+
selon la norme en vigueur.
21+
</simpara>
22+
</refsect1>
23+
24+
<refsect1 role="parameters">
25+
&reftitle.parameters;
26+
<variablelist>
27+
<varlistentry>
28+
<term><parameter>path</parameter></term>
29+
<listitem>
30+
<simpara>
31+
Le chemin du fichier à analyser.
32+
</simpara>
33+
</listitem>
34+
</varlistentry>
35+
<varlistentry>
36+
<term><parameter>options</parameter></term>
37+
<listitem>
38+
&dom.parameter.compliant.options;
39+
</listitem>
40+
</varlistentry>
41+
<varlistentry>
42+
<term><parameter>overrideEncoding</parameter></term>
43+
<listitem>
44+
&dom.parameter.compliant.encoding;
45+
</listitem>
46+
</varlistentry>
47+
</variablelist>
48+
</refsect1>
49+
50+
<refsect1 role="returnvalues">
51+
&reftitle.returnvalues;
52+
<simpara>
53+
Le document analysé sous la forme d'une instance de <classname>Dom\HTMLDocument</classname>.
54+
</simpara>
55+
</refsect1>
56+
57+
<refsect1 role="errors">
58+
&reftitle.errors;
59+
<itemizedlist>
60+
<listitem>
61+
<simpara>
62+
Lève une <exceptionname>ValueError</exceptionname> si
63+
<parameter>path</parameter> contient des octets nuls ou contient
64+
<literal>"%00"</literal>.
65+
</simpara>
66+
</listitem>
67+
&dom.errors.compliant.common;
68+
<listitem>
69+
<simpara>
70+
Lève une <exceptionname>ValueError</exceptionname> si
71+
le fichier n'a pas pu être ouvert.
72+
</simpara>
73+
</listitem>
74+
</itemizedlist>
75+
</refsect1>
76+
77+
&dom.parser.compliant.note.whitespace;
78+
79+
<refsect1 role="seealso">
80+
&reftitle.seealso;
81+
<simplelist>
82+
<member><methodname>Dom\HTMLDocument::createEmpty</methodname></member>
83+
<member><methodname>Dom\HTMLDocument::createFromString</methodname></member>
84+
</simplelist>
85+
</refsect1>
86+
87+
</refentry>
88+
<!-- Keep this comment at the end of the file
89+
Local variables:
90+
mode: sgml
91+
sgml-omittag:t
92+
sgml-shorttag:t
93+
sgml-minimize-attributes:nil
94+
sgml-always-quote-attributes:t
95+
sgml-indent-step:1
96+
sgml-indent-data:t
97+
indent-tabs-mode:nil
98+
sgml-parent-document:nil
99+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
100+
sgml-exposed-tags:nil
101+
sgml-local-catalogs:nil
102+
sgml-local-ecat-files:nil
103+
End:
104+
vim600: syn=xml fen fdm=syntax fdl=2 si
105+
vim: et tw=78 syn=sgml
106+
vi: ts=1 sw=1
107+
-->

‎reference/dom/dom/htmldocument/createfromstring.xml‎

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

0 commit comments

Comments
 (0)