<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
  <!ENTITY kappname "<application
>Nepomuk-WebMiner</application
>">
  <!ENTITY package "kcontrol">
  <!ENTITY kappversion "0.3"
><!--Application version. Use this variable everywhere it's needed.-->
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Estonian  "INCLUDE">
]>
<book lang="&language;">
    <bookinfo>
    <title
>Metaandmete ekstraktimise käsiraamat</title>

    <authorgroup>
	<author
><firstname
>Jörg</firstname
> <surname
>Ehrichs</surname
> <affiliation
> <address
><email
>joerg.ehrichs@gmx.de</email
></address>
	    </affiliation>
	</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>
    <copyright>
	<year
>2012</year>
	<holder
>Jörg Ehrichs</holder>
    </copyright>

    <legalnotice
>&FDLNotice;</legalnotice>

    <date
>2012-10-19</date
><!-- Date of (re)writing, or update.-->
    <releaseinfo
>&kappversion;</releaseinfo
><!-- Application version number. Use the variable definitions within header to change this value.-->

    <abstract>
        <para
>Käesolev käsiraamat tutvustab &kde; Süsteemi seadistuste moodulit, milles saab seadistada <application
>Nepomuk</application
>i metaandmete ekstraktimise teenust.</para>
    </abstract>

    <keywordset>
	<keyword
>KDE</keyword
><!-- do not change this! -->
	<keyword
>Süsteemi seadistused</keyword>
	<keyword
>Nepomuk</keyword>
	<keyword
>Metaandmed</keyword>
    </keywordset>

    </bookinfo>

    <chapter id="introduction">
    <title
>Sissejuhatus</title>
    <para
>Metaandmete ekstraktija otsib täiendavaid metaandmeid internetist <emphasis
>(Pythoni pluginate abil)</emphasis
> ja lisab need Nepomukile. See võib hankida andmeid kõigi dokumentide, filmide, telesaadete või muusikafailide kohta. </para>
    </chapter>

    <chapter id="dolphin-integration">
    <title
>Lõimimine &dolphin;iga</title>
    <para
>Käsitsi ekstraktimise alustamiseks võib käivitada metaandmete ekstraktija &dolphin;is kontekstimenüü vahendusel. Selleks klõpsa failil või kataloogil hiire parema nupuga ja vali <menuchoice
><guimenu
>Toiming</guimenu
> <guisubmenu
>Töölauaotsing</guisubmenu
> <guimenuitem
>...</guimenuitem
></menuchoice
> </para>
    <para
>Siin on neli võimalust metaandmeid tõmmata: <itemizedlist>
            <listitem>
                <para
><guilabel
>Tavaline</guilabel
>: näidatakse ekstraktimise dialoogi, aga jäetakse vahele kõik failid, millel on juba mingid metaandmed. </para>
            </listitem>
            <listitem>
                <para
><guilabel
>Automaatne</guilabel
>: ekstraktimine käib taustal, aga jäetakse vahele kõik failid, millel on juba mingid metaandmed. </para>
            </listitem>
            <listitem>
                <para
><guilabel
>Jõuga allalaadimine</guilabel
>: näidatakse ekstraktimisdialoogi ning kaasatakse ka failid, millel on juba mingid metaandmed. See võimaldab käsitsi määrata uusi otsinguparameetreid ja sel moel korrigeerida valesid metaandmeid. </para>
            </listitem>
            <listitem>
                <para
><guilabel
>Automaatne jõuga allalaadimine</guilabel
>: ekstraktimine käib taustal, aga asendatakse ka kõik varasemate ekstraktimistega hangitud metaandmed. </para>
            </listitem>
        </itemizedlist>
    </para>
    </chapter>

    <chapter id="extractor-dialog">
    <title
>Ekstraktimisdialoog</title>
    <para>
    <screenshot>
      <screeninfo
>Metaandmete ekstraktimise pilt</screeninfo>
            <mediaobject>
              <imageobject>
                <imagedata fileref="dialog.png" format="PNG"/>
              </imageobject>
              <textobject>
                <phrase
>Metaandmete ekstraktimise pilt</phrase>
              </textobject>
            </mediaobject>
    </screenshot>
    </para>
    <para
>Dialoog võimaldab kohandada kõigi failide otsinguparameetrit. Kõigi failide automaatselt ekstraktitud metaandmeid näitab <command
>1</command
>. Sõltuvalt failitüübist on otsinguvalikud erinevad. Filmi puhul on selleks pealkiri, telesaate puhul pealkiri, hooaeg ja osa, trükise korral autor ja pealkiri. </para>
    <para
>Lisaks otsinguparameetrile saab vahetada otsinguks kasutatavat pluginat. Vaikimisi on valitud eelistatud plugin. </para>
    <para
>Täiendavaid seadistusi saab määrata seadistamisnuppude vahendusel, nagu näitab <command
>2</command
>. </para>
    <para
>Kui kõik on vajalikult määratud, saab otsingut alustada klõpsuga nupule <guibutton
>Otsi</guibutton
>. </para>
    <para
>Kõiki otsingutulemusi näeb loendivaates <command
>3</command
>. Vali siit kirje, mida soovid tõmmata. </para>
    <para
>Mõningaid üksikasju valitud kirje kohta näitab <command
>4</command
>. Võrgus näitamise link avab veebibrauseri veebilehega, mida kasutati andmete ekstraktimisel. Ekstraktimise alustamiseks klõpsa nupule <guibutton
>Tõmba metaandmed</guibutton
>. </para>
    <para
>Elemendi ekstraktimise tulemusi näeb loendis <command
>5</command
>. Metaandmete salvestamiseks klõpsa nupule <guibutton
>Salvesta</guibutton
>. </para>
    <para
>Faililoendis mõne muu faili valimiseks saab kasutada nuppe <guibutton
>Eelmine</guibutton
> ja <guibutton
>Järgmine</guibutton
>, nagu näitab <command
>6</command
>. </para>
    </chapter>

    <chapter id="service">
    <title
>Teenus</title>
    <para
>Taustateenus vastutab kõigi kettal olevate uute failide metaandmete ekstraktimise eest. </para>
    <para
>Niipea kui <application
>Nepomuki failide indekseerija</application
> tuvastab uue faili, käivitatakse ekstraktija, mis püüab hankida internetist lisaandmeid. </para>
    <note>
        <para
>See võib tekitada üsna suurt võrguliiklust eriti siis, kui Nepomuk alustab alles esialgset indekseerimist. </para>
    </note>
    </chapter>

    <chapter id="settings">
    <title
>Seadistused</title>

    <sect1 id="fetcher-settings">
    <title
>Tõmbaja</title>
    <para
>Tõmbaja seadistused puudutavad metaandmete ekstraktija üldist käitumist. </para>
    <itemizedlist>
        <listitem>
            <para
><guilabel
>Prinditiitli/posteri/kaanepildi allalaadimine</guilabel
>: märkimise korral otsib ekstraktija allalaadimiseks sobivat prinditiitlit, posterit või kaanepilti. Pilt salvestatakse rakenduse kataloogi ja lisatakse ressursile <application
>Nepomuki</application
> vahendusel. </para>
        </listitem>
        <listitem>
            <para
><guilabel
>Prinditiitli salvestamine ressursikataloogi</guilabel
>: pildi salvestamise asemel rakenduse kataloogi salvestatakse pilt failiga samasse kohta. <note
> <para
>See võib tekitada topeltpilte, kui kahe erineva ressursi kohta käiv üks ja sama pilt salvestatakse eri kataloogidesse. See võib juhtuda näiteks telesaadete ja hooaegade posteritega, kui osad paiknevad eri kataloogides. </para>
                 </note>
            </para>
        </listitem>
        <listitem>
            <para
><guilabel
>Publikatsiooni viidete allalaadimine</guilabel
>: võimaldab trükise otsimisel alla laadida kõik aktiivses publikatsiooniressursis tsiteeritud viited. <note
> <para
>Et paljudel trükistel on hulganisti tsiteeritavaid viiteid, võib see võtta hulga aega. Kui teavet viidete kohta ei ole tarvis või on seda tarvis üksnes üksikute trükiste korral, oleks mõttekam see valik märkimata jätta. Viiteid saab hiljem vajaduse korral vajaliku ressursi jaoks eraldi hankida. </para>
                 </note>
            </para>
        </listitem
><listitem>
        <para
><guilabel
>Eelistatud plugin</guilabel
>: siin saab määrata, millist pluginat kasutatakse metaandmete hankimiseks esimesena. Alles siis, kui esimene otsing nurjub, kasutatakse teabe hankimiseks teisi pluginaid. </para>
    </listitem>
    </itemizedlist>
    </sect1>


    <sect1 id="fetcher-plugins">
    <title
>Pluginad</title>
    <para
>Selles loendis on näha kõik saadaolevad pluginad. Täpsema teabe saamiseks plugina kohta klõpsa nupule <guibutton
>Teave</guibutton
>. Mõnda pluginat on võimalik täiendavalt seadistada, mida saab teha nupule <guibutton
>Seadista</guibutton
> klõpsates. </para>
    </sect1>


    <sect1 id="fetcher-service">
    <title
>Teenus</title>
    <para
>Teenuse seadistused lubavad taustateenuse <command
>sisse/välja</command
> lülitada. Kui teenus on sisse lülitatud, käivitatakse ekstraktija iga uue indekseeritud faili korral, mille on loonud <application
>Nepomuki failide indekseerimise teenus</application
>. Kui teenus ei ole sisse lülitatud, tõmmatakse ainult metaandmed, kui kasutaja seda spetsiaalselt nõuab &dolphin;i kontekstimenüü kaudu. Valik <guilabel
>Korraga töös</guilabel
> määrab üheaegselt käivitatavate ekstraktori protsesside arvu. </para>
    <important>
        <para
>Suur hulk ühel ajal töötavaid protsesse võib halvata süsteemi. Mõistlikud väärtused jäävad 1 ja 6 vahele. </para>
    </important>
    
    <para>
    <itemizedlist>
      <listitem>
        <para
><guilabel
>Dokumendi teabe hankimine</guilabel
>: märkimisel tõmbab teenus automaatselt lisateabe kõigi dokumentide kohta, mida Nepomuk indekseerib. </para>
	  <important>
            <para
>See võib tähendada eraviisiliste andmete paljastamist plugina otsingumootorile. Otsing kasutab andmeid, mis saadakse failinimest, failis juba leiduvates metaandmetes ja vajaduse korral ka PDF-faili esimese lehekülje pealkirjastringi. </para>
          </important>
        <para
>Kui sa ei ole kindel, et sa seda soovid, jäta see võimalus märkimata ja kasuta metaandmete ekrtraktijat just nende dokumentide puhul, mille korral tunned selle järgi vajadust. </para>
      </listitem
><listitem>
        <para
><guilabel
>Muusika teabe hankimine</guilabel
>: märkimisel tõmbab teenus automaatselt lisateabe kõigi muusikafailide kohta, mida Nepomuk indekseerib. Kui see on märkimata, tuleb ekstraktija käivitada eraldi kõigi muusikafailide puhul. </para>
      </listitem
><listitem>
        <para
><guilabel
>Video teabe hankimine</guilabel
>: märkimisel tõmbab teenus automaatselt lisateabe kõigi videofailide kohta, mida Nepomuk indekseerib. Kui see on märkimata, tuleb ekstraktija käivitada eraldi kõigi videofailide puhul. </para>
      </listitem>
    </itemizedlist>
      
    </para>
    </sect1>

    </chapter>

    <chapter id="credits"
><title
>Autorid ja litsents</title
> 
    <para
>Tõlge eesti keelde: Marek Laane <email
>bald@smail.ee</email
></para
> 
&underFDL; &underGPL; </chapter>
</book>
