<commit_before><?xml version="1.0" encoding="UTF-8"?>
<sect1 id="zend.search.searching">
  <title>Pesquisando em um Índice</title>

  <sect2 id="zend.search.searching.query-parser">
    <title>Construindo Consultas</title>

    <para>Existem duas maneiras de pesquisar o índice. O primeiro método usa
    um analisador de consultas para construir a pesquisa a partir de uma
    string. O segundo oferece a possibilidade de criação de consultas
    customizadas através da API do Zend_Search_Lucene.</para>

    <para>Antes de decidir utilizar o analisador de consultas considere o
    seguinte: <orderedlist>
        <listitem>
          Se você pretende primeiro gerar programaticamente a string de consulta para depois submetê-la ao analisador então você deve considerar cuidadosamente a possibilidade a criação de suas consultas diretamente pela API. Em outras palavras, o analisador foi projetado para trabalhar com entradas de texto fornecidas por seres humanos e não com entradas geradas por software. 
        </listitem>

        <listitem>
          Campos não tokenizados funcionam melhor se adicionados diretamente às consultas, do que pela ação do analisador. Se o conteúdo de um campo é gerado pela aplicação, então deveria haver um cláusula de consulta para este campo. Um interpretador, que é utilizado pelo analisador de consultas, é projetado para converter entradas de texto provenientes de seres humanos para cláusulas de busca. Valores gerados por programas, tais como datas, palavras-chave, etc.,  deveriam ser consistentes o suficiente para não necessitar do interpretador. 
        </listitem>

        <listitem>
           Em um formulário de busca, somente os campos designados para receber texto deveriam ser submentidos ao analisador de consultas. Todo o resto (datas, tokens, etc.), pode ser submetido diretamente através da API de consulta. Um campo contendo um conjunto de valores, que pode ser exibido como um menu de persiana (pull-down), não deveria ser incluído na string de busca (e consequentemente submetido ao analisador), mas classificado como uma cláusula de busca. <commit_msg>Documentation:  - fixed DTD errors<commit_after><?xml version="1.0" encoding="UTF-8"?>
<sect1 id="zend.search.searching">
  <title>Pesquisando em um Índice</title>

  <sect2 id="zend.search.searching.query-parser">
    <title>Construindo Consultas</title>

    <para>Existem duas maneiras de pesquisar o índice. O primeiro método usa
    um analisador de consultas para construir a pesquisa a partir de uma
    string. O segundo oferece a possibilidade de criação de consultas
    customizadas através da API do Zend_Search_Lucene.</para>

    <para>Antes de decidir utilizar o analisador de consultas considere o
    seguinte: <orderedlist>
        <listitem>
            <para>
                Se você pretende primeiro gerar programaticamente a string de consulta para depois submetê-la ao analisador então você deve considerar cuidadosamente a possibilidade a criação de suas consultas diretamente pela API. Em outras palavras, o analisador foi projetado para trabalhar com entradas de texto fornecidas por seres humanos e não com entradas geradas por software. 
            </para>
        </listitem>

        <listitem>
            <para>
                Campos não tokenizados funcionam melhor se adicionados diretamente às consultas, do que pela ação do analisador. Se o conteúdo de um campo é gerado pela aplicação, então deveria haver um cláusula de consulta para este campo. Um interpretador, que é utilizado pelo analisador de consultas, é projetado para converter entradas de texto provenientes de seres humanos para cláusulas de busca. Valores gerados por programas, tais como datas, palavras-chave, etc.,  deveriam ser consistentes o suficiente para não necessitar do interpretador. 
            </para>
        </listitem>

        <listitem>
            <para>
                Em um formulário de busca, somente os campos designados para receber texto deveriam ser submentidos ao analisador de consultas. Todo o resto (datas, tokens, etc.), pode ser submetido diretamente através da API de consulta. Um campo contendo um conjunto de valores, que pode ser exibido como um menu de persiana (pull-down), não deveria ser incluído na string de busca (e consequentemente submetido ao analisador), mas classificado como uma cláusula de busca. 
            </para>
{'fraction_non_alphanumeric': 0.05030730707944457, 'fraction_numerical': 0.0022763487366264513, 'mean_word_length': 3.709539121114684, 'pattern_counts': {'":': 0, '<': 41, '<?xml version=': 2, '>': 41, 'https://': 0, 'lorem ipsum': 0, 'www.': 0, 'xml': 2}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '5217100', 'n_tokens_mistral': 1337, 'n_tokens_neox': 1306, 'n_words': 555}