Parcourir la source

modifs (pas finies) suite remarques Denis

Julien Dehos il y a 8 ans
Parent
commit
a88d7afed4
3 fichiers modifiés avec 32 ajouts et 14 suppressions
  1. 4 5
      depot_local.md
  2. 4 4
      index.md
  3. 24 5
      installation.md

+ 4 - 5
depot_local.md

@@ -12,9 +12,8 @@ L'élément de base d'un projet git est le dépôt. Il s'agit simplement d'un
 dossier classique que l'on demande à git de versionner (journaliser).
 
 Un dépôt git contient l'ensemble des commits (versions sauvegardées du projet).
-Ces commits peuvent être marqués par des étiquettes. Il existe deux étiquettes
-prédéfinies et gérées par git : `master` (dernier commit) et `HEAD`
-(commit/état courant des fichiers).
+On peut donc revenir à n'importe quelle version du projet. Généralement, on
+appelle `master` la dernière version sauvegardée et `HEAD` la version courante.
 
 ## Initialiser un dépôt
 
@@ -22,8 +21,8 @@ Allez dans le dossier à versionner puis lancez la commande `git init`.
 
 ![](depot_local_01.png)
 
-Git crée alors un dossier `.git` pour y stocker ses metadonnées.  Si vous ne
-voulez plus versionner votre dossier, il suffit de supprimer ce dossier.  Le
+Git crée alors un dossier caché `.git` pour y stocker ses metadonnées.  Si vous
+ne voulez plus versionner votre dossier, il suffit de supprimer ce dossier.  Le
 reste du temps, ne touchez pas à ce dossier si vous n'êtes pas absolument
 sûr(e) de ce que vous faites.
 

+ 4 - 4
index.md

@@ -47,16 +47,16 @@ que j'indique ».
 
 ## Dans quels cas ne pas utiliser git/gogs ?
 - édition collaborative en temps-réel -> sharelatex
-- partage de fichiers -> dropbox, serveur FTP/HTTP...
+- partage de fichiers "au plus simple" -> dropbox, serveur FTP/HTTP...
 - fichiers dans un format non textuel (word, excel, PDF...) 
 
 ## Concepts de base
 
 ### Notion de "version" (commit)
 
-Un "projet git" contient l'historique de toutes les modifications de chaque
-fichier.  On appelle "commit" un état sauvegardé de ces modifications (une
-version du projet en quelque sorte).
+Un "projet git" contient l'historique de toutes les modifications sauvegardées
+de chaque fichier.  On appelle "commit" un état sauvegardé de ces modifications
+(une version du projet en quelque sorte).
 
 Généralement, on modifie le projet à partir de la version précédente et ansi de
 suite; ce qui correspond à une succession de commits :

+ 24 - 5
installation.md

@@ -8,7 +8,21 @@ output:
 
 # Installation et configuration
 
-Pour utiliser git, il vous faut une connexion internet et un client git.
+Pour utiliser git, il vous faut un client git (et une connexion internet si
+vous voulez utiliser des dépôts distants).
+
+## Ligne de commandes vs interface graphique
+
+Il existe deux types de client git : le client console (en ligne de commandes)
+et les [clients
+graphiques](https://git-scm.com/book/fr/v2/Git-dans-d%E2%80%99autres-environnements-Interfaces-graphiques)
+(par exemple : gitg, giggle, qgit, gitk, git-gui, github-desktop...).
+
+[La communauté conseille souvent d'utiliser le client
+console.](https://git-scm.com/book/fr/v2/D%C3%A9marrage-rapide-La-ligne-de-commande)
+Celui-ci est certes moche mais c'est le seul qui donne accès à toutes les
+commandes git. De plus, il est souvent plus efficace, une fois passée la phase
+d'apprentissage. 
 
 ## Installation sous Linux
 
@@ -20,13 +34,18 @@ commande console :
 sudo apt-get install git
 ```
 
-Il existe également des clients graphiques : gitg, giggle, qgit, gitk, git-gui...
+## Installation sous Mac
+
+Télécharger et installer le client [git pour
+Mac](http://git-scm.com/download/mac). Le client console est ensuite accessible
+depuis un terminal.
 
-## Installation sous Windows ou Mac
+## Installation sous Windows 
 
 Télécharger et installer le client [git pour
-Windows](http://git-scm.com/download/win) ou le client [git pour
-Mac](http://git-scm.com/download/mac).
+Windows](http://git-scm.com/download/win). Le client console est ensuite
+accessible depuis l'outils git-bash inclus (ou depuis powershell pour ceux qui
+utilisent cet outil).
 
 ## Configuration