<?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 "kdepim">
  <!ENTITY % addindex "IGNORE">
  <!ENTITY % Catalan  "INCLUDE"
> 
]>
<book id="blogilo" lang="&language;">

<bookinfo id="blogiloinfo">
<title
>El manual de &kapplication;</title>

<authorgroup>
<author
>&Mehrdad.Momeny;&Mehrdad.Momeny.mail; </author>
&traductor.Antoni.Bella; 
</authorgroup>

<copyright>
<year
>2009</year>
<holder
>&Mehrdad.Momeny;</holder>
</copyright>

<legalnotice
>&FDLNotice;</legalnotice>

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

<abstract>
<para
>&kapplication; és un client de bloc per al &kde;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>bloc</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introducció</title>

<para
>&kapplication; és un client de bloc.</para>
<para
>Un client de bloc (també anomenat programari bloc o blogware) és programari dissenyat per simplificar la creació i manteniment de blocs web. Com ho fan altres sistemes especialitzats de gestió de continguts, les aplicacions de bloc web suporten la creació, edició i publicació d'articles al bloc i comentaris, amb funcions especials per a la gestió d'imatges, la sindicació web, i la moderació dels articles i comentaris.</para>
</chapter>

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

<sect1 id="getting-started">
<title
>Com començar</title>
<para
>A la finestra principal de &kapplication;, podeu crear nous articles, modificar els anteriors, eliminar-los del servidor, així com pujar fitxers al servidor dels medis. També podeu desar els articles localment per al seu posterior ús.</para>
<note
><para
>Tots això estarà disponible després de configurar com a mínim un bloc a &kapplication;.</para
></note>
<para
>Sense cap bloc configurat podeu escriure i desar articles localment per al seu posterior ús.</para>
<screenshot>
<screeninfo
>Aquesta és una captura de pantalla de &kapplication;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="mainwindow.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Finestra principal</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</sect1>

<sect1 id="configuring-a-blog">
<title
>Configurar un bloc</title>
<para
>La gestió del bloc està disponible en el diàleg <guilabel
>Configura &kapplication;</guilabel
>, i és accessible a través del menú <menuchoice
><guimenu
>Arranjament</guimenu
><guimenuitem
>Configura &kapplication;...</guimenuitem
></menuchoice
>, o de manera alternativa a través del menú <menuchoice
> <guimenu
>Bloc</guimenu
><guimenuitem
>Afegeix bloc...</guimenuitem
></menuchoice
>.</para>
<screenshot>
<screeninfo
>Afegir un nou bloc: pestanya <guilabel
>Bàsic</guilabel
></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add-blog-1.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Afegir un nou bloc: pestanya <guilabel
>Bàsic</guilabel
></phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>Per afegir un bloc, simplement haureu d'inserir l'adreça del bloc, nom d'usuari i contrasenya en els camps corresponents i feu clic al botó <guibutton
>Configura automàticament</guibutton
> per als servidors de blocs més populars, com Wordpress. L'agafarà com al vostre bloc, i api, i després obtindrà el vostre identificador de bloc.</para>
<para
>I si falla, podeu seleccionar manualment el tipus d'API del bloc a la pestanya <guilabel
>Avançat</guilabel
> i feu clic a <guibutton
>Obtén l'ID</guibutton
> per obtenir l'identificador, o introduir el vostre identificador de bloc, si ja el coneixeu. I si esteu utilitzant una idioma de «dreta a esquerra», seleccioneu <guilabel
>De dreta a esquerra</guilabel
> en la llista desplegable.</para>
<screenshot>
<screeninfo
>Afegir un nou bloc: pestanya <guilabel
>Avançat</guilabel
></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add-blog-2.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Afegir un nou bloc: pestanya <guilabel
>Avançat</guilabel
></phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>És possible comprovar què suporta &kapplication; per al vostre bloc, a la pestanya <guilabel
>Característiques implementades</guilabel
>.</para>
</sect1>

<sect1 id="creating-new-post">
<title
>Crear un nou article</title>
<para
>Per crear un article nou, a la finestra principal, podeu fer clic al botó <guibutton
>Nou article</guibutton
> de la barra d'eines o al menú <guimenu
>Article</guimenu
>, o simplement premeu <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> (la seva drecera).</para>
<para
>Es crea un article nou i buit, i el podeu escriure i configurar per ai després enviar-lo a un bloc.</para>
<para
>La finestra principal de &kapplication; es divideix en dues seccions, editor i quadre d'eines.</para>

<sect2
><title
>Editor</title>
<para
>A la secció de l'editor, teniu un camp de text amb l'etiqueta <guilabel
>Títol</guilabel
>, on podeu escriure el títol de l'article. A sota seu, hi ha tres pestanyes per editar l'article. La primera és un editor visual: és un editor de WYSIWYG i només haureu d'utilitzar les icones per donar format al text. La següent pestanya és un editor d'&HTML;, on disposeu d'un editor de text per editar el codi &HTML; del vostre article, amb un editor amb ressaltat de la sintaxi. I a l'última pestanya, podeu veure el vostre article a l'estil del bloc, abans d'enviar-lo al servidor.</para>
</sect2>

<sect2>
<title
>Quadre d'eines</title>
<para
>El quadre d'eines té quatre seccions:</para>
<orderedlist>
<listitem>
<para
>Articles del bloc</para>
<screenshot>
<screeninfo
>Articles del bloc</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="toolbox-1.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Articles del bloc</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>En aquesta secció, podeu obtenir els últims articles des del servidor.</para>
<para
>Feu doble clic sobre una entrada d'article per carregar-la a l'editor i modificar-la, o seleccioneu un missatge i utilitzeu el botó corresponent per a que s'elimini del servidor. </para>
</listitem>

<listitem>
<para
>Categories de l'article</para>
<screenshot>
<screeninfo
>Categories de l'article</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="toolbox-2.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Categories de l'article</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>En aquesta secció podeu seleccionar les categories i etiquetes per al vostre article. Les etiquetes han d'estar separades per comes.</para>
</listitem>

<listitem>
<para
>Opcions de l'article</para>
<screenshot>
<screeninfo
>Opcions de l'article</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="toolbox-3.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Opcions de l'article</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>Aquí podeu seleccionar les opcions per a l'article actualment a l'editor, com les opcions de <guilabel
>Opinions</guilabel
> (per exemple, si els visitants poden o no deixar un comentari per aquest article), seleccioneu una data de publicació, o un títol que s'utilitzarà per a l'enllaç permanent de l'article (sols per a blocs de Wordpress).</para>
</listitem>

<listitem>
<para
>Entrades locals</para>
<screenshot>
<screeninfo
>Entrades locals</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="toolbox-4.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Entrades locals</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>I en la secció <guilabel
>Entrades locals</guilabel
>, podeu fer doble clic sobre una entrada per a carregar-la a l'editor, o podeu eliminar-la del disc.</para>
</listitem>

</orderedlist>
</sect2>

</sect1>

<sect1 id="uploading">
<title
>Carregar un fitxer de suports al servidor</title>
<para
>Per carregar un fitxer al servidor, utilitzeu <menuchoice
><guimenu
>Bloc</guimenu
> <guimenuitem
>Puja suport...</guimenuitem
></menuchoice
>. Després se us demanarà que seleccioneu un fitxer del vostre disc. A continuació, es mostrarà el diàleg per pujar suports:</para>
<screenshot>
<screeninfo
>Pujar el suport...</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="media-upload.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Pujar el suport</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>Si una API de bloc és compatible amb la càrrega de suports, aquí disposareu de dues opcions, i si no, només n'hi haurà una i és servidor &FTP;.</para>
<para
>Aquí podeu veure una vista prèvia del fitxer desitjat (si hi ha un mètode de vista prèvia disponible ), i introduïu el seu nom al servidor. I després feu clic a <guibutton
>Puja</guibutton
>. </para>
<para
>Si voleu pujar a un servidor &FTP;, és necessari el camí absolut de la carpeta. I cal introduir un &URL; que s'utilitzarà per identificar l'enllaç del fitxer al servidor.</para>
</sect1>

</chapter>

<chapter id="menu-reference">
<title
>Referència del menú</title>

<sect1 id="file-menu">
<title
>El menú <guimenu
>Fitxer</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Fitxer</guimenu
> <guimenuitem
>Surt</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Surt</action
> de &kapplication;.</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="blog-menu">
<title
>El menú <guimenu
>Bloc</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Bloc</guimenu
> <guimenuitem
>Afegeix bloc...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Una manera ràpida d'afegir un nou bloc.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Bloc</guimenu
> <guimenuitem
>Puja suport...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Obre el pujador de suports, per carregar fitxers com imatges al bloc o servidor &FTP;.</para>
<note
><para
>Només les API de MetaWeblog, MovableType i WordPress suporten la funció de pujada de suports.</para
></note>
</listitem>
</varlistentry>

</variablelist>

</sect1>


<sect1 id="post-menu">
<title
>El menú <guimenu
>Article</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Article</guimenu
> <guimenuitem
>Nou article</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Crea un article nou i buit.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Article</guimenu
> <guimenuitem
>Desat localment</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Desa localment l'article actual.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Article</guimenu
> <guimenuitem
>Envia...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Obre el diàleg per pujar l'article, per pujar l'article actualment actiu al bloc actual.</para>
<para
>En pujar l'article, podeu seleccionar si aquest s'haurà de pujar com un esborrany. I, de manera addicional, com una edició d'un article existent, o com un article nou. </para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-menu">
<title
>El menú <guimenu
>Arranjament</guimenu
></title>

<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>T</keycap
></keycombo
> </shortcut
> <guimenu
>Arranjament</guimenu
> <guimenuitem
>Mostra el quadre d'eines</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra o oculta</action
> el quadre d'eines.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Mostra la barra d'eines</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra o oculta</action
> la barra d'eines.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Mostra la barra d'estat</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra o oculta</action
> la barra d'estat.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Configura dreceres... </guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
><action
>Configura</action
> les dreceres de teclat utilitzades per &kapplication;. </action>
</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Configura barres d'eines...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura</action
> els elements que voleu posar a la barra d'eines. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Arranjament</guimenu
> <guimenuitem
>Configura &kapplication;...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Mostra</action
> el diàleg de configuració de &kapplication;. </para
></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1>
<title
>El menú <guimenu
>Ajuda</guimenu
></title>
&help.menu.documentation; </sect1>

</chapter>

<chapter id="credits">

<title
>Crèdits i llicència</title>

<para
>&kapplication;</para>
<para
>Copyright del programa 2008-2009 &Mehrdad.Momeny; &Mehrdad.Momeny.mail; i &Golnaz.Nilieh; &Golnaz.Nilieh.mail; </para>
<para
>Copyright de la documentació &copy; 2009 &Mehrdad.Momeny; &Mehrdad.Momeny.mail; </para>

<para
>Traductor de la documentació: &credits.Antoni.Bella;</para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instal·lació</title>

<sect1 id="getting-blogilo">
<title
>Com obtenir &kapplication;</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Compilació i instal·lació</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;
-->
