ajout git + logos

This commit is contained in:
Grégory Lebreton 2022-10-18 12:55:38 +02:00
parent 1dffd2d674
commit 1cbfe8b160
8 changed files with 166 additions and 4 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 64 KiB

BIN
docs/assets/git/git.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 2.1 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 55 KiB

157
docs/divers/git/git.md Normal file
View File

@ -0,0 +1,157 @@
# <img src="../../../assets/git/git.png" width="50 px"> GIT Source Code Management
Git est un système de gestion de versions partagé qui fut développé en 2005 par le créateur de Linux Linus Thorvalds et publié sous licence libre GNU-GPLv2.
Il permet de stocker son code source en ligne pour y accéder de n'importe où et le partager facilement.
<img src="../../../assets/git/git-branch.png">
## Installation
```bash
sudo apt install git -y
```
## Les principales commandes
- Cloner un dépôt distant sur sa machine locale:
```bash
git clone https://gitlab.com/mon-dépôt-distant.git
```
- Initialiser un dossier de projet pour le "pousser" en ligne:
```bash
cd mon-projet/
git init
```
- Ajouter des fichiers au suivi (pour les synchroniser vers un dépôt distant):
```bash
git add fichier1 fichier2
```
- Créer un enregistrement (une version) du code avec un commentaire:
```bash
git commit -m "commentaire (exemple: modification du fichier1, ajout fonction test"
```
- Pousser les changements vers le dépôt distant (Gitlab ou Github par exemple):
```bash
git push
```
- Changer de branche dans le projet:
```bash
git checkout nom-de-la-branche
```
- Créer une nouvelle branche à partir de la branche actuelle:
```bash
git branch nom-nouvelle-branche
```
- Pousser une branche nouvellement créée en local vers le dépôt distant:
```bash
git push origin nom-nouvelle-branche
```
## Workflow
### Cloner un dépôt distant en local, l'éditer puis pousser les changement
- Cloner un dépôt distant sur sa machine locale:
```bash
git clone https://gitlab.com/mon-dépôt-distant.git
```
- Entrer dans le dossier du dépôt et modifier un fichier:
```bash
cd mon-dépôt-distant/
# modification sur un fichier
```
- Ajouter le fichier modifié au suivi:
```bash
git add fichier-modifié
```
- Créer un enregistrement de la modification
```bash
git commit -m "modif fichier-modifié"
```
- Pousser les changements sur le dépôt en ligne:
```bash
git push
```
### Initialiser un dépôt git dans un fichier local afin de le pousser sur un dépôt en ligne
- On entre dans le dossier et on l'initialise en tant que dépôt git:
```bash
cd mon-dépôt-local/
git init
```
- Ajouter tout les fichiers du dossier au suivi:
```bash
git add *
# ou
git add .
```
- Ajouter l'adresse du dépôt distant qui va recevoir le dépôt local:
```bash
git remote add origin https://gitlab.com/mon-user/mon-nouveau-dépôt.git
```
- Créer un enregistrement avec un commentaire:
```bash
git commit -m "premier push"
```
- Pousser le nouveau dépôt vers le dépôt distant en ligne:
```bash
git push origin main # ou le nom de la branche
```
## Autres commandes utiles
- Connaitre l'état du dépôt local:
```bash
git status
```
- Revenir à l'état après le git clone en éffaçant les chagements éffectués:
```bash
git reset --hard HEAD
```
- Visualiser les différences entre les fichiers originaux et les fichiers modifiés:
```bash
git diff
```
## Référence
[Documentation GIT](https://git-scm.com/)

View File

@ -1,4 +1,4 @@
# GARAGE MAP
# WORKADVENTURE GARAGE MAP
![map](img/map.png)
@ -42,7 +42,7 @@ npm run start
Le navigateur s'ouvre, choisir "tester la map"
- A chaque modification sur la map, enregistrer (ctrl+s) sur Tiled et recharger la page du navigateur.
!!! note A chaque modification sur la map, enregistrer (ctrl+s) sur Tiled et recharger la page du navigateur.
## Blocs

View File

@ -1,3 +1,6 @@
<center><img src="assets/logo-web-garage_numerique.png"></center>
# Introduction
Ce site répertorie la documentation du Garage Numérique, grâce au logiciel mkdocs avec le theme material.

View File

@ -1,4 +1,4 @@
# Présentation du Garage Numérique
# <img width="50 px" src="../assets/logo-garage-petit.png"> Présentation du Garage Numérique
Ces documents présentent le fonctionnement de l'association.

View File

@ -61,7 +61,7 @@ nav:
- "Présentation du Garage":
- presentation-garage/index.md
- presentation-garage/reglement_interieur.md
- "": presentation-garage/reglement_interieur_CHANGELOG.md
- presentation-garage/reglement_interieur_CHANGELOG.md
- presentation-garage/procedures.md
- presentation-garage/equipe.md
- presentation-garage/histoire.md
@ -141,6 +141,8 @@ nav:
- "Index": divers/dev/index.md
- "Créer un mod dans Minetest": divers/dev/create-minetest-mod.md
- "Installer codium et Unity": divers/dev/unity_codium.md
- "Git":
- divers/git/git.md
- Admin:
- "Page d'accueil": admin/index.md
- "Cadrage de l'ASP": admin/cadrage-asp/index.md