<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
  <!ENTITY kappname "&choqok;">
  <!ENTITY package "extragear">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Estonian  "INCLUDE">
]>

<book id="choqok" lang="&language;">

<bookinfo>
<title
>&choqok;i käsiraamat</title>

<authorgroup>
<author
><firstname
>Mehrdad</firstname
> <surname
>Momeny</surname
> <affiliation
> <address
>mehrdad.momeny@gmail.com</address>
</affiliation>
</author>
<author
><firstname
>Anne-Marie</firstname
> <surname
>Mahfouf</surname
> <affiliation
> <address
>&Anne-Marie.Mahfouf.mail;</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>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2009-03-25</date>
<releaseinfo
>0.5</releaseinfo>



<abstract>
<para
>&choqok; on KDE mikroblogimise klient (<ulink url="http://choqok.gnufolks.org"
>http://choqok.gnufolks.org</ulink
>).</para>
</abstract>


<keywordset>
<keyword
>KDE</keyword>
<keyword
>mikroblogimine</keyword>
<keyword
>klient</keyword>
<keyword
>Twitter</keyword>
<keyword
>Identi.ca</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Sissejuhatus</title>

<para
>&choqok; on mikroblogimise klient, mis praegu toetab Identi.ca/Laconica ja Twitter.com-i teenuseid.</para>
<para
>Mikroblogimine on multimeediablogimise vorm, mis võimaldab kasutajal saata lühikesi tekstilõike või mikromeediafaile, näiteks fotosid või heliklippe, ning neid avaldada. Neid võivad näha kõik või piiratud rühm inimesi vastavalt kasutaja otsusele. Sõnumeid võib edastada väga mitmel moel, sealhulgas tekstisõnumitena, kiirsuhtlussõnumitena, e-kirjaga, digitaalhelina või veebi kaudu.</para>
</chapter>

<chapter id="using">
<title
>&choqok;i kasutamine</title>

<sect1 id="getting-started">
<title
>Alustamine</title>

<para
>&choqok;i peaaknas on näha mõned ajateljed, mis võimaldavad hoida pilgu peal, mida on sinu sõbrad postitanud, neile vastata ning suunata sõnumeid, mida oled sõpradele saanud ja neilt saanud. Samuti saab ise uue sõnumi postitada.</para>

<para
>Kõik need võimalused avanevad siis, kui oled &choqok;is seadistanud vähemalt ühe konto.</para>

<screenshot>
<screeninfo
>&choqok;i peaakna pilt</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="choqok.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>&choqok;i peaaken</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Iga konto on eraldi kaardil: pildil võib näha kaarte nimetusega <guilabel
>identica</guilabel
> ja <guilabel
>twitter</guilabel
>.</para>

<para
>Kaardi ülaosa pakub võimalust saata otsesõnum mõnele isikule, kes on tellinud sinu konto. Otsesõnumeid saab saata sama teenuse teistele kasutajatele juhul, kui te mõlemad olete teineteise konto tellinud. Kui jätta <guilabel
>Otsesõnum kasutajale</guilabel
> märkimata, postitatakse sinu sõnum avalikult ning seda saavad lugeda kõik sinu sõbrad. Kui see aga märkida, saab valida loendist nime ning postitada erasõnumi, mida näeb ainult see isik.</para>

<para
>Tekstiala võimaldab postitada sõnumi, mis peab jääma alla 140 märgi. Seda, kui palju märke veel kirjutada saab, näeb rohelises kirjas otse tekstiala all paremal. Värv muutub oranžiks, kui veel on võimalik kirjutada ainult 30 märki, ning punaseks, kui ainult 0 märki. Kui sinu sõnumi pikkus ületab 140 märki, küsitakse sinu käest, kas soovid selle ikkagi postitada. Jaatava vastuse korral postitatakse esimesed 140 märki.</para>

<para
>Kaart <guilabel
>Kodu</guilabel
> ajateljel näeb kõiki postitusi, mida sina ise ja sinu sõbrad on kirjutanud. Postitust Identi.ca vahendusel nimetatakse siin lihtsalt postituseks (inglise keeles dent), Twitteri vahendusel postitatud sõnumeid samuti postitusteks või ka säutsudeks (inglise keeles tweet).</para>

<para
>Kaardil <guilabel
>Vastused</guilabel
> näeb sulle vastustena postitatud sõnumeid.</para>

<para
>Kõiki sinu saadetud erasõnumeid näeb kaardil <guilabel
>Väljuvad</guilabel
>, sinu saadud erasõnumeid aga kaardil <guilabel
>Sisenevad</guilabel
>.</para>

</sect1>

<sect1 id="search">
<title
>Otsimine</title>

<para
>Soovi korral võib teenustes huvipakkuvaid asju otsida (kõike, mida teenuse otsimise API kliendile vähegi pakub).</para>

<para
>Otsida saab menüükäsuga <menuchoice
><guimenu
>Tööriistad</guimenu
> <guimenuitem
> Otsi</guimenuitem
> </menuchoice
> (kiirklahv <keycombo action="simul"
>&Ctrl; <keycap
>F</keycap
></keycombo
>). Näiteks võib otsida konkreetset sõna kõigi kasutajate postitustest:</para>

<screenshot>
<screeninfo
>&choqok;i otsing</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="choqok_search.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>&choqok;i otsing</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

</sect1>

<sect1 id="configuring-account">
<title
>Konto seadistamine</title>

<para
>Ava &choqok;i seadistustedialoog menüükäsuga <menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>&choqok;i seadistamine...</guimenuitem
></menuchoice
>, liigu kaardile <guilabel
>Kontod</guilabel
> ja  klõpsa nupule <guibutton
>Lisa</guibutton
>, mille järel ilmub nähtavale dialoog <guilabel
>Uue konto lisamine</guilabel
>. </para>

<screenshot>
<screeninfo
>Konto lisamine</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="add_account.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Konto lisamine</phrase>
	  </textobject>
	</mediaobject>
</screenshot>

<para
>Sisesta meelepärane unikaalne alias, kasutajanimi ja parool ning klõpsa nupule <guibutton
> OK</guibutton
>. Seejärel kontrollitakse sinu antud andmeid ja kui kõik on korras, võidki kohe hakata kontot kasutama.</para>
<para
>Seejärel võid soovi korral seadistada ka teisi kontosid.</para>
</sect1>

<sect1 id="special-features">
<title
>Erivõimalused</title>

<itemizedlist>
<listitem
><para
>Soovi korral võib keelata &choqok;i ajatelje uuendamise (ajatelg on sinu ja su sõprade postituste loend). </para
></listitem>
<listitem
><para
>Veel üks erivõimalus on kasutaja teavitamine uutest saabunud postitustest. </para
></listitem>
<listitem
><para
>Kiirpostitust on võimalik teha kiirklahviga <keycombo action="simul"
>&Ctrl; <keycap
>T</keycap
></keycombo
>, mis avab kiirpostituse akna, kus saadki oma sõnumi kirja panna: <screenshot>
<screeninfo
>Kiirpostituse dialoog</screeninfo>
	<mediaobject>
	  <imageobject>
	    <imagedata fileref="choqok_quick.png" format="PNG"/>
	  </imageobject>
	    <textobject>
	    <phrase
>Kiirpostituse dialoog</phrase>
	  </textobject>
	</mediaobject>
</screenshot>
<note
><para
>Soovi korral võib saata ühe ja sama teksti kõigile kontodele.</para
></note>
</para
></listitem>
<listitem
><para
>Uue postituse saamisel märgib &choqok; selle lugemata sõnumiks ning näitab süsteemisalve ikooni peal lugemata postituste arvu. Kui peaaken on avatud ja see seejärel minimeerida süsteemisalve, märgitakse kõik uued sõnumid loetuks. </para
></listitem>
</itemizedlist>
</sect1>

</chapter>

<chapter id="commands">

<title
>Käskude seletused</title>

<sect1 id="menu">
<title
>Menüüelemendid</title>

<variablelist>
<title
>Menüü <guimenu
>Fail</guimenu
></title>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>T</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Kiirsõnum</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Kiirpostituse dialoogi avamine.</action>
</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo
><keycap
>F5</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Uuenda ajatelgi</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Ajatelgede uuendamine.</action>
</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>R</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Märgi kõik loetuks</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Kõigi sõnumite märkimine loetuks.</action>
</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Fail</guimenu
> <guimenuitem
>Minimeeri</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>&choqok;i akna minimeerimine süsteemisalve.</action>
</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Välju</guimenuitem
> </menuchoice
></term>
<listitem
><para
>&choqok;i <action
>tegevuse lõpetamine</action
>.</para
></listitem>
</varlistentry>
</variablelist>

<variablelist>
<title
>Menüü <guimenu
>Tööriistad</guimenu
></title>
<varlistentry>
<term
><menuchoice
><shortcut
><keycombo action="simul"
>&Ctrl;<keycap
>F</keycap
></keycombo
> </shortcut
> <guimenu
>Tööriistad</guimenu
><guimenuitem
>Otsing</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Otsingudialoogi avamine otsimiseks aktiivses kontos.</action>
</para
></listitem>
</varlistentry>
</variablelist>

<variablelist>
<title
>Menüü <guimenu
>Seadistused</guimenu
></title>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>U</keycap
></keycombo
> </shortcut
> <guimenu
>Seadistused</guimenu
> <guimenuitem
>Uuendamise taimeri lubamine</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Ajatelje uuendamise taimeri <action
>lubamine või keelamine</action
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Seadistused</guimenu
> <guimenuitem
>Märguannete lubamine</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Märguannete <action
>lubamine või keelamine</action
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Olekuriba näitamine</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Olekuriba näitamise <action
>lubamine või keelamine</action
>.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Kiirklahvide seadistamine...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>&choqok;is kasutatavate kiirklahvide <action
>seadistamine</action
>. </action>
</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Tööriistaribade seadistamine...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Võimaldab seadistada</action
> tööriistaribade välimust. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>&choqok;i seadistamine...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>&choqok;i seadistustedialoogi <action
>avamine</action
>. </para
></listitem>
</varlistentry>

</variablelist>

<para
>Lisaks on &choqok;il hästi tuntud menüü <guimenu
>Abi</guimenu
>. </para>
</sect1>

</chapter>


<chapter id="credits-and-license">
<title
>Autorid ja litsents</title>

<para
>&choqok;i autoriõigus 2008-2009: Mehrdad Momeny <email
>mehrdad.momeny@gmail.com</email
> </para>
<para
>Dokumentatsiooni autoriõigus 2009: Mehrdad Momeny <email
>mehrdad.momeny@gmail.com</email
> </para>

<para
>Tõlge eesti keelde: Marek Laane <email
>bald@smail.ee</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Paigaldamine</title>

<sect1 id="getting-chokoq">
<title
>&choqok;i hankimine</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Kompileerimine ja paigaldamine</title>
&install.compile.documentation; </sect1>
</appendix>

&documentation.index;
</book>


<!--
Local Variables:
mode: sgml
sgml-minimize-attributes: nil
sgml-general-insert-case: lower
sgml-indent-step:0
sgml-indent-data:nil
End:
-->