Commit 1bf66da1 authored by Matthieu Boileau's avatar Matthieu Boileau

Update README.md

parent c1dc5a7d
......@@ -11,133 +11,3 @@ L'auditoire doit partir avec des réponses aux questions suivantes :
- est-ce que mes utilisateurs ont intérêt ?
- est-ce que j'ai intérêt à déployer un serveur GitLab dans mon unité ?
# Plan
## Git
## GitLab du point de vue de l'utilisateur
L'intérêt d'un serveur git du point de vue de l'utilisateur :
- Accès à des sources depuis plusieurs plateformes
- Partage avec d'autres développeurs
- Utiliser des outils de développement collaboratifs :
- issue tracker
- merge request
- wiki
- utiliser l'intégration continue et de déploiement
Une aide très bien faite https://gitlab.math.unistra.fr/help
On entre dans l'interface côté utilisateur.
## GitLab du point de vue de l'administrateur
- API (Python)
- Gitlab-CI
-
# Plan
### 0. Préparation de la démo
- Détruire le projet `appendix-II` utilisé pendant la démo précédente
- Nettoyer GitHub Desktop
- Cloner la version de démo :
```
cd Desktop
git clone git@gitlab.math.unistra.fr:formation-info/expose-git-example.git appendix-II
```
- préparer le webmail : boîte aux lettres "euler"
### 1. Intérêt et applications de git (Partie présentée par Matthieu)
- sources de programmes
- sources LaTeX
- ce qu'il ne fait pas : les binaires
- comparaison avec OwnCloud
### 2. gitlab comme serveur git (Partie présentée par Alexis)
- Les fonctionnalités de gitlab :
Création rapide de projets avec gestion des droits (Public, privé,...)
Outils annexes : wiki, statistiques
- Accès labo/extérieur
- notifications mail
- README.md
### 3. démo : but monter que c'est simple et ergonomique (Partie présentée par Matthieu et Alexis)
- Création de projet pour suivre des sources LaTeX
- Importation d'un article sous LaTeX (git init)
- Modification, push, pull
- git-latexdiff
- tag (submission_1, revision_1)
- avertissement mail
#### Scénario de la démo
1. On introduit le document qui va faire l'objet d'un suivi de version
2. On attribue les rôles :
- Alexis est **Johannes Bernoulli**
- Matthieu est **Leonhard Euler**
3. **Euler**, très moderne, crée un projet gitlab sur le portail :
- création du projet
- ajout de **Bernoulli** au projet (master)
- notifications par mail
4. **Euler** pousse une version locale sur ce projet en suivant le tuto gitlab :
````
git remote add origin git@gitlab.math.unistra.fr:euler/appendix-II.git
git push -u origin master
```
5. **Euler** étiquète la version `submitted-to-JB` sur gitlab
6. **Bernoulli** se connecte à la page du projet et suit les instructions du README file.
7. Pendant ce temps, **Euler** installe le dépôt local dans GitHub Desktop et fait la démonstration des fonctionnalités :
- Config de git
- historique
8. **Bernoulli** :
- modifie le latex en exécutant le fichier `./bin/1_bernoulli_1.command`
- commit et synchronise ses modifications
9. **Sans synchroniser, Euler** modifie le latex en exécutant le fichier `./bin/2_euler_1.command` puis commit
10. **Euler** vérifie ses mails d'avertissement et synchronise son dépôt local malgré la modification de Bernoulli -> **ça marche !**
11. **Bernoulli** :
- récupère la version modifiée par Euler avec `git pull`
- modifie le latex en exécutant le fichier `./bin/3_bernoulli_2.command`
- commit et pousse ses modifications
12. **Euler** :
- **sans synchroniser,** modifie le latex en exécutant le fichier `./bin/3_euler_2.command`
- commit
- attend l'arrivée du mail du push de Bernoulli
- Essaie de faire un *Sync*
13. **Euler** résout à la main le conflit, commit et pousse
14. Dans gitlab, **Euler** fait une démo de la fonctionnalité `git blame` dans `Files > method-inveniendi-addII.tex > Blame`
15. On compare avec la version soumise avec `git-latexdiff`:
- Notice `git-latexdiff -h |head -n 4` :
```
Usage: git-latexdiff [options] OLD [NEW]
git-latexdiff [options] OLD --
git-latexdiff [options] -- OLD
Call latexdiff on twoGit revisions of a file.
```
- le HEAD : `git-latexdiff -v --main methodus-inveniendi-addII.tex submitted-to-JB`
- une version en cours de modification : `git-latexdiff -v --main methodus-inveniendi-addII.tex submitted-to-JB --`
### 4. Conclusion
- Ce qu'on peut faire/ne pas faire avec git et gitlab
- Les bonnes pratiques pour LaTeX
- Annoncer :
- un tuto d'initiation git
- un sondage pour une formation ?
### PS : penser à rajouter http://xkcd.com/1597/
\ No newline at end of file
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment