Astuce : travailler avec git en local
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
- 1. se placer dans ce dossier
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
git pull
-
git pull --rebase
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
git pull
- Pour supprimer une branche locale nommée ma-branche
git branch -D ma-branche