<?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 % Brazilian-Portuguese "INCLUDE"
> 
]>
<book id="blogilo" lang="&language;">

<bookinfo id="blogiloinfo">
<title
>Manual do &kapplication;</title>

<authorgroup>
<author
>&Mehrdad.Momeny;&Mehrdad.Momeny.mail; </author>
<othercredit role="translator"
><firstname
>Marcus</firstname
><surname
>Gama</surname
><affiliation
><address
><email
>marcus.gama@gmail.com</email
> </address
></affiliation
><contrib
>Tradução</contrib
></othercredit
> 
</authorgroup>

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

<legalnotice
>&FDLNotice;</legalnotice>

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

<abstract>
<para
>O &kapplication; é um cliente de 'blogs' para o &kde;. </para>
</abstract>

<keywordset>
<keyword
>KDE</keyword>
<keyword
>blog</keyword>
</keywordset>

</bookinfo>

<chapter id="introduction">
<title
>Introdução</title>

<para
>O &kapplication; é um cliente para 'blogs'.</para>
<para
>A blog client (also called blog software or blogware) is a software designed to simplify the creation and maintenance of weblogs. As other specialized content management systems do, weblog applications support the authoring, editing, and publishing of blog posts and comments, with special functions for image management, web syndication, and moderation of posts and comments.</para>
</chapter>

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

<sect1 id="getting-started">
<title
>Iniciando</title>
<para
>In &kapplication; main window, you can create new posts, modify previous ones, remove them from the server as well as upload media files to the server. You can also save posts locally for later use.</para>
<note
><para
>Tudo isto estará disponível após você ter configurado pelo menos um 'blog' no &kapplication;.</para
></note>
<para
>Without any configured blog you can write and save some posts locally for later use.</para>
<screenshot>
<screeninfo
>Aqui está uma imagem do &kapplication;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="mainwindow.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Janela principal</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</sect1>

<sect1 id="configuring-a-blog">
<title
>Configurar um 'blog'</title>
<para
>Blog management is available in the <guilabel
>Configure &kapplication;</guilabel
> dialog, and is accessible via <menuchoice
><guimenu
>Settings</guimenu
><guimenuitem
>Configure &kapplication;...</guimenuitem
></menuchoice
> menu. Also there is a shortcut for it in the main window in <menuchoice
> <guimenu
>Blog</guimenu
><guimenuitem
>Add Blog...</guimenuitem
></menuchoice
> menu.</para>
<screenshot>
<screeninfo
>Adicionar um novo 'blog' - página <guilabel
>Básico</guilabel
></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add-blog-1.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Adicionar um novo 'blog' - página <guilabel
>Básico</guilabel
></phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>To add a blog, you simply have to insert your blog address, username and password in the corresponding fields and then click the <guibutton
>Auto Configure</guibutton
> button for the most famous blogging servers such as Wordpress. It will guess your blog, and api, and then will fetch your BlogId.</para>
<para
>And if it fails, you can manually select your blog's API type in the <guilabel
>Advanced</guilabel
> tab and click <guibutton
>Fetch ID</guibutton
> to fetch id, or enter your Blog id, if you know it. And if you are using a “right to left” language, select <guilabel
>Right To Left</guilabel
> in next combo box.</para>
<screenshot>
<screeninfo
>Adicionar um novo 'blog' - página <guilabel
>Avançado</guilabel
></screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="add-blog-2.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Adicionar um novo 'blog' - página <guilabel
>Avançado</guilabel
></phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>You can check what &kapplication; supports for your blog now, in the <guilabel
>Supported Features</guilabel
> tab.</para>
</sect1>

<sect1 id="creating-new-post">
<title
>Criar uma Nova Publicação</title>
<para
>To create a new post, in main window, you can click on <guibutton
>New Post</guibutton
> toolbar button or under <guimenu
>Post</guimenu
> menu, or simply press <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> (its shortcut).</para>
<para
>É criada uma nova publicação vazia, para que você possa escrever, configurar e depois enviar para o seu 'blog'.</para>
<para
>A janela principal do &kapplication; está dividida em duas seções, o Compositor e a Caixa de Ferramentas.</para>

<sect2
><title
>Compositor</title>
<para
>In the Composer section, you have a text field with the label <guilabel
>Title</guilabel
>, where you can write the title of the post. Below it, you have 3 tabs to edit your post in several ways. The first is a Visual Editor: it is a WYSIWYG editor and you only need to use the icons to format your text. Next tab is a &HTML; editor, where you have a text editor to edit &HTML; code of your post, with a syntax highlighted editor. And on last tab, you can view your post with your blog style, before submitting it to the server.</para>
</sect2>

<sect2>
<title
>Caixa de ferramentas</title>
<para
>A Caixa de Ferramentas possui quatro seções:</para>
<orderedlist>
<listitem>
<para
>Publicações no 'Blog'</para>
<screenshot>
<screeninfo
>Publicações no 'Blog'</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="toolbox-1.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Publicações no 'Blog'</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>Nesta seção, você poderá obter as últimas publicações do servidor.</para>
<para
>Double click on a post entry to load it into the composer and modify it or remove a post from the server.</para>
</listitem>

<listitem>
<para
>Categorias da Publicação</para>
<screenshot>
<screeninfo
>Categorias da Publicação</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="toolbox-2.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Categorias da Publicação</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>Nesta seção, você poderá selecionar as categorias e marcas para a sua publicação. As marcas deverão estar separadas por vírgulas.</para>
</listitem>

<listitem>
<para
>Opções da Publicação</para>
<screenshot>
<screeninfo
>Opções da Publicação</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="toolbox-3.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Opções da Publicação</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>Here you can select some options for the currently active post in the composer such as <guilabel
>Feedback</guilabel
> options (for example if visitors can leave a comment for this post or not), select a publish date, or a title to use for permalink of the post (for Wordpress blogs only).</para>
</listitem>

<listitem>
<para
>Itens Locais</para>
<screenshot>
<screeninfo
>Itens Locais</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="toolbox-4.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Itens Locais</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>And in the <guilabel
>Local Entries</guilabel
> section, you can double click on an entry to load it into composer, or remove it from disk.</para>
</listitem>

</orderedlist>
</sect2>

</sect1>

<sect1 id="uploading">
<title
>Enviar um arquivo multimídia para o servidor</title>
<para
>To upload a file to the server, use <menuchoice
><guimenu
>Blog</guimenu
> <guimenuitem
>Upload Media...</guimenuitem
></menuchoice
> then you are asked to select a file from your disk. Then the media upload dialog will be ready to upload it:</para>
<screenshot>
<screeninfo
>Enviar Conteúdos Multimídia</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="media-upload.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>Enviar Conteúdos Multimídia</phrase>
    </textobject>
  </mediaobject>
</screenshot>
<para
>Se a API do seu 'blog' suportar o envio de conteúdos multimídia, você terá 2 opções aqui; caso contrário, só existirá uma e será o servidor de &FTP;.</para>
<para
>You can preview your desired file here (if it has any way to preview), and select its name on the server. And then click <guibutton
>Upload</guibutton
>.</para>
<para
>If you want to upload to a &FTP; server, the absolute path of the folder is required. And you have to enter a &URL; to use for guessing the link of the file on the server.</para>
</sect1>

</chapter>

<chapter id="menu-reference">
<title
>Referência do Menu</title>

<sect1 id="file-menu">
<title
>O Menu <guimenu
>Arquivo</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
><guimenu
>Arquivo</guimenu
> <guimenuitem
>Sair</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Sai</action
> do &kapplication;</para
></listitem>
</varlistentry>
</variablelist>

</sect1>

<sect1 id="blog-menu">
<title
>O Menu <guimenu
>Blog</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><guimenu
>Blog</guimenu
> <guimenuitem
>Adicionar um 'Blog'...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Uma forma rápida de adicionar um novo 'blog'.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>'Blog'</guimenu
> <guimenuitem
>Enviar o Arquivo Multimídia...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Abre o módulo de envio de arquivos, de modo a enviar conteúdos multimídia, como as imagens, para um 'blog' ou um servidor de &FTP;.</para>
<note
><para
>Somente as APIs do MetaWeblog, MovableType e Wordpress suportam a função de envio de arquivos.</para
></note>
</listitem>
</varlistentry>

</variablelist>

</sect1>


<sect1 id="post-menu">
<title
>O Menu <guimenu
>Publicação</guimenu
></title>

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> </shortcut
> <guimenu
>Publicação</guimenu
> <guimenuitem
>Nova Publicação</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Cria uma nova publicação em branco.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>S</keycap
></keycombo
> </shortcut
> <guimenu
>Publicação</guimenu
> <guimenuitem
>Salvar Localmente</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Salva a publicação atual a nível local.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Publicação</guimenu
> <guimenuitem
>Enviar...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Abre a janela de Envio da Publicação, de modo a enviar a publicação atualmente ativa para o 'blog' atual.</para>
<para
>In submit post, you can select if this post should submit as a draft or not. And additionally as an edit of current, or as a new post.</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

<sect1 id="settings-menu">
<title
>O Menu <guimenu
>Configurações</guimenu
></title>

<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>T</keycap
></keycombo
> </shortcut
> <guimenu
>Configurações</guimenu
> <guimenuitem
>Mostrar a Caixa de Ferramentas</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Toggle</action
> the toolbox on/off.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configurações</guimenu
> <guimenuitem
>Exibir barra de status</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Toggle</action
> the statusbar.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configurações</guimenu
> <guimenuitem
>Configurar os Atalhos...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
><action
>Configura</action
> os atalhos de teclado usados pelo &kapplication;. </action>
</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configurações</guimenu
> <guimenuitem
>Configurar as Barras de Ferramentas...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Configura</action
> os itens que você deseja colocar na barra de ferramentas. </para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configurações</guimenu
> <guimenuitem
>Configurar o &kapplication;...</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Apresenta</action
> a janela de configuração do &kapplication;. </para
></listitem>
</varlistentry>
</variablelist>
</sect1>

<sect1>
<title
>O menu <guimenu
>Ajuda</guimenu
></title>
&help.menu.documentation; </sect1>

</chapter>

<chapter id="credits">

<title
>Créditos e licença</title>

<para
>&kapplication;</para>
<para
>Direitos autorais do programa 2008-2009 &Mehrdad.Momeny; &Mehrdad.Momeny.mail; e &Golnaz.Nilieh; &Golnaz.Nilieh.mail; </para>
<para
>Direitos autorais da documentação &copy; 2009 &Mehrdad.Momeny; &Mehrdad.Momeny.mail; </para>

<para
>Tradução de Marcus Gama <email
>marcus.gama@gmail.com</email
></para
> 
&underFDL; &underGPL; </chapter>

<appendix id="installation">
<title
>Instalação</title>

<sect1 id="getting-blogilo">
<title
>Como obter o &kapplication;</title>
&install.intro.documentation; </sect1>

<sect1 id="compilation">
<title
>Compilação e instalação</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;
-->
