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

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

<authorgroup>
<author
>&Mehrdad.Momeny;&Mehrdad.Momeny.mail; </author>
<othercredit role="translator"
><firstname
>José</firstname
><surname
>Pires</surname
><affiliation
><address
><email
>zepires@gmail.com</email
></address
></affiliation
><contrib
>Tradução</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
>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
>Um cliente de 'blogs' (também chamado de 'software' de 'blogs' ou 'blogware') é uma aplicação desenhada para simplificar a criação e manutenção de 'weblogs' ('blogs' ou blogues). Como acontece nos outros sistemas de gestão de conteúdos especializados, estas aplicações suportam a criação, edição e publicação de textos e comentários de 'blogs', com mais algumas funções especiais para a gestão de imagens, a sindicância Web e a moderação de publicações e comentários.</para>
</chapter>

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

<sect1 id="getting-started">
<title
>Introdução</title>
<para
>Na janela principal do &kapplication;, poderá criar publicações novas, modificar as anteriores, removê-las do servidor e enviar ficheiros multimédia para o mesmo. Poderá também gravar localmente as publicações para uso posterior.</para>
<note
><para
>Todas estas estarão disponíveis, após ter configurado pelo menos um 'blog' no &kapplication;.</para
></note>
<para
>Sem qualquer 'blog' configurado, poderá escrever e gravar algumas publicações localmente para uso posterior.</para>
<screenshot>
<screeninfo
>Aqui está uma imagem do &kapplication;</screeninfo>
  <mediaobject>
    <imageobject>
      <imagedata fileref="mainwindow.png" format="PNG"/>
    </imageobject>
    <textobject>
      <phrase
>A Janela Principal</phrase>
    </textobject>
  </mediaobject>
</screenshot>
</sect1>

<sect1 id="configuring-a-blog">
<title
>Configurar um 'blog'</title>
<para
>A gestão do 'blog' está disponível na janela <guilabel
>Configurar o &kapplication;</guilabel
>, estando acessível através da opção do menu <menuchoice
><guimenu
>Configuração</guimenu
><guimenuitem
>Configurar o &kapplication;...</guimenuitem
></menuchoice
>. Do mesmo modo, existe um atalho para ela na janela principal, em <menuchoice
> <guimenu
>Blog</guimenu
><guimenuitem
>Adicionar um 'Blog'...</guimenuitem
></menuchoice
>.</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
>Para adicionar um 'blog', basta introduzir o endereço, o utilizador e a senha para o mesmo nos campos correspondentes, carregando depois no botão <guibutton
>Auto Configurar</guibutton
> para os servidores mais conhecidos, como o Wordpress. Irá determinar o seu 'blog', a API respectiva e irá então obter o seu ID de 'blog'.</para>
<para
>Se for mal-sucedido, poderá seleccionar manualmente o tipo de API do seu 'blog' na página <guilabel
>Avançado</guilabel
> e carregar em <guibutton
>Obter o ID</guibutton
> para obter o código de identificação, ou então indicar o seu ID de 'blog', caso o conheça. Finalmente, se estiver a usar uma língua escrita "da direita para a esquerda", seleccione a opção <guilabel
>Direita para a Esquerda</guilabel
> na lista seguinte.</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
>Poderá verificar agora o que o &kapplication; suporta para o seu 'blog' na página de <guilabel
>Funcionalidades Suportadas</guilabel
>.</para>
</sect1>

<sect1 id="creating-new-post">
<title
>Criar uma Nova Publicação</title>
<para
>Para criar uma nova publicação na janela principal, poderá carregar no botão <guibutton
>Nova Publicação</guibutton
> da barra de ferramentas, no menu <guimenu
>Publicação</guimenu
> ou simplesmente carregar em <keycombo action="simul"
>&Ctrl;<keycap
>N</keycap
></keycombo
> (o seu atalho respectivo).</para>
<para
>É criada uma nova publicação vazia, para que a possa escrever, configurar e depois enviar para o seu 'blog'.</para>
<para
>A janela principal do &kapplication; está dividida em duas secções, o Compositor e a Caixa de Ferramentas.</para>

<sect2
><title
>Compositor</title>
<para
>Na secção do Compositor, tem um campo de texto com a legenda <guilabel
>Título</guilabel
>, onde poderá escrever o título da publicação.  Por baixo, tem 3 páginas para editar a sua publicação de várias formas. A primeira é um Editor Visual: é um editor WYSIWYG e só terá de usar os ícones para formatar o seu texto. A página seguinte é um editor de &HTML;, onde tem um editor de texto para editar o código em &HTML; da sua publicação, tendo este o realce de sintaxe activado. Finalmente, poderá ver a sua publicação com o estilo do seu 'blog', antes de o enviar de facto para o servidor.</para>
</sect2>

<sect2>
<title
>Caixa de ferramentas</title>
<para
>A Caixa de Ferramentas tem quatro secçõ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 secção, poderá obter as últimas publicações do servidor.</para>
<para
>Faça duplo-click sobre um item de publicação para o carregar no compositor e modificá-lo, ou então para remover uma publicação do servidor.</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 secção, poderá seleccionar 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
>Aqui poderá seleccionar algumas opções para a publicação activa de momento no compositor, como as opções de <guilabel
>Reacções</guilabel
> (por exemplo, se os visitantes poderão deixar comentários para esta publicação ou não), seleccionar uma data de publicação ou um título a usar como hiperligação permanente para a publicação (apenas no caso dos 'blogs' do Wordpress).</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
>E na secção de <guilabel
>Itens Locais</guilabel
>, poderá fazer duplo-click sobre um item para o carregar no compositor ou removê-lo do disco.</para>
</listitem>

</orderedlist>
</sect2>

</sect1>

<sect1 id="uploading">
<title
>Enviar um ficheiro multimédia para o servidor</title>
<para
>Para enviar um ficheiro para o servidor, use a opção <menuchoice
><guimenu
>Blog</guimenu
> <guimenuitem
>Enviar o Ficheiro Multimédia...</guimenuitem
></menuchoice
>, sendo-lhe depois pedido para seleccionar um ficheiro do seu disco. Depois, a janela de envio de ficheiros ficará pronta para o enviar:</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, terá 2 opções aqui; caso contrário, só existirá uma e será o servidor de &FTP;.</para>
<para
>Poderá antever aqui o seu ficheiro desejado (se tiver alguma forma de antevisão possível) e seleccionar o seu nome no servidor. Depois, carregue em <guibutton
>Enviar</guibutton
>.</para>
<para
>Se quiser enviar para um servidor de &FTP;, é necessária a localização absoluta da pasta, pelo que terá de indicar o &URL; a usar para adivinhar a referência do ficheiro no servidor.</para>
</sect1>

</chapter>

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

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

<variablelist>
<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>Q</keycap
></keycombo
> </shortcut
> <guimenu
>Ficheiro</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 Ficheiro Multimédia...</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Abre o módulo de envio de ficheiros, de modo a enviar conteúdos multimédia, como as imagens, para um 'blog' ou um servidor de &FTP;.</para>
<note
><para
>Somente as API's do MetaWeblog, MovableType e Wordpress suportam a função de envio de ficheiros.</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
>Gravar Localmente</guimenuitem
> </menuchoice
></term>
<listitem
><para
>Grava a publicação actual 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 activa de momento para o 'blog' actual.</para>
<para
>Ao enviar a publicação, poderá seleccionar se esta deverá ser enviada como rascunho ou não, como uma edição da actual ou como uma nova publicação.</para>
</listitem>
</varlistentry>

</variablelist>

</sect1>

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

<variablelist>

<varlistentry>
<term
><menuchoice
><shortcut
> <keycombo action="simul"
>&Ctrl;<keycap
>T</keycap
></keycombo
> </shortcut
> <guimenu
>Configuração</guimenu
> <guimenuitem
>Mostrar a Caixa de Ferramentas</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Activa/desactiva</action
> a barra de ferramentas.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Mostrar a Barra de Estado</guimenuitem
> </menuchoice
></term>
<listitem
><para
><action
>Activa ou desactiva</action
> a barra de estado.</para
></listitem>
</varlistentry>

<varlistentry>
<term
><menuchoice
><guimenu
>Configuração</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ção</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ção</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
>Programa com 'copyright' 2008-2009 de &Mehrdad.Momeny; &Mehrdad.Momeny.mail; e &Golnaz.Nilieh; &Golnaz.Nilieh.mail; </para>
<para
>Documentação com 'copyright' &copy; 2009 de &Mehrdad.Momeny; &Mehrdad.Momeny.mail; </para>

<para
>Tradução de José Nuno Pires <email
>zepires@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;
-->