Astuce : travailler avec git en local

Git est un outil de suivi des modifications pour des documents partagés (code source, fichiers, etc).

Il est possible de travailler en local avec git pour faire tourner un YesWiki sur une branche de test par exemple (avec des modifications qui ne sont pas encore déployées par l'utilitaire de mise à jour). C'est l'objectif de cette page.

Préalable

avoir accès à une machine sous Linux
avoir installer Apache/Nginx et PHP (voir la documentation d'installation)
avoir accès à un terminal en ligne de commande
avoir installé git sur cette machine. Pour vérifier si c'est installer taper :
```
which git
```

Installation en ligne de commande

1. créer un dossier de travail
- par exemple dans /var/www/html/
- ou /var/www/html/monsite/
- ```
mkdir -p /var/www/html/monsite/
```
2. se placer dans ce dossier
```
cd /var/www/html/monsite/
```
3. initialiser le dossier pour git
```
git init
```
4. ajouter le dépôt YesWiki
```
git remote add origin 
https://github.com/YesWiki/yeswiki.git
```
- Ceci permet de dire à git de se relier au dépôt yeswiki en donnant l'alias origin.
5. Afficher les informations sur le dépôt distant
```
git remote -v
```
6. Importer les données utiles à git
```
git fetch origin
```
7. Afficher toutes les branches disponibles
```
git branch -a
```
8. Créer et importer la branche doryphore
```
git checkout doryphore
```

Dans l'état, ça ne fonctionne pas, il manque les bibliothèques externes.
Pour ceci.

On vérifie si composer est installé avec :
```
which composer
```
- si c'est vide, installer composer : https://getcomposer.org/download/
Installation des bibliothèques externes
- 1. se placer dans ce dossier
```
cd /var/www/html/monsite/
```
- 2. Installation des bibliothèques externes :
```
composer install
```
- 3. Il faut aussi faire la mise à jour dans le dossier autoupdate.
```
cd ./tools/autoupdate
composer install
```

Pour tester, se rendre à l'url :
http://localhost/monsite/
(l'url doit être adapté en fonction de votre serveur)

Mise à jour en ligne de commande

Pour mettre à jour les données du serveur en local :

se rendre dans le dossier
```
cd /var/www/html/monsite/
```
importer les modifications
```
git fetch -p origin
```
puis
```
git pull
```
```
git pull --rebase
```
peut être utile lors de certaines mises à jour

Quelques commandes

Pour tester une branche particulière
```
git checkout nom-de-la-branche
```
Pour vérifier quelle est la branche actuelle :
```
git branch
```
Pour revenir à doryphore
```
git checkout doryphore
```
puis faire
```
git pull
```
Pour supprimer une branche locale nommée ma-branche
```
git branch -D ma-branche
```
possible si le dossier n'est plus sur cette branche.