archived-doc-pt-br/chmonly/search.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: dcd5448282973a659f62e4240fb6e50aae0eb78b Maintainer: leonardolara Status: ready -->
 <chapter xml:id="chm.search" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>A pesquisa de texto completa</title>

  <para>
   Esta edição do Manual do PHP inclui uma possibilidade avançada de pesquisa de texto completo
   fornecida pelo aplicativo visualizador. Isso permite
   que os usuários pesquisem em cada palavra no arquivo de ajuda para encontrar uma
   correspondência. Por exemplo, se um usuário fizer uma pesquisa de texto completo sobre a palavra
   "Apache", todos os tópicos que contêm a palavra "Apache" serão listados.
   A pesquisa avançada de texto completo permite que um usuário pesquise usando expressões booleanas,
   curingas e aninhadas. Um usuário também pode limitar a pesquisa
   a resultados anteriores, corresponder a palavras semelhantes ou pesquisar apenas títulos de tópicos.
  </para>

  <para>
   O uso do recurso de pesquisa é bastante direto. Clique na
   aba de pesquisa, digite as palavras desejadas e pressione ENTER (ou clique
   em "Listar Tópicos"). Então você receberá uma lista de correspondências do
   Manual do PHP (e as notas). Você pode usar o botão com uma
   seta para a direita para adicionar operadores booleanos à sua pesquisa (ou você pode
   digitá-los). Conforme você vê os resultados, você pode usar os títulos das colunas
   (Título, Localização e Classificação) para classificar a lista de tópicos. A ordem padrão
   é por Classificação. Você também pode ajustar alguns parâmetros na parte inferior desta
   aba.
  </para>

  <para>
   As palavras encontradas são destacadas na página atual no painel Tópico
   por padrão. Você pode desativar esse recurso escolhendo o item de menu "Destaque
   de Pesquisa Desativado" no menu Opções. Para obter esse recurso
   de volta de forma semelhante. Se você estiver visualizando um tópico longo, apenas as primeiras 500
   instâncias de uma palavra ou frase de pesquisa serão destacadas, devido a uma
   limitação do visualizador.
  </para>

  <sect1 xml:id="chm.search.rules">
   <title>Regras gerais de pesquisa</title>
   <para>
    Uma pesquisa básica consiste na palavra ou frase que você deseja encontrar. Você
    pode usar expressões curinga, expressões aninhadas, operadores booleanos,
    correspondências de palavras semelhantes, uma lista de resultados anteriores ou títulos de tópicos para
    definir melhor sua pesquisa.
   </para>
   <para>
    As regras básicas para formular consultas são as seguintes:
    <itemizedlist>
     <listitem>
      <simpara>As pesquisas não diferenciam maiúsculas de minúsculas, então você pode digitar sua pesquisa em letras maiúsculas ou minúsculas.</simpara>
     </listitem>
     <listitem>
      <simpara>
       Você pode pesquisar por qualquer combinação de letras (a-z) e números (0-9).
       Você não pode pesquisar por letras únicas (a, b, c, etc.) e as seguintes
       palavras reservadas: an, and, as, at, be, but, by, do, for, from, have, he,
       in, it, not, of, on, or, she, that, the, there, they, this, to, we,
       which, with, you.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Sinais de pontuação como ponto (.), dois pontos (:), ponto e vírgula (;), vírgula (,),
       e hífen (-) são ignorados durante uma pesquisa.
      </simpara>
     </listitem>
     <listitem>
      <simpara>Agrupe os elementos da sua pesquisa usando aspas duplas ou parênteses para separar cada elemento. Você não pode pesquisar por aspas.</simpara>
     </listitem>
    </itemizedlist>
   </para>
   <para>
    <note>
     <para>
      Se você estiver procurando por um nome de arquivo com uma extensão, você deve agrupar
      a string inteira entre aspas duplas, ("arquivo.ext"). Caso contrário, o ponto
      quebrará o nome do arquivo em dois termos separados. A operação padrão
      entre termos é AND, então você criará o equivalente lógico para
      "arquivo AND ext."
     </para>
    </note>
   </para>
  </sect1>

  <sect1 xml:id="chm.search.words">
   <title>Procurando por palavras ou frases</title>
   <para>
    Você pode pesquisar por palavras ou frases e usar expressões curinga.
    As expressões curinga permitem que você pesquise por um ou mais caracteres
    usando um ponto de interrogação ou asterisco. A tabela abaixo descreve os
    resultados desses diferentes tipos de pesquisas.
    <table>
     <title>Pesquisas de palavras e frases</title>
     <tgroup cols="3">
      <thead>
       <row>
        <entry>Procurar</entry>
        <entry>Exemplo</entry>
        <entry>Resultados</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry>Uma única palavra</entry>
        <entry>select</entry>
        <entry>Tópicos que contêm a palavra "select". (Você também encontrará suas variações gramaticais, como "selector" e "selection".)</entry>
       </row>
       <row>
        <entry>Uma frase</entry>
        <entry>"new operator" ou new operator</entry>
        <entry>
         <simpara>
          Tópicos que contêm a frase literal "new operator" e todas as suas variações gramaticais.
         </simpara>
         <simpara>
          Sem as aspas, a consulta é equivalente a especificar "new AND operador", que
          encontrará tópicos contendo ambas as palavras individuais, em vez da frase.
         </simpara>
        </entry>
       </row>
       <row>
        <entry>Expressões curinga</entry>
        <entry>esc* ou HT??</entry>
        <entry>
         <simpara>
          Os resultados para o primeiro exemplo incluem tópicos que contêm os termos "ESC",
          "escape", "escalation" e assim por diante. O asterisco não pode ser o único
          caractere no termo.
         </simpara>
         <simpara>
          Os resultados para o segundo exemplo incluem tópicos que contêm os termos "HTTP",
          "HTML" e assim por diante. O ponto de interrogação não pode ser o único caractere no
          termo.
         </simpara>
        </entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>
   <para>
    <note>
     <para>
      Selecione a caixa de seleção "Match similar words" para incluir pequenas variações gramaticais
      para a frase que você pesquisa. Este recurso localiza apenas variações da palavra com
      sufixos comuns. Por exemplo, uma pesquisa pela palavra "add" encontrará "added", mas
      não encontrará "additive". Esta opção é independente de outras opções ou sintaxe.
      Se você fizer uma pesquisa somente por títulos, as variações nos títulos serão correspondidas. Se você usar
      aspas (ou qualquer outro operador de consulta), qualquer variação da palavra pode aparecer; por
      exemplo, "stemmed search" também corresponderá a "stemming search".
     </para>
    </note>
   </para>
  </sect1>

  <sect1 xml:id="chm.search.terms">
   <title>Definindo termos de pesquisa</title>
   <para>
    Os operadores AND, OR, NOT e NEAR permitem que você defina precisamente sua
    pesquisa criando um relacionamento entre os termos de pesquisa. A tabela a seguir
    mostra como você pode usar cada um desses operadores. Se nenhum operador for especificado,
    AND é usado. Por exemplo, a consulta "server cgi security" é equivalente
    a "server AND cgi AND security".
    <table>
     <title>Operadores de pesquisa</title>
     <tgroup cols="3">
      <thead>
       <row>
        <entry>Procurar</entry>
        <entry>Exemplo</entry>
        <entry>Resultados</entry>
       </row>
      </thead>
      <tbody>
       <row>
        <entry>Ambos os termos no mesmo tópico</entry>
        <entry>http AND apache</entry>
        <entry>Tópicos contendo as palavras "http" e "apache".</entry>
       </row>
       <row>
        <entry>Qualquer termo em um tópico</entry>
        <entry>ming OR swflib</entry>
        <entry>Tópicos contendo a palavra "ming" ou a palavra "swflib" ou ambas.</entry>
       </row>
       <row>
        <entry>O primeiro termo sem o segundo termo</entry>
        <entry>xml NOT expat</entry>
        <entry>Tópicos contendo a palavra "xml", mas não a palavra "expat".</entry>
       </row>
       <row>
        <entry>Ambos os termos no mesmo tópico, próximos um do outro</entry>
        <entry>database NEAR security</entry>
        <entry>Tópicos contendo a palavra "database" dentro de oito palavras da palavra "security".</entry>
       </row>
      </tbody>
     </tgroup>
    </table>
   </para>
   <para>
    <note>
     <para>
      Os caracteres |, &amp; e ! também podem ser usados ​​no lugar de OR AND e
      NOT respectivamente. Isso pode não funcionar se você usar uma versão muito antiga do
      visualizador.
     </para>
    </note>
   </para>
  </sect1>

  <sect1 xml:id="chm.search.nested">
   <title>Usando expressões aninhadas ao pesquisar</title>
   <para>
    Expressões aninhadas permitem que você crie buscas complexas por informações.
    Por exemplo, "html AND ((smtp OR pop3) NEAR mail)" encontra tópicos
    contendo a palavra "html" junto com as palavras "smtp" e "mail"
    próximas, ou contendo "html" junto com as palavras "pop3" e
    "mail" próximas.
   </para>
   <para>
    As regras básicas para pesquisar tópicos de ajuda usando expressões aninhadas são
    as seguintes:
    <itemizedlist>
     <listitem>
      <simpara>
       Você pode usar parênteses para aninhar expressões dentro de uma consulta. As
       expressões entre parênteses são avaliadas antes do resto da consulta.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Se uma consulta não contiver uma expressão aninhada, ela será avaliada da esquerda para a direita.
       Por exemplo: "mail NOT pop3 OR smtp" encontra tópicos contendo a palavra "mail" sem
       a palavra "pop3" ou tópicos contendo a palavra "smtp". Por outro lado, "mail NOT
       (pop3 OR smtp)" encontra tópicos contendo a palavra "mail" sem nenhuma das palavras
       "pop3" ou "smtp".
      </simpara>
     </listitem>
     <listitem>
      <simpara>Não é possível aninhar expressões com mais de cinco níveis de profundidade.</simpara>
     </listitem>
    </itemizedlist>
   </para>
  </sect1>
  <!--
  <sect1 xml:id="chm.search.notes">
   <title>Manual Content and User Note Separation</title>
   <para>
    The manual content and the user notes are separated to
    <filename>php_manual_LANG.chm</filename> and
    <filename>php_manual_notes.chm</filename>. There were several reasons
    to do this, including:
    <itemizedlist>
     <listitem>
      <simpara>
       This way you can update the user notes and the manual independently
       as you need.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       You can have more than one language of the manual, while only
       need to have one notes file. All the CHM files need to be in the
       same directory, and all translations need to share the same
       preferences if you would not like to have more then one notes file.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       You can bookmark manual pages with notes, or just a notes part
       of a page separately.
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       You can "turn off" user note display and user note search results by
       simply deleting <filename>php_manual_notes.chm</filename>, moving it
       out of the directory or renaming it.
      </simpara>
     </listitem>
    </itemizedlist>
    All these benefits lead us to provide the manual the way you can see it
    right now. This distribution had the effect on the full text search that
    you get search results from the manual content and from the user notes
    as separate ones. The "Location" column shows the source of the result,
    also enabling you to "add precedence" to manual content results with
    ordering the results by "Location". User note page titles are also
    prefixed with "N:" to make them easily distinguishable in the favorites
    list (there's no location info in the favorites list).
   </para>
  </sect1>
  -->

 </chapter>

<!-- 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
-->