Pour installer Grisbi, vous devez disposer d'une machine fonctionnant sous
Linux.
Seules les versions stables sont proposées sous la forme de paquets RPM et DEB
(à l'exception des versions antérieures à la 2.2 pour lesquelles il n'y avait
pas de paquetages).
2.1 Introduction
Pour rompre un peu avec l'habitude qui consiste à présenter l'installation
uniquement en ligne de commande (mais celui qui sait se servir de la ligne de
commande n'a normalement pas besoin qu'on lui explique comment taper rpm
;-) nous allons surtout vous expliquer comment installer Grisbi à l'aide des
nombreux outils graphiques que proposent à l'heure actuelle toutes les
distributions. Il en manquera sans doute, dans ce cas merci de nous contacter et
nous aider à compléter ce chapitre. Et afin d'éviter toute polémique ne voyez
surtout pas une quelconque indication sur nos préférences dans l'ordre des
différentes procédures. Hormis les procédures en ligne de commande et la
compilation à partir du CVS qui sont reléguées à la fin, les procédures sont
classées par ordre alphabétique de l'utilitaire décrit.
2.2 Pré-requis
Les librairies suivantes doivent être disponibles sur votre machine :
- gtk 1.2.x ;
- gnome 1.0.x ;
- libxml.
2.3 Installation avec GnoRPM (Gnome)
- ouvrez gnorpm en root (le mieux étant de le faire dans une console en
tapant su puis votre mot de passe, et enfin gnorpm) ;
- cliquez sur le bouton Installer ;
- cliquez sur Ajouter ;
- naviguez dans l'arborescence et sélectionnez le paquetage ;
- cliquez sur le bouton Ajouter ;
- cliquez sur Installer pour installer un paquetage inexistant sur
le système. Et imperativement sur Mise à jour pour la mise à
jour d'un paquetage existant.
2.4 Installation avec Kpackage (KDE)
- téléchargez le RPM et copiez-le où vous voulez sur votre disque dur ;
- ouvrez ensuite le gestionnaire de fichiers en mode super utilisateur et
- allez dans le répertoire où vous avez enregistré le RPM ;
- cliquez (gauche ou droit selon votre configuration) sur le RPM ce qui
ouvre Kpackage avec les prérogatives de root, le seul habilité à installer un
logiciel ;
- choisissez Installer et c'est fini.
2.5 Installation avec RPMInst (distribution Mandrake)
A noter que cette installation ne nécéssite pas de téléchargement préalable du
RPM :
- cliquez sur le lien du RPM qui vous intéresse, une boîte de dialogue vous
demande si vous voulez enregistrer le fichier sur le disque ou l'ouvrir ;
- choisissez Ouvrir ;
- une autre boîte vous demande ensuite votre mot de passe root, pendant que
le contenu du RPM se charge dans un répertoire temporaire sur votre disque ;
- RPMinst démarre à la fin du téléchargement, et l'installation se fait
toute seule :-).
Si certaines dépendances ne sont pas satisfaites RPMinst vous demandera
d'insérer l'un ou l'autre de vos CD Mandrake, à moins que vous n'ayez configuré
une source ftp ou http.
2.6 Installation en ligne de commande
On va quand même sacrifier à la tradition et garder aussi ce passage.
Pour vérifier la présence des pré-requis sur votre machine, tapez dans une
console :
- rpm -qa | grep gtk
- rpm -qa | grep gnome
- rpm -qa | grep libxml
Pour installer Grisbi, ouvrez une console en mode super utilisateur, et tapez :
rpm -Uvh grisbi-n.n.n.rpm où vous remplacez n.n.n par le numéro de la
version que vous venez de télécharger.
2.7 Installation à partir d'un paquetage Debian
Pour installer Grisbi sur une Debian, téléchargez le fichier .deb sur votre
disque dur. Ouvrez une console en mode super utilisateur, et tapez :
dpkg -i grisbi-0.x.x.deb
Les pré-requis et commentaires sont les mêmes que pour les RPM.
2.8 Installation avec APT-GET (distribution Debian)
Si vous avez installé une Debian sur votre machine, sous vouloir vous flatter,
vous savez utiliser apt-get. Nous allons néanmoins rappeler les commandes que
vous aurez à taper :
- dans /etc/apt/sources.list ajoutez :
deb http://www.grisbi.org/telechargement apt/
- dans un terminal, tapez en tant que root : apt-get install grisbi
et c'est tout. Les éventuelles dépendances seront gérées par apt-get. Mais
ça vous le saviez déjà...
2.9 Installation de Grisbi à partir des sources
(tar.gz)
Si vous préférez compiler vous même Grisbi, téléchargez les sources
(grisbi-n.n.n.tar.gz).
Pour installer et compiler les sources, les librairies suivantes (au moins ;-)
sont requises :
- gcc ;
- make ;
- gtk ;
- gnome ;
- gnome32-devel ;
- libxml ;
- libxml-devel ;
- libgnomeprint15-devel ;
- libgdk-pixbuf2-devel.
2.9.1 Mode graphique
Nous donnerons les explications pour KDE dans un premier temps:
- ouvrez Konqueror et allez dans le répertoire où vous avez téléchargé
grisbi-n.n.n.tar.gz ;
- faîtes un clic droit dessus et choisissez Extraire ici... ;
- allez dans le répertoire /grisbi-n.n.n ainsi créé ;
- ouvrez un terminal (menu Fenêtre/Afficher terminal) ;
- tapez :
- ./configure ;
- make ;
- su ;
- saisissez votre mot de passe root ;
- make install ;
- c'est terminé.
Si vous avez des messages d'erreur c'est que des dépendances ne sont pas
satisfaites, et il vous appartient de corriger celà.
Si tout s'est bien passé, Grisbi est installé et vous devriez avoir une entrée
dans le menu Applications/Finances.
2.9.2 Ligne de commande
- décompressez les sources en tapant :
- tar-zxvf grisbi-n.n.n.tar.gz où vous remplacez n.n.n par le numéro
de la version que vous venez de télécharger ;
- allez dans le répertoire ainsi créé : cd grisbi-n.n.n ;
- lancez la compilation en utilisant les mêmes commandes que ci-dessus
(configure, etc.).
2.10 Installation à partir des sources CVS
2.10.1 Avertissement
Vous ne devez en aucun cas utiliser votre fichier de compte avec ces versions de
Grisbi! Travaillez uniquement avec une copie! Le format du fichier de comptes
est susceptible de changer d'un instant à l'autre et vous ne pourriez plus
ouvrir votre fichier. Si la conversion vers le nouveau format se fait
automatiquement le retour en arrière lui n'est pas possible.
Les messages d'alerte de Grisbi sont sufisamment explicites. Nous déclinons
toute responsabilité et ne répondrons à aucun mail en cas de plantage de
fichier.
2.10.2 Connexion au CVS
Comment faire? C'est plus simple qu'on ne pourrait le croire...
Dans une console tapez (sur une seule ligne) :
export CVSROOT=:pserver:anonymous@cvs.tuxfamily.org
:/cvsroot/grisbi
Vous n'aurez pas besoin de retaper cette commande tant que le terminal reste
ouvert.
2.10.3 Version stable
Abonnez-vous à la liste CVS ou consultez ses archives (l'adresse se trouve sur
le site de Grisbi) pour connaître la version stable à télécharger.
Créez quelque part un répertoire Grisbi-stable ou un autre nom du même genre.
Placez-vous dans ce répertoire et tapez :
cvs -z9 checkout -r upstream_version_n.n.n grisbi
Bien évidemment vous remplacerez les n.n.n par ce que vous trouverez sur la
liste CVS.
Ensuite allez dans le sous-répertoire grisbi qui est apparu, et ensuite
utilisez la procédure de compilation habituelle :
- ./configure
- make
- su (puis entrez votre mot de passe root)
- make install
2.10.4 Version instable
C'est une version qui intègre les futures fonctionnalités de Grisbi en cours de
développement.
Pour la tester c'est en gros la même chose sauf que vous nommez votre répertoire
Grisbi-instable, et que vous tapez juste :
cvs -z9 co grisbi
puis vous compilez en ne faisant surtout pas la dernière étape
(make install). A la place cliquez sur l'exécutable qui est apparu dans
le sous-répertoire grisbi/src.
2.11 Installation de la documentation à partir des sources
CVS
De même que le code, la documentation est sur le CVS de Grisbi. Vous pouvez
ainsi récupérer une documentation stable et une instable de la même façon que le
code. En effet la récupération des sources du code sur le CVS ne récupère pas
celles de la documentation. Elle n'est intégrée au code que lors de la création
des archives tar.gz et des paquetages.
La récupération de la documentation est très semblable à celle du code.
2.11.1 Connexion au CVS
Dans une console tapez (sur une seule ligne) :
export CVSROOT=:pserver:anonymous@cvs.tuxfamily.org:
/cvsroot/grisbi
Vous n'aurez pas besoin de retaper cette commande tant que le terminal reste
ouvert.
2.11.2 Version stable
Abonnez-vous à la liste CVS ou consultez ses archives pour connaître la version
stable à télécharger.
Créez quelque part un répertoire Grisbi/Documentation-stable ou un autre nom du
même genre. Placez-vous dans ce répertoire et tapez :
cvs -z9 checkout -r upstream_version_n.n.n doc
Bien évidemment vous remplacerez les n.n.n par ce que vous trouverez sur la
liste CVS. C'est normalement le même numéro que pour le code.
Ensuite allez dans le sous-répertoire /doc qui est apparu.
Les différentes versions peuvent être compilées soit avec soit sans les
illustrations (pour des raisons de taille de fichier). Le choix se fait en
commentant ou en décommentant les lignes 105 et 106 du fichier
grisbi.tex. Lorsque votre choix est fait, utilisez l'une des procédures
de compilation suivante :
- make html pour une documentation au format HTML. Attention, le
premier fichier (la table des matières) se nomme index.html, et le
fichier grisbi.html est la version mono-fichier ;
- make pdf pour une documentation au format PDF ;
- make ps pour une documentation au format PS ;
- make dvi pour une documentation au format DVI ;
- make all pour tous les formats d'un seul coup.
Copiez la documentation dans le répertoire qui adéquat et tapez
make distclean pour nettoyer les fichiers générés par la compilation.
Pour tout effacer (pour recommencer une nouvelle compilation) tapez make
mrproper.
2.11.3 Version instable
C'est la version qui documente les fonctionnalités de Grisbi contenues dans le
code instable.
Pour la tester c'est en gros la même chose sauf que vous nommez votre répertoire
Grisbi/Documentation-instable, et que vous tapez juste :
cvs -z9 co doc
puis vous compilez comme précédemment.
2.12 Démarrer Grisbi
Normalement la procédure d'installation a rajouté une entrée dans votre menu
K ou Gnome dans la section Bureautique/Finances.
Vous pouvez bien sûr placer un raccourci sur votre bureau. L'icône se
trouve dans /usr/share/pixmaps.
Vous pouvez également taper grisbi dans une ligne de commande.