<?xml version="1.0" ?>
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
  <!-- Define an entity for your application if it is not part of KDE
       CVS -->
  <!ENTITY kapplication "<application
>Blogilo</application
>">
  <!ENTITY kappname "&kapplication;">
  <!ENTITY package "playground/pim">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Estonian  "INCLUDE"
> 
]>
<book lang="&language;">

<bookinfo>
<title
>&kapplication; käsiraamat</title>

<authorgroup>
<author
>&Mehrdad.Momeny;&Mehrdad.Momeny.mail; </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
>2009</year>
<holder
>&Mehrdad.Momeny;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

<date
>2009-09-21</date>
<releaseinfo
>1.0</releaseinfo>

<abstract>
<para
>&kapplication; on &kde; ajaveebiklient. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>veebipäevik</keyword>
</keywordset>

</bookinfo>

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

<para
>&kapplication; on ajaveebiklient</para>
<para
>Ajaveebiklient (ka veebipäevikuklient, blogiklient) on tarkvara, mis on loodud lihtsustama veebipäevikute loomist ja hooldamist. Nagu teisedki sisuhalduse süsteemid, toetavad ajaveebirakendused veebipäeviku sissekannete ja kommentaaride loomist, muutmist ja avaldamist, lisades sellele mõningaid erifunktsioone, näiteks piltide haldamine, uudistevoogude haldamine ning sissekannete ja kommentaaride modereerimine.</para>
</chapter>

<chapter id="using-kapp">
<title
>&kapplication; kasutamine</title>

<sect1 id="getting-started">
<title
>Alustamine</title>
<para
>&kapplication; peaaknas saab luua uusi sissekandeid, muuta olemasolevaid, hankida neid serverist ning laadida serverisse nii sissekandeid kui ka meediafaile. Samuti võib sissekandeid salvestada kohalikult, et nendega hiljem enne avaldamist veel midagi ette võtta.</para>
<note
><para
>Kõik need võimalused avanevad siis, kui oled &kapplication;s seadistanud vähemalt ühe veebipäeviku.</para
></note>
<para
>Kui ühtegi veebipäevikut ei ole seadistatud, saab sissekandeid küll kirjutada, aga neid on võimalik salvestada ainult kohalikult.</para>
<screenshot>
<screeninfo
>&kapplication; pilt</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="mainwindow.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Peaaken</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</sect1>

<sect1 id="configuring-a-blog">
<title
>Ajaveebi seadistamine</title>
<para
>Veebipäeviku haldamist võimaldab <guilabel
>&kapplication; seadistustedialoog</guilabel
>, mille saab avada menüükäsuga <menuchoice
><guimenu
>Seadistused</guimenu
><guimenuitem
>&kapplication; seadistamine...</guimenuitem
></menuchoice
> Samuti on peaakna menüüdes olemas vastav käsk: <menuchoice
> <guimenu
>Veebipäevik</guimenu
><guimenuitem
>Lisa veebipäevik...</guimenuitem
></menuchoice
></para>
<screenshot>
<screeninfo
>Uue veebipäeviku lisamine - kaart <guilabel
>Põhiline</guilabel
></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add-blog-1.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Uue veebipäeviku lisamine - kaart <guilabel
>Põhiline</guilabel
></phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>Veebipäeviku lisamiseks tuleb kirjutada lihtsalt oma veebipäeviku aadress, kasutajanimi ja parool vastavatele väljadele ning klõpsata siis nupule <guibutton
>Automaatseadistamine</guibutton
>, mis sobib kenasti tuntuimate ajaveebiserverite, näiteks Wordpressi korral. Selle puhul arvatakse ära sinu veebipäevik ja API ning hangitakse veebipäeviku ID.</para>
<para
>Kui see peaks nurjuma, saab kaardil <guilabel
>Muu</guilabel
> käsitsi kirja panna oma veebipäeviku API tüübi ning klõpsata nupule <guibutton
>Tõmba ID</guibutton
> või kui juhtud seda teadma, ka otse veebipäeviku ID sisestada. Kui kasutad keelt, millest kirjutatakse paremalt vasakule, saab ära märkida vastava valiku <guilabel
>Paremalt vasakule</guilabel
>.</para>
<screenshot>
<screeninfo
>Uue veebipäeviku lisamine - kaart <guilabel
>Muu</guilabel
></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add-blog-2.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Uue veebipäeviku lisamine - kaart <guilabel
>Muu</guilabel
></phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>Seda, milliseid võimalusi &kapplication; sinu veebipäeviku puhul toetab, saab üle vaadata kaardil <guilabel
>Toetatud omadused</guilabel
>.</para>
</sect1>

<sect1 id="creating-new-post">
<title
>Uue sissekande loomine</title>
<para
>Uue sissekande loomiseks klõpsa peaaknas tööriistariba nupule <guibutton
>Uus sissekanne</guibutton
>, vali sama käsk menüüst <guimenu
>Sissekanne</guimenu
> või kasuta kiirklahvi <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
>.</para>
<para
>Nüüd luuakse uus tühi sissekanne, mida sul on võimalik täita oma sisuga, vajadusel midagi seadistada ning siis edastada oma ajaveebi.</para>
<para
>&kapplication; peaaken jaguneb kaheks osaks: koostaja ja tööriistakast.</para>

<sect2
><title
>Koostaja</title>
<para
>Koostajas seisab ülal tekstikast nimetusega <guilabel
>Pealkiri</guilabel
>, kuhu tulebki kirjutada oma sissekande pealkiri. Selle all on kolm kaarti, mis võimaldavad sissekannet mitmel viisil redigeerida. Esimene neist on visuaalne redaktor: WYSIWYG redaktor, milles teksti vormindamiseks piisab ikoonide kasutamisest. Selle jõrval on &HTML; redaktor: tekstiredaktor, milles saab redigeerida oma sissekande &HTML; koodi, mida hõlbustab süntaksi esiletõstmine. Viimasel kaardil saab oma sissekannet enne selle saatmist serverisse näha veebipäeviku stiilis.</para>
</sect2>

<sect2>
<title
>Tööriistakast</title>
<para
>Tööriistakast koosneb neljast osast:</para>
<orderedlist>
<listitem>
<para
>Veebipäeviku sissekanded</para>
<screenshot>
<screeninfo
>Veebipäeviku sissekanded</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="toolbox-1.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Veebipäeviku sissekanded</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>Selles osas saab serverist tõmmata viimaseid sissekandeid.</para>
<para
>Topeltklõpsuga sissekande kirjele laaditakse see redaktoris ning seda on võimalik redigeerida või ka serverist üldse eemaldada.</para>
</listitem>

<listitem>
<para
>Sissekannete kategooriad</para>
<screenshot>
<screeninfo
>Sissekannete kategooriad</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="toolbox-2.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Sissekannete kategooriad</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>Selles osas saab valida oma sissekandele kategooriaid ja silte. Sildid tuleb eraldada komadega.</para>
</listitem>

<listitem>
<para
>Sissekannete valikud</para>
<screenshot>
<screeninfo
>Sissekannete valikud</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="toolbox-3.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Sissekannete valikud</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>Siin saab määrata mõningaid redaktoris avatud sissekande valikuid, näiteks <guilabel
>tagasiside</guilabel
> kohta (kas külastajad võivad jätta sissekandele kommentaare või mitte jne.), valida avaldamisaja või pealkirja, mida kasutatakse sissekande püsilingina (ainult Wordpressi ajaveebide korral).</para>
</listitem>

<listitem>
<para
>Kohalikud sissekanded</para>
<screenshot>
<screeninfo
>Kohalikud sissekanded</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="toolbox-4.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Kohalikud sissekanded</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>Sektsioonis <guilabel
>Kohalikud sissekanded</guilabel
> saab topeltklõpsuga sissekandel laadida selle koostajasse või ka eemaldada kettalt.</para>
</listitem>

</orderedlist>
</sect2>

</sect1>

<sect1 id="uploading">
<title
>Meediafaili üleslaadimine serverisse</title>
<para
>Faili üleslaadimiseks serverisse vali menüükäsk <menuchoice
><guimenu
>Veebipäevik</guimenu
> <guimenuitem
>Laadi meediafail üles...</guimenuitem
></menuchoice
>, mille järel sul palutakse valida fail kettalt. Seejärel on meediafaili üleslaadimise dialoog valmis faili teele saatma:</para>
<screenshot>
<screeninfo
>Meediafailide üleslaadimine</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="media-upload.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Meediafailide üleslaadimine</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>Kui sinu veebipäeviku API toetab meediafailide üleslaadimist, on siin kaks valikut, kui mitte, siis ainult üks ehk &FTP; server.</para>
<para
>Soovitud faili saab siin eelvaadelda (kui see on üldse võimalik) ning määrata kindlaks faili nime serveris. Siis aga jääb üle vaid vajutada nupule <guibutton
>Laadi üles</guibutton
>.</para>
<para
>Kui soovid laadida faili &FTP; serverisse, tuleb määrata kataloogi absoluutne asukoht. Samuti tuleb sisestada &URL;, mida kasutatakse faili lingi jaoks serveris.</para>
</sect1>

</chapter>

<chapter id="menu-reference">
<title
>Menüükirjed</title>

<sect1 id="file-menu">
<title
>Menüü <guimenu
>Fail</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Fail</guimenu
> <guimenuitem
>Välju</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Lõpetab</action
> &kapplication; töö</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="blog-menu">
<title
>Menüü <guimenu
>Veebipäevik</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Veebipäevik</guimenu
> <guimenuitem
>Lisa veebipäevik...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Võimaldab kiiresti lisada veebipäeviku.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Veebipäevik</guimenu
> <guimenuitem
>Laadi meediafail üles...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Avab meediafailide üleslaadimisdialoogi failide, näiteks piltide üleslaadimiseks ajaveebi või &FTP; serverisse.</para>
<note
><para
>Meediafailide üleslaadimist toetavad ainult MetaWeblogi, MovableType'i ja Wordpressi API-d.</para
></note>
</listitem>
</varlistentry>

</variablelist>

</sect1>


<sect1 id="post-menu">
<title
>Menüü <guimenu
>Sissekanne</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Sissekanne</guimenu
> <guimenuitem
>Uus sissekanne</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Uue tühja sissekande loomine.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Sissekanne</guimenu
> <guimenuitem
>Salvesta kohalikult</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Aktiivse sissekande salvestamine kohalikult.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Sissekanne</guimenu
> <guimenuitem
>Saada...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Avab sissekande saatmise dialoogi aktiivse sissekande saatmiseks aktiivsesse ajaveebi.</para>
<para
>Sissekande saatmisel saab valida, kas saata see mustandina või mitte. Lisaks saab määrata, kas tegemist on aktiivse sissekande muutmisega või uue sissekandega.</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-menu">
<title
>Menüü <guimenu
>Seadistused</guimenu
></title>

<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>T</keycap
></keycombo
> </shortcut
> <guimenu
>Seadistused</guimenu
> <guimenuitem
>Tööriistakasti näitamine</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Lülitab</action
> tööriistakasti näitamise sisse ja välja.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Olekuriba näitamine</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Lülitab</action
> olekuriba näitamise sisse ja välja.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Seadistused</guimenu
> <guimenuitem
>Kiirklahvide seadistamine...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Võimaldab <action
>seadistada</action
> &kapplication; kiirklahve. </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
>&kapplication; seadistamine...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Avab</action
> &kapplication; seadistustedialoogi. </para
></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1>
<title
>Menüü <guimenu
>Abi</guimenu
></title>
&help.menu.documentation; </sect1>

</chapter>

<chapter id="credits">

<title
>Autorid ja litsents</title>

<para
>&kapplication;</para>
<para
>Rakenduse autoriõigus 2008-2009: &Mehrdad.Momeny;&Mehrdad.Momeny.mail; ja &Golnaz.Nilieh;&Golnaz.Nilieh.mail; </para>
<para
>Dokumentatsiooni autoriõigus &copy; 2009: &Mehrdad.Momeny;&Mehrdad.Momeny.mail; </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-blogilo">
<title
>&kapplication; 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: xml
sgml-minimize-attributes:nil
sgml-general-insert-case:lower
sgml-indent-step:0
sgml-indent-data:nil
End:

vim:tabstop=2:shiftwidth=2:expandtab
kate: space-indent on; indent-width 2; tab-width 2; indent-mode none;
-->
