Installation d'un poste de travail
Ce que nous allons apprendre
- Installation du logiciel git
- Préparer identification de son ordinateur pour la communication avec Framagit
- Initialisation de votre dépôt local
- Modifier votre premier document
Procédons par étapes
Nous revenons sur notre ordinateur local.
1. Installer Git
En général Git n'est pas installé par défaut sur votre ordinateur.
Pour l'installer sous GNU/Linux (Debian, Mint, Ubuntu, et bien sûr Emmabuntüs) (Pour les autres types de distributions, ou pour les systèmes Windows et MacOSX, voir les wikis respectifs à la section installation de logiciels.), ouvrir un terminal et entrer :
sudo apt-get install git
Puis renseigner votre mot de passe et répondre Oui pour accepter le téléchargement.
Dans un terminal, sous GNU/Linux lors de la frappe des caractères du mot de passe, ceux-ci ne sont pas visualisés par des * et rien n'est affiché pour des raisons de sécurité. Donc tapez votre mot de passe et ensuite appuyer sur la touche « Entrée »
2. Préparer la connexion avec Framagit
Toujours dans une fenêtre, créer la clé de chiffrement qui va servir aux communications avec notre projet sur le serveur Framagit :
ssh-keygen
Taper Entrée sans rien changer aux différentes options proposées.
Afficher la clé dans le terminal :
cat .ssh/*.pub
Sélectionner toute la clé, et la copier dans le presse-papier avec un clic-droit > Copier
Retourner sur la page « Profile Settings » de votre compte Framagit, et cliquer sur le menu « SSH Keys » ou sur ce lien direct : https://framagit.org/profile/keys
La fenêtre des clés SSH va s'ouvrir :
Et l'on va coller la clé SSH dans la boite du champ « Key »en faisant un clic-droit > Coller.
On peut aussi renseigner le titre de cette nouvelle clé dans le champ « Title »
puis on clique sur le bouton vert « Add Key »
On reste sur Framagit mais on retourne sur la page du projet « Communication ».
Sous le titre du projet « Communication », on clique sur "clone" en bleu à droite, et on choisit l'option de connexion SSH (et non pas HTTPS). Et on copie dans le presse-papier l'adresse qui se trouve à droite en cliquant sur l'icône tout à droite « Copy to Clipboard »
3. Initialisation du Git local
Maintenant tout est prêt sur le site Framagit, et nous allons finir de paramétrer le Git local.
Toujours dans notre terminal :
git config --global user.name "Yves Saboret"
git config --global user.email "mettre ici votre adresse mail"
Créer le dossier dans lequel nous allons cloner le projet Emmabuntüs et y aller. Par exemple :
mkdir Git-Emma
cd Git-Emma
Créer le clone du projet « Communication » :
git clone <copier ici l'adresse URL du projet qui est dans le presse-papier>
L'opération va débuter par un petit message, qui n'est pas une erreur, et auquel il faut répondre « yes » :
Cloning into 'Communication'…
The authenticity of host 'git.framasoft.org (2a01:4f8:200:1302::42)'
can't be established.
ECDSA key fingerprint is SHA256:nO6L2sApWj/OkjW7avditV/dHOMEG/cV7Ps5z7yaS30.
Are you sure you want to continue connecting (yes/no)?** Yes
Warning: Permanently added 'git.framasoft.org,2a01:4f8:200:1302::42'
(ECDSA) to the list of known hosts.**
Attention le clonage va prendre un temps certain, mais Git vous tient au courant de l'avancement des travaux.
4. Modifier un document
Les opérations décrites précédemment ne sont à faire qu'une seule fois. Maintenant nous allons nous intéresser aux opérations à effectuer lorsqu'on veut modifier un (ou plusieurs) document(s), puis le(s) renvoyer sur le site Framagit.
Et d'abord, partir de maintenant et chaque fois que vous le souhaitez, vous pouvez demander l'état de votre clone en entrant :
git status
ou bien
git status > ../modif.txt
pour sauver l'état dans le fichier modif.txt
ou bien encore
git status <chemin-à-vérifier>
Cette commande vous indique si tout est à jour dans votre copie locale
ou bien, au contraire, si des mises à jour sont en attente.
Par exemple, en ce moment je travaille sur ce document, mais je n'ai pas encore dit à Git de l'ajouter dans le projet et il me le signale
Toutefois, la première chose à faire, c'est de vérifier que votre clone local est bien à jour (d'autres personnes ont peut-être modifié quelques fichiers entre-temps). Donc on ré-synchronise avec la commande :
git pull
pour être sûr que notre clone est bien à jour par rapport au serveur.
Attention : Avant de modifier les fichiers de type .odt (dans le projet Communication, par exemple) il faut prendre quelques précautions, et avertir la communauté que le fichier va être édité, donc on leur demande de ne pas y toucher. Nous expliciterons comment un peu plus loin.
Donc vous pouvez modifier un (ou des) fichier(s) en local en vous plaçant à l'endroit adéquat de l'arborescence. Dans notre exemple, nous serions ici :
~/Git-Com/Communication/Tutoriels/Fr/
pour y modifier le fichier DVP_Presentation_Framagit.odt
Une fois que vous êtes satisfait des modifications apportées au(x) fichier(s), il faut mettre à jour l'index de votre branche locale par la commande :
git add <fichier-modifié>
Une fois tous les fichiers ajoutés on valide le tout par un « commit », en expliquant le sens ou la raison des modifications :
git commit -m "raison de l'évolution"
Notre exemple :
Enfin on peut mettre à jour la branche maîtresse sur le serveur Framagit :
git push -u origin master
Si malheureusement, le fichier a été modifié entre temps, la commande git push retournera une erreur et il faudra recommencer les modifications (après un nouveau git pull pour tout mettre à jour).
Par contre, si tout se passe bien, on peut informer la communauté que votre travail est fini, et donc que quelqu'un d'autre peut éventuellement prendre le relais.
Note : ce problème avec les mises à jour simultanées provient du fait que les fichiers de type .odt sont compressés (binaires) et non pas de simples fichiers textes comme les codes source, et Git ne sait pas faire la réconciliation automatique des modifications simultanées sur de tels fichiers.
Faisons le point
Maintenant que vous savez envoyer votre premier document, nous allons voir comment gérer la communication au sein des membres de l'équipe.