# &koffice;

## Introdução

### Componentes do &koffice;

O &koffice; é um pacote de escritório integrado para o Ambiente de Trabalho K (&kde;). O &koffice; consiste atualmente dos seguintes programas:

- &kword; (processador de textos baseado em quadros)

- &kspread; (uma aplicação de planilha)

- &kpresenter; (apresentações na tela e slides)

- &kivio; (uma aplicação de fluxogramas)

- Karbon14 (uma aplicação de gráficos vetoriais)

- &krita; (uma aplicação de desenho rasterizado ou baseado em pixel)

- &kugar; (uma ferramenta para gerar relatórios de qualidade empresarial)

- Kexi (um ambiente integrado de gerenciamento de dados)

- &kchart; (uma aplicação de geração de gráficos)

- &kformula; (um editor de fórmulas matemáticas)

Uma vez que se baseiam no modelo de componentes KParts, os programas do &koffice; estão desenhados para funcionar muito bem uns com os outros. Qualquer componente do &koffice; poderá ser incorporado em outro documento do &koffice;. Por exemplo, você poderá inserir uma tabela que tenha criado no &kspread; diretamente em um documento do &kword;. Desta forma, pode-se criar documentos compostos e complexos com os programas do &koffice;.

Um mecanismo de plugins torna simples a extensão da funcionalidade do &koffice;. Você irá encontrar vários plugins em alguns dos componentes e poderá aprender a criar plugins você mesmo. Existe também uma seção neste manual dedicada à criação de plugins, na qual poderá aprender como fazer isso.

Este manual cobre somente os recursos gerais do &koffice;, aqueles que são comuns à maioria ou todos os programas do pacote. Para informações detalhadas sobre os diferentes programas, dê uma olhada nos seus respectivos manuais.

### Visão geral dos recursos do &koffice;

#### Integração

O &koffice; oferece uma plataforma onde todos os componentes são construídos. Através desta plataforma, consegue-se uma alta integração. É possível desenvolver o seu próprio componente, para que se integre da mesma forma. Esta tecnologia está descrita em mais profundidade no capítulo das KParts.

#### Leve

Apesar de oferecer tantos componentes, o &koffice; é muito leve, rápido e tem um consumo de memória relativamente pequeno. Isto também acontece porque o &koffice; está construído sobre o &kde;, que por si só já é uma plataforma de desenvolvimento de aplicações muito poderosa.

Um objetivo do &koffice; é também não sobrecarregar a interface do usuário com recursos que raramente são necessários. Isto resulta numa interface leve e útil e que lhe permite trabalhar de forma eficiente.

Ser leve poderá às vezes significar que alguma funcionalidade em especial que necessite não esteja lá. Nesse caso, você poderá sempre adicionar esta funcionalidade você mesmo ao estender o &koffice;. O &koffice; não necessita de fato de ficar cheio de blocos de recursos que só algumas pessoas possam necessitar. Essas opções poderão ficar ainda disponíveis através de plugins ou 'scripts' adicionais, tornando o próprio &koffice; muito mais leve.

#### Completo

O &koffice; oferece uma grande gama de componentes, que cobrem a maioria das necessidades de escritório e domésticas. As funcionalidades adicionais podem ser sempre implementadas através de 'scripts', plugins ou mesmo componentes inteiros baseados na plataforma do &koffice;.

#### Formato OpenDocument do OASIS

É de grande importância, para qualquer pacote de escritório, aderir a normas bem estabelecidas. Especialmente a nível do formato de arquivos, para permitir uma troca de documentos transparente com outros pacotes de escritório. Isto evita também a dependência de fornecedores, o que é especialmente importante para empresas e também para indivíduos.

Por esta razão, o &koffice; adotou o formato OpenDocument da OASIS como formato nativo.

#### Funcionalidades do KDE

Uma vez que o &koffice; funciona sobre o &kde;, todas as funcionalidades que poderia se esperar de uma aplicação do &kde; estão também disponíveis no &koffice;. Isto inclui o DCOP, o KParts, integração com o ambiente de trabalho, capacidade de configuração e assim por diante. Tudo isto torna a aparência e comportamento do &koffice; muito familiar e realmente integra o &koffice; no ambiente de trabalho, o que possibilita fluxos de trabalho transparentes.

## Tecnologia do &koffice;

### KParts - o construtor de blocos do &koffice;

Cada aplicativo do &koffice; foi desenvolvido para preencher necessidades muito específicas. Por exemplo, o &kspread; é um programa para manipulação de planilhas, enquanto o &kword; é um programa para processamento de texto. Através do foco em áreas específicas, cada programa busca a perfeição exatamente em sua área. No entanto, dependendo do que você deseja fazer com o &koffice;, você frequentemente desejará obter vantagens das funcionalidades providas por diferentes aplicativos, mas no mesmo documento.

Suponhamos que você esteja preparando um documento no &kword; e você deseje ilustrar algum ponto usando uma tabela. Apesar do &kword; prover sua própria funcionalidade para inserção de tabelas, ela pode não ser suficiente para suas necessidades. Por exemplo, você pode desejar usar determinados formatos de dados monetários ou realizar cálculos usando fórmulas de planilha. Agora, algum programador do &kword; certamente poderia tentar implementar esta funcionalidade. No entanto, o &kword; nunca será tão bom quanto o &kspread; neste campo, e se ele tentar implementar todas as funcionalidades que você possivelmente necessitará, ele acabará criando um complexo e incompreensível código fonte, tornando impossível mantê-lo.

A alternativa para isso é o KParts. Sua filosofia é simples: deixe cada aplicativo fazer o que faz melhor.

#### Compondo documentos com o KParts

Com o KParts, seus documento podem usar todas funcionalidades oferecidas por todos aplicativos do &koffice;. Você pode obter estas vantagens através da sinserção das chamadas partes em seu documento. Cada uma destas partes são essencialmente outros documentos, que são um documento dentro de outro documento.

No exemplo mencionado acima, você pode simplesmente inserir uma parte do &kspread; em seu documento &kword;. Então, sempre que você editar sua tabela, o &kspread; irá tomar o controle em segundo plano. O controle retornará para o &kword; quando você parar de trabalhar na tabela e voltar a trabalhar no texto. A única mudança que você perceberá são as barras de ferramentes e menus que, durante a edição da tabela, refletirão a funcionalidade do &kspread; ao invés do &kword;. Esta abilidade de incluir a funcionalidade de um aplicativo outro é chamada embutimento.

#### Usando KParts em seu documento

Se você nunca trabalhou com documentos compostos, você pode achá-los confusos no início. As instruções passo-a-passo a seguir lhe mostrará que usar KParts é tão fácil quanto trabalhar com um aplicativo único.

#### Inserindo uma parte &kspread; num aplicativo &kword;.

1. Inicie o &kword;. Você pode fazer isso clicando no painel ou menu ou digitando ``kword`` na linha de comando.

2. Inicie um novo documento em branco. Você pode desejar digitar algum texto para exemplo.

3. Selecione Inserir Quadro de Objeto Planilhas. Você observará que o cursor do mouse mudará para uma cruz. Esta forma do cursor indica que você deve selecionar uma área.

4. Pressione o &LMB; onde você deseja que seja o canto superior esquerdo de sua tabela, mantenha-o pressionado e mova-o para o canto inferior direito. Solte o botão. Agora um diálogo aparece fornecendo a possibilidade de inserir um documento existente ou criar um novo. Crie uma planilha em branco. É isto -- você terminou.

Fácil, não? Você pode agora ver um quadro de tabela em seu documento &kword;. Agora, dê um duplo-clique dentro da tabela e veja o quê acontece. Você notará que:

- Sua barra de menu e barra de ferramentas mudou. Elas agora refletem as do &kspread;.

- Seu quadro de tabela agora contém alguns elementos visuais do &kspread;, com barras de rolagem, uma barra de abas para seleção de tabelas, &etc;.

Tente editar a tabela. Você verá que isto não é diferente de usar o &kspread;. De fato você está usando o &kspread;.

Agora clique em algum lugar de seu documento &kword; fora da área da tabela. As barras de menu e de ferramentas irão retornar para as do &kword;, os elementos do &kspread; visualizados irão desaparecer. Sua tabela se mantém e ainda reflete as mudanças realizadas por você.

KParts é fácil de usar. Tente inserir outras partes ou cada parte em partes.

## Configurando o &koffice; e o Seu Sistema

Embora o &koffice; deva funcionar bastante bem por si só, poderão haver algumas coisas a otimizar para obter o melhor do &koffice;. Este capítulo mostra-lhe o que poderá fazer para atingir melhores resultados com o seu novo pacote de escritório e adequá-lo às suas necessidades. O &koffice; é altamente configurável, mesmo ao nível de detalhe das barras de ferramentas e dos menus.

### Otimizando a Saída de Fontes

Fontes são um tópico difícil no X Windows. Nesta seção nós iremos cobrir alguns problemas que são frequentemente relatados por pessoas que usam o &koffice;. Alguns problemas não são falhas do &koffice;, mas dependem da configuração de seu sistema, de modo que será necessário modificar seus arquivos de configuração de sistema para solucioná-los. Se você não possui acesso à conta root em seu sistema, por favor informe ao seu administrador de sistema sobre o problema e mostre para ele ou ela este manual. Como o tópico fontes é muito complexo para ser totalmente coberto aqui, você pode consultar o Font HOWTO de onde eu peguei as informações deste capítulo. Você encontrará mais detalhes lá.

#### Como Obter Bonitas Fontes Escalonáveis na Tela

STUFF

#### Como Obter a Saída para Impressão Correta

Apesar do &koffice; automaticamente manipular todas as fontes X11 na tela, a saída para impressora pode apresentar um problema: na maioria dos sistemas, a impressão é feita via ghostscript. Agora, apesar do &koffice; conhecer os nomes das fontes usadas pelo X Windows, ele normalmente não conhece os nomes das fontes usadas pelo ghostscript. O &koffice; tenta adivinhar estes nomes, mas infelizmente isso nem sempre funciona.

Este problema pode ser resolvido, apesar disso não ser fácil. Atualmente, talvez você estej ausando uma distribuição Linux que já tenha feito a maior parte do trabalho para você (então se você não tem nenhuma para queixar-se de sua saída para impressora você pode pular esta seção). O que você deve fazer é informar ao ghostscript como traduzir (adivinhar) os nomes das fontes do &koffice; usando seus próprios nomes de fontes. Isto pode ser feito adicionando linhas para o arquivo chamado `Fontmap`. Uma linha de apelido no `Fontmap` se parece com o seguinte exemplo:

##### Um apelido no Fontmap do ghostscript

    /Algerian-Roman /Algerian       ;

Por favor, observe que o espaço antes do ';' é obrigatório. Neste exemplo, Algerian-Roman é o nome &koffice; usado para Algerian. Você terá que adicionar linhas deste tipo para as fontes &koffice; que não são exibidas corretamente. Para tornar esta tarefa mais fácil, Donovan Rebbechi escreveu um script perl que pode ser encontrado em http://pegasus.rutgers.edu/~elflord/font_howto/kwdfont. Presumindo que você tem um fontfile `usr/share/ghostscript/fonts/fontfile.ttf` você deverá digitar ``kwdfont` `/usr/share/ghostscript/fonts/fontfile.ttf`` para obter os apelidos apropriados. O script deverá funcionar na maioria dos casos. Como mencionado, você pode dar uma olhada em Font HOWTO para informações mais precisas e profundas.

### Customizando o &GUI; do &koffice;

Apesar do &koffice; vir como uma &GUI; (interface gráfica com o usuário) que pode atender as necessidades da maioria das pessoar, existem boas razões pelas quais você pode desejar mudar o modo como os programas parecem.

Minha mãe, por exemplo, tem um pouco de medo e botões e entradas de menu que ela não compreende. Para ajustar o &koffice; às necessidades dela, eu reduzi a &GUI; para um mínimo de funcionalidade. Como ela apenas precisa escrever cartas e usar certos modelos, não é necessário mais funcionalidade que salvar, abrir, imprimir, &etc;

Graças ao conceito de ação do &Qt; e &kde;, você pode facilmente personalizar barras de menu e ferramentas do &koffice;. Infelizmente, no momento, não existe nenhum diálogo fácil-de-usar para fazer seu &koffice; armazenar sua configuração de &GUI; em arquivos &XML; e você deverá editá-los manualmente. Felizmente, esta situação irá mudar no futuro; por enquanto, você deve ter algum conhecimento básico de como um documento &XML; funciona (ou HTML, que é um sub-conjunto do &XML;). [O conceito de ação necessita ser discutido em maiores detalhes -- kt.]

Normalmente, cada aplicativo &koffice; possui pelo menos dois destes arquivos &XML;: um descrevendo a &GUI; do shell (basicamente, o que você vê se nenhum documento for aberto) e um descrevendo a &GUI; da respectiva parte (o que você vê normalmente). Por exemplo, para o &kword;, estes dois arquivos &XML; são chamados `kword_shell.rc` e `kword.rc`.

Aqui está um exemplo simples de como se parece um arquivo rc.

#### Um exemplo de um arquivo rc simples

    <!DOCTYPE QConfig ><qconfig>
    <menubar>
    <menu name="Edit"><text>Edit</text>
    <action name="edit_cut"/>
    <action name="edit_copy"/>
    <action name="edit_paste"/>
    <separator/>
    <action name="edit_find"/>
    </menu>
    <menu name="Insert"><text>Insert</text>
    <action name="insert_picture"/>
    <action name="insert_clipart"/>
    <menu name="Variable"><text>Variable</text>
    <action name="insert_var_datefix"/>
    <action name="insert_var_datevar"/>
    </menu>
    </menu>
    </menubar>
    <toolbars>
    <toolbar name="edit_toolbar" position="right">
    <action name="edit_cut"/>
    <action name="edit_copy"/>
    <action name="edit_paste"/>
    </toolbar>
    </toolbars>
    </qconfig>

## Como obter mais informações

### Outros manuais do &koffice;

Para informações detalhadas dos diferentes aplicativos do &koffice;, por favor consulto seus respectivos manuais.

### Links

Os seguintes links podem ser úteis se você estiver procurando por mais informações sobre o &kde; ou &koffice;.

- The &koffice; homepage. Aqui você pode encontrar informações de como obter e intalar&koffice;, notícias sobre o desenvolvimento do &koffice; capturas de tela &etc;

- A Página Web do KDE. O KDE é o mais avançado e totalmente livre ambiente de desktop para sistemas operacionais unix. O &koffice; utiliza bibliotecas do &kde;.

- Trolltech. Os criadoresdo conjunto de ferramentas C++ &Qt;. O &kde; e o &koffice; usam o &Qt;.

## Programando &koffice;

### Introdução

Se você deseja participar do desenvolvimento do &koffice;, os seguintes recursos podem ser do seu interesse:

- Em http://developer.kde.org você encontrará muitos documentos sobre programação com &Qt; e &kde;. Aqui você pode encontrar a versão online da documentação completa das bibliotecas do &kde;.

- Nos códigos fontes do &koffice; você encontrará um aplicativo exemplo na pasta `example`.

## Créditos e Licença

O &koffice; é resultado do esforço conjunto de muitos desenvolvedores. Cada arquivo fonte do &koffice; possui direitos autorais para pessoas que escreveram este arquivo específico e seus nomes podem ser encontrados no início de cada arquivo fonte com a licença aplicada a este arquivo. Os nomes dos desenvolvedores do núcleo podem ser encontrados em http://www.koffice.org/people.php.

Este manual possui Copyright de Jost Schenck. Ele pode ser distribuído gratuitamente, enquanto este aviso de Copyright estiver incluído. Você pode modificá-lo enquanto você me enviar as mudanças ou atualizá-las para o CVS do &kde;. Eu não serei responsável por qualquer resultado do uso deste manual.

Os outros manuais do &koffice; possuem Copyright dos seus respectivos autores.

&underFDL; &underGPL;

## Instalação

### Requisitos do Sistema

Para você instalar e usar o &koffice; você deve ter:

- Um sistema &UNIX; funcional (por exemplo, um &Linux; ou um BSD) com um &X-Window; configurado (por exemplo, o XFree86 ou o X.Org).

- As bibliotecas do &Qt; 3.3 da Trolltech. Veja em www.trolltech.com para mais informações.

- O Ambiente de Trabalho K 3.3 (&kde; 3.3) ou posterior. O &koffice; não pode ser compilado com versões anteriores do &kde;. As informações sobre como obter e instalar o &kde; poderão ser encontradas em: &kde-http;

- Permissão para instalar programas em seu computador. Se você é o único usuário do sistema, isto não será um problema. No entanto, se você esta usando um computador em rede, verifique primeiro com seu administrador.

Lembre-se que, embora precise das bibliotecas do &kde; 3.3 (ou posteriores) no seu sistema, você poderá usar ainda o &koffice; num ambiente de trabalho diferente (como, por exemplo, o XFCE ou o GNOME).

Se você planeja compilar seu &koffice; do código fonte você também precisará:

- `automake` 1.6.1 ou superior. Ele pode ser baixado de: ftp://ftp.gnu.org/pub/gnu/automake/

- `autoconf` 2.53 ou superior. Ele pode ser baixado de: ftp://ftp.gnu.org/pub/gnu/autoconf/

- Um compilador C++ com suporte a exceções, preferencialmente um versão recente do GCC. (Veja http://gcc.gnu.org para informações sobre como obtê-lo e instalá-lo.)

- Os pacotes de desenvolvimento do &Qt; 3.3 da Troll Tech. Se estes pacotes não estiverem instalados no seu sistema e se não estiverem incluídos na distribuição do seu sistema operacional, você provavelmente deverá ter que compilar o &Qt; a partir do código. Este código-fonte poderá ser obtido em http://www.trolltech.com/download/index.html.

Uma vez que você tenha determinado que seu sistema atinge estes requisitos, você pode decidir entre compilar o código fonte ou instalar de pacotes binários pré-compilados.

Se você deseja obter a versão mais atual do &koffice; você pode encontrar mais informações seguindo este link: Obtendo Pacotes Binários.

Se binários pré-compilados não estão disponíveis para seu sistema, você pode baixar o código fonte e compilá-lo você mesmo. Instruções sobre onde obter o código fonte atual (e o que fazer com o código fonte uma vez que você já o tenha) podem ser encontradas seguindo este link: Getting the source code.

Por favor veja a &koffice; homepage para maiores detalhes. Lá é onde você pode sempre encontrar as informações mais atualizadas sobre o código e as distribuições binárias!

### Obtendo Pacotes Binários

Você pode baixar os binários mais atuais de:

http://koffice.kde.org/releases/1.4.0-release.php

ou de um dos muitos sites espelhos. A lista atual dos sites espelho pode ser encontrada em:

http://www.kde.org/mirrors.html

É importante que você use um pacote binário compatível com seu sistema. Se você usa o sistema operacional &Linux; e não encontrou um pacote binário no site web do &koffice; ou um de seus espelhos, você talvez possa obtê-lo do site wed de sua distribuição.

### Dos Pacotes Binários

Para instalar o &koffice; dos binários pré-compilados, você deve:

1. Certificar-se que seu computador possui todos os programas necessários e em condições de uso (excluindo o &koffice;, claro). Você pode encontrar os requisitos do sistema seguindo este link: Requisitos do Sistema.

2. Baixe o binário (ou binários) do &koffice; em uma pasta temporária.

3. Se o nome do arquivo terminar em `.rpm` (arquivo do Gerenciador de Pacotes da &RedHat;), o &koffice; pode ser instalado com o seguinte comando:

       $rpm-U nome_do_arquivo

   Se o nome do arquivo terminar em `.deb` (arquivo de Pacote Debian), o &koffice; pode ser instalado com o seguinte comando:

       $ dpkg-i
       nome_do_arquivo

   Se o nome do arquivo termina em `.tar.gz` or `.tgz` (um arquivo tarball ), &koffice; pode ser instalado com os seguintes comandos:

       $ cd /
       $ tar -xzvf nome_do_arquivo

   Nestes exemplos, nome_do_arquivo deve ser substituído pelo nome completo do pacote, incluindo o caminho completo se você não estiver no diretório no qual ele foi salvo.

4. Isto é tudo. O &koffice;. deverá estar agora instalado em seu sistema.

Se você possui um front-end gráfico para o gerenciador de pacotes, como o&kpackage; ou o GnoRPM, instalado em seu sistema, você pode achar mais conveniente usá-lo do que a linha de comando. Consulte a documentação do programa para encontrar como instalar o pacote.

### Obtendo o Código Fonte

Você pode baixar o código fonte atual de: http://koffice.kde.org/ ou de um dos muitos sites espelho. A lista atual dos sites espelho podem ser encontradas em:

http://www.kde.org/mirrors.html

### Do Código Fonte

Se você deseja construir o &koffice; a partir do código fonte, você deve:

1. Certificar-se que seu computador possui todos os programas necessários instalados e em condições de uso (excluindo o &koffice; claro). Você pode encontrar os requisitosdo sistema seguindo este link: Requisistos do Sistema.

2. Baixe o arquivo fonte do &koffice; em uma pasta temporária.

3. Se o nome do arquivo termina em `.src.rpm` (arquivo do Gerenciador de Pacotes da &RedHat;), o código fonte do&koffice; pode ser instalado com:

       $ rpm-U nome_do_arquivo

   Se o nome do arquivo termina em `.src.tar.gz` ou `.src.tgz` (um arquivo tarball), o código fonte do &koffice; pode ser instalado com:

       $ tar -xzvf nome_do_arquivo

4. O código fonte do &koffice; pode agora ser instalado em seu sistema.

&documentation.index;