updated old translations in reference/url/functions

reference/url/functions/get-meta-tags.xml

@@ -0,0 +1,146 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- EN-Revision: 6ecb3d252204d4f7077eb5221209b4eab0216c18 Maintainer: leonardolara Status: ready -->
+<refentry xml:id="function.get-meta-tags" xmlns="http://docbook.org/ns/docbook">
+ <refnamediv>
+  <refname>get_meta_tags</refname>
+  <refpurpose>Extrai todos os atributos de conteúdo de metatags de um arquivo e retorna um array</refpurpose>
+ </refnamediv>
+
+ <refsect1 role="description">
+  &reftitle.description;
+  <methodsynopsis>
+   <type class="union"><type>array</type><type>false</type></type><methodname>get_meta_tags</methodname>
+   <methodparam><type>string</type><parameter>filename</parameter></methodparam>
+   <methodparam choice="opt"><type>bool</type><parameter>use_include_path</parameter><initializer>&false;</initializer></methodparam>
+  </methodsynopsis>
+  <para>
+   Abre o arquivo informado em <parameter>filename</parameter> e analisa-o linha a linha procurando por
+   &lt;meta&gt;-tags. A análise termina em
+   <literal>&lt;/head&gt;</literal>.
+  </para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+  &reftitle.parameters;
+  <para>
+   <variablelist>
+    <varlistentry>
+     <term><parameter>filename</parameter></term>
+     <listitem>
+      <para>
+       O caminho para o arquivo HTML, como uma string. Pode ser um arquivo local ou uma
+       <acronym>URL</acronym>.
+      </para>
+      <para>
+       <example>
+        <title>O que <function>get_meta_tags</function> analisa</title>
+        <programlisting role="html">
+<![CDATA[
+<meta name="author" content="name">
+<meta name="keywords" content="php documentation">
+<meta name="DESCRIPTION" content="a php manual">
+<meta name="geo.position" content="49.33;-86.59">
+</head> <!-- análise termina aqui -->
+]]>
+        </programlisting>
+       </example>
+      </para>
+     </listitem>
+    </varlistentry>
+    <varlistentry>
+     <term><parameter>use_include_path</parameter></term>
+     <listitem>
+      <para>
+       Definir <parameter>use_include_path</parameter> para &true; fará com que
+       o PHP tente abrir o arquivo ao longo do caminho de inclusão padrão de acordo com
+       a diretiva <link linkend="ini.include-path">include_path</link>.
+       Isto é útil para arquivos locais, mas não para URLs.
+      </para>
+     </listitem>
+    </varlistentry>
+   </variablelist>
+  </para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+  &reftitle.returnvalues;
+  <para>
+   Retorna um array com todas as metatags analisadas.
+  </para>
+  <para>
+   O valor da propriedade "name" torna-se a chave, o valor da propriedade "content"
+   torna-se o valor do array retornada, para que se possa usar facilmente
+   funções padrão de arrays para percorrê-lo ou acessar valores únicos.
+   Caracteres especiais no valor da propriedade "name" são substituídos por
+   '_', o restante é convertido para minúsculas. Se duas metatags tiverem o mesmo
+   nome, apenas a última será retornada.
+  </para>
+  <para>
+   Retorna &false; em caso de falha.
+  </para>
+ </refsect1>
+
+ <refsect1 role="examples">
+  &reftitle.examples;
+  <para>
+   <example>
+    <title>O que <function>get_meta_tags</function> retorna</title>
+    <programlisting role="php">
+<![CDATA[
+<?php
+// Assumindo que as tags acima estão em www.example.com
+$tags = get_meta_tags('http://www.example.com/');
+
+// Note qcomo as chaves estão todas em minúsculas agora, e
+// como o ponto (.) foir substituído pelo sublinhado (_) na chave.
+echo $tags['author'];       // name
+echo $tags['keywords'];     // php documentation
+echo $tags['description'];  // a php manual
+echo $tags['geo_position']; // 49.33;-86.59
+?>
+]]>
+    </programlisting>
+   </example>
+  </para>
+ </refsect1>
+
+ <refsect1 role="notes">
+  &reftitle.notes;
+  <note>
+   <para>
+    Somente metatags com atributos "name" serão analisadas. As aspas não são obrigatórias.
+   </para>
+  </note>
+ </refsect1>
+
+ <refsect1 role="seealso">
+  &reftitle.seealso;
+  <para>
+   <simplelist>
+    <member><function>htmlentities</function></member>
+    <member><function>urlencode</function></member>
+   </simplelist>
+  </para>
+ </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
+-->