<?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 % Catalan  "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>
      &traductor.Antoni.Bella; 
    </authorgroup>

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

  <sect1>
    <title
>Vista general</title>

    <para
>El protocol <acronym
>nepomuksearch</acronym
> permet cercar al rebost de metadades de Nepomuk per als fitxers o qualsevol altre tipus de recurs (tot i que els fitxers és el cas d'ús més important, ja que estem parlant de sistemes de fitxers virtuals).</para>
    <note>
      <para
>Per fer funcionar el sistema de Nepomuk aquest ha de ser activat. Activar l'indexador de fitxers Strigi proveeix millors resultats i el mode per a més possibilitats de cerca.</para>
    </note>

    <para
>Normalment <acronym
>nepomuksearch</acronym
> és usat de forma transparent a l'usuari a través d'una aplicació com el <application
>Dolphin</application
> la qual proporciona elements d'interfície gràfica d'usuari per a construir la consulta necessària i el URL corresponent. No obstant això, també és possible escriure una adreça URL de consulta de forma manual. Hi ha dues possibilitats diferents que puguin ser d'interès per a l'usuari (tenir en compte que les consultes creades com a continuació s'exposen no es limita als fitxers):</para>
    <variablelist>
      <varlistentry>
        <term>
          <userinput
>nepomuksearch:/?query=Nepomuk</userinput>
        </term>
        <listitem>
          <para
>buscarà qualsevol cosa que contingui la paraula «Nepomuk». «Nepomuk» es pot substituir amb qualsevol cosa que la <xref linkend="query_syntax"/> simple permeti.</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
>s'executarà la consulta <acronym
>SPARQL</acronym
> que en aquest cas cerca tots els recursos que estan marcats amb una etiqueta «Nepomuk». Tingueu en compte que la consulta ha de ser codificada amb el signe per cent «%», &ead;, un URI com <userinput
>&lt;http://www.semanticdesktop.org/ontologies/2007/08/15/nao#Tag&gt;</userinput
> hauria de ser escrita com a <userinput
>%3chttp:%2f%2fwww.semanticdesktop.org%2fontologies%2f2007%2f08%2f15%2fnao#Tag%3e</userinput
>.</para>
        </listitem>
      </varlistentry>
    </variablelist>

  </sect1>

  <sect1 id="query_syntax">
    <title
>Sintaxi de la consulta Nepomuk</title>
    <para
>La sintaxi és força simple. Múltiples termes de consulta es poden combinar amb les paraules clau <command
>AND</command
> i <command
>OR</command
>, els termes poden ser exclosos per un prefix amb un signe menys, i les propietats específiques es poden cercar mitjançant la combinació de nom de la propietat amb un comparador i el valor.</para>
    <tip>
      <para
>Aquesta sintaxi també es pot usar en els camps de cerca estàndard, com ara el <application
>Dolphin</application
> n'és un.</para>
    </tip>
    <sect2>
      <title
>Exemples</title>
      <variablelist>
        <varlistentry>
          <term
><userinput
>Nepomuk KDE</userinput
> o <userinput
>Nepomuk AND KDE</userinput
> </term>
          <listitem>
            <para
>cerca de tot el que contingui les paraules «Nepomuk» i «KDE» en qualsevol de les seves propietats (això inclou el contingut dels fitxers).</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>Nepomuk OR KDE</userinput>
          </term>
          <listitem>
            <para
>cerca de tot el que contingui la paraula «Nepomuk» o la paraula «KDE» en qualsevol de les seves propietats.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>«Nepomuk KDE»</userinput>
          </term>
          <listitem>
            <para
>cerca de tot el que contingui la frase exacta «Nepomuk KDE» en qualsevol de les seves propietats.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>hastag:Nepomuk</userinput>
          </term>
          <listitem>
            <para
>cerca de tot el que està marcat amb una etiqueta anomenada «Nepomuk».</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>+hastag:nepomuk AND -hastag:scribo</userinput>
          </term>
          <listitem>
            <para
>cerca de tot el que estigui marcat amb l'etiqueta «Nepomuk», però no una marca amb l'etiqueta «scribo».</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
  </sect1>

</article>
