# &koffice;

## 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 frames)
- &kspread; (um aplicativo de planilha)
- &kpresenter; (apresentações na tela e slides)
- &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 extender 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.

## 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. Chose Create KSpread table frame from the Tools menu. You'll notice that the mouse cursor has changed to a cross. This form of the cursor indicates that you are supposed to select an area.

4. Press the &LMB; mouse button where you want the upper left corner of your table to be, hold it and drag it to the lower right corner. Release the button. That's it--you're done.

Easy, isn't it? You should now see a table frame in your &kword; document. Now, click inside the table to see what happens. You'll notice that:

- 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

Fonts are a difficult topic on X Windows. In this section we'll cover some problems that are frequently reported by people using &koffice;. Some problems are not just &koffice;s fault, but depend on your system configuration, which is why you may need to modify system configuration files in order to solve them. If you don't have access to the root account on your system, please ask your system operator about this and point him or her to this manual. As the topic of fonts is too complex to cover all of it here, you may want to consult the Font HOWTO from which I've taken the following information. You will find more details there.

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

- &kde-http;. The most advanced and absolutely free desktop environment for unix-like operating systems. &koffice; makes use of the &kde; libraries.

- Troll Tech. The creators of the C++-toolkit &Qt;. &kde; and &koffice; make use of &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 `example`.

## Copyright e Licenciamento

&koffice; is copyrighted by the &koffice; team.

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 examplo, &Linux; ou BSD) com um &X-Window; configurado (por examplo, XFree86).

- The &Qt; 2.1 libraries from Troll Tech. See ftp://ftp.troll.no/ for more information.

- The K Desktop Environment 2.0 (&kde; 2.0). &koffice; cannot be compiled with earlier versions of &kde;. Information on obtaining and installing &kde; 2.0 can be found at: &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.

Please note that, while you need the &kde; 2.0 libraries on your system, you can still use &koffice; in a different desktop environment (for example, &kde; 1.1, UDE or GNOME).

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

- `automake` 1.4 or newer. This can be downloaded from: ftp://ftp.gnu.org/pub/gnu/automake/

- `autoconf` 2.13 or later. This can be downloaded from: ftp://ftp.gnu.org/pub/gnu/autoconf/

- A C++ compiler which supports exceptions (preferably egcs 1.1.x). This can be downloaded from http://egcs.cygnus.com/

- Troll Tech's &Qt; 2.1 development packages. These can be downloaded from 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.

If you want to obtain the most current binary version of KOffice, you can find more information by following this 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 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. Download the &koffice; binary into a temporary folder.

3. If the filename ends in `.rpm` (&RedHat; Package Management file), &koffice; can be installed with the following command:

       $
       rpm-Ufilename

   .

   If thefilename ends in `.deb` (Debian Package file), &koffice; can be installed with the following command:

       $ 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_arquivo

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

If you want to build &kword; from source code, you should:

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-Ufilename

   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;