<?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ü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 ><http://www.semanticdesktop.org/ontologies/2007/08/15/nao#Tag></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>