<?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 % Swedish "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
>Stefan</firstname
> <surname
>Asserhäll</surname
> <affiliation
><address
><email
>stefan.asserhall@comhem.se</email
></address
></affiliation
> <contrib
>Översättare</contrib
></othercredit
> 
    </authorgroup>

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

  <sect1>
    <title
>Översikt</title>

    <para
>Protokollet <acronym
>nepomuksearch</acronym
> gör det möjligt att söka i Nepomuks metadatalager efter filer eller vilken annan typ av resurs som helst (även om filer är det viktigaste användarfallet, eftersom det handlar om virtuella filsystem här).</para>
    <note>
      <para
>För att det ska fungera måste Nepomuk-systemet vara aktiverat. Att aktivera filindexering med Strigi tillhandahåller bättre resultat och mycket fler sökmöjligheter.</para>
    </note>

    <para
>Normalt används <acronym
>nepomuksearch</acronym
> osynligt för användaren via ett program som <application
>Dolphin</application
>, som tillhandahåller grafiska användargränssnittselement för att skapa de förfrågningar som behövs, och motsvarande webbadresser. Dock är det också möjligt att skriva en frågewebbadress för hand. Det finns två olika möjligheter som kan vara av intresse för en användare (var medveten om att förfrågningarna som skapas enligt beskrivningen nedan inte är begränsade till filer):</para>
    <variablelist>
      <varlistentry>
        <term>
          <userinput
>nepomuksearch:/?query=Nepomuk</userinput>
        </term>
        <listitem>
          <para
>söker efter allting som innehåller ordet "Nepomuk". "Nepomuk" kan ersättas med vad som helst som tillåts av enkel <xref linkend="query_syntax"/>.</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
>utför <acronym
>SPARQL</acronym
>-förfrågan, som i det här fallet söker efter alla resurser som är betecknade med en etikett benämnd "Nepomuk". Var medveten om att förfrågningen måste vara procentkodad, dvs. en webbadress som <userinput
>&lt;http://www.semanticdesktop.org/ontologies/2007/08/15/nao#Tag&gt;</userinput
> skulle behöva skrivas som <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 frågesyntax</title>
    <para
>Syntaxen är ganska enkel. Flera frågetermer kan kombineras med nyckelorden <command
>AND</command
> (och) eller <command
>OR</command
> (eller), termer kan undantas genom att inleda dem med ett minustecken, och särskilda egenskaper kan sökas efter genom att kombinera egenskapens namn med en jämförelseoperator och värdet.</para>
    <tip>
      <para
>Syntaxen kan också användas i standardsökfält liksom det i <application
>Dolphin</application
>.</para>
    </tip>
    <sect2>
      <title
>Exempel</title>
      <variablelist>
        <varlistentry>
          <term
><userinput
>Nepomuk KDE</userinput
> eller <userinput
>Nepomuk AND KDE</userinput
> </term>
          <listitem>
            <para
>sök efter allting som innehåller orden "Nepomuk" och "KDE" i någon av sina egenskaper (det inkluderar innehåll i filer).</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>Nepomuk OR KDE</userinput>
          </term>
          <listitem>
            <para
>sök efter allting som antingen innehåller ordet "Nepomuk" eller ordet "KDE" i någon av sina egenskaper.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>"Nepomuk KDE"</userinput>
          </term>
          <listitem>
            <para
>sök efter allting som innehåller den exakta ordföljden "Nepomuk KDE" i någon av sina egenskaper.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>hastag:Nepomuk</userinput>
          </term>
          <listitem>
            <para
>sök efter allting som är betecknat med etiketten "Nepomuk".</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>+hastag:nepomuk AND -hastag:scribo</userinput>
          </term>
          <listitem>
            <para
>sök efter allting som är betecknat med etiketten "nepomuk" men inte etiketten "scribo".</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
  </sect1>

</article>
