<?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 % Estonian  "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
>Marek</firstname
><surname
>Laane</surname
><affiliation
><address
><email
>bald@smail.ee</email
></address
></affiliation
><contrib
>Tõlge eesti keelde</contrib
></othercredit
> 
    </authorgroup>

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

  <sect1>
    <title
>Ülevaade</title>

    <para
>Protokoll <acronym
>nepomuksearch</acronym
> võimaldab otsida Nepomuki metaandmete hoidlast faile või muud laadi ressursse (ehkki failid on kõige olulisemad, sest antud juhul on juttu virtuaalsetest failisüsteemidest).</para>
    <note>
      <para
>Selle jaoks peab Nepomuki süsteem olema aktiveeritud. Failide indekseerija Strigi aktiveerimine annab veel paremaid tulemusi ning märksa rohkem otsimisvõimalusi.</para>
    </note>

    <para
>Tavaliselt on <acronym
>nepomuksearch</acronym
> tarvitusel kasutaja jaoks läbipaistvalt näiteks selliste rakenduste vahendusel nagu <application
>Dolphin</application
>, mis pakuvad graafilise kasutajaliidese elemente vajalike päringute ja vastavate URL-ide konstrueerimiseks. Siiski on võimalik panna päringu URL kirja ka käsitsi. Selleks on kaks eri võimalust (pane sealjuures tähele, et allpool näidetena toodud päringud ei piirdu failidega).</para>
    <variablelist>
      <varlistentry>
        <term>
          <userinput
>nepomuksearch:/?query=Nepomuk</userinput>
        </term>
        <listitem>
          <para
>otsib kõike, mis sisaldab sõna "Nepomuk". Selle asemel võib olla mõistagi mistahes muu sõna, mida lihtne <xref linkend="query_syntax"/> võimaldab.</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
>käivitab <acronym
>SPARQL</acronym
> päringu,  mis antud juhul otsib kõiki ressursse, mis on sildistatud sildiga, mille nimeks on "Nepomuk". Arvesta kindlasti, et päring peab olema protsendimärkidega kodeeritud, s.t selline URI nagu <userinput
>&lt;http://www.semanticdesktop.org/ontologies/2007/08/15/nao#Tag&gt;</userinput
> tuleb kirjutada kujul <userinput
>%3chttp:%2f%2fwww.semanticdesktop.org%2fontologies%2f2007%2f08%2f15%2fnao#Tag%3e</userinput
>.</para>
        </listitem>
      </varlistentry>
    </variablelist>

  </sect1>

  <sect1 id="query_syntax">
    <title
>Nepomuki päringu süntaks</title>
    <para
>Süntaks on tegelikult päris lihtne. Mitut päringumõistet saab kombineerida võtmesõnadega <command
>AND</command
> või <command
>OR</command
>, mõisted võib välistada neile miinust ette pannes ning konkreetseid omadusi saab otsida, kui kombineerida omaduse nimi võrdusmärgi ja väärtusega.</para>
    <tip>
      <para
>Sama süntaksit võib kasutada ka tavalistel otsinguväljadel, näiteks <application
>Dolphin</application
>is.</para>
    </tip>
    <sect2>
      <title
>Näited</title>
      <variablelist>
        <varlistentry>
          <term
><userinput
>Nepomuk KDE</userinput
> või <userinput
>Nepomuk AND KDE</userinput
> </term>
          <listitem>
            <para
>otsib kõike, mis sisaldab sõnu "Nepomuk" ja "KDE" mis tahes omadustes (kaasa arvatud faili sisus).</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>Nepomuk OR KDE</userinput>
          </term>
          <listitem>
            <para
>otsib kõike, mis sisaldab kas sõna "Nepomuk" või "KDE" mis tahes omadustes.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>"Nepomuk KDE"</userinput>
          </term>
          <listitem>
            <para
>otsib kõike, mis sisaldab täpset fraasi "Nepomuk KDE" mis tahes omadustes.</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>hastag:Nepomuk</userinput>
          </term>
          <listitem>
            <para
>otsing kõike, mis on sildistatud sildiga, mille nimi on "Nepomuk".</para>
          </listitem>
        </varlistentry>
        <varlistentry>
          <term>
            <userinput
>+hastag:nepomuk AND -hastag:scribo</userinput>
          </term>
          <listitem>
            <para
>otsib kõike, mis on sildistatud sildiga, mille nimi on "nepomuk", aga mitte sildiga, mille nimi on "scribo".</para>
          </listitem>
        </varlistentry>
      </variablelist>
    </sect2>
  </sect1>

</article>
