<?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 % Dutch "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>
      &Freek.de.Kruijf; 
    </authorgroup>

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

  <sect1>
    <title
>Overzicht</title>

    <para
>Het <acronym
>nepomuksearch</acronym
>-protocol stelt u in staat in de Nepomuk-metagegevensopslag of enig ander type hulpbron te zoeken (hoewel bestanden het meest belangrijke gebruik is omdat we hier praten over virtuele bestandssystemen).</para>
    <note>
      <para
>Om het te laten werken moet het Nepomuk-systeem geactiveerd zijn. Activeren van de Strigi-bestandenindexeerder geeft betere resultaten en veel meer zoekmogelijkheden.</para>
    </note>

    <para
>Typisch is dat <acronym
>nepomuksearch</acronym
> transparant door de gebruiker wordt gebruikt via een applicatie als <application
>Dolphin</application
> die GUI-elementen levert om de benodigde zoekopdracht en de bijbehorende URL. Het is echter ook mogelijk om een zoekopdracht-URL handmatig te maken. Er zijn twee verschillende mogelijkheden die voor de gebruiker interessant kunnen zijn (wees u ervan bewust dat de hieronder getoonde zoekopdrachten niet beperkt zijn tot bestanden):</para>
    <variablelist>
      <varlistentry>
        <term>
          <userinput
>nepomuksearch:/?query=Nepomuk</userinput>
        </term>
        <listitem>
          <para
>zal naar alles zoeken wat het woord "Nepomuk" bevat. "Nepomuk" kan vervangen worden door wat de eenvoudige <xref linkend="query_syntax"/> toestaat.</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
>de <acronym
>SPARQL</acronym
> zoekopdracht zal uitvoeren die in dit geval zoekt naar alle hulpbronnen die een tag met het label "Nepomuk" hebben. Merk op dat de zoekopdracht met procenten gecodeerd moet worden, &ie; een URI zoals <userinput
>&lt;http://www.semanticdesktop.org/ontologies/2007/08/15/nao#Tag&gt;</userinput
> zou moeten worden geschreven als <userinput
>%3chttp:%2f%2fwww.semanticdesktop.org %2fontologies%2f2007%2f08%2f15%2fnao#Tag%3e</userinput
>.</para>
        </listitem>
      </varlistentry>
    </variablelist>

  </sect1>

  <sect1 id="query_syntax">
    <title
>Nepomuk zoeksyntax</title>
    <para
>De syntax is tamelijk eenvoudig. Meervoudige zoektermen kunnen worden gecombineerd met de trefwoorden <command
>AND</command
> of <command
>OR</command
>, termen kunnen worden uitgesloten door ze vooraf te laten gaan door een minteken en specifieke eigenschappen kunnen gezocht worden door de naam van de eigenschap te combineren met vergelijkingsaanduiding en de waarde.</para>
    <tip>
      <para
>Deze syntax kan ook worden gebruikt in standard zoekvelden zoals die van <application
>Dolphin</application
>.</para>
    </tip>
    <sect2>
      <title
>Voorbeelden</title>
      <variablelist>
        <varlistentry>
          <term
><userinput
>Nepomuk KDE</userinput
> of <userinput
>Nepomuk AND KDE</userinput
> </term>
          <listitem>
            <para
>zoekt naar alles wat de woorden "Nepomuk" en "KDE" bevat in elk van hun eigenschappen (dit omvat de inhoud van bestanden).</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>Nepomuk OR KDE</userinput>
          </term>
          <listitem>
            <para
>zoekt naar alles wat ofwel het woord "Nepomuk" of het woord "KDE" bevat in elk van hun eigenschappen.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>"Nepomuk KDE"</userinput>
          </term>
          <listitem>
            <para
>zoekt naar alles wat exact de tekst "Nepomuk KDE" bevat in elk van hun eigenschappen.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>hastag:Nepomuk</userinput>
          </term>
          <listitem>
            <para
>zoekt naar alles wat de tag genaamd "Nepomuk" als tag heeft gekregen.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>+hastag:nepomuk AND -hastag:scribo</userinput>
          </term>
          <listitem>
            <para
>zoekt naar alles wat de tag genaamd "Nepomuk" als tag heeft gekregen maar geen tag genaamd "scribo" heeft.</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
  </sect1>

</article>
