Skip to content

Commit 1d403e4

Browse files
PhilDaiguillePhilDaiguille
authored
add translate page dom (#224)
1 parent 3b72767 commit 1d403e4

110 files changed

Lines changed: 9671 additions & 0 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎reference/dom/dom/dom/attr/isid.xml‎

Lines changed: 77 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,77 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: c1f37a6c270aadbbb3da56a3973ffd62197adf2b Maintainer: PhilDaiguille Status: ready -->
3+
<!-- Reviewed: no -->
4+
<refentry xml:id="dom-attr.isid" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
5+
<refnamediv>
6+
<refname>Dom\Attr::isId</refname>
7+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domattr.isid')/db:refnamediv/db:refpurpose)"/>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis role="Dom\\Attr">
13+
<modifier>public</modifier> <type>bool</type><methodname>Dom\Attr::isId</methodname>
14+
<void/>
15+
</methodsynopsis>
16+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domattr.isid')/db:refsect1[@role='description']/db:para[1])"/>
17+
<simpara>
18+
Según la norma DOM esto requiere un DTD que defina el atributo ID
19+
como de tipo ID. Para utilizar este método, el documento debe
20+
ser validado en el momento del análisis pasando
21+
<constant>LIBXML_DTDVALID</constant> como opción.
22+
</simpara>
23+
</refsect1>
24+
25+
<refsect1 role="parameters">
26+
&reftitle.parameters;
27+
&no.function.parameters;
28+
</refsect1>
29+
30+
<refsect1 role="returnvalues">
31+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domattr.isid')/db:refsect1[@role='returnvalues']/*)">
32+
<xi:fallback/>
33+
</xi:include>
34+
</refsect1>
35+
36+
<refsect1 role="examples">
37+
&reftitle.examples;
38+
<example>
39+
<title>Ejemplo de Dom\Attr::isId()</title>
40+
<programlisting role="php">
41+
<![CDATA[
42+
<?php
43+
44+
// Se debe validar el documento antes de referirse al id
45+
$doc = Dom\XMLDocument::createFromFile('examples/book-docbook.xml', LIBXML_DTDVALID);
46+
47+
// Se obtiene el atributo llamado id del elemento chapter
48+
$attr = $doc->getElementsByTagName('chapter')->item(0)->getAttributeNode('id');
49+
50+
var_dump($attr->isId()); // bool(true)
51+
52+
?>
53+
]]>
54+
</programlisting>
55+
</example>
56+
</refsect1>
57+
</refentry>
58+
<!-- Keep this comment at the end of the file
59+
Local variables:
60+
mode: sgml
61+
sgml-omittag:t
62+
sgml-shorttag:t
63+
sgml-minimize-attributes:nil
64+
sgml-always-quote-attributes:t
65+
sgml-indent-step:1
66+
sgml-indent-data:t
67+
indent-tabs-mode:nil
68+
sgml-parent-document:nil
69+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
70+
sgml-exposed-tags:nil
71+
sgml-local-catalogs:nil
72+
sgml-local-ecat-files:nil
73+
End:
74+
vim600: syn=xml fen fdm=syntax fdl=2 si
75+
vim: et tw=78 syn=sgml
76+
vi: ts=1 sw=1
77+
-->

‎reference/dom/dom/dom/attr/rename.xml‎

Lines changed: 176 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,176 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 2c9920402e11ecdc75f604e0d23c23fab1c75b74 Maintainer: PhilDaiguille Status: ready -->
3+
<!-- Reviewed: no -->
4+
<refentry xml:id="dom-attr.rename" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>Dom\Attr::rename</refname>
7+
<refpurpose>Cambia el nombre calificado o el espacio de nombres de un atributo</refpurpose>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis role="Dom\\Attr">
13+
<modifier>public</modifier> <type>void</type><methodname>Dom\Attr::rename</methodname>
14+
<methodparam><type class="union"><type>string</type><type>null</type></type><parameter>namespaceURI</parameter></methodparam>
15+
<methodparam><type>string</type><parameter>qualifiedName</parameter></methodparam>
16+
</methodsynopsis>
17+
<simpara>
18+
Este método cambia el nombre calificado o el espacio de nombres de un atributo.
19+
</simpara>
20+
</refsect1>
21+
22+
<refsect1 role="parameters">
23+
&reftitle.parameters;
24+
<variablelist>
25+
<varlistentry>
26+
<term><parameter>namespaceURI</parameter></term>
27+
<listitem>
28+
<simpara>
29+
El nuevo espacio de nombres <acronym>URI</acronym> del atributo.
30+
</simpara>
31+
</listitem>
32+
</varlistentry>
33+
<varlistentry>
34+
<term><parameter>qualifiedName</parameter></term>
35+
<listitem>
36+
<simpara>
37+
El nuevo nombre calificado del atributo.
38+
</simpara>
39+
</listitem>
40+
</varlistentry>
41+
</variablelist>
42+
</refsect1>
43+
44+
<refsect1 role="returnvalues">
45+
&reftitle.returnvalues;
46+
<simpara>
47+
&return.void;
48+
</simpara>
49+
</refsect1>
50+
51+
<refsect1 role="errors">
52+
&reftitle.errors;
53+
<variablelist>
54+
<varlistentry>
55+
<term><classname>DOMException</classname> con el código <constant>Dom\NAMESPACE_ERR</constant></term>
56+
<listitem>
57+
<simpara>
58+
Lanzada si hay un error con el espacio de nombres, tal como se determina por
59+
<parameter>qualifiedName</parameter>.
60+
</simpara>
61+
</listitem>
62+
</varlistentry>
63+
<varlistentry>
64+
<term><classname>DOMException</classname> con el código <constant>Dom\INVALID_MODIFICATION_ERR</constant></term>
65+
<listitem>
66+
<simpara>
67+
Lanzada si un atributo ya existe en el elemento con el mismo
68+
nombre calificado.
69+
</simpara>
70+
</listitem>
71+
</varlistentry>
72+
</variablelist>
73+
</refsect1>
74+
75+
<refsect1 role="examples">
76+
&reftitle.examples;
77+
<example xml:id="dom-attr.rename.example.basic">
78+
<title>Ejemplo de <methodname>Dom\Attr::rename</methodname> para cambiar el espacio de nombres y el nombre calificado</title>
79+
<simpara>
80+
Esto cambia el nombre calificado de <literal>my-attr</literal> a
81+
<literal>my-new-attr</literal> y también cambia su espacio de nombres a
82+
<literal>urn:my-ns</literal>.
83+
</simpara>
84+
<programlisting role="php">
85+
<![CDATA[
86+
<?php
87+
88+
$doc = Dom\XMLDocument::createFromString('<root my-attr="value"/>');
89+
90+
$root = $doc->documentElement;
91+
$attribute = $root->attributes['my-attr'];
92+
$attribute->rename('urn:my-ns', 'my-new-attr');
93+
94+
echo $doc->saveXml();
95+
96+
?>
97+
]]>
98+
</programlisting>
99+
&example.outputs;
100+
<screen>
101+
<![CDATA[
102+
<?xml version="1.0" encoding="UTF-8"?>
103+
<root xmlns:ns1="urn:my-ns" ns1:my-new-attr="value"/>
104+
]]>
105+
</screen>
106+
</example>
107+
<example xml:id="dom-attr.rename.example.only-name">
108+
<title>Ejemplo de <methodname>Dom\Attr::rename</methodname> para cambiar solo el nombre calificado</title>
109+
<simpara>
110+
Esto cambia solo el nombre calificado de <literal>my-attr</literal>
111+
y mantiene el espacio de nombres <acronym>URI</acronym> sin cambios.
112+
</simpara>
113+
<programlisting role="php">
114+
<![CDATA[
115+
<?php
116+
117+
$doc = Dom\XMLDocument::createFromString('<root my-attr="value"/>');
118+
119+
$root = $doc->documentElement;
120+
$attribute = $root->attributes['my-attr'];
121+
$attribute->rename($attribute->namespaceURI, 'my-new-attr');
122+
123+
echo $doc->saveXml();
124+
125+
?>
126+
]]>
127+
</programlisting>
128+
&example.outputs;
129+
<screen>
130+
<![CDATA[
131+
<?xml version="1.0" encoding="UTF-8"?>
132+
<root my-new-attr="value"/>
133+
]]>
134+
</screen>
135+
</example>
136+
</refsect1>
137+
138+
<refsect1 role="notes">
139+
&reftitle.notes;
140+
<note>
141+
<simpara>
142+
A veces es necesario cambiar el nombre calificado y el espacio de nombres
143+
<acronym>URI</acronym> juntos en un solo paso para no infringir
144+
las reglas de los espacios de nombres.
145+
</simpara>
146+
</note>
147+
</refsect1>
148+
149+
<refsect1 role="seealso">
150+
&reftitle.seealso;
151+
<simplelist>
152+
<member><methodname>Dom\Element::rename</methodname></member>
153+
</simplelist>
154+
</refsect1>
155+
156+
</refentry>
157+
<!-- Keep this comment at the end of the file
158+
Local variables:
159+
mode: sgml
160+
sgml-omittag:t
161+
sgml-shorttag:t
162+
sgml-minimize-attributes:nil
163+
sgml-always-quote-attributes:t
164+
sgml-indent-step:1
165+
sgml-indent-data:t
166+
indent-tabs-mode:nil
167+
sgml-parent-document:nil
168+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
169+
sgml-exposed-tags:nil
170+
sgml-local-catalogs:nil
171+
sgml-local-ecat-files:nil
172+
End:
173+
vim600: syn=xml fen fdm=syntax fdl=2 si
174+
vim: et tw=78 syn=sgml
175+
vi: ts=1 sw=1
176+
-->

‎reference/dom/dom/dom/characterdata/after.xml‎

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 8c0d111851c38647956dc6a4527746787dd606eb Maintainer: PhilDaiguille Status: ready -->
3+
<!-- Reviewed: no -->
4+
<refentry xml:id="dom-characterdata.after" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
5+
<refnamediv>
6+
<refname>Dom\CharacterData::after</refname>
7+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.after')/db:refnamediv/db:refpurpose)"/>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis role="Dom\\CharacterData">
13+
<modifier>public</modifier> <type>void</type><methodname>Dom\CharacterData::after</methodname>
14+
<methodparam rep="repeat"><type class="union"><type>Dom\Node</type><type>string</type></type><parameter>nodes</parameter></methodparam>
15+
</methodsynopsis>
16+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.after')/db:refsect1[@role='description']/db:para[1])"/>
17+
</refsect1>
18+
19+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domchildnode.after')/db:refsect1[@role='parameters'])" />
20+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domchildnode.after')/db:refsect1[@role='returnvalues'])" />
21+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domchildnode.after')/db:refsect1[@role='errors'])" />
22+
23+
<refsect1 role="examples">
24+
&reftitle.examples;
25+
<example xml:id="dom-characterdata.after.example.basic">
26+
<title>Ejemplo de <methodname>Dom\CharacterData::after</methodname></title>
27+
<simpara>
28+
Añade nodos después de los datos de caracteres.
29+
</simpara>
30+
<programlisting role="php">
31+
<![CDATA[
32+
<?php
33+
$doc = Dom\XMLDocument::createFromString("<container><![CDATA[hello]]]]><![CDATA[></container>");
34+
$cdata = $doc->documentElement->firstChild;
35+
36+
$cdata->after("beautiful", $doc->createElement("world"));
37+
38+
echo $doc->saveXML();
39+
?>
40+
]]>
41+
</programlisting>
42+
&example.outputs;
43+
<screen>
44+
<![CDATA[
45+
<?xml version="1.0" encoding="UTF-8"?>
46+
<container><![CDATA[hello]]]]><![CDATA[>beautiful<world/></container>
47+
]]>
48+
</screen>
49+
</example>
50+
</refsect1>
51+
52+
<refsect1 role="seealso">
53+
&reftitle.seealso;
54+
<simplelist>
55+
<member><methodname>Dom\ChildNode::after</methodname></member>
56+
<member><methodname>Dom\CharacterData::before</methodname></member>
57+
</simplelist>
58+
</refsect1>
59+
60+
</refentry>
61+
<!-- Keep this comment at the end of the file
62+
Local variables:
63+
mode: sgml
64+
sgml-omittag:t
65+
sgml-shorttag:t
66+
sgml-minimize-attributes:nil
67+
sgml-always-quote-attributes:t
68+
sgml-indent-step:1
69+
sgml-indent-data:t
70+
indent-tabs-mode:nil
71+
sgml-parent-document:nil
72+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
73+
sgml-exposed-tags:nil
74+
sgml-local-catalogs:nil
75+
sgml-local-ecat-files:nil
76+
End:
77+
vim600: syn=xml fen fdm=syntax fdl=2 si
78+
vim: et tw=78 syn=sgml
79+
vi: ts=1 sw=1
80+
-->

‎reference/dom/dom/dom/characterdata/appenddata.xml‎

Lines changed: 52 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,52 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 8c0d111851c38647956dc6a4527746787dd606eb Maintainer: PhilDaiguille Status: ready -->
3+
<!-- Reviewed: no -->
4+
<refentry xml:id="dom-characterdata.appenddata" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
5+
<refnamediv>
6+
<refname>Dom\CharacterData::appendData</refname>
7+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.appenddata')/db:refnamediv/db:refpurpose)"/>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis role="Dom\\CharacterData">
13+
<modifier>public</modifier> <type>void</type><methodname>Dom\CharacterData::appendData</methodname>
14+
<methodparam><type>string</type><parameter>data</parameter></methodparam>
15+
</methodsynopsis>
16+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.appenddata')/db:refsect1[@role='description']/db:para[1])"/>
17+
</refsect1>
18+
19+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.appenddata')/db:refsect1[@role='parameters'])" />
20+
<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.appenddata')/db:refsect1[@role='returnvalues'])" />
21+
22+
<refsect1 role="seealso">
23+
&reftitle.seealso;
24+
<simplelist>
25+
<member><methodname>Dom\CharacterData::deleteData</methodname></member>
26+
<member><methodname>Dom\CharacterData::insertData</methodname></member>
27+
<member><methodname>Dom\CharacterData::replaceData</methodname></member>
28+
<member><methodname>Dom\CharacterData::substringData</methodname></member>
29+
</simplelist>
30+
</refsect1>
31+
32+
</refentry>
33+
<!-- Keep this comment at the end of the file
34+
Local variables:
35+
mode: sgml
36+
sgml-omittag:t
37+
sgml-shorttag:t
38+
sgml-minimize-attributes:nil
39+
sgml-always-quote-attributes:t
40+
sgml-indent-step:1
41+
sgml-indent-data:t
42+
indent-tabs-mode:nil
43+
sgml-parent-document:nil
44+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
45+
sgml-exposed-tags:nil
46+
sgml-local-catalogs:nil
47+
sgml-local-ecat-files:nil
48+
End:
49+
vim600: syn=xml fen fdm=syntax fdl=2 si
50+
vim: et tw=78 syn=sgml
51+
vi: ts=1 sw=1
52+
-->

0 commit comments

Comments
 (0)