# &koffice;

## Introdución

### Componentes de &koffice;

&koffice; é unha suite ofimática integrada para o Sistema de Escritorio K (&kde;). Na actualidade &koffice; consta das seguintes componentes:

- &kword; (un procesador de texto baseado en molduras)

- &kspread; (un programa de follas de cálculo)

- &kpresenter; (un programa de apresentacións)

- &kivio; (un programa de diagramas de fluxo)

- Karbon14 (un programa de debuxo vectorial)

- &krita; (un programa de debuxo baseado en píxels)

- &kugar; (unha ferramenta para xerar informes de calidade)

- Kexi (un entorno integrado para xestionar dados)

- &kchart; (un programa de xeración de diagrámas/gráficas)

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

Dado que estas componentes están baseadas no modelo de componentes KParts, as componentes de &koffice; están deseñadas para traballar perfeitamente unhas coas outras. Calquer componente de &koffice; pode ser integrada noutro documento de &koffice;. Por exemplo, pode inserir unha folla de cálculo criada com &kspread; direitamente nun documento de &kword;. Desta maneira, pode criar documentos compostos moi complexos usando &koffice;.

Un mecanismo de extensións (plug-ins) simplifica o aumentar a funcionalidade de &koffice;. Atopará moitas extensións nalgunha das componentes e pode aprender como escreber as extensións. Tamén hai unha sección neste manual adicada a desenvolver extensións, coa que poderá iniciarse neste tema.

Este manual só trata as características xerais de &koffice;; as que son comúns á maioría das componente da suite. Para atopar información detallada acerca das diferentes componentes, consulte o manual de cada programa.

### Resumo das características de &koffice;

#### Integración

&koffice; fornece un framework que todos os seus programas usan. Mediante este framework acádase unha grande integración. É posíbel desenvolver a súa propria componente que se integre por igual. A tecnoloxía para isto é descrita con maior detalle no capítulo acerca das KParts.

#### Lixeireza

Apesar de oferecer tantas componentes, &koffice; é moi lixeira, rápida e consume pouca memoria. Isto tamén se obtén porque &koffice; está construído con base en &kde;, que en si é un poderoso framework de desenvolvimento.

Un dos obxectivos de &koffice; é non sobrecargar a interface do usuario con funcionalidades que rara vez son usadas. Isto resulta nunha interface limpa e sinxela que lle permite traballar con eficacia.

Ser lixeiro pode por veces ser sinónimo de que algunha funcionalidade concreta non estexa ahí. Neste caso sempre pode engadir a funcionalidade por si, ampliando &koffice;. &koffice; en realidade non quer estar saturado por engadir grandes cantidades de funcións que só uns poucos usuarios requeren. Tais funcionalidades sempre poden estar disponíbeis mediante extensións adicionais ou guións, mantento deste xeito a &koffice; lixeiro.

#### Extensión

&koffice; oferece un rango amplo de componentes, cobrindo a maioría das necesidades do fogar e traballo. As funcionalidades adicionais sempre poden ser implementadas mediante guións, extensións, ou mesmo componentes baseadas no framework &koffice;.

#### Formato OASIS OpenDocument

É de importancia crucial para calquer suite ofimática o adherirse a estándares estabelecidos. Especialmente no nível de formato de ficheiro para permitir o intercambio de documentos sen trabas entre diferentes suites ofimáticas. Isto serve para evitar quedar atrapado por un provedor, o que é especialmente importante nas empresar, mais tamén para as persoas.

Por este motivo &koffice; adoptou o formato OASIS OpenDocumento como formato nativo de ficheiro.

#### Características de KDE

Xa que &koffice; está construido con base en &kde; todas as características que espera dun programa de &kde; tamén está disponíbel en &koffice;. Isto inclui DCOP, KParts, Integración no Escritorio, Configurabilidade, e outras. Todo isto fai que a aparencia e comportamento de &koffice; sexa moi familiar e que &koffice; se integre no sistema de escritorio, permitido traballar sen dificultades.

## Tecnoloxía de &koffice;

### KParts - os tixolos cos que se construi &koffice;

Cada programa de &koffice; está deseñado para satisfacer unhas necesidades específicas. Por exemplo, &kspread; é un programa para manipular follas de cálculo, mentres que &kword; é un programa para procesar textos. Ao focarse só nunha área concreta, cada programa procura ser bon só nesa área. Porén, dependendo do que faga con &koffice;, a miudo ha querer aproveitarse das funcionalidades fornecidas por varios programas, pero no mesmo documento.

Supoña que está a traballar nun documento en &kword; e quer ilustrar algo mediante unha táboa. Aínda que &kword; fornece táboas, estas poden non ser de abondo para as súas necesidades. Por exemplo, pode querer usar certos formatos de divisa ou facer cálculos usando fórmulas de folla de cálculo. Certamente, algún dos desenvolventes de &kword; pode tentar implementar esta funcionalidade. Porén &kword; nunca ha chegar a ser tan bon como &kspread; neste eido; e se tentase implementar todas as funcionalidades que poida chegar a precisar, acabaría por ser tremendamente complexo e o código fonte sería imposíbel de manter.

A alternativa a isto son as KParts. A súa filosofía é simples: deixa que cada programa faga aquelo no que sexa o mellor.

#### Documentos compostos con KParts

Grazas ás KParts, os seus documentos poden usar todas as funcionalidades fornecidas por todos os programas de &koffice;. Pode aproveitarse disto inserindo as autodenominadas componentes non seus documentos. Cada unha destas componentes é en esencia outro documento, isto é, un documento dentro doutro.

No exemplo anterior, simplesmente insira unha componente &kspread; no seu documento &kword;. Logo, sempre que edite a súa táboa, &kspread; tomará o control silandeiramente. O control ha voltar para &kword; canto termine de traballar na táboa e volte para o texto. O único cambio que debera notar é que as barras de ferramentas e os menús, ao traballar coa táboa, reflicten as funcionalidades de &kspread; no canto de as de &kword;. Esta habilidade de incluir a funcionalidade dunha aplicación noutra é denominada encaixamento.

#### Uso de KParts nos seus documentos

Se nunca traballou con documentos compostos, pode achá-los extranos ao primeiro. As seguintes instrucións paso-por-paso demostrarán-lle que usar KParts é tan sinxelo como traballar cun único programa.

#### Inserir unha componente &kspread; en &kword;

1. Inicie &kword;. Pode facé-lo desde o painel ou escrebendo ``kword`` na liña de comandos.

2. Abra un novo documento en branco. Se o desexa, escreba algún texto de mostra.

3. Escolla Inserir Moldura de Obxecto Follas de Cálculo. Comprobe que o ponteiro do rato agora é unha cruz. Esta forma do ponteiro indica que debe escoller unha área.

4. Prema o &LMB; onde desexe situar o canto de acima á esquerda da súa táboa, manteña-o calcado e arraste-o ao canto de baixo á direita. Solte o botón. Agora aparece un diálogo que lle dá a posibilidade de inserir un documento xa existente ou criar un novo. Crie un en branco. Xa está feito.

Facil, non si? Agora debera ver unha moldura cunha táboa no documento de &kword;. Faga duplo-click dentro da táboa para ver o que acontece. Verá que:

- As barras de menú e ferramentas cambian. Agora coinciden coas de &kspread;.

- A moldura da táboa agora contén os elementos dunha vista de &kspread;, con barras de desprazamento, unha barra de páxinas para escoller a folla, &etc;

Tente editar a táboa. Verá que non é diferente de usar &kspread;. De feito está a usar &kspread;.

Agora prema no documento de &kword;, fora da táboa. As barras de menú e ferramentas deberan voltar a ser as de &kword;, os elementos da vista de &kspread; deberían ter desaparecido. A táboa segue no sitio e reflicte os cambios que fixese nela.

As KParts son fáceis de usar. Probe a inserir outras componentes ou mesmo componentes dentro de componentes.

## Configuración de &koffice; e O Seu Sistema

Aínda de &koffice; debera funcionar correctamente tal como é tras ser instalado, pode haber cousas que optimizar para sacar o mellor del. Este capítulo mostra-lle o que pode facer para obter os mellores resultados e facer que se axuste mellor ás súas necesidades. &koffice; é altamente configurábel, mesmo nos detalles da disposición nas barras de menú e ferramentas.

### Optimización dos Tipos de Letra

Os tipos de letra son un asunto complicado no sistema X Windows. Nesta sección tratamos algúns problemas que son informados con frecuencia polo usuarios de &koffice;. Algúns destes problemas non son culpa de &koffice;, senón que dependen da configuración do sistema, polo que deberá alterar os ficheiros de configuración do sistema para resolvé-los. Se non ten aceso á conta de root do seu sistema, póñase en contacto co seu administrador de sistemas para comentar-llo e dirixa-o para este manual. Dado que o asunto dos tipos de letra é complexo de mais para tratá-lo por inteiro aquí, tal vez desexe consultar o COMO dos Tipos de Letra do cal foi extraida a seguinte información. Aló ha achar mais detalles.

#### Como Obter na Pantalla Letras Ampliadas de Xeito Suave

STUFF

#### Como Obter un Impreso Correcto

Mentres de &koffice; pode xestionar automaticamente todos os tipos de letra de X11 na pantalla, os impresos poden prantexar un problema: na maioría dos sistemas, a impresión é feita mediante ghostscript. &koffice; coñece os nomes dos tipos de letra que usa X Windows, pero polo xeral non coñece os nomes usados por ghostscript. &koffice; tenta adiviñar estes nomes, o que por desgraza non funciona ben sempre.

Este problema pode ser resolto, aínda que non é tan fácil. En realidade, talvez estexa a usar unha distribuición que xa teña feito a maioría do traballo (polo que se non ten motivo de queixa dos impresos pode saltar esta sección). O que ten que facer é indicarlle a ghostscript como traducir (adiviñando) os nomes dos tipos de letra usados por &koffice; para os seus proprios nomes. Isto pode facerse engadindo liñas nun ficheiro chamado `Fontmap`. Unha liña de alcume en `Fontmap` ten un aspeito similar ao seguinte:

##### Un alcume en Fontmap de ghostscript

    /Algerian-Roman /Algerian       ;

Recorde que é obrigatorio o espazo antes do ";". Neste exemplo, Algerian-Roman é o nome que &koffice; usa para o Arxelino. Deberá engadir tais liñas para os tipos de letra que &koffice; non mostre correctamente. Para simplificar esta tarefa, Donovan Rebbechi escrebeu un guión en perl que pode atopar en http://pegasus.rutgers.edu/~elflord/font_howto/kwdfont. Se ten un ficheiro de fontes `/usr/share/ghostscript/fonts/fontfile.ttf` escreba ``kwdfont` `/usr/share/ghostscript/fonts/fontfile.ttf`` para obter os alcumes apropriados. O guión ha funcionar na maioría dos casos. Como se dixo antes, vote unha ollada ao COMO dos Tipos de Letra para obter información mais exacta e completa.

### Personalización da &GUI; de &koffice;

A pesar de que &koffice; trai de serie unha &GUI; (interface gráfica para o usuario) que debería ser axeitada para a maioría das persoas, hai boas razóns polas que pode querer mudar a aparencia do programa.

Por exemplo, miña mai asustase cos botóns e entradas de menú que non comprende. Para adaptar &koffice; ás súas necesidades, reducín a &GUI; a un mínimo de funcionalidade. Dado que só precisa escreber cartas e usar algúns modelos, non hai necesidade de moitas mais funcionalidades que guardar, cargar, imprimir, &etc;

Grazas ao conceito de acción de &Qt; e &kde;, pode personalizar á súa vontade as barras de menú e ferramentas de &koffice;. Por desgraza, neste momento, non hai diálogos de uso cómodo para facer isto. &koffice; guarda a configuración da &GUI; en ficheiros &XML; que ha ter que editar. Gostaríanos que esta situación cambie no futuro; por agora, ha precisar algúns coñecimentos básicos de como traballa un documento &XML; (ou HTML, que é un subconxunto de &XML;). [O conceito de acción precisa de ser afondado nel -- kt.]

Normalmente, cada programa de &koffice; ten polo menos dous ficheiros &XML;: un que descrebe a &GUI; da shell (basicamente, o que ve se non hai nengún documento aberto) e un descrebendo a &GUI; da componente respectiva (o que ve normalmente). Por exemplo, para &kword;, estes dous ficheiros &XML; son `kword_shell.rc` e `kword.rc`.

Este é un exemplo sinxelo dun destes ficheiros de configuración.

#### Un exemplo dun ficheiro sinxelo de configuración

    <!DOCTYPE QConfig ><qconfig>
    <menubar>
    <menu name="Edit"><text>Editar</text>
    <action name="edit_cut"/>
    <action name="edit_copy"/>
    <action name="edit_paste"/>
    <separator/>
    <action name="edit_find"/>
    </menu>
    <menu name="Insert"><text>Inserir</text>
    <action name="insert_picture"/>
    <action name="insert_clipart"/>
    <menu name="Variable"><text>Variábel</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 información

### Outros manuais de &koffice;

Para obter información detallada acerca dos programas de &koffice;, consulte os seus respectivos manuais.

### Ligazóns

As seguintes ligazóns deberían ser úteis se está a procurar mais información acercad de &kde; ou &koffice;.

- A páxina web de &koffice;. Aquí poderá atopar información acerca de como obter e instalar &koffice;, novas acerca de &koffice; do desenvolvemento, capturas de pantalla &etc;

- A páxina web de KDE. KDE é o sistema de escritorio mais avanzado e absolutamente libre para sistemas operativos tipo unix. &koffice; usa as bibliotecas de &kde;.

- Trolltech. Os creadores do toolkit escrito en C++ &Qt;. &kde; e &koffice; usan &Qt;.

## Programación de &koffice;

### Introdución

Se desexa desenvolver &koffice;, os seguintes recursos poden-lle ser de interese:

- En http://developer.kde.org atopará múltiplos documentos acerca de programación con &Qt; e &kde;. Aquí ha poder achar a versión en liña da documentación completa das bibliotecas de &kde;.

- Nas fontes de &koffice; poderá atoar unha aplicación de exemplo no cartafol `example`.

## Copyright e Licenza

&koffice; é o resultado do esforzo conxunto de moitos desenvolventes. Cada ficheiro das fontes de &koffice; ten o copyright das persoas que o escreberon, os nomes dos cais pode atopar ao inicio de cada ficheiro das fontes xunto coa licenza que se aplica a tal ficheiro. Os nomes dos desenvolventes principais poden ser atopados en http://www.koffice.org/people.php.

O copyright deste manual é de Jost Schenck. Pode ser distribuido libremente, mentres se inclúa esta nota de copyright. Pode modificar o manual mentres me envíe a min as mudanzas ou as envíe para o CVS de &kde;. Non me fago responsábel de nengunha consecuencia derivada do uso deste manual.

Os restantes manuais de &koffice; teñen copyright dos seus respectivos autores.

&underFDL; &underGPL;

## Instalación

### Requerimentos do Sistema

Para instalar e usar &koffice; debe ter:

- Un sistema &UNIX; en funcionamento (por exemplo, &Linux; ou BSD) cun sistema &X-Window; configurado (por exemplo, XFree86 ou X.org).

- As bibliotecas &Qt; 3.3 de Trolltech. Consulte www.trolltech.com para mais información.

- O Sistema de Escritorio K 3.3 (&kde; 3.3) ou mais recente. &koffice; non pode ser compilado con versións anteriores de &kde;. Pode obter información acerca da obtención e instalación de &kde; en &kde-http;

- Permisos para instalar software no seu ordenador. Se está nun sistema independente, isto non debera ser un problema. Porén, se está nun ordenador dunha rede, verifique este ponto co seu administrador.

Lembre que, aínda que as bibliotecas de &kde; 3.3 (ou mais recentes) son requeridas, poderá usar &koffice; nun sistema de escritorio diferente (por exemplo, XFCE ou GNOME).

Se prevé compilar &koffice; desde as fontes tamén ha precisar:

- `automake` 1.6.1 ou mais recente. Isto pode ser obtido desde: ftp://ftp.gnu.org/pub/gnu/automake/

- `autoconf` 2.53 ou mais recente. Isto pode ser obtido desde: ftp://ftp.gnu.org/pub/gnu/autoconf/

- Un compilador de C++ que soporte excepcións, preferibelmente unha versión recente de GCC. (Consulte http://gcc.gnu.org para obter información acerca de como obté-lo e instalá-lo.)

- Os paquetes de desenvolvimento de &Qt; 3.3 de Troll Tech. Se estes paquetes non están instalados no seus sistema e non se inclúen na distribuición do seu sistema operativo, talvez teña que compilar &Qt; desde as fontes. Estas fontes poden ser obtidas desde http://www.trolltech.com/download/index.html.

Unha vez que teña determinado se o seu sistema cumpre con estes requerimentos, debe decidir se quer compilar o código fonte ou instalar desde paquetes precompilados.

Se quer obter a versión precompilada mais recente de &koffice;, pode achar información na seguinte ligazón:Obtendo Paquetes Precompilados.

Se non hai executábeis precompilados para o seu sistema, pode obter o código fonte e compilá-lo por si proprio. Pode achar información acerca de onde obter o código fonte (e que facer con el cando o teña) na seguinte ligazón: Obtención do Código Fonte.

Consulte a páxina web de &koffice; para mais detalles. Aló é onde sempre pode atopar a información mais actualizada acerca das fontes e de distribuicións precompiladas!

### Obtención de Paquetes Precompilados

Pode obter os paquetes binarios mais recentes desde:

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

ou dalgún sitio de réplica. A lista actual de réplicas pode ser atopada en:

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

É importante que use un paquete precompilado que sexa compatíbel co seus sistema. Se usa o sistema operativo &Linux; e non é quen de atopar un paquete precompilado no sitio web de &koffice; nen nunha das súas réplicas, pode ser que o atope no sitio web da súa distribuición.

### Desde Paquetes Precompilados

Para instalar &koffice; desde paquetes precompilados, debe:

1. Verificar que o seu ordenador ten instalado e operativo todo o software requerido (excepto &koffice;, claro). Pode atopar os requerimentos do sistema na seguinte ligazón: Requerimentos do Sistema.

2. Obter o binario (ou binarios) de &koffice; para un cartafol temporal.

3. Se o nome do ficheiro remata en `.rpm` (ficheiro &RedHat; Package Management), &koffice; poderá ser instalado co seguinte comando:

       $rpm-U nomeFicheiro

   Se o nome do ficheiro remata en `.deb` (ficheiro de paquete Debian), &koffice; pode ser instalado co seguinte comando:

       $ dpkg-i nomeFicheiro

   Se o nome do ficheiro remata en `.tar.gz` ou `.tgz` (un paquete tarball), &koffice; poderá ser instalado mediante os seguintes comandos:

       $ cd /
       $ tar -xzvf nomeFicheiro

   Neste exemplos nomeFicheiro debe ser substituido polo nome completo do paquete incluindo a rota completa se non está no directorio no que o guardou.

4. Iso é todo. &koffice; debera estar instalado no seu sistema.

Se dispuxese dunha interface para o xestor de paquetes, como &kpackage; ou GnoRPM, instalada no seu sistema, pode resultar-lle mais axeitada de usar que unha liña de comandos. Consulte a documentación do programa para averiguar como instalá-lo.

### Obtención do Código Fonte

Pode obter o código fonte actual en: http://koffice.kde.org/ ou nun sitio de réplica. A lista destes sitios pode ser achada en:

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

### Desde Código Fonte

Se quer compilar &koffice; desde as fontes, deberá:

1. Verificar que o seu ordenador ten instalado todo o software requerido e que este está operativo (sen contar con &koffice;, claro). Pode atopar esta lista de requerimentos na seguinte ligazón: Requerimentos do Sistema.

2. Obteña o ficheiro coas fontes de &koffice; para un cartafol temporal.

3. Se o nome o ficheiro remata en `.src.rpm` (ficheiro &RedHat; Package Management), o código fonte de &koffice; pode ser instalado con:

       $ rpm-U nomeFicheiro

   Se o nome do ficheiro remata en `.src.tar.gz` ou `.src.tgz` (un paquete tarball), o código fonte de &koffice; pode ser instalado mediante:

       $ tar -xzvf nomeFicheiro

4. Tras disto, o código fonte de &koffice; debera estar instalado no seu sistema.

&documentation.index;