306 lines
12 KiB
Text
306 lines
12 KiB
Text
Readme for libreoffice package for Debian
|
|
--------------------------------------------
|
|
|
|
Contents
|
|
========
|
|
Introduction
|
|
Quick start
|
|
Printer setup
|
|
Native CUPS support
|
|
Non-CUPS systems
|
|
Language support
|
|
Spellcheck dictionaries, Hyphenation patterns and Thesauri
|
|
Help packages
|
|
Display and crashing problems
|
|
X server crashes
|
|
Font problems
|
|
Why are the menu fonts smaller than in older versions?
|
|
Changing the default user interface font typeface for non-KDE/Gnome desktops
|
|
Enabling the splash screen
|
|
AppArmor problems
|
|
More information about LibreOffice in Debian
|
|
|
|
|
|
Introduction
|
|
============
|
|
Welcome to the LibreOffice packages for the Debian distribution. These
|
|
packages are of the release of LibreOffice with the following
|
|
modifications:
|
|
|
|
* Packaged as libreoffice-core (architecture-dependent core files),
|
|
libreoffice-common (architecture-independent common files),
|
|
libreoffice-{calc,writer,draw,impress,base} (the LibreOffice modules)
|
|
libreoffice-l10n-<lang> and libreoffice-help-<lang> and
|
|
other subpackages (-filters-* for lesser used filters, -gtk/-gnome/-kde,
|
|
ttf-opensymbol for the OpenSymbol font, ...).
|
|
|
|
* Integration with other Debian packages:
|
|
- Global desktop integration for all users for KDE and Gnome desktops.
|
|
Menu entries for all window managers that support the Debian 'menu'
|
|
package.
|
|
|
|
* Some extra features not yet present in official releases:
|
|
- Many of the patches included in the Ximian edition
|
|
|
|
* Extra documentation - this README and man pages.
|
|
|
|
|
|
Quick start
|
|
===========
|
|
|
|
To start using LibreOffice, execute the command
|
|
|
|
libreoffice
|
|
|
|
as the user which you wish to start LibreOffice as. This will create the
|
|
necessary user files in ~/.libreoffice/3 for you. Alternatively, you
|
|
can start LibreOffice from the menus, if you have the menu package
|
|
installed/use KDE or GNOME.
|
|
|
|
Printing
|
|
========
|
|
|
|
Printing on CUPS systems
|
|
------------------------
|
|
The Debian packages include native CUPS support from version 1.1.1-3. This
|
|
is standard in all OpenOffice.org versions since 2.0.
|
|
When LibreOffice detects a CUPS system, it will download printer settings for
|
|
all CUPS queues, and these can be set from within the printer properties dialog.
|
|
|
|
If you wish to add additional filters or print commands, you can add them
|
|
using 'spadmin'. Note that the 'Add a printer' option is disabled - you
|
|
should add printers using your favourite CUPS frontend.
|
|
|
|
When creating a new document, LibreOffice will use the default paper size of
|
|
your default CUPS printer queue. If your new documents have the wrong paper
|
|
size, please check the configuration of your printer.
|
|
|
|
Non-CUPS systems (lpr, lprng, SAL_DISABLE_CUPS=1)
|
|
---------------------------------
|
|
There is a tool supplied with LibreOffice for setting up printers. You can
|
|
execute this with the command
|
|
|
|
/usr/lib/openoffice/program/spadmin
|
|
|
|
To change the page size and other default settings on non-CUPS systems,
|
|
modify /etc/openoffice/psprint.conf. The settings are documented in there.
|
|
|
|
Language support
|
|
================
|
|
You can get foreign language support by installing the
|
|
libreoffice-l10n-<lang> package for your language. You will also need the
|
|
'locales' (or belocs-locales-data for some locales, alternatively locales-all
|
|
if you want all locales) package installed.
|
|
The user interface language is selected according to your locale(1) settings.
|
|
|
|
To change the user interface language for all users, run
|
|
|
|
dpkg-reconfigure locales
|
|
|
|
[ This is not needed when you install locales-all ]
|
|
|
|
To change the language for just one user, you must arrange for the LC_MESSAGES
|
|
or LANG environment variable to be set. You can list all available locales
|
|
with the command 'locale -a'.
|
|
For example, to run LibreOffice in German from the command line:
|
|
|
|
LANG=de_DE libreoffice
|
|
|
|
Spellcheck dictionaries, Hyphenation patterns and Thesauri
|
|
----------------------------------------------------------
|
|
Currently, there are dictionaries available for Afrikaans, Arabic, Armenian,
|
|
Bulgarian, Catalan, Croatian, Czech, Danish, Dutch, English (AUS/GB/US),
|
|
Esperanto, Estonian, Farsi, Finnish, French, Galician, German (DE/CH/AT),
|
|
Greek, Hebrew, Hungarian, Irish (Gaeilge), Italian, Kurdish, Latvian,
|
|
Lithuanian, Manx Gaelic, Norwegian Bokmal, Norwegian Nynorsk, Polish,
|
|
Portuguese, Portuguese (Brazilian), Russian, Scots Gaelic, Slovak, Slovenian,
|
|
Spanish, Swahili, Swedish, Thai, Ukrainian and Uzbek.
|
|
Dictionaries are packaged as myspell-<lang> (or, for newer ones improved
|
|
for hunspell hunspell-<lang>).
|
|
|
|
Currently, there are thesauri available for Czech, English (AUS/GB/US),
|
|
German (DE/CH), Italian, Polish and Slovak.
|
|
Thesauri are packaged as mythes-<lang>
|
|
|
|
Currently, there are hyphenation patterns available for English (USA),
|
|
Croatian, Estonian, German, Hungarian, Italian, Polish, Slovenian and
|
|
Lithuanian.
|
|
Hyphenation patterns are packaged as hyphen-<lang>.
|
|
|
|
Help packages
|
|
-------------
|
|
Currently, there are localized help packages available for
|
|
Bulgarian, Chinese, Czech, Danish, Dutch, English (GB), English (USA),
|
|
Estonian, French, Galician, German, Hungarian, Italian, Japanese, Khmer,
|
|
Macedonian, Polish, Portuguese (Brazil), Russian, Slovakian, Slovenian and
|
|
Spanish and Swedish.
|
|
They are packaged as libreoffice-help-<lang>.
|
|
|
|
Problems
|
|
================================
|
|
|
|
Here are some problems that have been reported with this version. If you do
|
|
not see your problem here, please check for open bug reports:
|
|
|
|
http://bugs.debian.org/debian-openoffice@lists.debian.org
|
|
|
|
1. If you are using NFS mounted file systems, you should make sure that locking
|
|
is functioning:
|
|
|
|
'Make sure NFS lockd/statd is running on the client, or mount the NFS export
|
|
with the 'nolock' option.
|
|
|
|
If /usr gets mounted from an initrd, check 'ps' output once the system is
|
|
fully booted to ensure that you see a [lockd] kernel process, or an
|
|
'rpc.lockd' / 'rpc.statd' userspace process.
|
|
|
|
If not, just issue your mount command again (no need to even -o remount it
|
|
seems!) and run /etc/init.d/nfs-common restart.' (Thanks to Gavin Hamill)
|
|
|
|
See this mailing list thread for more information:
|
|
http://lists.debian.org/debian-openoffice/2004/debian-openoffice-200402/msg00223.html
|
|
|
|
X server crash with Matrox cards
|
|
--------------------------------
|
|
If your X server is using the mga driver, you may find that your X server
|
|
crashes. You can work around this problem by adding this line to the mga
|
|
Device section:
|
|
|
|
Option "XaaNoScreenToScreenColorExpandFill"
|
|
|
|
There is a bug already open against xserver-xfree86 for this problem. Thanks
|
|
to Philip Armstrong for this information.
|
|
|
|
LibreOffice crash with nVidia cards
|
|
--------------------------------------
|
|
It seems that LibreOffice can trigger some obscure bugs in the X server
|
|
drivers for Nvidia cards too, especially if you have more than one processor.
|
|
Try updating your drivers to the latest version.
|
|
|
|
Moreover LibreOffice may hang and takes X with it when RenderAccel
|
|
is enabled when using the proprietary nVidia Drivers. Disabling this option
|
|
helps then.
|
|
|
|
Font problems
|
|
=============
|
|
|
|
Why are the menu fonts smaller than in older versions?
|
|
------------------------------------------------------
|
|
This is caused by a change in the way LibreOfffice interprets your X server DPI
|
|
setting.
|
|
This setting, when correctly configured, means that software can display text
|
|
at its true size on the display.
|
|
|
|
The official OpenOffice.org version assumes that anyone who has their X server
|
|
configured with a DPI of less than 96 has not actually configured it at all,
|
|
and sets it back to 96. Unfortunately, this has the side effect that
|
|
displays with a lower DPI setting, such as some LCD laptop displays, cannot
|
|
display the page at its true size.
|
|
|
|
So you can fix this by correctly setting the DPI for your X server. Gnome
|
|
users will find that it is set to 96 DPI by default; others may need to edit
|
|
their X server configuration.
|
|
|
|
The best way to get the correct DPI setting is to add a 'DisplaySize' entry to
|
|
the Monitor section. From the XF86Config-4 man page:
|
|
|
|
DisplaySize width height
|
|
This optional entry gives the width and height, in millimetres, of the
|
|
picture area of the monitor. If given this is used to calculate the
|
|
horizontal and vertical pitch (DPI) of the screen.
|
|
|
|
If you set this value correctly, X will calculate and use the correct DPI
|
|
setting, even if you use several different display resolutions.
|
|
|
|
From Nikita V. Youshchenko <yoush at cs.msu.su>:
|
|
|
|
- Many display manager configurations pass the option "-dpi 100" to the X
|
|
server by default, overriding any autodetected DPI. This has to be removed
|
|
for DisplaySize to work. The file that you need to edit varies depending on
|
|
the way your X server is started:
|
|
xdm: /etc/X11/xdm/Xservers
|
|
kdm: /etc/kde3/kdm/Xservers
|
|
gdm: /etc/gdm/gdm.conf
|
|
startx: /etc/X11/xinit/xserverrc
|
|
|
|
- Gnome's gconf overrides the autodetected DPI, by setting Xft.dpi to a value
|
|
entered in configuration dialog, 96 by default. I don't know what is
|
|
the clean fix for this. Perhaps it should be fixed on the Gnome side.
|
|
|
|
From Juergen Kreileder <jk at blackdown.de>:>
|
|
|
|
- Note that with most recent graphics cards and monitors XFree86 is able to
|
|
get the monitor size (and thus the correct dpi value) through ddc.
|
|
(**) NVIDIA(0): Validated modes for display device DFP-0:
|
|
(**) NVIDIA(0): Default mode "1600x1200": 189.0 MHz, 87.5 kHz, 70.0 Hz
|
|
(II) NVIDIA(0): Virtual screen size determined to be 1600 x 1200
|
|
(--) NVIDIA(0): Display dimensions: (410, 310) mm
|
|
(--) NVIDIA(0): DPI set to (99, 98)
|
|
(That's with the proprietary NVIDIA drivers but other XFree86 drivers have
|
|
that support too.)
|
|
|
|
If you use KDE or Gnome, LibreOffice will use the same font face and size as
|
|
your desktop environment. If you use another window manager, you can either
|
|
let it pick a default font itself, or change the font to be used (see next
|
|
section), or set the OOO_FORCE_DESKTOP environment variable to
|
|
kde (for kde3)/kde4 or gnome, to use KDE or Gnome settings respectively.
|
|
|
|
Changing the default user interface font typeface for non-KDE/Gnome desktops
|
|
----------------------------------------------------------------------------
|
|
If you do not want to use KDE or Gnome settings and want to change font sizes
|
|
within LibreOffice, you can configure the user interface font as follows:
|
|
|
|
- Font size -
|
|
|
|
You can change the font scaling using the user interface:
|
|
|
|
Tools Menu -> Options -> View -> Scale
|
|
|
|
- Font typeface -
|
|
|
|
You can change the default font typeface by replacing it with a different font
|
|
installed on your system. This can be done using the font replacement function.
|
|
Choose Tools - Options - LibreOffice - Font Replacement to access this
|
|
function.
|
|
|
|
To change the font of the LibreOffice user interface, you have to replace
|
|
the default font "Andale Sans UI" with another font and mark the "always"
|
|
setting for this replacement. "Andale Sans UI" is not selectable and has to be
|
|
typed in. The replacement font has to be a font which supports the requested
|
|
locale ( e.g for Korean language the replacement font has to be a font
|
|
including Korean characters).
|
|
|
|
Refer to the LibreOffice Help for a detailed explanation of the font
|
|
replacement dialog.
|
|
|
|
Enabling the splash screen
|
|
==========================
|
|
If you like the splash screen while LibreOffice is loading, you can enable it by
|
|
editing /etc/openoffice/sofficerc. Change Logo=0 to Logo=1.
|
|
|
|
AppArmor problems
|
|
=================
|
|
|
|
LibreOffice in Debian ships with AppArmor profiles:
|
|
|
|
/etc/apparmor.d/usr.lib.libreoffice.*
|
|
|
|
To debug issues with these AppArmor profiles, see:
|
|
|
|
https://wiki.debian.org/AppArmor/Debug
|
|
|
|
If you are using custom settings such as a custom env:UserInstallation
|
|
directory, you may need to adjust them to match your local setup.
|
|
In this example, you would need to add your custom
|
|
env:UserInstallation to @{libo_user_dirs} in the
|
|
usr.lib.libreoffice.program.soffice.bin profile.
|
|
|
|
More information about LibreOffice in Debian
|
|
===============================================
|
|
Please read the official README.gz (in the same directory as this file), too.
|
|
|
|
If you have questions, either post to our the mailing list:
|
|
|
|
http://lists.debian.org/debian-openoffice
|
|
|
|
The Debian LibreOffice team
|