<chapter id="getting-started">

<chapterinfo>
  <authorgroup>
    <author
><firstname
>Bernd</firstname
><surname
>Pol</surname
></author>
    <!-- ROLES_OF_TRANSLATORS -->
  </authorgroup>
</chapterinfo>

<title
>Introdução ao &kdevelop; &mdash; Uma Visita Guiada</title>

<para
>Agora que você instalou o seu IDE &kdevelop;, como é que o vai utilizar bem? Dado que esta é uma aplicação complexa, a curva de aprendizagem pode ser um pouco inclinada, principalmente se não estiver já habituado a este tipo de ambientes de desenvolvimento integrados. </para>
<para
>Iremos tentar suavizar esta curva de aprendizagem um pouco, vendo os passos de criação de uma aplicação do KDE em C++. Como tal, iremos dar uma vista de olhos (focada) em: </para>
<simplelist>
  <member
><link linkend="gettingstarted-overview"
>O que é visto à superfície do IDE do &kdevelop;.</link
></member>
  <member
><link linkend="gettingstarted-configure"
>Alguns passos de configuração iniciais.</link
></member>
  <member
><link linkend="gettingstarted-new"
>Como criar um novo projecto.</link
></member>
  <member
><link linkend="gettingstarted-edit"
>Como lidar com os documentos.</link
></member>
  <member
><link linkend="gettingstarted-compile"
>Como compilar a aplicação deste projecto.</link
></member>
  <member
><link linkend="gettingstarted-extend"
>Como adicionar classes e outros detalhes ao seu projecto.</link
></member>
  <member
><link linkend="gettingstarted-debug"
>O que fazer para depurar a aplicação.</link
></member>
  <member
><link linkend="gettingstarted-doc"
>Algumas ferramentas básicas para compilar o programa ou a documentação do utilizador.</link
></member>
</simplelist>

<sect1 id="gettingstarted-overview">
<title
>Uma Vista Introdutória sobre o &kdevelop;</title>

<sect2 id="gettingstarted-overview-basic">
<title
>À Superfície</title>

<para
>Quando você inicia o &kdevelop; pela primeira vez, irá obter uma visualização semelhante à seguinte: </para>

<screenshot>
  <mediaobject>
    <imageobject>
      <imagedata fileref="empty-ide.png" format="PNG"/>
    </imageobject>
    <caption
><para
>A disposição inicial do &kdevelop; </para
></caption>
  </mediaobject>
</screenshot>

<formalpara>
<title
>Área de Trabalho e Páginas das Janelas de Ferramentas</title>
<para
>Neste caso inicial, o &kdevelop; usa o modo denominado por <link linkend="uimodes-survey"
>modo de interface de utilizador IDEAl</link
>. Um espaço de trabalho com o tamanho máximo possível fica rodeado pela esquerda, baixo e direita por uma série de botões que actuam de forma semelhante às páginas numa área dividida em páginas. Se carregar numa destas páginas, aparece então uma <emphasis
>janela de ferramentas</emphasis
> que lhe permitirá trabalhar numa tarefa específica. </para>
</formalpara>

<formalpara>
<title
>Menu e Barras de Ferramentas</title>
<para
>No topo, existe o menu normal, seguido de várias filas de barras de ferramentas, estando algumas vazias inicialmente. Elas serão populadas, logo que exista um projecto aberto para o trabalho de facto. </para>
</formalpara>

<formalpara>
<title
>Barra de Estado</title>
<para
>Finalmente, existe uma barra de estado no fundo da janela que mostra algumas informações curtas sobre as várias tarefas. </para>
</formalpara>
</sect2
> <!-- gettingstarted-overview-basic -->

<sect2 id="gettingstarted-overview-help">
<title
>Como Obter Alguma Ajuda</title>

<para
>Para além da <guimenu
>Ajuda</guimenu
>, que oferece algumas respostas a perguntas específicas, a barra de estado e dois tipos de dicas de ferramentas oferecem algumas informações rápidas. </para>

<formalpara>
<title
>O Que Este Item do Menu Faz?</title>
<para
>Quando voce coloca o cursor do rato sobre um item do menu, existe alguma informação curta que será apresentada na barra de estado. Embora isto, em alguns casos, repita apenas o nome da selecção, noutros poderá oferecer algumas informações adicionais sobre o intuito do comando do menu.</para>
</formalpara>

<formalpara>
<title
>Qual é o Nome Deste Item?</title>
<para
>Em vários itens, irá aparecer uma dica com um nome curto da função, quando você colocar o cursor por cima dela durante alguns segundos. Isto é útil para uma orientação rápida na barra de ferramentas ou nas páginasd de ferramentas no modo IDEAl, quando o IDE tiver sido configurado para mostrar os ícones apenas nestes botões.</para>
</formalpara>

<formalpara>
<title
>O Que é Que Este Item Faz?</title>
<para
>Está disponível mais alguma informação, através da ajuda de dicas de ferramentas para muitos itens do IDE. Seleccione a opção <menuchoice
><guimenu
>Ajuda</guimenu
> <guimenuitem
>O Que É Isto?</guimenuitem
></menuchoice
> ou carregue em <keycombo
><keycap
>&Shift;</keycap
><keycap
>F1</keycap
></keycombo
>, podendo então com o cursor do ponto de interrogação seleccionar o item que deseja conhecer. Poderá também abrir qualquer menu desta forma e carregar num item específico do menu (tanto os activos como os desactivados, a cinzento) para ver se está disponível mais alguma informação.</para>
</formalpara>

</sect2
> <!-- gettingstarted-overview-help -->

<sect2 id="gettingstarted-overview-menu">
<title
>O que está nos menus</title>

<para
>Existem dez menus seleccionáveis na barra de menu. A maioria deles fica preenchida por completo, logo que um projecto tenha sido aberto para trabalho, enquanto outros necessitam pelo menos de um documento aberto. Em resumo, eles irão permitir os seguintes tipos de acção. </para>

<variablelist>
  <varlistentry>
  <term
><guimenu
>Ficheiro</guimenu
></term>
  <listitem>
    <formalpara
><title
>Acções Normais</title>
    <para
>Este menu é bastante comum. Permite criar, abrir, gravar, imprimir e fechar ficheiros de documentos, assim como sair da aplicação &kdevelop;, como é normal acontecer.</para
></formalpara>
    <formalpara
><title
>Reverter as Alterações</title>
    <para
>Para além disso, permite reverter as alterações, carregando de novo o conteúdo do ficheiro de uma forma ordeira.</para
></formalpara>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Editar</guimenu
></term>
  <listitem>
    <para
>Este menu só é útil se estiver algum documento aberto.</para>
    <formalpara
><title
>Acções Normais</title>
    <para
>Oferece as acções normais para desfazer/refazer e para cortar/copiar/colar. Para além disso, permite seleccionar blocos de texto de várias formas.</para
></formalpara>
    <formalpara
><title
>Procurar e Substituir</title>
    <para
>Existe uma funcionalidade de procura muito poderosa disponível no menu <guimenu
>Editar</guimenu
>. Para além das acções normais de procura e substituição que se limitam ao documento actual, você poderá também conduzir uma procura e substituição a nível global. Isto permite trabalhar em todos os ficheiros do projecto de uma vez.</para
></formalpara>
    <formalpara
><title
>Edição de Texto Avançada</title>
    <para
>Existem possibilidades para formatar de novo o documento actual e para completar automaticamente alguns textos escritos parcialmente de várias formas.</para
></formalpara>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Ver</guimenu
></term>
  <listitem>
    <para
>Tal como no menu <guimenu
>Editar</guimenu
>, este menu só é útil se estiver algum projecto aberto de momento. Neste caso, ficarão disponíveis as seguintes acções (entre outras):</para>
    <formalpara
><title
>Histórico de Navegação</title>
    <para
>Avance e recue pelos documentos &etc; que tenha visitado.</para>
    </formalpara>
    <formalpara
><title
>Registo de Erros</title>
    <para
>Navegue pelas linhas de código dos erros que foram encontrados no último processo de compilação/construção.</para>
    </formalpara>
    <formalpara
><title
>Gerir a Janela de Ferramentas</title>
    <para
>Seleccione ou esconda as janelas de ferramentas ou as áreas acopláveis de ferramentas.</para>
    </formalpara>
    <formalpara
><title
>Acções Relacionadas com o Editor</title>
    <para
>Alguns itens do menu <guimenu
>Ver</guimenu
> controlam a aparência e comportamento do editor que você usa. No caso do componente do &kate; (Editor de Texto Avançado Incorporado), ficarão disponíveis os seguintes controlos:</para>
    </formalpara>
    <itemizedlist>
      <listitem
><para
>Controlar o comportamento de mudança de linha na janela do documento.</para
></listitem>
      <listitem
><para
>Mostrar ou esconder vários dados nas janelas de documentos: os números de linhas, ícones e, adicionalmente, as marcações de favoritos na barra de posicionamento.</para
></listitem>
      <listitem
><para
>Controlar a visibilidade das secções dobradas (temporariamente escondidas) num texto de código.</para
></listitem>
    </itemizedlist>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Projecto</guimenu
></term>
  <listitem>
    <para
>Todo o trabalho do &kdevelop; baseia-se em <emphasis
>projectos</emphasis
> que coleccionam basicamente os ficheiros de código, os ficheiros de gestão das compilações e outras informações numa pasta de projecto. Neste menu, poderá controlar o projecto a usar, as propriedades que tem e algumas acções de gestão. Em particular:</para>
    <formalpara
><title
>Abrir um Projecto</title>
    <para
>Permite criar projectos novos, abrir projectos existentes e importar os projectos de outros ambientes.</para>
    </formalpara>
    <formalpara
><title
>Opções do Projecto</title>
    <para
>Permite definir um conjunto completo de propriedades diferentes do projecto.</para>
    </formalpara>
    <formalpara
><title
>Gestão de Classes</title>
    <para
>Adiciona novas classes ao projecto e atravessa a árvore de heranças de uma classe.</para>
    </formalpara>
    <formalpara
><title
>Distribuir o Projecto</title>
    <para
>Ajuda a distribuir os pacotes de distribuição do projecto.</para
></formalpara>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Compilar</guimenu
></term>
  <listitem>
    <para
>Este menu tem a ver com tudo o que respeita à compilação e documentação do projecto. Como tal, só é usado quando está um projecto aberto de momento. Neste caso, oferece as seguintes acções:</para>
    <formalpara
><title
>Compilar, Editar as Ligações, Executar</title>
    <para
>Permite compilar e gerar o executável do projecto completo ou de partes dele, assim como executar a aplicação a partir do IDE.</para>
    </formalpara>
    <formalpara
><title
>Preparar as Operações de Compilação</title>
    <para
>Isto depende, de facto, do sistema de compilações que usa para este projecto. No caso dos projectos do 'automake', ele permite correr o <filename
>Makefile.cvs</filename
> e o <filename
>configure</filename
> por si só. Existe também a possibilidade de remover os ficheiros traduzidos do projecto em várias etapas de intensidade.</para>
    </formalpara>
    <formalpara
><title
>Instalar a Aplicação</title>
    <para
>Permite instalar a aplicação, tanto nas pastas locais como nas pastas do sistema que só estão acessíveis para o utilizador 'root'.</para>
    </formalpara>
    <formalpara
><title
>Documentação da API</title>
    <para
>Compila ou remove a documentação da API baseada no 'doxygen' do projecto, tal como está definido nas opções do projecto.</para>
    </formalpara>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Depuração</guimenu
></term>
  <listitem>
    <para
>Ainda que este menu seja preenchido quando está activo um projecto, só é útil de facto se o projecto actual tiver sido compilado previamente com a informação de depuração (o que é definido basicamente na opção <menuchoice
><guimenu
>Projecto</guimenu
> <guimenuitem
>Opções do Projecto..</guimenuitem
></menuchoice
>). Estão disponíveis as seguintes acções neste caso:</para>
    <formalpara
><title
>Acções Normais do Depurador</title>
    <para
>A primeira secção na opção <guimenu
>Depurar</guimenu
> oferece uma interface gráfica para o depurador simbólico GDB da &GNU;. Permite iniciar e parar a sua aplicação no depurador e percorrê-lo de várias formas.</para>
    </formalpara>
    <formalpara
><title
>Pontos de Paragem</title>
    <para
>O &kdevelop; oferece várias formas de definir pontos de paragem no código da sua aplicação. Uma delas é através da opção do menu <guimenuitem
>Comutar o Ponto de Paragem</guimenuitem
>.</para>
    </formalpara>
    <formalpara
><title
>Depuração Avançada</title>
    <para
>Outras opções do menu <guimenu
>Depurar</guimenu
> permitem uma análise mais sofisticada do programa. Use o <keycombo
><keycap
>&Shift;</keycap
><keycap
>F1</keycap
></keycombo
> para obter mais informações sobre o seu objectivo.</para>
    </formalpara>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Janela</guimenu
></term>
  <listitem>
    <para
>Este menu é relativamente comum. Poderá seleccionar qualquer janela de documento aberta, assim como fechar aqui uma ou mais janelas. Poderá até seleccionar um conjunto de janelas de documentos para serem fechadas de uma vez.</para>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Ferramentas</guimenu
></term>
  <listitem>
    <para
>O &kdevelop; é altamente personalizável. Poderá seleccionar um editor favorito para os seus documentos, assim como oferecer ferramentas externas e incorporadas para extender as capacidades básicas do IDE. O menu <guimenu
>Ferramentas</guimenu
> reflecte a maior parte desta configuração.</para>
    <formalpara
><title
>Edição Avançada</title>
    <para
>O conjunto superior dos itens do menu <guimenu
>Ferramentas</guimenu
> será oferecido pelo 'plugin' do editor em uso. Poderá seleccionar o seu editor favorito coma opção menu entries will be provided by the editor plugin which is in use. You may select your favorite <menuchoice
><guimenu
>Configuração</guimenu
> <guimenuitem
>Configurar o KDevelop...</guimenuitem
> <guilabel
>Editor</guilabel
></menuchoice
>. Logo que tenha sido seleccionado um ficheiro de documento editável, a parte superior do menu <guimenu
>Ferramentas</guimenu
> irá oferecer comandos de edição avançados, específicos para a componente do editor em uso.</para>
    </formalpara>
    <formalpara
><title
>Tratamento da Parte Web</title>
    <para
>No caso de a janela do documento activa conter uma página em HTML (&eg; mostrada numa selecção de <guilabel
>Documentação</guilabel
>), o menu <guimenu
>Ferramentas</guimenu
> irá mostrar itens de menu adicionais que oferecem várias formas de lidar com as páginas Web.</para>
    </formalpara>
    <formalpara
><title
>Outras Ferramentas</title>
    <para
>Normalmente existirão um conjunto de outros itens, de acordo com as ferramentas disponíveis de momento. Use o <keycombo
><keycap
>&Shift;</keycap
><keycap
>F1</keycap
></keycombo
> para obter mais informações sobre os seus fins.</para>
    </formalpara>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Configuração</guimenu
></term>
  <listitem>
    <para
></para>
  </listitem>
  </varlistentry>
  
  <varlistentry>
  <term
><guimenu
>Ajuda</guimenu
></term>
  <listitem>
    <para
></para>
  </listitem>
  </varlistentry>
</variablelist>

</sect2
> <!--gettingstarted-overview-menu-->

</sect1
> <!-- gettingstarted-overview -->

<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->

<sect1 id="gettingstarted-configure">
<title
>Alguma Configuração</title>

<para
>(--- a ser escrito ---)</para>

</sect1
> <!-- gettingstarted-configure -->

<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->

<sect1 id="gettingstarted-new">
<title
>Como Iniciar um Projecto Novo &mdash; o &appwizard;</title>

<para
>(--- a ser escrito ---)</para>

</sect1
> <!-- gettingstarted-new -->

<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->

<sect1 id="gettingstarted-edit">
<title
>Lidar com os Documentos</title>

<para
>(--- a ser escrito ---)</para>

<sect2 id="gettingstarted-edit-codecompletion">
<title
>Como Automatizar Algumas Tarefas de Escrita</title>

<para
>(--- a ser escrito ---)</para>

</sect2
> <!-- gettingstarted-edit-codecompletion -->

</sect1
> <!-- gettingstarted-edit -->

<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->

<sect1 id="gettingstarted-compile">
<title
>Como Compilar um Projecto</title>

<para
>(--- a ser escrito ---)</para>

<sect2 id="gettingstarted-compile-messages">
<title
>O que Dizem as Mensagens</title>

<para
>(--- a ser escrito ---)</para>

</sect2
> <!-- gettingstarted-compile-messages -->

</sect1
> <!-- gettingstarted-compile -->

<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->

<sect1 id="gettingstarted-extend">
<title
>Como Extender um Projecto &mdash; o &automanag;</title>

<para
>(--- a ser escrito ---)</para>

<sect2 id="gettingstarted-extend-automake">
<title
>Uma Vista Rápida sobre a Maquinaria do Automake</title>

<para
>(--- a ser escrito ---)</para>

</sect2
> <!-- gettingstarted-extend-automake -->

<sect2 id="gettingstarted-extend-pics">
<title
>Como Colocar os Ícones numa Pasta Separada</title>

<para
>(--- a ser escrito ---)</para>

</sect2
> <!-- gettingstarted-extend-pics -->

<sect2 id="gettingstarted-extend-class">
<title
>Como Adicionar Classes Novas</title>

<para
>(--- a ser escrito ---)</para>

<caution
><para
>Tenha cuidado quando selecciona os nomes dos seus ficheiros de classes. É extremamente difícil alterá-los depois. </para
></caution>

</sect2
> <!-- gettingstarted-extend-class -->

<sect2 id="gettingstarted-extend-subproject">
<title
>O que Está num Sub-Projecto?</title>

<para
>(--- a ser escrito ---)</para>

<sect3 id="gettingstarted-extend-subproject-active">
<title
>Concentre-se no seu Trabalho &mdash; o Alvo Activo</title>

<para
>(--- a ser escrito ---)</para>

</sect3
> <!-- gettingstarted-extend-subproject-active -->

</sect2
> <!-- gettingstarted-extend-subproject -->

<sect2 id="gettingstarted-extend-restructure">
<title
>Alguns Passos para Restruturar um Projecto</title>

<para
>(--- a ser escrito ---)</para>

</sect2
> <!-- gettingstarted-extend-restructure -->


</sect1
> <!-- gettingstarted-extend -->

<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->

<sect1 id="gettingstarted-debug">
<title
>Como Depurar</title>

<para
>(--- a ser escrito ---)</para>

</sect1
> <!-- gettingstarted-debug -->

<!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->

<sect1 id="gettingstarted-doc">
<title
>Uma Nota Sobre a Documentação</title>

<para
>(--- a ser escrito ---)</para>

</sect1
> <!-- gettingstarted-doc -->

</chapter>
