ajouts suite aux cours de mars 2022

Author: ms-studio

00-git.md

@@ -8,18 +8,47 @@ permalink: index.html
 
 <img src="img/git-basics/git-logo.png" alt="Logo de Git" style="width: 300px;">
 
-**Git** est un logiciel de *gestion de versions* décentralisé, créé en 2005 par Linus Torvalds (le créateur de Linux). C'est un logiciel libre, sous licence GPL. Il existe des versions pour toutes les plateformes, y compris MacOS. Le site officiel de documentation est [git-scm.com](https://git-scm.com).
+### Qu'est-ce que Git ?
+
+**Git** est un logiciel de *gestion de versions* décentralisé. C'est un puissant outil de collaboration, indispensable dans tous les types de projets informatiques.
+
+### D'où vient GIT ?
+
+Git a été créé en 2005 par [Linus Torvalds](https://fr.wikipedia.org/wiki/Linus_Torvalds) (le créateur de Linux). C'est un logiciel libre, sous licence GPL. Il existe des versions pour toutes les plateformes, y compris MacOS. Le site officiel de documentation est [git-scm.com](https://git-scm.com).
+
+### À quoi sert Git ?
 
 Voici quelques-uns des avantages que Git apporte: 
 
 - Permet à un grand nombre de collaborateurs de travailler sur un même projet, en offrant une bonne gestion des modifications.
 - Permet de synchroniser un projet entre plusieurs collaborateurs, en ayant l'assurance que tous les fichiers soient à jour.
 - Permet d'avoir un historique précis de tous les changements et modifications d'un projet. Cela permet de clarifier les questions récurrentes: "Où est la dernière version du fichier X?" et "Qu'est-ce qui a été changé entre les révisions 41 et 42"?.
 
+Git a été inventé pour gérer des projets informatiques – du code. Mais ses avantages ont aussi été utilisés pour :
+
+- écrire de la documentation
+- gérer des documents légaux comme [les textes de loi](http://bundestag.github.io/gesetze/) du gouvernement d'Allemagne
+- des données médicales, comme p.ex. [les données Covid](https://github.com/openZH/covid_19) (direction de santé du canton de Zurich)
+- Git est très utilisé dans le domaine du design typographique. Exemples: chez Google Fonts, chaque fonte est gérée dans Github.
+
+## Travailler avec Git
+
 Git est à la base un outil "en ligne de commande". Afin d'avoir un meilleur confort d'utilisation, il existe divers logiciels offrant une interface graphique. 
 
 Voir [les logiciels](logiciels.html)
 
 Il existe également des services en ligne (comme GitHub) permettant d'héberger des projets Git, afin de faciliter la collaboration et d'avoir une sauvegarde en ligne.
 
 Voir [GitHub et autres hébergements](github.html)
+
+
+#### Ce que Git ne fait pas très bien:
+
+La gestion de données "binaires", des fichiers audio (WAV, MP3...) ou vidéo (MP4, MOV...).
+
+Il existe des solutions comparables à Git pour certaines applications:
+
+- [Abstract](https://www.abstract.com/), pour le versionnage et la collaboration dans le design d'interfaces. Gère les formats Sketch et Adobe XD.
+- [Frame.io](https://frame.io/) - "cloud-based collaboration platform" pour la vidéo.
+-  [Perforce Helix Sync](https://www.perforce.com/products/helix-core-apps/helix-sync) - "the game and media standard for version control". Pour des logiciels Maya, 3ds Max, Photoshop, dans le domaine du jeu vidéo et de la production virtuelle.
+- [Alienbrain](https://www.alienbrain.com/) - pour "les principaux outils artistiques en 3D et en 2D": Unreal Engine, Autodesk 3DS Max, Autodesk Maya, Adobe Photoshop. Vise les industries du jeu vidéo, de l'architecture, de l'ingénierie.

06-bases.md

@@ -0,0 +1,55 @@
+---
+layout: page
+title: Bases
+permalink: bases.html
+---
+
+
+## Comment fonctionne Git ?
+
+Git est un logiciel pouvant fonctionner en ligne de commande, on lui "parle" en utilisant des commandes, telles que `pull`, `push`, `clone`, `add`, `commit`...
+
+Le principe: 
+
+1. En utilisant des commandes Git, on enregistre des "snapshots" qui conservent l'état du projet à un point précis.
+2. On synchronise les modifications locales avec un serveur distant. Git s'occupe de fusionner les modifications.
+
+### La notion de commit
+
+La commande **git commit** est centrale dans Git: c'est cette commande qui crée un nouvel "instantané" de l'état de votre projet, dans son intégralité. 
+
+Comme le dit David Demaree dans *Git for Humans*: 
+
+- Un commit enregistre les modifications apportées aux fichiers figurant dans la base de données de Git: il indique par exemple qu'un fichier est passé de la version A à la version B.
+- Chaque commit est autonome: il ne référence pas seulement ce qui a changé, mais aussi tout ce qui compose l'état de votre projet à un moment donné.
+
+### Les états des fichiers
+
+Le livre "*[Pro Git](https://git-scm.com/book/fr/v2)*" donne une bonne explication des "trois états" dans lesquels peuvent se trouver les fichiers:
+
+Git gère **trois états** dans lesquels les fichiers peuvent résider : `modifié`, `indexé` et `validé`.
+
+- **Modifié** (*Modified*) signifie que vous avez modifié le fichier mais qu’il n’a pas encore été validé (*committed*).
+- **Indexé** (*Staged*) signifie que vous avez marqué un fichier modifié dans sa version actuelle pour qu’il fasse partie du prochain instantané du projet.
+- **Validé** (*Committed*) signifie que les données sont stockées en sécurité dans votre base de données locale.
+
+Ceci nous mène aux **trois sections principales** d’un projet Git : le **répertoire de travail** (*working directory*), la **zone d’index** (*staging area*) et le **répertoire Git** (*Git directory*).
+
+![Les trois zones, selon Pro Git](img/git-basics/areas.png)
+
+- Le **répertoire de travail** (*working tree* ou *working directory*) : votre espace de travail, sur votre ordinateur. En langage Git: "c'est une extraction unique d’une version du projet. Ces fichiers sont extraits depuis la base de données compressée dans le répertoire Git et placés sur le disque pour pouvoir être utilisés ou modifiés". 
+- La **zone d’index** (*staging area*). On l’appelle aussi des fois la zone de préparation. On y ajoute des fichiers avec la commande "git add": ils sont désormais indexés. Cette zone stocke tout ce qui fera partie du prochain instantané (commit). La zone d'index n'est pas synchronisée ni partagée, elle n'existe que sur votre ordinateur.
+- Le **répertoire Git** (*Git directory*) est l’endroit où Git stocke les méta-données et la base de données des objets de votre projet. C’est la partie la plus importante de Git, et c’est ce qui est copié lorsque vous clonez un dépôt depuis un autre ordinateur.
+
+On pourrait encore ajouter deux sections:
+
+- Le **répertoire Git distant** (remote): il s'agit du serveur, par exemple sur Github (ou Gitlab, Framagit). 
+- Le **stash** : des modifications "mises de côté". Permet de sauvegarder temporairement des changements apportés à votre copie de travail pour que vous puissiez effectuer d'autres tâches, puis revenir et les réappliquer par la suite.
+
+![Représentation des états, espaces et commandes](img/git-basics/commandes-git.jpg)
+
+L’utilisation standard de Git se passe comme suit :
+
+1. vous modifiez des fichiers dans votre répertoire de travail (état = modifié).
+2. vous **indexez** (*stage*) les fichiers modifiés, ce qui ajoute des instantanés de ces fichiers dans la zone d’index (état = indexé).
+3. vous **validez** (*do a commit*), ce qui a pour effet de basculer les instantanés des fichiers de l’index dans la base de données du répertoire Git (état = validé).

25-github-publier.md

@@ -4,7 +4,7 @@ title: Créer un projet
 permalink: github-publier.html
 ---
 
-**Comment créer un projet sur GitHub?**
+## Comment créer un projet sur GitHub ?
 
 Voici la méthode avec l'application GitHub Desktop:
 
@@ -24,6 +24,25 @@ Github va vous dire "This folder is not a repository" ... c'est normal!
 
 Pour cela, faites un clic-droit sur l'un de ces fichiers. Dans le menu contextuel, choisissez "Ignore all .indd files" (pour ne pas prendre en compte les fichiers InDesign, par exemple).
 
+Le fichier `.gitignore` est un fichier optionnel, situé à la racine de votre projet, qui permet de désigner tout ce que Git doit "ignorer". 
+
+Cela comprend généralement des fichiers temporaires créés par certains logiciels, ou des fichiers système comme [.DS_Store](https://fr.wikipedia.org/wiki/.DS_Store) (sur MacOS), [Thumbs.db](https://fr.wikipedia.org/wiki/Thumbs.db) ou Desktop.ini (systèmes Windows).
+
+Exemple, [le .gitignore du Repository de Space Grotesk](https://github.com/floriankarsten/space-grotesk/blob/master/.gitignore):
+
+```
+# file manager empty files
+.DS_Store
+.empty
+.sparkleshare
+# temporary files
+*(Autosaved).glyphs
+*.vfbak
+# minisite files
+/docs/node_modules
+/docs/package-lock.json
+```
+
 ### Le premier commit
 
 - Une fois cela fait, effectuez votre premier **commit**. Indiquez un message de Commit (champ *Summary*), obligatoire.

40-branches.md

@@ -14,6 +14,8 @@ Ces ajouts, qui peuvent introduire des dysfonctionnements, ne vont pas perturber
 
 Une fois qu'un développement expérimental arrive à maturité, on peut l'intégrer dans la version de base. On fera cela en fusionnant la branche expérimentale avec la branche "main", en faisant appel à la fonction "merge".
 
+![Représentation des branches, par Daina Lightfoot](img/git-basics/version-history-header.jpg)
+
 ## Fonctions dans l'interface Github Desktop
 
 Dans Github Desktop, le menu "Branch" propose différentes fonctions permettant d'agir sur les branches.
@@ -34,9 +36,11 @@ Dans Github Desktop, le menu "Branch" propose différentes fonctions permettant
 
 ## Merge
 
-## Pull Request
+(à documenter)
 
+## Pull Request
 
+(à documenter)
 
 ## Documentation sur les branches
 

50-workflow.md

@@ -4,8 +4,6 @@ title: Workflow
 permalink: workflow.html
 ---
 
-![](img/memes/shower-github.png)
-
 Un workflow Git
 ===
 
@@ -19,7 +17,7 @@ Une méthodologie Git pour projets de design, proposée par [Mathieu Dutour](htt
 * Faites une "pull request" de votre branche vers la branche principale ("main").
 * Voilà! Vos collaborateurs peuvent voir vos modifications, faire des commentaires, et les approuver. Une fois approuvés, faire un "merge" de votre "pull request".
 
-![Instructions en cas d'incendie, trouvées dans un laboratoire du CERN (via Cassandre Poirier-Simon)](img/git-folklore/fire-git-commit-push.jpg){:id: .large-image}
+![](img/git-basics/git-workflow-pull-request.jpg)
 
 ### Mettre à jour une branche
 

70-terminologie.md

@@ -20,6 +20,8 @@ Voici quelques-uns des termes fondamentaux du système Git:
 
 **Merge** (fusionner) : *combining two branches*. Une action critique: le "merge" est le fusionnement de deux versions d'un projet (branche alternative vers branche principale). Si cela se passe bien, les modifications de la branche A seront proprement intégrées par la branche B. Si cela se passe mal, vous pouvez rencontrer un "merge conflict".
 
+![](img/memes/git-Merge.gif)
+
 **Rebase** (rembobiner) : *apply any commits of current branch ahead of specified one*.
 
 **Branch** (branche) : *create a new branch at the current commit (a movable label that points to a commit)*.