initial translation in reference/dom/dom

reference/dom/dom/attr/isid.xml

@@ -0,0 +1,75 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 2c9920402e11ecdc75f604e0d23c23fab1c75b74 Maintainer: leonardolara Status: ready -->
+<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">
+ <refnamediv>
+  <refname>Dom\Attr::isId</refname>
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domattr.isid')/db:refnamediv/db:refpurpose)"/>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis role="Dom\\Attr">
+   <modifier>public</modifier> <type>bool</type><methodname>Dom\Attr::isId</methodname>
+   <void/>
+  </methodsynopsis>
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domattr.isid')/db:refsect1[@role='description']/db:para[1])"/>
+  <simpara>
+   De acordo com o padrão DOM, isso requer um DTD que defina o
+   ID do atributo como sendo do tipo ID. Para utilizar este método o documento
+   deve ser validado no momento da análise passando
+   <constant>LIBXML_DTDVALID</constant> como uma opção.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  &no.function.parameters;
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domattr.isid')/db:refsect1[@role='returnvalues']/*)">
+   <xi:fallback/>
+  </xi:include>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example>
+   <title>Exemplo de Dom\Attr::isId()</title>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+// É necessário validar o documento antes de referir ao seu id
+$doc = Dom\XMLDocument::createFromFile('book.xml', LIBXML_DTDVALID);
+
+// Recuperando o atributo denominado id do elemento chapter
+$attr = $doc->getElementsByTagName('chapter')->item(0)->getAttributeNode('id');
+
+var_dump($attr->isId()); // bool(true)
+
+?>
+]]>
+   </programlisting>
+  </example>
+ </refsect1>
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

reference/dom/dom/attr/rename.xml

@@ -0,0 +1,174 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 2c9920402e11ecdc75f604e0d23c23fab1c75b74 Maintainer: leonardolara Status: ready -->
+<refentry xml:id="dom-attr.rename" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <refnamediv>
+  <refname>Dom\Attr::rename</refname>
+  <refpurpose>Altera o nome qualificado ou namespace de um atributo</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis role="Dom\\Attr">
+   <modifier>public</modifier> <type>void</type><methodname>Dom\Attr::rename</methodname>
+   <methodparam><type class="union"><type>string</type><type>null</type></type><parameter>namespaceURI</parameter></methodparam>
+   <methodparam><type>string</type><parameter>qualifiedName</parameter></methodparam>
+  </methodsynopsis>
+  <simpara>
+   Este método altera o nome qualificado ou namespace de um atributo.
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <variablelist>
+   <varlistentry>
+    <term><parameter>namespaceURI</parameter></term>
+    <listitem>
+     <simpara>
+      O novo <acronym>URI</acronym> de namespace do atributo.
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><parameter>qualifiedName</parameter></term>
+    <listitem>
+     <simpara>
+      O novo nome qualificado do atributo.
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <simpara>
+   &return.void;
+  </simpara>
+ </refsect1>
+
+ <refsect1 role="errors">
+  &reftitle.errors;
+  <variablelist>
+   <varlistentry>
+    <term><classname>DOMException</classname> com código <constant>Dom\NAMESPACE_ERR</constant></term>
+    <listitem>
+     <simpara>
+      Gerado se houver um erro no namespace, conforme determinado por
+      <parameter>qualifiedName</parameter>.
+     </simpara>
+    </listitem>
+   </varlistentry>
+   <varlistentry>
+    <term><classname>DOMException</classname> com código <constant>Dom\INVALID_MODIFICATION_ERR</constant></term>
+    <listitem>
+     <simpara>
+      Gerado se já existir um atributo no elemento com o mesmo
+      nome qualificado.
+     </simpara>
+    </listitem>
+   </varlistentry>
+  </variablelist>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="dom-attr.rename.example.basic">
+   <title>Exemplo de <methodname>Dom\Attr::rename</methodname> para alterar o namespace e o nome qualificado</title>
+   <simpara>
+    Isto altera o nome qualificado de <literal>my-attr</literal> para
+    <literal>my-new-attr</literal> e também altera seu namespace para
+    <literal>urn:my-ns</literal>.
+   </simpara>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+$doc = Dom\XMLDocument::createFromString('<root my-attr="value"/>');
+
+$root = $doc->documentElement;
+$attribute = $root->attributes['my-attr'];
+$attribute->rename('urn:my-ns', 'my-new-attr');
+
+echo $doc->saveXml();
+
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+<?xml version="1.0" encoding="UTF-8"?>
+<root xmlns:ns1="urn:my-ns" ns1:my-new-attr="value"/>
+]]>
+   </screen>
+  </example>
+  <example xml:id="dom-attr.rename.example.only-name">
+   <title>Exemplo de <methodname>Dom\Attr::rename</methodname> para alterar somente o nome qualificado</title>
+   <simpara>
+    Isto apenas altera o nome qualificado de <literal>my-attr</literal>
+    e mantém o namespace <acronym>URI</acronym> igual.
+   </simpara>
+   <programlisting role="php">
+<![CDATA[
+<?php
+
+$doc = Dom\XMLDocument::createFromString('<root my-attr="value"/>');
+
+$root = $doc->documentElement;
+$attribute = $root->attributes['my-attr'];
+$attribute->rename($attribute->namespaceURI, 'my-new-attr');
+
+echo $doc->saveXml();
+
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+<?xml version="1.0" encoding="UTF-8"?>
+<root my-new-attr="value"/>
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <simpara>
+    Às vezes é necessário alterar o nome qualificado e o <acronym>URI</acronym>
+    do namespace juntos em uma única etapa para não quebrar
+    nenhuma regra do namespace.
+   </simpara>
+  </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><methodname>Dom\Element::rename</methodname></member>
+  </simplelist>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

reference/dom/dom/characterdata/after.xml

@@ -0,0 +1,78 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 2c9920402e11ecdc75f604e0d23c23fab1c75b74 Maintainer: leonardolara Status: ready -->
+<refentry xml:id="dom-characterdata.after" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <refnamediv>
+  <refname>Dom\CharacterData::after</refname>
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.after')/db:refnamediv/db:refpurpose)"/>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis role="Dom\\CharacterData">
+   <modifier>public</modifier> <type>void</type><methodname>Dom\CharacterData::after</methodname>
+   <methodparam rep="repeat"><type class="union"><type>Dom\Node</type><type>string</type></type><parameter>nodes</parameter></methodparam>
+  </methodsynopsis>
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.after')/db:refsect1[@role='description']/db:para[1])"/>
+ </refsect1>
+
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domchildnode.after')/db:refsect1[@role='parameters'])" />
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domchildnode.after')/db:refsect1[@role='returnvalues'])" />
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domchildnode.after')/db:refsect1[@role='errors'])" />
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <example xml:id="dom-characterdata.after.example.basic">
+   <title>Exemplo de <methodname>Dom\CharacterData::after</methodname></title>
+   <simpara>
+    Adiciona nós após os dados de caracteres.
+   </simpara>
+   <programlisting role="php">
+<![CDATA[
+<?php
+$doc = Dom\XMLDocument::createFromString("<container><![CDATA[hello]]]]><![CDATA[></container>");
+$cdata = $doc->documentElement->firstChild;
+
+$cdata->after("beautiful", $doc->createElement("world"));
+
+echo $doc->saveXML();
+?>
+]]>
+   </programlisting>
+   &example.outputs;
+   <screen>
+<![CDATA[
+<?xml version="1.0" encoding="UTF-8"?>
+<container><![CDATA[hello]]]]><![CDATA[>beautiful<world/></container>
+]]>
+   </screen>
+  </example>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><methodname>Dom\ChildNode::after</methodname></member>
+   <member><methodname>Dom\CharacterData::before</methodname></member>
+  </simplelist>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->

reference/dom/dom/characterdata/appenddata.xml

@@ -0,0 +1,50 @@
+<?xml version="1.0" encoding="utf-8"?><!-- EN-Revision: 2c9920402e11ecdc75f604e0d23c23fab1c75b74 Maintainer: leonardolara Status: ready -->
+<refentry xml:id="dom-characterdata.appenddata" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
+ <refnamediv>
+  <refname>Dom\CharacterData::appendData</refname>
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.appenddata')/db:refnamediv/db:refpurpose)"/>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis role="Dom\\CharacterData">
+   <modifier>public</modifier> <type>void</type><methodname>Dom\CharacterData::appendData</methodname>
+   <methodparam><type>string</type><parameter>data</parameter></methodparam>
+  </methodsynopsis>
+  <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.appenddata')/db:refsect1[@role='description']/db:para[1])"/>
+ </refsect1>
+
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.appenddata')/db:refsect1[@role='parameters'])" />
+ <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('domcharacterdata.appenddata')/db:refsect1[@role='returnvalues'])" />
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <simplelist>
+   <member><methodname>Dom\CharacterData::deleteData</methodname></member>
+   <member><methodname>Dom\CharacterData::insertData</methodname></member>
+   <member><methodname>Dom\CharacterData::replaceData</methodname></member>
+   <member><methodname>Dom\CharacterData::substringData</methodname></member>
+  </simplelist>
+ </refsect1>
+
+</refentry>
+<!-- Keep this comment at the end of the file
+Local variables:
+mode: sgml
+sgml-omittag:t
+sgml-shorttag:t
+sgml-minimize-attributes:nil
+sgml-always-quote-attributes:t
+sgml-indent-step:1
+sgml-indent-data:t
+indent-tabs-mode:nil
+sgml-parent-document:nil
+sgml-default-dtd-file:"~/.phpdoc/manual.ced"
+sgml-exposed-tags:nil
+sgml-local-catalogs:nil
+sgml-local-ecat-files:nil
+End:
+vim600: syn=xml fen fdm=syntax fdl=2 si
+vim: et tw=78 syn=sgml
+vi: ts=1 sw=1
+-->