Overview

Artifact ID: c4c2b08f28a30a4ef2c92ab440af2a3fc475443b
Page Name:Fonctionnement hors-ligne
Date: 2020-11-12 19:56:49
Original User: bohwaz
Mimetype:text/x-markdown
Parent: 9ac7dab3813550f2c7b46d94711cdf13678ea292 (diff)
Next 1179d0d6a1d7232f452d838dd3aedfa6b9f9c61a
Content

Garradin peut fonctionner sur votre PC, sans avoir besoin d'être installé sur un serveur distant ! C'est le mode "hors ligne", ou "Garradin desktop edition" ;)

Pour cela il faut installer le paquet .deb sous les distributions Linux Debian et Ubuntu.

Une fois le paquet installé, il est possible de lancer Garradin via :

  • Le menu "Applications" du système, à la catégorie "bureautique" ou "finances"
  • En ligne de commande : en lançant la commande garradin

(Note : dans ce document ~ dans un chemin veut dire "le répertoire personnel de l'utilisateur courant", synonyme de /home/machin ou machin est votre login utilisateur.)

Lancé de cette manière, Garradin va enregistrer le fichier de l'association par défaut dans le répertoire .local/share/garradin de l'utilisateur courant (ou ~/.local/share/garradin en jargon Unix). Dans ce répertoire un fichier association.sqlite représente les données de l'association. Les sauvegardes seront également stockées dans ce dossier et nommées association.XXXX.sqlite ou XXXX indique l'origine de la sauvegarde (effectuée avant une mise à jour, avant une restauration de sauvegarde, ou alors à intervalle fixe).

Utilisation avancée avec une base de données différente

Pour spécifier une base de données située à un autre endroit, avec Garradin en ligne de commande il est possible de lancer la commande garradin /chemin/vers/le/fichier/association.sqlite

La prochaine fois que Garradin sera lancé sans argument, il réutilisera ce fichier-là.

Pour annuler ce comportement il convient de supprimer le fichier ~/.config/garradin/last qui contient l'adresse du fichier d'association à utiliser au lancement.

Il n'est pas possible d'ouvrir plusieurs fichiers d'association différents en même temps.

Pour fermer l'instance Garradin en cours il faut fermer le terminal ou le tuer en faisant Ctrl+C ou dans un autre terminal lancer killall garradin.

Enfin, pour spécifier un autre répertoire par défaut pour le stockage des fichiers d'association, il suffit de personnaliser la variable d'environnement XDG_DATA_HOME au lancement : XDG_DATA_HOME=/home/user/association garradin

Utilisation avancée : modification de la configuration

Si vous mettez un fichier config.local.php dans le répertoire ~/.config/garradin/ celui-ci sera utilisé par Garradin, vous permettant de modifier la configuration interne de Garradin.

Pour voir ce qu'il est possible de configurer, consultez le fichier config.dist.php qui montre les différentes constantes de configuration possibles.