
                             StarOffice mini-HOWTO

Matthew Borowski,
Adapt par Nat Makarvitch

   Version 0.8fr8b
     _________________________________________________________________

   _Installation de StarOffice (StarDivision, GmbH) sous Linux._
     _________________________________________________________________

1. Introduction

   Site de rfrence de la Version Originale

   La plus rcente version franaise de ce texte se trouve sur son site
   de rfrence. Seule la diffusion des versions non modifies est
   autorise.

   L'ensemble logiciel _StarOffice_, rdig en langage C et exploitant la
   bibliothque Motif, rassemble plusieurs outils de bureautique :
     * StarWriter, traitement de texte
     * StarCalc, tableur
     * StarImage, logiciel de dessin
     * StarDraw, logiciel de dessin objet
     * StarChart, grapheur
     * StarMath, diteur d'quations

   La version Linux de StarOffice est librement utilisable en dehors des
   contextes commerciaux mais tout utilisateur professionnel doit
   acqurir une licence dont le cot est pour le moment non dtermin.

   Seule la distribution _OpenLinux_ (commercialise par Caldera) permet
   d'employer partout StarOffice.

1.1 Motif

   StarOffice utilise la version 2.0 de la bibliothque Motif.
   _Motif 1.2_ ou _LessTif_ ne permettront donc pas d'exploiter le
   binaire dpendant de bibliothques dynamiques.

   La version "statique" du programme, gnre de faon  intgrer les
   bibliothques, fonctionne partout mais induit une charge svre du
   systme.

   StarOffice fonctionne bien sur mon Pentium 100 disposant de 48 Mo de
   mmoire vive, sous Linux Red Hat 4.1 et Motif 2.0. Le chargement de la
   version "dynamique" exige beaucoup moins de ressources que la version
   "statique" et dure environ une minute.

2. Pour obtenir StarOffice

   La la plus rcente disponible se trouve sur le serveur FTP de Lire le
   fichier "README.StarOffice" avant de tlcharger les archives
   proposes.

   Ces fichiers se trouvent aussi sur d'autres serveurs FTP, par exemple
   (France mtropolitaine) au LIP6

   Liste des archives  tlcharger (cas de la version 3.1) :

     * StarOffice31-common.tar.gz
     * l'une des archives de documents standard et d'exemples :
          + StarOffice31-english.tar.gz (version anglaise) ou
          + StarOffice31-german.tar.gz (version allemande)
     * l'une des archives de binaires :
          + StarOffice31-dynbin (dynamiques) ou
          + StarOffice31-statbin.tar.gz (statiques)
     * (le cas chant) StarOffice31-upgrade2final.tar.gz

   Note : l'diteur Caldera propose aussi StarOffice, par exemple sous
   forme de CD-ROM vendu 7,99 dollars amricains.

3. Installation

   Voici les tapes de l'installation de StarOffice :
     * l'utilisateur _root_ doit dcompacter sous /usr/local les archives
       _tar_ fournies
     * chaque utilisateur doit lancer au moins une fois le programme
       d'installation locale
     * chaque utilisateur doit "sourcer" un fichier cr lors de
       l'installation locale
       (_ /.sd.sh_ or _ /.sd.csh_)
     * chaque utilisateur lira avec profit la section de ce document
       consacre  LANG.

3.1 Bibliothque C (libc)

   Les binaires de StarOffice reposent sur la version 5.4.4 de la
   bibliothque C, et fonctionneront avec la libc 5.3, _mais_ le
   programme d'installation ne donne satisfaction qu'avec une version de
   libc au moins gale  5.4.4.

   Une solution (non teste) permettant d'installer le logiciel sans
   mettre  jour consisterait  dsarchiver une libc adquate dans un
   rpertoire temporaire puis  la rfrencer dans la variable
   d'environnement _LD_LIBRARY_PATH_ avant d'invoquer l'utilitaire
   d'installation.

   Il est inutile d'essayer d'employer une libc trop ancienne car la
   procdure d'installation choue en ce cas avec le message d'erreur :
 line 1: Syntax error at token 'I' expected declarator;

  Mise  jour de la libc

   La plus rcente version de la libc se nomme _libc-VERSION.bin.tar.gz_
   (par exemple _libc-5.4.33.bin.tar.gz_) et se trouve dans le rpertoire
   /pub/linux/GCC des sites FTP (par exemple _ftp.lip6.fr_).

   En extraire le contenu dans un rpertoire temporaire puis, en tant que
   root, copier le fichier libc.so.* dans le rpertoire /lib. tablir
   ensuite le lien symbolique ncessaire  sa prise en charge grce  la
   commande :
ln -sf /lib/libc.so.VERSION /lib/libc.so.5

   o _VERSION_ remplace le numro de version.

   Les utilisateurs de la distribution Red Hat utiliseront plutt le
   paquet _rpm_ adquat.

   Le _Dr. Romano Giannetti_ (romano@iet.unipi.it) nous rvle comment
   installer sans mise  jour de la libc sur une machine Red Hat 4.2 avec
   libc5.3 :
    1. rcuprer une libc.so.5.4.x, pas exemple sous forme de rpm (il se
       trouve dans le rpertoire contrib des sites FTP). L'extraire dans
       un rpertoire temporaire vide grce  : rpm2cpio
       libc.so.5.4.x-y.rpm | cpio --extract --make-directories. La
       bibliothque se trouvera dans le rpertoire ./lib
    2. dplacer libc.so.5.4.x idans votre rpertoire home. Puis (correct
       sous un shell de la famille sh): ln -s libc.so.5.4.x libc.so.5 ;
       export LD_LIBRARY_PATH=$HOME:/lib:/usr/lib
    3. invoquer setup

  Installation du programme

   Il suffit, en tant que _root_, d'extraire les archives de StarOffice
   sous /usr/local/ :
cd /usr/local
tar -xzvf NOM_DU_FICHIER.tar.gz

  Configuration

   Chaque futur utilisateur de StarOffice doit invoquer les commandes
   suivantes :
cd /usr/local/StarOffice-3.1
./setup

   puis opter pour la "standard installation". Il est recommand
   d'accepter d'installer dans le chemin de rpertoire propos ("default
   installation path").

   StarOffice utilise un certain nombre de variables d'environnement. Les
   fichiers ~/.sd.sh (pour le shell Bourne) et ~/.sd.csh (pour le shell
   C) mettent en place les valeurs adquates. Les utilisateurs de _bash_
   devront placer  la fin de leur fichier ~/.bashrc une ligne :
source ~/.sd.sh

   Cette ncessaire modification ne sera prise en charge que lors des
   connexions ("login") suivantes.

  Bogue de Caldera OpenLinux

   Phil Reardon indique que la procdure d'installation du StarOffice
   d'OpenLinux ajoute  l'un des chemins de rpertoires un caractre '/'
   inutile. Pour rsoudre ce problme il suffit de supprimer le premier
   caractre '/' apparaissant dans la ligne :
exec ${pfad:='.'}/linux-x86/bin/$name;;

   Il faut donc supprimer le '/' plac avant "linux-x86".

  Variable d'environnement LANG

   Les fichiers ~/.sd.sh et ~/.sd.csh lient la variable d'environnement
   _LANG_  une valeur, ce qui oblige divers programmes (dont _Perl_ et
   _man_)  mettre des messages d'avertissement, par exemple : "warning:
   setlocale(LC_CTYPE, "")..." ou bien "Failed to open the message
   catalog man on the path NLSPATH=".

   Il suffit, pour s'en affranchir, de supprimer la ligne "LANG=us" de
   ~/.sd.sh et la ligne "setenv LANG us" de ~/.sd.csh.

   Merci  Adam L. Klein, de m'avoir indiqu cela.

4. Invocation

   Lancer au pralable une seule instance par machine de :
     * "svdaemon" afin de disposer de l'aide en ligne
     * "svportmap" afin d'assurer la communication entre les applications

   Pour invoquer StarOffice :

export LANG=fr
. ~/sd.sh
/usr/local/StarOffice-3.1/linux-x86/bin/soffice3

   Lors de la premire invocation bien vrifier que les chemins des
   fichiers de configuration sont corrects (menu  options ).

   Les binaires sont abrits dans
   /usr/local/StarOffice-3.1/linux-x86/bin/ et se nomment soffice3,
   sdraw3, swriter3, scalc3, smath3, schart3 et simage3.

5. Astuces

   Voici diverses astuces communiques par _Patrick D'Cruze_
   (pdcruze@netpal.com.au)

    1. Les variables d'environnement mises en place par .sd.sh (ou
       .sd.csh) polluent parfois les autres applications. J'ai donc
       supprim leur "sourcing" dans mes fichiers d'initialisation du
       shell (par exemple .bash_profile). Puis ai copi le fichier .sd.sh
       sous le nom de /usr/local/bin/swriter et y ai ajout une premire
       ligne #! /bin/bash et une ligne exec swriter3 $*  la fin. Il
       suffisait ds lors de le rendre excutable (chmod a+rx
       /usr/local/bin/swriter) afin de permettre  tout utilisateur, en
       l'invoquant, d'utiliser StarWriter.
    2. De nombreux utilisateurs affirment que le chargement de StarOffice
       exige beaucoup de temps (jusqu' une minute). Ce dlai correspond,
       selon les auteurs de la plupart des articles Usenet pertinents, 
       l'allocation de mmoire effectue par l'diteur de liens
       dynamiques ld.so pour chaque symbole rfrenc par Star Office. Ce
       dernier exploite un nombre lev de bibliothques, l'diteur de
       liens explore par consquent une quantit importante de fichiers.
       Une solution consiste  confiner StarOffice, grce  chroot, dans
       une arborescence o se trouveront dupliques les seules
       bibliothques ncessaires (/usr/X11R6/lib, libc/libm et
       libg++/libstdc++), afin d'pargner  l'diteur de liens dynamiques
       d'inutiles recherches. StarWriter, sur mon P13/32 Mo, dmarre
       ainsi en 15 secondes.

6. Problmes divers

   En cas de problme de fontes : chmod -R a+r
   /usr/local/StarOffice3.1/Xp3

   En cas de problme d'impression invoquer, en tant que root, les
   commandes suivantes :
     _________________________________________________________________

mkdir /tmp/XpSp_
mkdir /tmp/Xp_
mkdir /tmp/XpSp_/tmp
mkdir /tmp/Xp_/tmp
chgrp -R users /tmp/XpSp_
chgrp -R users /tmp/Xp_
     _________________________________________________________________

7. Autres sources d'information

     * StarDivision, en particulier le forum.
     * M. Hoennig, donc la GUILDE propose une adaptation en franais.
       Voici un autre document traitant de Star Office (concerne surtout
       la Red Hat 5).

8. Section ajoute dans l'adaptation en franais

8.1 Francophones

   Voici comment faire fonctionner les touches mortes d'accentuation.

   Saisir les accents sous Applixware est possible grce  une table
   xmodmap adquate.
   JP Lecaille (SO 4 sous RH 5)

   Je prcise que j'utilise la Red Hat 5.

   je dcompresse so40_lnx_01.tar.gz dans le rpertoire /usr/local, puis
   libc-5.4.44.bin.tar.gz dans le mme rpertoire (je ne me rappelle plus
   o j'ai trouv la libc, je suppose que c'est accessible sur FTP
   Search).

   Ensuite je me place dans le rpertoire /usr/local/Office40_Install/lib
   et je fais :

ln -s libc.so.5.4.44 libc.so
ln -s libc.so.5.4.44 libc.so.5
ln -s libm.so.5.0.9 libm.so
ln -s libm.so.5.0.9 libm.so.5

   J'dite le fichier setup du rpertoire /usr/local/Office40_Install et
   je le change en :

#!/bin/sh
#
# StarOffice setup script
# (c) 1997, Star Division GmbH

cd `dirname $0`
sd_archive_path=`pwd`
sd_setup_binary=setup.bin
sd_platform=`uname -s`

# some platforms may need an additional search path for X11 shared libraries
case $sd_platform in
  SunOS)
         LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/usr/openwin/lib
         export LD_LIBRARY_PATH
         ;;
      *)
         LD_LIBRARY_PATH=/usr/local/Office40_Install/lib/:$LD_LIBRARY_PATH
         export LD_LIBRARY_PATH
         ;;
esac

        export SAL_FONTPATH XPPATH

# execute setup binary
exec $sd_archive_path/$sd_setup_binary $*

   Il ne reste plus qu' invoquer ~/Office40_Install/setup /net.

9. Contributions

   Merci de contacter l'auteur ou le traducteur de ce document si vous
   disposez d'informations intressantes.

   Cette adaptation franaise doit beaucoup  J. Chion et  P. Vaur.

10. Copyright

   Ce document est (C) 1997 by Matthew Borowski.

   La redistribution de ce document par tout moyen lectronique est
   permise sous condition qu'il demeure inchang. Si vous voulez inclure
   ce document dans un CD-ROM ou un livre, demandez une autorisation
   auparavent (je prfre que les demandes soient effectues par courrier
   lectronique).

   L'auteur dcline toute responsabilit quant  ce qui pourrait advenir
   directement ou indirectement du fait de l'utilisation de ce document.
   L'auteur n'est pas employ chez de StarDivision, GmbH ou Caldera, Inc.

   Commentaires et questions peuvent tre adresss directement  l'auteur
    mkb@poboxes.com.
