technique:git:git_basique

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
technique:git:git_basique [2020/01/01 20:43] – francoisatechnique:git:git_basique [2024/04/02 15:08] (Version actuelle) – modification externe 127.0.0.1
Ligne 1: Ligne 1:
-====== Git : fonctionnalités de base ====== +**Cette page est obsolète. Veuillez accéder au contenu à son nouvel emplacement : [[https://bibliotech.cemea.org/books/outils-technique/page/git-basique|git-basique]]**
- +
-Petit mémo rapide sur Git\\ +
-Dans cette approche basique de git, nous partons du principe simple que vous êtes seul à travailler sur votre projet et que toutes vos modifications seront enregistrées sur la branche principale appelée "master". +
- +
-===== 1. Création d'un dépot initial ===== +
- +
-Pour commencer par le plus simple, le mieux est de créer votre projet (appelé dépot) sur une forge comme [[http://framagit.org|framagit.org]] qui contient beaucoup d'autres projets. +
- +
-Il est absolument nécessaire d'avoir un compte avec un identifiant mémorisé et son mot de passe à saisir (régulièrement pour l'instant). Utiliser le lien "Sign In" en haut à droite puis l'onget Register pour créer votre compte. +
- +
-Une fois votre compte créé, vous pouvez créer un projet comme "monprojet". Vous pouvez choisir de rendre ce projet public ou le garder privé (lire les options). +
- +
-Vous pouvez y ajouter un fichier README.md qui servira de descriptif de présentation de votre projet.\\ +
-Lorsque vous sauvegardez un fichier dans l'interface, il vous est demandé de compléter un champ "commit" qu'il est utile de personnaliser à chaque modification.\\ +
-Par exemple : "Corrections ortho" ou "ajout du paragraphe" ou "ajout de telle fonctionnalité". +
- +
-===== 2. Récupération de votre dépot dans un dossier de votre PC ===== +
- +
-Au préalable assurez-vous d'avoir le programme git installé sur votre Linux préféré :<code> +
- +
-sudo apt install git +
- +
-</code> +
- +
-Créez un dossier où vous voulez soit avec votre gestionnaire de fichiers, soit avec un terminal (''mkdir mondossier'') et placez-vous dedans (''cd mondossier'') +
- +
-Retournez ensuite dans l'interface graphique de votre dépot et copier le lien du dépot sous le lien "clone" et choisissez de copier l'adresse en https pour l'instant. +
- +
-Dans votre terminal, lancer la commande en collant (Ctrl+Shift+V) l'adresse de votre depot : +
- +
-<code> +
-git clone https://framagit.org/monnom/monprojet.git +
- +
-</code> +
- +
-Patientez et vous devriez récupérez tout le contenu de votre dépot sur votre PC (avec l'historique des modifications) +
- +
-===== 3. Vérifications ===== +
- +
-<code> +
-cd monprojet +
-ls +
- +
-</code> +
- +
-Et vérifiez que votre fichier README.md est là avec les autres. +
- +
-===== 4. Modifications, contributions ===== +
- +
-Vous pouvez ensuite modifier tous les fichiers existants ou rajouter des sous-dossiers avec des fichiers qui concernent votre projet. +
- +
-Lorsque vous voulez sauvegarder l'état de votre projet (appelons-le l'état V1), il va falloir faire un commit.\\ +
-Au préalable, vous devez indiquer quel fichier a été modifié et doit être pris en compte dans ce commit.\\ +
-Vous pouvez utiliser la commande +
- +
-<code> +
-git status +
- +
-</code> +
- +
-qui ne sert qu'à donner des informations, elle est sans risque\\ +
-Vous pouvez soit ajouter chaque fichier à la main, soit les ajouter tous en une fois +
- +
-<code> +
-git add fichiermodifié +
-git add * # pour les ajouter tous +
- +
-</code> +
- +
-Refaire un ''git status'' pour vérifier leur prise en compte +
-===== 5. Premier commit ===== +
- +
-Lors du premier commit (photographie de votre état V1), git vous demandera des informations d'identification que vous pouvez saisir dès maintenant en remplaçant par les bonnes infos (ceci est juste à titre informatif, vous pouvez mettre ce que vous voulez) +
- +
-<code> +
-git config --global user.name "Votre nom ou pseudo" +
-git config --global user.email "Votre email" +
- +
-</code> +
- +
-Pour effectuer votre commit , lancez : +
- +
-<code> +
-git commit -m "Votre message de commit comme Version 1 du projet" +
- +
-</code> +
- +
-Et vous pouvez ensuite continuer de travailler sur vos documents, vous savez que vous pourrez toujours revenir sur cette version à n'importe quel moment (Nous verrons comment une autre fois) +
- +
-===== 6. Envoyer vos commits sur le dépot distant ===== +
- +
-Une fois que vous avez fait vos 25 commits, vous pouvez avoir envie de les stocker sur le dépot distant pour que d'autres puissent les récupérer ou que vous puissiez les récupérer depuis une autre machine par exemple.\\ +
-Lancer alors un +
- +
-<code> +
-git push +
- +
-</code> +
- +
-On vous demandera un login d'identifiant sur la forge : votre login\\ +
-et un mot de passe : celui utilisé sur la forge +
- +
-Et après quelques instants vos commits sont envoyés sur la forge +
- +
-===== 7. Quelques commandes utiles ===== +
- +
-Pour voir l'état actuel de votre travail : +
- +
-<code> +
-git status +
- +
-</code> +
- +
-Pour voir l'historique des logs : +
- +
-<code> +
-git log +
-git log --graph +
-git log --stat +
-git log -2 # voir les 2 derniers commits +
-git log -p # pour faire un patch +
- +
-</code> +
- +
-Pour voir les différences +
- +
-<code> +
-git diff # pour voir les différences entre le dossier et l'index (après un git add ou git rm ou git mv) +
-git diff --cached # diff entre index  et le repository (après commit) +
-git diff commit1 commit2 +
- +
-</code> +
- +
-A lancer si votre dépôt a été modifié (par quelqu'un d'autre ou par vous depuis la derniére fois) +
- +
-<code> +
-git pull +
- +
-</code> +
- +
-Pour indiquer une étape importante du code comme la Version stable V1 +
- +
-<code> +
-git tag "Version stable 1.0" +
- +
-</code> +
- +
-Pour réinitialiser au dernier commit +
- +
-<code> +
-git reset --hard +
- +
-</code> +
  • technique/git/git_basique.1577907802.txt.gz
  • Dernière modification : 2020/04/11 02:26
  • (modification externe)