Warning, /network/choqok/doc/index.docbook is written in an unsupported language. File is not indexed.

 <?xml version="1.0" ?>
 <!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
 "dtd/kdedbx45.dtd" [
   <!ENTITY % addindex "IGNORE">
   <!ENTITY % English "INCLUDE">
 ]>
 
 <book id="choqok" lang="&language;">
 
 <bookinfo>
 <title>The &choqok; Handbook</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>
 <author>
 <firstname>Andrea</firstname>
 <surname>Scarpino</surname>
 <affiliation>
 <address>scarpino@kde.org</address>
 </affiliation>
 </author>
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
 <legalnotice>&FDLNotice;</legalnotice>
 
 <date>2015-01-25</date>
 <releaseinfo>1.5</releaseinfo>
 
 <abstract>
 <para>&choqok; is a micro-blogging client by KDE
 (<ulink url="https://choqok.kde.org">https://choqok.kde.org</ulink>).</para>
 </abstract>
 
 <keywordset>
 <keyword>KDE</keyword>
 <keyword>micro-blogging</keyword>
 <keyword>client</keyword>
 <keyword>Twitter</keyword>
 <keyword>Pump.io</keyword>
 <keyword>GNU social</keyword>
 </keywordset>
 
 </bookinfo>
 <!--FIXME https://choqok.kde.org/news/2013/09/01/choqok-1-4-released.html -->
 <chapter id="introduction">
 <title>Introduction</title>
 
 <para>&choqok; is a micro-blogging client which currently supports
 Pump.io, GNU social and Twitter.com services.</para>
 <para>Micro-blogging is a form of multimedia blogging that allows users to
 send brief text updates or micro media such as photos or audio clips and publish
 them. These can be viewed either by anyone or by a restricted group, which can
 be decided by the user. These messages can be submitted by a variety of means,
 including text messaging, instant messaging, email, digital audio or the
 web.</para>
 </chapter>
 
 <chapter id="using">
 <title>Using &choqok;</title>
 
 <sect1 id="getting-started">
 <title>Getting Started</title>
 
 <para>In the &choqok; main window there are some timelines allowing you to see
 what your friends have posted, replies to them and direct messages sent and
 received from friends. You can also post a new message.</para>
 
 <para>All of this will be available when you configure at least one account
 in &choqok;.</para>
 
 <screenshot>
 <screeninfo>Here is a screenshot of the &choqok; main window</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="choqok.png" format="PNG"/>
           </imageobject>
             <textobject>
             <phrase>&choqok; main window</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 
 <para>You have one tab per account, on the screenshot you can see a tab with the
 alias <guilabel>Pump.io</guilabel> and another with the alias
 <guilabel>twitter</guilabel>.</para>
 
 <para>On top of the tab you can choose to send a direct message to someone who
 is subscribed to your account. You can send direct messages to other users of
 the same service, as long as both of you are subscribed to each other. If you
 leave <guilabel>Direct message to</guilabel> unchecked your message will be
 posted publicly and all your friends will read it. If you check it, you will
 then choose a name in the list and the private message will only be posted to
 this person.</para>
 
 <para>The text area allows you to post your message which must have less than
 140 characters. The number of characters left is displayed in green on bottom
 right under the text area. The color changes to orange when you reach the 30
 characters limit then to red when you reach 0. If your message is longer
 than 140 characters, you will be asked if you want to post it anyway. If you
 agree, it will be posted up to 140 characters.</para>
 
 <para>The <guilabel>Home</guilabel> tab displays the timeline which consists in
 all posts you and your friends wrote. A post using Pump.io is called a post
 while a post using Twitter is called a tweet.</para>
 
 <para>The <guilabel>Reply</guilabel> tab displays posts that are replies to
 you.</para>
 
 <para>All the private messages you sent will be displayed in the
 <guilabel>Outbox</guilabel> tab while the received ones will be displayed in the
 <guilabel>Inbox tab</guilabel>.</para>
 
 </sect1>
 
 <sect1 id="search">
 <title>Searching</title>
 
 <para>You can search through services for something (anything that
 the service-search API can offer to a client).</para>
 
 <para>This function is available via the <menuchoice><guimenu>Tools</guimenu>
 <guimenuitem>Search</guimenuitem> </menuchoice> menu (shortcut:
 <keycombo action="simul">&Ctrl;
 <keycap>F</keycap></keycombo>)
 For example you can search for a special word in all users' posts:</para>
 
 <screenshot>
 <screeninfo>&choqok; search feature</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="choqok_search.png" format="PNG"/>
           </imageobject>
             <textobject>
             <phrase>&choqok; search feature</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 
 </sect1>
 
 <sect1 id="configuring-account">
 <title>Configuring an Account</title>
 
 <para>Open the &choqok; configuration window via
 <menuchoice><guimenu>Settings</guimenu> <guimenuitem>Configure
 &choqok;...</guimenuitem> </menuchoice> then go to the
 <guilabel>Accounts</guilabel> tab and click the <guibutton>Add</guibutton>
 button, the <guilabel>Add a new account</guilabel> window will appear.
 </para>
 
 <screenshot>
 <screeninfo>Adding an account</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="add_account.png" format="PNG"/>
           </imageobject>
             <textobject>
             <phrase>Adding an account</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 
 <para>Simply enter your desired unique alias, username and password and click
 the <guibutton>OK</guibutton> button. This will check your credentials and, if
 everything is okay, your account will be ready to use.</para>
 <para>You can configure other accounts subsequently.</para>
 </sect1>
 
 <sect1 id="special-features">
 <title>Special Features</title>
 
 <itemizedlist>
 <listitem><para>
 You can disable the timeline updating of &choqok; (the timeline is the list of
 posts by you and your friends).
 </para></listitem>
 <listitem><para>
 Another special feature is the ability to notify the user about new
 received posts.
 </para></listitem>
 <listitem><para>
 You can do a quick post by pressing
 <keycombo action="simul">&Ctrl;
 <keycap>T</keycap></keycombo>
 to open the quick micro-blog window and write your post:
 <screenshot>
 <screeninfo>Quick posting dialog</screeninfo>
         <mediaobject>
           <imageobject>
             <imagedata fileref="choqok_quick.png" format="PNG"/>
           </imageobject>
             <textobject>
             <phrase>Quick posting dialog</phrase>
           </textobject>
         </mediaobject>
 </screenshot>
 <note><para>You can post the same text to all accounts at once.</para></note>
 </para></listitem>
 <listitem><para>
 When new posts are received, &choqok; marks them as unread and shows the number
 of unread posts in the system tray icon. When the main window is shown and
 then minimized to system tray it then marks all new messages as read.
 </para></listitem>
 </itemizedlist>
 </sect1>
 
 </chapter>
 
 <chapter id="commands">
 
 <title>Command Reference</title>
 
 <sect1 id="menu">
 <title>The Menu Items</title>
 
 <variablelist>
 <title>The <guimenu>File</guimenu> Menu</title>
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo>
 </shortcut>
 <guimenu>File</guimenu>
 <guimenuitem>Quick Post</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Open the quick posting window.</action>
 </para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo><keycap>F5</keycap></keycombo>
 </shortcut>
 <guimenu>File</guimenu>
 <guimenuitem>Update Timelines</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Update timelines.</action>
 </para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo action="simul">&Ctrl;<keycap>R</keycap></keycombo>
 </shortcut>
 <guimenu>File</guimenu>
 <guimenuitem>Mark All As Read</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Mark all messages as read.</action>
 </para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>File</guimenu>
 <guimenuitem>Minimize</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Minimize &choqok; window to tray.</action>
 </para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
 </shortcut>
 <guimenu>File</guimenu>
 <guimenuitem>Quit</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Quit</action> &choqok;.</para></listitem>
 </varlistentry>
 </variablelist>
 
 <variablelist>
 <title>The <guimenu>Tools</guimenu> Menu</title>
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo action="simul">&Ctrl;<keycap>F</keycap></keycombo>
 </shortcut>
 <guimenu>Tools</guimenu>
 <guimenuitem>Search</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Open search window for current account.</action>
 </para></listitem>
 </varlistentry>
 </variablelist>
 
 <variablelist>
 <title>The <guimenu>Settings</guimenu> Menu</title>
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo action="simul">&Ctrl;<keycap>U</keycap></keycombo>
 </shortcut>
 <guimenu>Settings</guimenu>
 <guimenuitem>Enable Update Timer</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Toggle</action> update timeline timer.</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <shortcut>
 <keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
 </shortcut>
 <guimenu>Settings</guimenu>
 <guimenuitem>Enable Notifications</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Toggle</action> notifications.</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>Settings</guimenu>
 <guimenuitem>Show Statusbar</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Toggle</action> the statusbar.</para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>Settings</guimenu>
 <guimenuitem>Configure Shortcuts...</guimenuitem>
 </menuchoice></term>
 <listitem><para><action><action>Configure</action> the keyboard shortcuts used
 by &choqok;.
 </action>
 </para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>Settings</guimenu>
 <guimenuitem>Configure Toolbars...</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Configure</action> the items you want to put in the
 toolbar.
 </para></listitem>
 </varlistentry>
 
 <varlistentry>
 <term><menuchoice>
 <guimenu>Settings</guimenu>
 <guimenuitem>Configure &choqok;...</guimenuitem>
 </menuchoice></term>
 <listitem><para><action>Display</action> the &choqok; settings dialog.
 </para></listitem>
 </varlistentry>
 
 </variablelist>
 
 <para>In addition &choqok; has the well known <guimenu>Help</guimenu> menu items.
 </para>
 </sect1>
 
 </chapter>
 
 
 <chapter id="credits-and-license">
 <title>Credits and License</title>
 
 <para>&choqok; copyright 2008-2015 Mehrdad Momeny <email>mehrdad.momeny@gmail.com</email>
 </para>
 <para>Documentation copyright 2009 Mehrdad Momeny <email>mehrdad.momeny@gmail.com</email>
 </para>
 
 <!-- TRANS:CREDIT_FOR_TRANSLATORS -->
 
 &underFDL;
 &underGPL;
 
 </chapter>
 
 &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:
 -->