docs: Meilleure documentation de méthode pour spip-cli & checkout

docs/10-INSTALL.md

@@ -2,6 +2,9 @@
 
 ## Méthode 1
 
+- avantage: spip-cli est toujours à jour
+- inconvénient: il est téléchargé à chaque `ddev restart`
+
 ### 1/ Installation
 - pour une utilisation globale pour tous les projets, copier les fichiers `spip` et `checkout` à la racine de ce dépôt dans `~/.ddev/commands/web`
 - ou bien, pour une utilisation par projet, les copier simplement dans votre projet : `/var/www/html/nom_du_site/.ddev/commands/web`
@@ -19,13 +22,23 @@ ou `ddev checkout spip .`
 En cas de restart du conteneur, les fichiers de son système sont écrasés, il faut donc 
 relancer l'installation.
 
-## Méthode 2
+## Méthode 2 
+
+- inconvénient: il faut penser à mettre à jour (git pull) le spip-cli (global ou local) de temps en temps
+
+Il est possible d’installer spip-cli & checkout globalement pour chaque site (la même version pour tous)
+ou de l’installer spécifiquement sur certains sites. 
+
+Il faut simplement se placer dans le bon répertoire `.ddev` (global ou spécifique au site)
 
-Proposée par @marcimat, qui s'agaçait que DDEV doive réinstaller spip-cli (git clone) à chaque 
-fois qu’on restart un projet…
+### Installation globale
 
-Alors il a changé de méthode : installer par défaut dans homeadditions, et appeller ces scripts 
-dans les commandes webs.
+- avantage: présent par défaut sur chaque projet
+- dans les commandes suivantes, utiliser `~/.ddev` (le répertoire ddev global)
+
+### Installation locale (par site)
+
+- dans les commandes suivantes, remplacer `~/.ddev` par `{votre projet}/.ddev` (le ddev spécifique au site)
 
 ### spip-cli
 
@@ -35,11 +48,30 @@ git clone git@git.spip.net:spip-contrib-outils/spip-cli.git
 cd spip-cli
 composer install --no-dev
 ```
+
 ```shell
 cd ~/.ddev/commands/web
 echo '#!/bin/bash' > spip
 echo '~/spip-cli/bin/spip "$@"' >> spip
 ```
+
+Éditer (créer au besoin) `~/.ddev/homeadditions/.bash_aliases`
+```shell
+if [ ! -L /usr/local/bin/spip ]; then
+    ln -s ~/spip-cli/bin/spip /usr/local/bin
+fi
+source ~/spip-cli/bin/spip_console_autocomplete
+```
+
+#### Mise à jour
+
+```shell
+cd ~/.ddev/homeadditions/spip-cli
+git pull
+composer install --no-dev
+```
+
+
 ### checkout
 
 Piège : DDEV n'aime pas trop les liens symboliques…
@@ -57,5 +89,20 @@ echo '#!/bin/bash' > checkout
 echo '~/checkout/checkout.php "$@"' >> checkout
 ```
 
-Évidemment dans ce cas là, c’est à vous de faire les mises à jour (git pull / composer install)
-de `spip-cli` et `checkout`de temps en temps.
+Éditer (créer au besoin) `~/.ddev/homeadditions/.bash_aliases`
+```shell
+if [ ! -L /usr/local/bin/checkout ]; then
+    ln -s ~/checkout/checkout /usr/local/bin
+fi
+```
+
+#### Mise à jour
+
+```shell
+cd ~/.ddev/homeadditions/checkout
+git stash
+git pull
+git stash pop
+composer install --no-dev
+```
+