Recursos Avançados

Christopher Hornbaker

    chrishornbaker@earthlink.net

Marcus Gama

    marcus_gama@uol.com.br

Tradução

# Recursos Avançados

Este capítulo apresenta os recursos avançados do &quantaplus; e como usá-los.

## Ferramentas &XML;

A versão 3.2 do &quantaplus; vem com muitas ferramentas e recursos &XML; novos. As ferramentas são única em sua integração com o &quantaplus;. Todas estas ferramentas usam o Kommander como uma interface e o libxml2 e libxlst como programas de base. A combinação deles torna as ferramentas rápidas, eficientes, produtivas e completas.

### Ferramentas de Documentação do &kde;

O &quantaplus; suporta as duas ferramentas de documentação principais do &kde;: `meinproc` e `checkXML`.

#### `meinproc`

Qualquer um que já trabalhou com a documentação do &kde; conhece o `meinproc` e o quão extraordinário ele é. Bem, examinaremos em detalhes com uma grande interface gráfica! Não será mais necessário um shell; simplesmente clique em um ícone que se assemelha a um processador e tudo será feito!

Pasta de Trabalho Atual

  Este aplicativo espera que um arquivo `index.docbook` esteja presente em uma pasta. Se o `index.docbook` estiver na pasta de trabalho atual, então simplesmente deixe a Pasta de Trabalho Atual selecionada. Caso contrário, então desabilite a Pasta de Trabalho Atual e insira a pasta que deseja processar no campo Outra Pasta.

Os arquivos de saída serão colocados na mesma pasta dos arquivos fontes. Todos os arquivos &HTML; serão removidos cada vez que o `meinproc` é executado.

#### `checkXML`

Novamente, qualquer um que tenha trabalhado com a documentação do &kde; conhece a utilidade deste aplicativo. Novamente, o &quantaplus; fornece uma formidável interface gráfica para ele.

Pasta de Trabalho Atual

  Se o arquivo atualmente aberto é o `index.docbook`, então simplesmente deixe Pasta de Trabalho Atual habilitado. Caso contrário, desabilite Pasta de Trabalho Atual e insira a pasta onde o `index.docbook` pode ser encontrado.

Saída

Se não houver saída, então seu arquivo é inválido. Por favor corrija os erros reportados e tente novamente.

### Validação &XML;

O &quantaplus; possui uma grande ferramenta de validação &XML;, que usa o `xmllint` como programa base.

Arquivo Atual

  Se o arquivo a ser validado está atualmente em foco no &quantaplus;, então simplesmente deixe Arquivo Atual habilitado. Caso contrário, então desabilite o Arquivo Atual e selecione o arquivo a ser validado a partir do seletor de Outro Arquivo.

Verificação de Conformação

  Se você somente deseja saber se o arquivo está conforme, clique a caixa de verificação Verificação de Conformação Somente.

Definição de &URI;

  Se você estiver usando um &DTD; e ele é especificado dentro do arquivo &XML;, então selecione &DTD; (Interno) (padrão), caso contrário selecione &DTD; (Externo) e localizar o &DTD; com o seletor de arquivo de Definição de &URI;. A validação tanto do Esquema &W3C; &XML; como a RelaxNG são necessárias para ser definido externamente através do seletor de arquivo de Definição de &URI;.

### Processando &XSL;

Sim, o &quantaplus; possui uma ferramenta de processamento &XSL; também! Ele usa a ferramenta `xsltproc` fornecida com o libxml2.

Arquivo Atual

  Se o arquivo a ser processado está atualmente em foco no &quantaplus;, então simplesmente deixe Arquivo Atual selecionado. Caso contrário, então desabilite Arquivo Atual e selecione o arquivo a ser processado a partir do seletor de Outro Arquivo.

Folha de Estilo

  Selecione o arquivo &XSL; que você deseja usar.

Nome do arquivo de saída

  Insira o nome do arquivo no qual você deseja que o resultado seja salvo. O arquivo é gerado na sua pasta pessoal por padrão.

Este aplicativo perde flexibilidade. Desculpe, nós faremos melhor na próxima vez.

Usando Plugins

Mathieu Kooiman

    quanta@map-is.nl

Marcus Gama

    marcus_gama@uol.com.br

Tradução

## Usando Plugins

### O que é um Plugin?

O &quantaplus; é capaz de carregar plugins, que são KParts. O ambiente de trabalho de KPart é outro potencialidade do ambiente de trabalho do &kde;. Um KPart é um pedaço de funcionalidade reusável relativamente pequeno. Ele permite aos desenvolvedores do &kde; facilmente construir a partir do trabalho de outros programadores. Um exemplo disto é o próprio &quantaplus;. O editor do &quantaplus; usa o KPart &kate;. O KPart &kate; já possui um conjunto de funcionalidades que o &quantaplus; precisa, como destaque de sintaxe. Integrando-o ao &quantaplus; permite aos desenvolvedores do &quantaplus; focar no que o &quantaplus; deve ser capaz de fazer, ao invés de enfrentar os muitos problemas que o desenvolvimento de um novo componente/KPart de editor a partir do zero trará.

Os plugins que o &quantaplus; carrega não devem fazer nada com o &quantaplus; propriamente dito. Isto faz dele um sistema de plugin poderoso. Você pode beneficiar-se de funcionalidades extras sem precisar esperar que alguém integre-as ao &quantaplus;! Os plugins podem ser carregados em diversos elementos de &GUI;. Mais sobre isto pode ser visto abaixo.

### Entendendo o Diálogo de Edição de Plugin

Para instalar um Plugin ou KPart nós trabalharemos a partir do menu Plugins Editar . Isto trará o seguinte diálogo:

O diálogo Editar Plugin.

Este diálogo permite gerenciar todos os plugins definidos além de adicionar novos. Nós descreveremos cada elemento de &GUI; aqui:

Caminhos de busca

  Aqui você pode preencher um caminho de busca. Ao adicionar um plugin sem uma Localização, o &quantaplus; buscará nestes caminhos pelo plugin.

Adicionar

  Isto trará um diálogo que permite adicionar um novo plugin.

Configurar

  Isto permitirá mudar as configurações de um plugin em particular.

Remover

  Remove o plugin atualmente selecionado.

Atualizar

  Atualiza o conteúdo do diálogo.

Read to learn more about plugins.

## Desenvolvimento em Equipe

Muitas vezes, um projeto tem mais de uma pessoa trabalhando nele e existe alguma espécie de relação hierárquica entre eles. O &quantaplus; suporta a noção de membros do projeto e eles são configurados no diálogo em &Shift;F7 Projeto Propriedades do Projeto .

O diálogo do editor dos membros da equipe

Os itens do Nome, E-mail são auto-explicativos.

O Papel define o papel do membro no projeto e poderá ser um dos seguintes:

- Líder da Equipe

- Lider do Subprojeto

- Lider da Tarefa

- Membro Normal

A Tarefa é uma descrição da tarefa atribuída a este membro.

Sub-projeto: você poderá selecionar uma lista de sub-projetos. Eles poderão ser configurados e criados pressionando o botão Editar sub-projetos. Cada sub-projeto tem um nome visível de usuário e um item de localização, correspondendo o último a uma localização relativa de uma pasta sob a árvore do projeto. Isto significa que um sub-projeto é uma pasta sob o projeto principal. Por exemplo, o projeto principal poderá ser a página Web da sua companhia, enquanto um sub-projeto poderá ser a página Web da Intranet, localizada sob a pasta `intranet` do projeto.

Um membro poderá ter mais de um papel no projeto, como ser líder da equipe e do sub-projeto.

Além de manter um registro da sua equipe, existe mais um benefício na configuração dos membros da equipe: você poderá configurar um evento para informar os líderes da equipe quando acontecer alguma ação. Veja em como fazê-lo.

## Ações do Evento

As ações de eventos são ações que são executadas quando algum evento ocorre no projeto. Um desses exemplos poderá ser o registro de quando o projeto foi aberto e fechado da última vez, para que possa ser analisado posteriormente quanto cada um trabalhou ou para enviar uma mensagem de e-mail quando for gravado um arquivo, ou ainda para adicionar o arquivo ao CVS com a ajuda de um programa, quando desejar adicionar o arquivo ao projeto; e esta lista poderá continuar.

Na página de Configuração do Evento no diálogo de &Shift;F7 Projeto Propriedades do Projeto , você poderá criar, editar e remover as ações do evento.

O diálogo do editor de evento

Os itens no diálogo são:

Evento

  a ação é executada quando ocorrer o evento selecionado na lista. Os nomes dos eventos são suficientemente claros.

Ação

  o tipo da ação executada. As escolhas possíveis são

  Ação sem programa

    uma ação que não é uma ação de um programa definido pelo usuário. Veja as ações do usuário em .

    Nome da ação indica a ação a executar quando ocorrer o evento.

  Enviar um e-mail

    é enviado um e-mail quando ocorrer a ação para o destinatário selecionado na lista do Destinatário. Ele poderá ser um líder de equipe ou de um sub-projeto. Veja em a definição destes líderes.

  Registrar o evento

    o evento é registrado num arquivo. Os argumentos desta ação são:

    Arquivo de registro

      o nome completo e a localização do arquivo

    Detalhe

      Quanta informação irá conter este registro

    Comportamento

      Se deve criar/sobrepor o arquivo de registro existente ou adicionar o novo evento a ele.

  Ação de programa

    uma ação de um programa definido pelo usuário. Veja em as ações do usuário.

    Nome da ação indica a ação a executar quando ocorrer o evento.

Os outros itens dependem do tipo de Ação com que foram descritos.

&debugging-quanta;