# O Manual do &kapptemplate;

Anne-Marie
Mahfouf

    &Anne-Marie.Mahfouf.mail;

José
Pires

    zepires@gmail.com

Tradução
2008
&Anne-Marie.Mahfouf;
&FDLNotice;
2008-04-28
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; para o ajudar a iniciar a programação no &kde; facilmente.

O &kapptemplate; oferece-lhe alguns projectos de modelos básicos, usando também os modelos do KDevelop se estiverem instalados na sua máquina.

Por omissão, irá encontrar:

- Uma aplicação &GUI; simples do &kde; 4

- Um modelo de KPart para o &kde; 4

- Um modelo baseado numa janela principal para o Qt4

- Uma aplicação em PyQt4

- Uma aplicação em Py&kde;4

- Um modelo em Ruby (korundum4)

- Um modelo de 'applet' do Plasma

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

Um ficheiro `README` em cada modelo permitir-lhe-á descobrir como compilar o projecto. Também lhe dará referências para tutoriais relacionados com o projecto. Depois de gerar o projecto, a tarefa do &kapptemplate; está terminada e você está à vontade para a compilar.

## Usar o &kapptemplate;

O &kapptemplate; é um assistente. A primeira página deste explica-lhe que o &kapptemplate; irá gerar um projecto de base. Carregue em Seguinte para iniciar a geração do seu projecto. 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, poderá ver uma antevisão do modelo e, por baixo, a sua descrição. Depois de escolher o seu modelo, está convidado a introduzir o nome do projecto no campo abaixo.

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

Na terceira página, é-lhe pedida a versão do projecto, a pasta de origem e o nome e e-mail do autor. Se tiver preenchido a sua informação pessoal na página do &systemsettings;, esta será extraída a partir daí por omissão.

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

A quarta e última página dá-lhe alguns resultados sobre a geração do projecto.

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

Depois carregue em Terminar para fechar o &kapptemplate;.

## Que modelo é que precisa?

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

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

Este é um modelo gráfico para o &kde; 4, baseado no CMake e que usa a KXMLGuiWindow e o KConfig XT. Esta é uma aplicação normal do &kde; 4.

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

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

Não se esqueça de ler o ficheiro `README` na pasta do projecto. Poderá encontrar alguns tutoriais óptimos para o &kde; 4 em http://techbase.kde.org/Development/Tutorials.

### O modelo de aplicação 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 para o &kde; 4

Não se esqueça de ler o ficheiro `README` na pasta do projecto.

### A aplicação do plasmóide

Este modelo gera uma 'applet' simples do Plasma com um ícone e algum texto nela.

Modelo da 'applet' do Plasma para o &kde; 4
Modelo da 'applet' do Plasma para o &kde; 4

Precisa do &kde; 4.1 para compilar este modelo, sendo que também necessita do CMake. Poderá ler mais sobre o assunto em http://techbase.kde.org/index.php?title=Development/Tutorials/Plasma/GettingStarted, onde se explicam todos os métodos.

Reinicie o Plasma para carregar a 'applet', executando o comando `kquitapp plasma && plasma` ou veja-a com o `plasmoidviewer NomeDaSuaApplet`.

### A aplicação em PyQT4

O modelo gerar-lhe-á a seguinte aplicação:

A aplicação do PyQt4
A aplicação do PyQt4

Necessita do PyQt4 da sua distribuição.

Para executar o modelo, primeiro gere o módulo em Python do Desenhador OMeuCalendario.ui, escrevendo `pyuic4 -o OMeuCalendario.py OMeuCalendario.ui`, na sua pasta do projecto, e depois inicie o seu projecto: `python APLICACAO.py`.

### A aplicação em PyKDE4

O modelo gerar-lhe-á a seguinte aplicação:

A aplicação do PyKDE4
A aplicação do PyKDE4

Necessita do PyKDE 4 da sua distribuição.

Para executar o modelo, primeiro gere o módulo em Python do Desenhador OMeuCalendario.ui, escrevendo `pyuic4 -o OMeuCalendario.py OMeuCalendario.ui`, na sua pasta do projecto, e depois inicie o seu projecto: `python APLICACAO.py`.

### A aplicação em Ruby para o &kde;

O modelo gerar-lhe-á a seguinte aplicação:

A aplicação em Ruby do &kde;
A aplicação em Ruby do &kde;

Necessita 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 projecto (veja no `README`), escreva no Konsole: `krubyapplication a_sua_apl/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 José Nuno Pires zepires@gmail.com

&underFDL; &underGPL;

## Instalação

### Como obter o &kapptemplate;

&install.intro.documentation;

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

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