<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % Portuguese "INCLUDE">
<!-- change language only here -->
]>

<article lang="&language;" id="nepomuksearch">
  <title
>nepomuksearch</title>
  <articleinfo>
    <authorgroup>
      <author
><personname
> <firstname
>Sebastian</firstname
> <surname
>Tr&uuml;g</surname
> </personname
> <email
>trueg@kde.org</email
> </author>
      <othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>zepires@gmail.com</email
></address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
    </authorgroup>

    <date
>2010-09-10</date>
    <releaseinfo
>1.0.0</releaseinfo>
  </articleinfo>

  <sect1>
    <title
>Introdução</title>

    <para
>O protocolo <acronym
>nepomuksearch</acronym
> permite procurar no armazém de meta-dados do Nepomuk por ficheiros ou qualquer outro tipo de recurso (ainda que os ficheiros sejam o caso de uso mais importante, dado que estamos a falar aqui de sistemas de ficheiros virtuais).</para>
    <note>
      <para
>Para funcionar, é necessário activar o sistema Nepomuk. A activação do indexador de ficheiros Strigi oferece melhores resultados e mais possibilidades de pesquisa.</para>
    </note>

    <para
>Tipicamente, o <acronym
>nepomuksearch</acronym
> é usado de forma transparente para o utilizador, através de uma interface como o <application
>Dolphin</application
>, que oferece elementos gráficos para construir a pesquisa necessária, bem como o URL correspondente. Contudo, também é possível escrever um URL de pesquisa manualmente. Existem duas possibilidades diferentes e interessantes para o utilizador (tenha em atenção que as pesquisas aqui apresentadas não se limitam aos ficheiros):</para>
    <variablelist>
      <varlistentry>
        <term>
          <userinput
>nepomuksearch:/?query=Nepomuk</userinput>
        </term>
        <listitem>
          <para
>irá procurar por tudo o que contenha a palavra "Nepomuk". "Nepomuk" pode ser substituído o que a <xref linkend="query_syntax"/> simples permitir.</para>
        </listitem>
      </varlistentry>
      <varlistentry>
        <term>
          <userinput
>nepomuksearch:/?sparql=select ?r where { ?r nao:hasTag ?tag . ?tag nao:prefLabel 'Nepomuk'^^xsd:string . }</userinput>
        </term>
        <listitem>
          <para
>irá executar a pesquisa <acronym
>SPARQL</acronym
> que, neste caso, irá procurar todos os recursos marcados com uma marca com a legenda "Nepomuk". Tenha atenção que a pesquisa tem de ser codificada com percentagens, ie. um URI do tipo <userinput
>&lt;http://www.semanticdesktop.org/ontologies/2007/08/15/nao#Tag&gt;</userinput
> teria de ser escrito como a seguinte forma <userinput
>%3chttp:%2f%2fwww.semanticdesktop.org%2fontologies%2f2007%2f08%2f15%2fnao#Tag%3e</userinput
>.</para>
        </listitem>
      </varlistentry>
    </variablelist>

  </sect1>

  <sect1 id="query_syntax">
    <title
>Sintaxe de Pesquisas do Nepomuk</title>
    <para
>A sintaxe é relativamente simples. Poderá compor vários termos da pesquisa com as palavras <command
>AND</command
> (E) ou <command
>OR</command
> (OU); esses mesmos termos poderão ser excluídos ou negados se os anteceder com um sinal de menos (-), podendo procurar também por uma dada propriedade específica, combinando o nome da propriedades com um comparador e o valor.</para>
    <tip>
      <para
>Esta sintaxe também poderá ser usada nos campos de pesquisa normais, como no do <application
>Dolphin</application
>.</para>
    </tip>
    <sect2>
      <title
>Exemplos</title>
      <variablelist>
        <varlistentry>
          <term
><userinput
>Nepomuk KDE</userinput
> ou <userinput
>Nepomuk AND KDE</userinput
> </term>
          <listitem>
            <para
>procura por tudo o que contém as palavras "Nepomuk" e "KDE" em qualquer uma das suas propriedades (incluindo o conteúdo dos ficheiros).</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>Nepomuk OR KDE</userinput>
          </term>
          <listitem>
            <para
>procura por tudo o que contém as palavras "Nepomuk" ou "KDE" em qualquer uma das suas propriedades.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>"Nepomuk KDE"</userinput>
          </term>
          <listitem>
            <para
>procura por tudo o que contém a frase exacta 'Nepomuk KDE' em qualquer uma das suas propriedades.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>hastag:Nepomuk</userinput>
          </term>
          <listitem>
            <para
>procura por tudo o que tenha uma marca chamada "Nepomuk".</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>+hastag:nepomuk AND -hastag:scribo</userinput>
          </term>
          <listitem>
            <para
>procura por tudo o que tenha uma marca chamada "nepomuk" mas não uma marca chamada "scribo".</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
  </sect1>

</article>
