# &koffice;

## Aún por hacer en este manual

Esta es la lista de cosas sobre las que tenemos que trabajar en este manual:

- Escribir esta lista.

- Sólo sobre todo lo demás.

Si alguno quiere ayudar, hagámelo saber en la dirección de correo de abajo. Gracias.

Jost jost@schenck.de

## Introducción

&koffice; es una suite ofimática integrada para el entorno de escritorio K (&kde;). &koffice; contiene actualmente los siguientes programas:

- &kword; (un procesador de textos basado en marcos)
- &kspread; (una aplicación de hoja de cálculo)
- &kpresenter; (presentaciones por pantalla y transparencias)
- &kontour; (aplicación de dibujo vectorial)
- &kformula; (un editor de fórmulas matemáticas)
- &kchart; (una aplicación para dibujar gráficos)
- &kivio;
- &kugar;

A causa de que están basadas en el modelo de componentes de KParts, los programas de &koffice; están diseñados para funcionar muy bien entre sí. Cualquier componente de &koffice; se puede empotrar en otro documento de &koffice;. Por ejemplo, puede insertar una tabla que creó con &kspread; directamente en un documento de &kword;. De esta forma, los documentos complejos compuestos se pueden crear usando programas de &koffice;.

Un mecanismo de plugins hace fácil extender la funcionalidad de &koffice;. Ya hay dos aplicaciones, una grabadora de macros y una calculadora, que muestran cómo se puede hacer esto.

Este manual sólo cubre las características generales de &koffice;, aquellas que son comunes a la mayoría de programas de esta suite. Para información detallada sobre los diferentes programas, diríjase a los otros manuales.

## Primeros pasos con &koffice;

## KParts - los bloques de los que se compone &koffice;

Cada aplicación de &koffice; está diseñada para cumplir con unas necesidades muy específicas. Por ejemplo, &kspread; es un programa para manipular hojas de datos, mientras que &kword; es un programa para el procesamiento de textos. Al centrarse en un área específica, cada programa busca el objetivo de la perfección en esa área concreta. Sin embargo, dependiendo de lo que quiera hacer con &koffice;, a menudo querrá usar la ventaja de la funcionalidad proporcionada por diferentes aplicaciones, pero en el mismo documento.

Suponga que está preparando un documento en &kword; y quiere ilustrar algún punto usando una tabla. Mientras que &kword; proporciona su propia funcionalidad para la inserción de tablas, esto no puede ser suficiente para sus necesidades. Por ejemplo, puede querer usar ciertos formatos de datos monetarios o hacer cálculos usando fórmulas de una hoja de cálculo. Ahora, algún programador de &kword; ciertamente podría intentar implementar esta funcionalidad. Sin embargo, &kword; nunca sería tan bueno como &kspread; en ese campo; y si intentó implementar toda la funcionalidad que pudiera necesitar, acabaría convirtiéndose en un código fuente irracionalmente complejo e imposible de mantener.

La alternativa a esto es KParts. Su filosofía es simplo: dejar que cada aplicación haga lo que hace mejor.

### Documentos compuestos con KParts

Con KParts, sus documentos pueden usar toda la funcionalidad ofrecida por las aplicaciones de &koffice;. Puede beneficiarse de esto insertando las partes así llamadas en su documento. Cada una de esas partes es esencialmente otro documento, esto es, un documento dentro de un documento.

En el ejemplo mencionado arriba, simplemente podía insertar una parte de &kspread; dentro de su documento &kword;. Entonces, si quiere editar su tabla, &kspread; tomaría el control en segundo plano. El control se devolvería a &kword; cuando terminara de trabajar sobre la tabla y empezara a trabajar en el texto de nuevo. El único cambio que percibiría es que las barras de herramientas y los menús, mientras editara la tabla, reflejarían la funcionalidad de &kspread; en lugar de &kword;. Esta capacidad para incluir la funcionalidad de una aplicación en otra se llama empotramiento.

### Usando KParts in du documento

Si nunca ha trabajado con documentos compuestos, puede encontrarlo confuso al principio. Las siguientes instrucciones paso a paso le muestran que usar KParts es tan fácil como trabajar con una sóla aplicación.

### Insertando una parte &kspread; en una aplicación &kword;

1. Inicie &kword;. Puede hacerlo desde el panel o tecleando ``kword`` en la línea de comando.

2. Comience un documento nuevo, en blanco. Puede querer teclear algún texto de ejemplo.

3. Seleccione Crear marco de tabla KSpread desde el menú Herramientas. Se dará cuenta de que el cursor del ratón se ha convertido en una flecha. Esta forma del cursor indica que se supone que tiene que seleccionar un área.

4. Presione el botón del ratón &LMB; donde quiera que esté la esquina superior izquierda de su tabla, manténgalo pulsado y arrástrelo a la esquina inferior izquierda. Suelte el botó. Ya está, lo ha hecho.

Fácil, ¿no? Debería ver ahora un marco de tabla en su documento de &kword;. Ahora, haga clic dentro de la tabla para ver lo que ocurre. Se dará cuenta de que:

- Sus barras de menú y de herramientas han cambiado. Ahora reflejan las de &kspread;.

- Su marco de tabla contiene ahora los elementos de una vista de &kspread;, con barras de desplazamiento, una barra de tabulaciones para la selección de tablas, &etc;

Intente editar la tabla. Verá que no es distinto que usando &kspread;. De hecho, está usando &kspread;.

Ahora haga clic en cualquier lugas de su documento de &kword; fuera del área de la tabla. Las barras de menú y herramientas deberían volver a ser las de &kword;, los elementos de la vista de &kspread; deberían desaparecer. Su tabla permanece y refleja todos los cambios que ha realizado en ella.

KParts es fácil de usar. Intente insertar otras partes o incluso partes dentro de partes.

## Optimizando &koffice; y su sistema

Mientras que &koffice; debería funcionar bien, hay algunas cosas que optimizar para sacar lo mejor de &koffice;. Este capítulo le muestra lo que debe querer hacer para lograr los mejores resultados con su nueva suite ofimática.

### Optimizando la salida de tipografías

Las tipografías son un tema delicado en X Windows. En esta sección trataremos algunos problemas de los que informan con frecuencia la gente que está usando &koffice;. Algunos problemas no son solo culpa de &koffice;, sino que dependen de la configuración de su sistema, que es por lo que puede necesitar modificar archivos de configuración del sistema para resolverlos. Si no tiene acceso a la cuenta de root de su sistema, pida a su poerador de sistemas que le eche un vistazo a esto y lo apunte en su manual. Como el tema de las tipografías es demasiado complejo para abarcarlo por completo aquí, puede querer consultar el CÓMO de las tipografías del que he tomado la información que viene a continuación. Encontrará más detalles allí.

#### Cómo obtener tipografías bien escaladas en la pantalla

COSAS

#### Cómo obtener una impresión correcta

Aunque &koffice; puede manipular automáticamente todas las tipografías de X11 en pantalla, la impresión puede ser problemática: en la mayoría de los sistemas, la impresión se realiza vía ghostscript. Ahora, mientras que &koffice; conoce los nombres de tipografías usados por X Windows, normalmente no conoce los nombres de las tipografías usadas por ghostscript. &koffice; intenta adivinar esos nombres, lo que desafortunadamente no funciona siempre.

Este problema se puede resolver, aunque no es tan fácil. Por el momento, puede que esté usando una distribución que ya haya hecho la mayoría del trabajo para usted (así que si no tiene ninguna razón para quejarse acerca de la impresión, puede saltarse esta sección). Lo que tiene que hacer es decirle a ghostscript cómo traducir los nombres de tipografías (adivinados) que usa &koffice; a sus propios nombres de tipografías. Esto se puede hace añadiendo líneas al archivo llamado `Fontmap`. Una línea de alias en `Fontmap` se debe parecer a la del siguiente ejemplo:

##### Un alias en el mapa de tipografías -Fontmap- de ghostscript

    /Algerian-Roman /Algerian       ;

Fíjese en que es obligatorio un espacio antes de «;». En este ejemplo, Algerian-Roman es el nombre que usa &koffice; para Algerian. Tendrá que añadir esas líneas para las tipografías que &koffice; no muestra correctamente. Para hacer más fácil esta tarea, Donovan Rebbechi ha escrito un script de perl que puede encontrar en http://pegasus.rutgers.edu/~elflord/font_howto/kwdfont. Asumiento que tiene un archivo de tipografías `/usr/share/ghostscript/fonts/fontfile.ttf`, tendrá que introducir ``kwdfont` `/usr/share/ghostscript/fonts/fontfile.ttf`` para obtener los alias adecuados. El script debería funcionar en la mayoría de los casos. Como ya se mencionó, debería echar un vistazo al CÓMO de tipografías para una información más profunda y precisa.

### Personalizando el &GUI; de &koffice;

Mientras &koffice; sale de la caja con un &GUI; (interfaz gráfico de usuario) que debería valer para las necesidades de la mayoría de la gente, hay buenas razones por las que debe querer cambiar el aspecto de los programas.

Mi madre, por ejemplo, se asusta un poco con los botones y las entradas del menú que no comprende. Para ajustar &koffice; a sus necesidades, reduje el &GUI; al mínimo de funcionalidad. Ya que ella sólo necesita escribir cartas y usar ciertas plantillas, no hay necesidad de mucha más funcionalidad que guardar, cargar, imprimir, &etc;

Gracias al concepto de acción de &Qt; y &kde;, puede personalizar libremente las barras de menú y de herramientas de &koffice;. Desafortunadamente, por el momento no hay diálogos fáciles para hacer esto. &koffice; guarda la configuración de su &GUI; en archivos &XML; y tendrá que editarlos. Con suerte, esta situación cambiará en el futuro; por ahora, tendrá algunos conocimientos básicos de cómo funciona un documento &XML; (o HTML, que es un subconjunto de &XML;). [El concepto de acción necesita discutirse en más detalle -- kt.]

Normalmente, cada aplicación de &koffice; tiene al menos dos archivos &XML;: uno que describe el &GUI; del shell (básicamente, esto es lo que verá si no hay ningún documento abierto) y uno que describe el &GUI; de la parte respectiva (esto es lo que verá normalmente). Por ejemplo, para &kword;, estos dos archivos de &XML; se llaman `kword_shell.rc` y `kword.rc`.

Aquí hay un ejemplo simple de tal archivo rc.

#### Un ejemplo de un archivo rc simple

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

## Cómo obtener más información

### Otros manuales de &koffice;

Para información detallada de diferentes aplicaciones de &koffice;, consulte sus respectivos manuales.

### Enlaces

Los siguientes enlaces deberían ser útiles si está buscando más información sobre &kde; o &koffice;.

- La página de &koffice;. Aquí puede encontrar información sobre cómo obtener e instalar &koffice;, noticias sobre el desarrollo de &koffice;, capturas de pantalla &etc;

- &kde-http;. El entorno de escritorio más avanzado y absolutamente libre para sistemas operativos tipo unix. &koffice; hace uso de las bibliotecas de &kde;.

- Troll Tech. Los creadores del kit de desarrollo basado en C++ &Qt;. &kde; y &koffice; hace uso de &Qt;.

## Programando &koffice;

Si quiere desarrollar para &koffice;, los siguientes recursos pueden ser interesantes:

- En http://developer.kde.org encontrará muchos documentos sobre la programación con &Qt; y &kde;. Aquí puede encontrar la versión en la red de la documentación de la biblioteca &kde;.

- Use kdoc (en el módulo del CVS `kdoc`) para generar su propia documentación de la biblioteca &kde;.

- En las fuentes de &koffice; encontrará una aplicación de ejemplo en el directorio `example`.

## Copyright y licencia

Copyright de &koffice; por el equipo de &koffice;.

Este manual es copyright de Jost Schenck. Se puede distribuir libremente, según la nota del copyright incluida. Puede cambiarlo y enviarme los cambios o realizarlos sobre el CVS de &kde;. No me hago responsable de ningún resultado del uso de este manual.

Los otros manuales de &koffice; son copyright de sus respectivos autores.

&underFDL; &underGPL;

## Instalación

### Requisitos del sistema

Para instalar y usar &koffice; tiene que tener:

- Un sistema &UNIX; en funcionamiento (por ejemplo, &Linux; o BSD) con un &X-Window; configurado (por ejemplo, XFree86).

- Las bibliotecas &Qt; 2.1 de Troll Tech. Vea ftp://ftp.troll.no/ para más información.

- El entorno de escritorio K 2.0 (&kde; 2.0). &koffice; no se puede compilar con versiones anteriores de &kde;. Se puede encontrar información sobre cómo obtener y compilar &kde; 2.0 en: &kde-http;

- Permiso para instalar software en su computador. Si está en un sistema propio, esto no debería ser un problema. Sin embargo, si está usando un computador en red, consulte antes con su administrador.

Por favor, tenga en cuenta que, aunque necesite las bibliotecas 2.0 en su sistema, puede usar aún &koffice; en un entorno de escritorio diferente (por ejemplo, &kde; 1.1, UDE o GNOME).

Si planea compilar &koffice; desde el código fuente también necesitará:

- `automake` 1.4 o más reciente. Se puede descargar de: ftp://ftp.gnu.org/pub/gnu/automake/

- `autoconf` 2.13 o posterior. Se puede descargar de: ftp://ftp.gnu.org/pub/gnu/autoconf/

- Un compilador de C++ que admita excepciones (preferiblemente egcs 1.1.x). Se puede descargar de http://egcs.cygnus.com/

- Paquetes de desarrollo de &Qt; 2.1 de Troll Tech. Se pueden descargar de ftp://ftp.troll.no/

Una vez que haya determinado que su sistema cumple estos requisitos, debe decidir si quiere compilar el código fuente o instalar paquetes binarios precompilados.

Si quiere obtener la versión binaria más reciente de KOffice, puede encontrar más información siguiendo este enlace: Obteniendo paquetes binarios.

Si no hay paquetes binarios disponibles para su sistema, puede descargar el código fuente y compilarlo usted mismo. Se pueden encontrar instrucciones sobre dónde obtener el código fuente actual (y qué hacer con el código fuente una vez que lo tenga) siguiente este enlace:Getting the source code.

Visite la página de &koffice; para más detalles. Ahí es donde siempre puede encontrar la información más reciente tanto de las distribuciones fuente como binaria.

### Obteniendo paquetes binarios

Puede descargar los binarios más recientes de:

http://koffice.kde.org/

o de una de las muchas réplicas. La lista actual de sitios de réplica se puede encontrar en:

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

Es importante que use un paquete binario que sea compatible con su sistema. Si usa el sistema operativo &Linux; y no puede encontrar un paquete binario en el sitio web de &koffice; o una de sus réplicas, puede que haya la posibilidad de obtener uno del sitio de su distribución.

### Desde paquetes binarios

Para instalar &koffice; desde binarios precompilados, debería:

1. Asegurarse de que su computador tiene todo el software requerido instalado y funcionando (excluyendo &koffice;, por supuesto). Puede encontrar los requisitos del sistema siguiente este enlace: System Requirements.

2. Descargue el binario de &koffice; en un directorio temporal.

3. Si el nombre del archivo acaba en `.rpm` (archivo del sistema de paquetes de &RedHat;), &koffice; se puede instalar con el siguiente comando:

       $
       rpm-Unombrearchivo

   .

   Si el nombre del archivo acaba en `.deb` (archivo de paquete de Debian), &koffice; se puede instalar usando el siguiente comando:

       $ dpkg-i
       nombrearchivo

   Si el nombre del archivo acaba en `.tar.gz` o `.tgz` (un archivo tarball), &koffice; se puede instalar con los siguientes comandos:

       $ cd /
       $ tar -xzvf nombrearchivo

4. Eso es todo. &koffice; debe estar ahora instalado en su sistema.

Si tiene un interfaz gráfico para la gestión de paquetes, como &kpackage; o GnoRPM instalado en su sistema, puede encontrar más conveniente usarlos en lugar de una línea de comando. Consulte la documentación del programa para averiguar cómo instalarlo con él.

### Obteniendo el código fuente

Puede descargar el código fuente actual de: http://koffice.kde.org/ o de uno de los muchos sitios de réplica. La lista actual de sitios de réplica se puede encontrar en:

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

### Desde código fuente

Si quiere construir &kword; desde el código fuente, debería:

1. Asegurarse de que su computador tiene tono el software requerido instalado y funcionando (salvo &koffice;, por supuesto). Puede encontrar los requisitos del sistema siguiendo este enlace: System Requirements.

2. Descargue el archivo fuente de &koffice; en un directorio temporal.

3. Si el nombre del archivo termina en `.src.rpm` (archivo de sistema de paquetes de &RedHat;), el código fuente de &koffice; se puede instalar con:

       $ rpm-Unombrearchivo

   Si el nombre del archivo acaba en `.src.tar.gz` o `.src.tgz` (un archivo tarball), el código fuente para &koffice; se puede instalar con:

       $ tar -xzvf nombrearchivo

4. El código fuente para &koffice; debe estar instalado en su sistema.

### Problemas con la compilación

Por escribir

&documentation.index;