# &koffice;

Uma Introdução Geral
Jost
Schenck

    jost@schenck.de

Marcus
Gama

    marcus_gama@uol.com.br

Tradução
2001-06-02
0.01.01

&koffice; é um pacote integrado de escritório para o Ambiente de Desktop K (&kde;).

KDE
KOffice

## Ainda está sendo feito neste manual

Esta é uma lista de coisas que ainda precisam ser feitas neste manual:

- Escreva esta lista.

- Somente sobre tudo.

Se alguém deseja ajudar, me avise no endereço de email abaixo. Obrigado.

Jost jost@schenck.de

## Introdução

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

- &kword; (processador de textos baseado em quadros)
- &kspread; (um aplicativo de planilha)
- &kpresenter; (apresentações na tela e slides)
- &kontour; (um aplicativo de desenho vetorial)
- &kformula; (um editor de fórmulas matemáticas)
- &kchart; (um aplicativo de desenho de gráficos/tabelas)
- &kivio;
- &kugar;

Devido ao fato de ser baseado no modelo de componentes do KParts, os programas do &koffice; foram desenvolvidos para trabalhar muito bem uns com os outros. Qualquer componente &koffice; pode ser embutido em outro documento &koffice;. Por exemplo, você pode inserir uma tabela criada no &kspread; diretamente num documento do &kword;. Deste modo, documentos compostos complexos podem ser criados usando os programas do &koffice;.

Um mecanismo de plug-in torna fácil estender a funcionalidade do &koffice;. De fato, existem dois aplicativos, um gravador de macros e uma calculadora, que podem mostrar como isto pode ser feito.

Este manual somente abrange as características gerais do &koffice;, as quais são comuns à maioria ou à todos os programas da suíte. Para informações detalhadas sobre os diferentes programas, dê uma olhada nos outros manuais.

## Primeiros passos no &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ê freqüentemente 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 inserçã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 habilidade 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. Escolha Criar quadro de tabela do KSpread do menu Ferramentas. 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 botão de mouse &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. É isto -- você terminou.

Fácil, não? Você pode agora ver um quadro de tabela em seu documento &kword;. Agora, clique dentre da tabela e veja o que 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.

## Otimizando &koffice; e Seu Sistema

Apesar d &koffice; poder trabalhar muito bem sem configurações adicionais, existem algumas coisas para otimizar para obter o melhor do &koffice;. Este capítulo lhe mostra o que você deve fazer para conseguir melhores resultados com sua nova suíte de escritório.

### 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 freqüentemente 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á-las. Se você não possui acesso à conta root em seu sistema, por favor solicite ao seu operador de sistema sobre isto 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ê esteja usando 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.

### Personalizando 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 pessoas, 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 instalar o&koffice;, notícias sobre o desenvolvimento do &koffice; telas &etc;

- &kde-http;. O mais avançado e totalmente gratuito ambiente de desktop para sistemas operacionais unix. O &koffice; utiliza bibliotecas do &kde;.

- Troll Tech. Os criadores do kit de ferramentas C++ &Qt;. O &kde; e o &koffice; usa o &Qt;.

## Programando &koffice;

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;.

- Use kdoc (no módulo CVS `kdoc`) para gerar sua própria documentação da biblioteca &kde;.

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

## Direito de Cópia e Licenciamento

&koffice; é copyrighted pela equipe do &koffice;.

Este manual é copyright por 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; são copyrighted por seus respectivos autores.

&underFDL; &underGPL;

## Instalação

### Requisitos do Sistema

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

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

- As bibliotecas &Qt; 2.1 da Troll Tech. Veja ftp://ftp.troll.no/ para mais informações.

- O Ambiente de Desktop K 2.0 (&kde; 2.0). O &koffice; não pode sercompilado com versões anteriores do &kde;. Informações de como obter e instalar o &kde; 2.0 podem 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.

Por favor observe que, apesar de você precisar das bibliotecas do &kde; 2.0 em seu sistema, você pode ainda usar o &koffice; em um ambiente de desktop diferente (por exemplo, &kde; 1.1, UDE ou GNOME).

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

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

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

- Um compilador C++ com suporte a exceções (preferencialmente egcs 1.1.x). Ele pode ser baixado de http://egcs.cygnus.com/

- Pacotes de desenvolvimento do &Qt; 2.1 da Troll Tech. Eles podem ser baixados de ftp://ftp.troll.no/

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: Getting Binary Packages.

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/

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 web 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 do &koffice; em uma pasta temporária.

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

       $
       rpm-Ufilename

   .

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

       $ dpkg-i
       filename

   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_aqruivo

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 &kword; 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 requisitos do sistema seguindo este link: Requisitos 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-Unome_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.

### Problemas com Compilação

A ser escrito

&documentation.index;