1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
|
-
-
+
+
-
-
+
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
-
+
|
# Fonctionnement hors ligne
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 :
* Debian Buster ou supérieur (ne fonctionnera pas avec Stretch ou Jessie !)
* Ubuntu Bionic (18.04) ou supérieur (ne fonctionnera pas avec Xenial)
* Debian Buster ou supérieur
* Ubuntu Bionic (18.04) ou supérieur
Commencez par installer les prérequis :
```
sudo apt update
sudo apt install php-sqlite3 php-intl php-cli php-imagick
```
* Télécharger le paquet .deb : [téléchargement Garradin](./uvlist)
* L'installer (soit avec le gestionnaire de paquet soit en ligne de commande en utilisant `sudo apt-get install ./garradin-X.Y.Z.deb`)
* Télécharger le paquet `.deb` en cliquant sur le bouton **Debian** de [la page d'accueil](./)
* L'installer (soit avec le gestionnaire de paquet soit en ligne de commande en utilisant `sudo apt-get install ./paheko-X.Y.Z.deb`)
Une fois le paquet installé, il est possible de lancer Garradin via :
Une fois le paquet installé, il est possible de lancer Paheko via :
* Le menu "Applications" du système, à la catégorie "bureautique" ou "finances"
* En ligne de commande : en lançant la commande `garradin`
* En ligne de commande : en lançant la commande `paheko`
### Enregistrement des données
(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).
Lancé de cette manière, Paheko va enregistrer le fichier de l'association par défaut dans le répertoire `.local/share/paheko` de l'utilisateur courant (ou `~/.local/share/paheko` 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).
### Extensions
On peu installer des extensions en les mettant dans le répertoire `~/.local/share/garradin/plugins`.
On peu installer des extensions en les mettant dans le répertoire `~/.local/share/paheko/plugins`.
### 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`
Pour spécifier une base de données située à un autre endroit, avec Paheko en ligne de commande il est possible de lancer la commande `paheko /chemin/vers/le/fichier/association.sqlite`
La prochaine fois que Garradin sera lancé sans argument, il réutilisera ce fichier-là.
La prochaine fois que Paheko 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.
Pour annuler ce comportement il convient de supprimer le fichier `~/.config/paheko/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`.
Pour fermer l'instance Paheko en cours il faut fermer le terminal ou le tuer en faisant `Ctrl+C` ou dans un autre terminal lancer `killall paheko`.
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`
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_paheko`
### 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.
Si vous mettez un fichier `config.local.php` dans le répertoire `~/.config/paheko/` celui-ci sera utilisé par Paheko, vous permettant de modifier la configuration interne de Paheko.
Pour voir ce qu'il est possible de configurer, consultez le fichier [`config.dist.php`](https://fossil.kd2.org/garradin/doc/trunk/src/config.dist.php) qui montre les différentes constantes de configuration possibles.
Pour voir ce qu'il est possible de configurer, consultez le fichier [`config.dist.php`](./doc/trunk/src/config.dist.php) qui montre les différentes constantes de configuration possibles.
|