# Manual do &kapptemplate;

Anne-Marie
Mahfouf

    &Anne-Marie.Mahfouf.mail;

Marcus
Gama

    marcus.gama@gmail.com

Tradução
2008
&Anne-Marie.Mahfouf;
&FDLNotice;
28/04/2008
0.1

O &kapptemplate; é um gerador de modelos para o &kde; 4.

KDE
kdesdk
KDE 4
programação
modelo
C++
python
ruby
pyqt4
pykde4
plasma
Qt 4

## Introdução

O &kapptemplate; gera modelos do &kde; 4 para o ajudá-lo a iniciar a programação no &kde; facilmente.

O &kapptemplate; oferece-lhe alguns projetos de modelos básicos, usando também os modelos do KDevelop se eles estiverem instalados no seu computador.

Por padrão, você irá encontrar:

- Uma &GUI; simples do &kde; 4

- Um modelo de KPart para o &kde; 4

- Um modelo baseado numa janela principal para o Qt4

- Um aplicativo em PyQt4

- Um aplicativo em Py&kde;4

- Um modelo em Ruby (korundum4)

- Um modelo de miniaplicativo do Plasma

Responda às perguntas do assistente em cada página e gere o seu modelo.

Um arquivo `README` em cada modelo lhe permitirá descobrir como compilar o projeto. Ele também fornecerá referências para tutoriais relacionados com o projeto. Depois de gerar o projeto, a tarefa do &kapptemplate; está terminada e você está livre para compilá-lo.

## Usando o &kapptemplate;

O &kapptemplate; é um assistente. A primeira página dele explica que o &kapptemplate; irá gerar um projeto base. Clique em Próximo para iniciar a geração do seu projeto. O botão Cancelar irá interromper o programa e sair dele. O botão de Ajuda irá mostrar este manual no &khelpcenter;.

Primeira página do &kapptemplate;
Primeira página do &kapptemplate;

A segunda página apresenta os modelos disponíveis. À direita, você poderá ver uma previsão do modelo e, abaixo, a sua descrição. Depois de selecionar o seu modelo, você será convidado a inserir o nome do projeto no campo abaixo.

Segunda página do &kapptemplate;
Segunda página do &kapptemplate;

Na terceira página, será pedida a versão do projeto, a pasta de origem e o nome e e-mail do autor. Se você tiver preenchido a sua informação pessoal na página de configuração do sistema, ela será usada como padrão.

Terceira página do &kapptemplate;
Terceira página do &kapptemplate;

A quarta e última página fornece alguns resultados sobre a geração do projeto.

Quarta página do &kapptemplate;
Quarta página do &kapptemplate;

Depois clique em Terminar para fechar o &kapptemplate;.

## De que modelo você precisa?

Este capítulo descreve os modelos, para que você possa escolher aquele que esteja melhor adaptado às suas necessidades.

### O modelo de &GUI; em C++ para o &kde; 4

Este é um modelo de &GUI; para o &kde; 4, baseado no CMake e que usa a KXMLGuiWindow e o KConfig XT. Este é um aplicativo padrão do &kde; 4.

Aqui está uma imagem do modelo de &GUI; em C++ para o &kde; 4
O modelo de &GUI; em C++ para o &kde; 4

Este modelo demonstra como você poderá criar menus do &kde; com a XMLGui e como usar o KConfig XT para mudar a configuração, usando a opção Configurações Configurar o <NomeDoAplicativo> .

Não se esqueça de ler o arquivo `README` na pasta do projeto. Você poderá encontrar alguns ótimos tutoriais para o &kde; 4 em http://techbase.kde.org/Development/Tutorials.

### O modelo de aplicativo KPart em C++ para o &kde; 4

Este é um modelo de KPart para o &kde; 4, baseado no CMake.

Aqui está uma imagem do modelo de KPart em C++ para o &kde; 4
Um modelo de KPart em C++ para o &kde; 4

Não se esqueça de ler o arquivo `README` na pasta do projeto.

### O aplicativo do plasmoide

Este modelo gera um miniaplicativo simples do Plasma com um ícone e algum texto nele.

Modelo do miniaplicativo do Plasma para o &kde; 4
Modelo do miniaplicativo do Plasma para o &kde; 4

Você precisa do &kde; 4.1 para compilar este modelo, além do próprio CMake. Você poderá ler mais sobre o assunto em http://techbase.kde.org/index.php?title=Development/Tutorials/Plasma/GettingStarted, onde todos os métodos são explicados.

Reinicie o Plasma para carregar o miniaplicativo, executando o comando `kquitapp plasma && plasma` ou veja-o com o `plasmoidviewer NomeDoSeuMiniaplicativo`.

### O aplicativo em PyQT4

O modelo gerará o seguinte aplicativo:

O aplicativo do PyQt4
O aplicativo do PyQt4

Você precisará do PyQt4 da sua distribuição.

Para executar o modelo, primeiro gere o módulo em Python a partir do Designer MeuCalendario.ui, digitando `pyuic4 -o MeuCalendario.py MeuCalendario.ui`, na sua pasta do projeto, e depois inicie o seu projeto: `python APLICACAO.py`.

### O aplicativo em PyKDE4

O modelo gerará o seguinte aplicativo:

O aplicativo do PyKDE4
O aplicativo do PyKDE4

Você precisa do PyKDE 4 da sua distribuição.

Para executar o modelo, primeiro gere o módulo em Python a partir do Designer MeuCalendario.ui, digitando `pyuic4 -o MeuCalendario.py MeuCalendario.ui`, na sua pasta do projeto, e depois inicie o seu projeto: `python APLICACAO.py`.

### O aplicativo em Ruby para o &kde;

O modelo gerará o seguinte aplicativo:

O aplicativo em Ruby do &kde;
O aplicativo em Ruby do &kde;

Você precisa do korundum4 do módulo 'kdebindings' para o &kde; 4 ou da sua distribuição, de modo a executar este modelo.

Para executar o modelo, depois de compilar e instalar o projeto (veja no `README`), digite no Konsole: `krubyapplication seu_aplicativo/main.rb`.

## Créditos e licença

- Programa com 'copyright' 1998-2003 de &Kurt.Granroth;

- Programa com 'copyright' 2006-2008 de &Anne-Marie.Mahfouf;

- Programa com 'copyright' 2008 de Beat Wolf

Contribuições:

- Ajuda no código: Beat Wolf asraniel@fryx.ch

- Modelo em Ruby: Cyrille Berger cberger@cberger.net

- Modelo em Ruby: Richard Dale Richard_Dale@tipitina.demon.co.uk >

- Modelo em Py&kde;4: Christoph Burgmer chrislb@gmx.de

Documentação com 'copyright' 2008 de &Anne-Marie.Mahfouf; &Anne-Marie.Mahfouf.mail;

Tradução de Marcus Gama marcus.gama@gmail.com

&underFDL; &underGPL;

## Instalação

### Como obter o &kapptemplate;

&install.intro.documentation;

### Compilação e instalação

&install.compile.documentation;
&documentation.index;