301
300
<sect2><title>How to Get Correct Printout</title>
304
While &koffice; automatically can handle all X11 fonts <emphasis>on
305
screen</emphasis>, printout can pose a problem: on most systems,
306
printing is done via <application>ghostscript</application>. Now, while
307
&koffice; knows the font names used by X Windows, it does normally
302
<para> While &koffice; automatically can handle all X11 fonts
303
<emphasis>on screen</emphasis>, printout can pose a problem: on most
304
systems, printing is done via
305
<application>ghostscript</application>. Now, while &koffice; knows the
306
font names used by X Windows, it does normally
308
307
<emphasis>not</emphasis> know the font names used by
309
ghostscript. &koffice; tries to guess these names, which unfortunately
310
doesn't work all of the time.
308
<application>ghostscript</application>. &koffice; tries to guess these
309
names, which unfortunately doesn't work all of the time. </para>
314
312
This problem can be solved, although this is not that easy. Actually,
365
363
functionality than saving, loading, printing, &etc;
369
Thanks to the <quote>action</quote> concept of &Qt; and &kde;, you can freely customize
370
&koffice; menu bars and tool bars. Unfortunately, at the moment, there are no
371
easy-to-use dialogs to do this. &koffice; stores its &GUI; configuration in
372
&XML; files and you'll have to edit those. Hopefully, this situation will
373
change in the future; for now, you'll need some basic knowledge of how
374
an &XML; document works (or <acronym>HTML</acronym>, which is a subset
375
of &XML;). [The <quote>action</quote> concept needs to be discussed in
366
<para> Thanks to the <quote>action</quote> concept of &Qt; and &kde;,
367
you can freely customize &koffice; menu bars and tool
368
bars. Unfortunately, at the moment, there are no easy-to-use dialogs
369
to do this. &koffice; stores its &GUI; configuration in &XML; files
370
and you'll have to edit those. Hopefully, this situation will change
371
in the future; for now, you'll need some basic knowledge of how an
372
&XML; document works (or <acronym>HTML</acronym>, which is a subset of
373
&XML;). [The <quote>action</quote> concept needs to be discussed in
374
more detail -- kt.] </para>
380
377
Normally, each &koffice; application has at least two of those &XML;
507
505
This manual is copyright by Jost Schenck. It can be distributed
508
506
freely, as long as this copyright notice is included. You may change
509
it as long as you send me the changes or commit them to KDE CVS.
510
I'll not be liable for anything resulting from the use of this
507
it as long as you send me the changes or commit them to &kde;
508
<acronym>CVS</acronym>. I'll not be liable for anything resulting
509
from the use of this manual.
515
The other KOffice manuals are copyrighted by their respective authors.
513
The other &koffice; manuals are copyrighted by their respective authors.
524
521
<appendix id="installation">
525
522
<title>Installation</title>
527
<sect1 id="Requirements">
524
<sect1 id="requirements">
528
525
<title>System Requirements</title>
531
In order to install and use KOffice you must have:
528
In order to install and use &koffice; you must have:
536
A functioning Unix system (for example, Linux or BSD)
537
with a configured X Window System (for example, XFree86).
533
A functioning &UNIX; system (for example, &Linux; or BSD)
534
with a configured &X-Window; (for example, XFree86).
538
535
</para></listitem>
540
The Qt 2.1 libraries from Troll Tech. See
537
The &Qt; 2.1 libraries from Troll Tech. See
541
538
<ulink url="ftp://ftp.troll.no/">ftp://ftp.troll.no/</ulink>
542
539
for more information.
543
540
</para></listitem>
545
The K Desktop Environment 2.0 (KDE 2.0). KOffice cannot be compiled
546
with earlier versions of KDE. Information on obtaining and installing
547
KDE 2.0 can be found at:
548
<ulink url="http://www.kde.org">http://www.kde.org.</ulink>
542
The K Desktop Environment 2.0 (&kde; 2.0). &koffice; cannot be compiled
543
with earlier versions of &kde;. Information on obtaining and installing
544
&kde; 2.0 can be found at: &kde-http;
549
545
</para></listitem>
551
547
Permission to install software on your computer. If you are on a
558
Please note that, while you need the KDE 2.0 libraries on your system,
559
you can still use KOffice in a different desktop environment (for example,
560
KDE 1.1, UDE or GNOME).
554
Please note that, while you need the &kde; 2.0 libraries on your system,
555
you can still use &koffice; in a different desktop environment (for example,
556
&kde; 1.1, UDE or GNOME).
564
If you plan on <link linkend="FromSource">compiling KOffice from
560
If you plan on <link linkend="from-source">compiling &koffice; from
565
561
source code</link> you will also need:
570
Automake 1.4 or newer. This can be downloaded from:
566
<command>automake</command> 1.4 or newer. This can be downloaded from:
571
567
<ulink url="ftp://ftp.gnu.org/pub/gnu/automake/">ftp://ftp.gnu.org/pub/gnu/automake/</ulink>
572
568
</para></listitem>
574
Autoconf 2.13 or later. This can be downloaded from:
570
<command>autoconf</command> 2.13 or later. This can be downloaded from:
575
571
<ulink url="ftp://ftp.gnu.org/pub/gnu/autoconf/">ftp://ftp.gnu.org/pub/gnu/autoconf/</ulink>
576
572
</para></listitem>
601
597
the source code and compile it yourself. Instructions on where to obtain the
602
598
current source code (and what to do with the source code once you have it)
603
599
can be found by following this link:
604
<link linkend="GettingSource">Getting the source code</link>.
600
<link linkend="getting-source">Getting the source code</link>.
608
Please see the <ulink url="http://koffice.kde.org">KOffice homepage</ulink>
609
for further details. That is where you can always find the most up-to-date
610
information on both source and binary distributions!
603
<note><para> Please see the <ulink
604
url="http://koffice.kde.org">&koffice; homepage</ulink> for further
605
details. That is where you can always find the most up-to-date
606
information on both source and binary distributions! </para></note>
616
<sect1 id="GettingBinaries">
611
<sect1 id="getting-binaries">
617
612
<title>Getting Binary Packages</title>
633
628
<ulink url="http://www.kde.org/mirrors.html">http://www.kde.org/mirrors.html</ulink>
637
It is important that you use a binary package which is compatible with your system.
638
If you use the Linux operating system and are unable to find a binary package
639
at the KOffice web site or one of its mirrors, you may be able to obtain one
640
from the website of your distribution.
631
<note><para> It is important that you use a binary package which is
632
compatible with your system. If you use the &Linux; operating system
633
and are unable to find a binary package at the &koffice; web site or
634
one of its mirrors, you may be able to obtain one from the website of
635
your distribution. </para></note>
646
<sect1 id="FromBinaries">
640
<sect1 id="from-binaries">
647
641
<title>From Binary Packages</title>
650
644
To install &koffice; from precompiled binaries, you should:
653
<orderedlist numeration="arabic">
655
Ensure your computer has all of the required software installed and
656
in working condition (excluding KOffice of course). You can find the
657
system requirements by following this link:
658
<link linkend="Requirements">System Requirements</link>.
661
Download the KOffice binary into a temporary directory.
664
If the filename ends in .rpm (Redhat Package Management file),
665
KOffice can be installed with the following command:
667
<prompt>$</prompt> <command>rpm -U <replaceable>filename</replaceable></command>
669
If the filename ends in .deb (Debian Package file), KOffice can be
670
installed with the following command:
672
<prompt>$</prompt> <command>dpkg -i <replaceable>filename</replaceable></command>
674
If the filename ends in .tar.gz or .tgz (a tarball file), KOffice can be
675
installed with the following command:
677
<prompt>$</prompt> <command>cd /</command>
678
<prompt>$</prompt> <command>tar -xzvf <replaceable>filename</replaceable></command>
682
That's all. KOffice should now be installed on your system.
687
If you have a graphical front-end for package management, such as
688
KPackage or GnoRPM, installed on your system, you may find that more
689
convenient to use than a command line. Consult the program's
690
documentation to find out how to install with it.
649
<para>Ensure your computer has all of the required software installed
650
and in working condition (excluding &koffice; of course). You can find
651
the system requirements by following this link: <link
652
linkend="requirements">System Requirements</link>.</para></step>
653
<step><para>Download the &koffice; binary into a temporary
654
directory.</para></step>
655
<step><para>If the filename ends in <literal
656
role="extension">.rpm</literal> (&RedHat; Package Management file),
657
&koffice; can be installed with the following command:
658
<screen><prompt>$</prompt>
659
<userinput><command>rpm</command><option>-U</option><replaceable>filename</replaceable></userinput></screen>. </para>
660
<para>If thefilename ends in <literal role="extension">.deb</literal> (Debian Package file), &koffice; can be installed with the following command:
661
<screen><prompt>$</prompt> <userinput><command>dpkg</command><option>-i</option>
662
<replaceable>filename</replaceable></userinput></screen>
664
<para>If the filename ends in <literal
665
role="extension">.tar.gz</literal> or <literal
666
role="extension">.tgz</literal> (a tarball file), &koffice; can be
667
installed with the following commands:</para>
670
<prompt>$</prompt> <userinput><command>cd</command> /</userinput>
671
<prompt>$</prompt> <userinput><command>tar</command> <option>-xzvf</option> <replaceable>filename</replaceable></userinput>
676
That's all. &koffice; should now be installed on your system.
680
<note><para> If you have a graphical front-end for package management,
681
such as &kpackage; or <application>GnoRPM</application>, installed on
682
your system, you may find that more convenient to use than a command
683
line. Consult the program's documentation to find out how to install
684
with it. </para></note>
696
<sect1 id="GettingSource">
689
<sect1 id="getting-source">
697
690
<title>Getting Source Code</title>
700
693
You can download the current source code from:
704
694
<ulink url="http://koffice.kde.org/">http://koffice.kde.org/</ulink>
708
695
or from one of many mirror sites. The current list of mirror sites
719
<sect1 id="FromSource">
706
<sect1 id="from-source">
720
707
<title>From Source Code</title>
723
If you want to build KWord from source code, you should:
710
If you want to build &kword; from source code, you should:
726
<orderedlist numeration="arabic">
728
715
Ensure your computer has all the required software installed and
729
in working condition (excluding KOffice of course). You can find
716
in working condition (excluding &koffice; of course). You can find
730
717
the system requirements by following this link:
731
<link linkend="Requirements">System Requirements</link>.
734
Download the KOffice source file (***insert filenames (srpm and tar)
735
here***) into a temporary directory.
738
If the filename ends in .src.rpm (Redhat Package Management file),
739
the source code for KOffice can be installed with:
741
<prompt>$</prompt> <command>rpm -U <replaceable>filename</replaceable></command>
743
If the filename ends in .src.tar.gz or .src.tgz (a tarball file),
744
the source code for KOffice can be installed with:
746
<prompt>$</prompt> <command>tar -xzvf <replaceable>filename</replaceable></command>
750
The source code for KOffice should now be installed on your
718
<link linkend="requirements">System Requirements</link>.
721
Download the &koffice; source file <!-- ***insert filenames (srpm and -->
722
<!-- tar) here*** --> into a temporary directory.
725
If the filename ends in <literal role="extension">.src.rpm</literal>
726
(&RedHat; Package Management file), the source code for &koffice; can
728
<screen><prompt>$</prompt> <userinput><command>rpm</command><option>-U</option><replaceable>filename</replaceable></userinput></screen></para>
730
<para>If the filename ends in <literal role="extension">.src.tar.gz</literal> or <literal role="extension">.src.tgz</literal> (a tarball file),
731
the source code for &koffice; can be installed with:
732
<screen><prompt>$</prompt> <userinput><command>tar</command> <option>-xzvf</option> <replaceable>filename</replaceable></userinput></screen>
734
<step><para>The source code for &koffice; should now be installed on
735
your system.</para></step>
762
<sect1 id="CompilingProblems">
741
<sect1 id="compiling-problems">
763
742
<title>Problems with Compilation</title>
added
removed
doc/koffice/index.docbook
