diff --git a/README.md b/README.md index 2fafa49..9d2b398 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,18 @@ + +# Accéder au projet : +- https://USERNAME.gitlab.io/PROJECT_NAME +=> L'URL FINALE == https://bonnebulle.gitlab.io/plain-html-redo Redirige vers = https://plain-html-redo-751743.gitlab.io -( URL Non personelle ) +( URL Non personelle ) . . . hébergement gratuit ! --- -Tuto : +# Tuto : -Objectif : +## Objectif : Cloner un projet initial existant ( "> git clone +url" ) Comprendre le versionning + fork @@ -19,14 +23,18 @@ Auto-héberger une page sur GitLab ( gratuit ) -Éditer du code ... +## Éditer du code ... Le partager et envoyer les dernières modifications : GITLAB permet de travailler sans rien installer ! -Il embarque un IDE (éditeur de code accessible en ligne ) +Il embarque un IDE ( éditeur de code accessible en ligne ) On va travailler à partir de cet interface web +mais on peut aussi l'installer "en local" : -.... mais on peut aussi... -INSTALLER EN LOCAL : + + + + +# INSTALLER EN LOCAL : + VSCODE / CODIUM : ? https://alternativeto.net/software/codium/ @@ -41,9 +49,8 @@ https://www.it-connect.fr/tuto-changer-langue-visual-studio-code-francais-anglai https://www.jetbrains.com/webstorm/ -MAIS AUSSI : +## Terminal -+ Terminal : ( utiliser la ligne de commande ) https://openclassrooms.com/fr/courses/6173491-apprenez-a-utiliser-la-ligne-de-commande-dans-un-terminal/6349461-decouvrez-le-terminal#r-6349452 @@ -51,7 +58,7 @@ https://openclassrooms.com/fr/courses/6173491-apprenez-a-utiliser-la-ligne-de-co https://coolguy.website/map-is-the-territory/introduction.html -+ Git : +## Git : https://git-scm.com/downloads Vérifier via Terminal @@ -60,12 +67,19 @@ Vérifier via Terminal --- -CREER UN COMPTE GITlab + +# En ligne sur GitLab/Hub + +CREER UN COMPTE GItLab/Hub https://gitlab.com/users/sign_up + +## TOKEN + On aurra aussi besoin d'un Token d'accès.... Un code long qui donne certaines autorisations ( par exemple pour pull/push/commit, etc ) ----> TOKEN + +DO .... PAGE du PROJET -> GAUCHE -> Settings > Access Token --> Add New Token (boutton gris) @@ -81,10 +95,12 @@ Vérfier / Révoquer les acces : . . . -FORK PROJET + +# FORK PROJET PAGE d'exemple : https://gitlab.com/pages/plain-html +DO .... On clic "Fork" --> Cela va copier le projet existant dans tes projets sur les serveurs de GitLab/Hub --> Et tu pourras alors modifier cette version (copie) en toute libertée @@ -94,6 +110,7 @@ EX/ https://gitlab.com/bonnebulle/plain-html-redo . . . +# METTRE EN LIGNE Pour rendre le projet accessible en ligne, hébergé par GitLab/Hub... "Transformer" en PAGE : Dans le projet actuel -> @@ -107,15 +124,48 @@ PAGE URL == . . . +# OUVRIR ou CLONER + +DO .... RETOUR AU PROJET --> Code (boutton bleu) --> Ouvrir avec.... ---> Va ouvrir un IDE... +- Cloner le projet en entier (travailler en local) /SI/ on veut cloner+ouvrir le projet en local... ( avec vscode/codium/IDE installé sur l'ordinateur ) Gitlab va proposer de clonner le projet avant de l'ouvrir avec .... + +- On peut également cloner le projet depuis le terminal avec : +/SI/ on veut le faire manuellement +DO .... +RETOUR AU PROJET +--> Code (boutton bleu) +--> Clone with HTTPS (copy https.....monprojet.git) +Dans le terminal aller dans un dossier ou télécharger le projet +. . . +Chemin actuel +> pwd +Se déplacer cd +EX dossier actuel/ ./(+press TABULATION) +EX dossier parent/ ../(+press TABULATION) +> cd ./ +> cd ../ + +Une fois dans le bon dossier (au choix) +> git clone https....monprojet.git +lister fichiers clonés +> ls +--> dossier du projet +--> on va dedans +> cd monprojet +> ls +Localiser le chemin du dossier actuel +> pwd + +- Ouvir 1 fichier... en ligne sur l'IDE embarquée de GitLab... /SI/ on veut travailler en ligne (IDE GitLab)... On peut ouvrir un fichier spécifique EX/ https://gitlab.com/bonnebulle/plain-html-redo/-/blob/main/README.md @@ -123,7 +173,9 @@ EX/ https://gitlab.com/bonnebulle/plain-html-redo/-/blob/main/README.md --> Open in Web IDE... -DEPUIS CET IDE, on va pouvoir sauvegarder l'état d'avancement du projet en utilisant GIT +# DO Git commandes depuis l'IDE + +DEPUIS notre IDE, on va pouvoir sauvegarder l'état d'avancement du projet en utilisant GIT ( qui se charge : - de cloner "> clone https://gitlab.com/bonnebulle/plain-html-redo.git" - de télécharger l'état actuel du projet présent sur le serveur git "> git pull" @@ -143,6 +195,15 @@ Ils permettent... ... ainsi on comprend ce qui se passe "derière" quand on clic les boutons ... ( quelles commandes sont envoyées ) + + + + + + + +# TUTOS + COMMANDES + - Git - Git dans Bash ↳ https://git-scm.com/book/fr/v2/Annexe-A:-Git-dans-d%e2%80%99autres-environnements-Git-dans-Bash @@ -155,26 +216,46 @@ Ils permettent... --- -CHECKOUT -Changer de branche -TUTO https://git-scm.com/book/fr/v2/Les-branches-avec-Git-Gestion-des-branches +# PULL (aspirer) -Etat des fichiers : +Récupère les fichiers tels que présents sur GitLab/Hub +( on récupère l'état de travail des fichiers présents sur le serveur ) +> git pull +( va prévenir si des modifications difèrent en local ) + +# Etat des fichiers : > git status Ajouter un fichier (ou tous *) > git add ./README.md > git add * + +Remove du stash (état lattant avant commit + push) +> git rm ./README.md + +annuler un ajout sur un fichier +> git checkout -- CONTRIBUTING.md + +restaure +> git restore --staged CONTRIBUTING.md + + + +## Commit + Git commit -> git commit +( sauvegarder l'état actuel des fichiers locaux ) +> git commit + ... on écrit les modifications apportées dans le navigateur text ... on peut installer nano https://command-not-found.com/nano ... ou utiliser vim... .... on tappe -- ESCAPE + ":a" pour rendrer en mod édition .... on quitte+save en tappant -- ESCAPE + ":wq" .... on quitte no_save tappant -- ESCAPE + ":q!" -/OU/ directement depuis la commmande +/OU/ directement depuis la commmande + > git commit -m 'initial commit of my project' Visualiser les modifications : @@ -185,20 +266,33 @@ Visualiser les modifications : voir l'historique > git log --pretty=format:"%h %s" --graph -annuler un ajout sur un fichier -> git checkout -- CONTRIBUTING.md -restaure -> git restore --staged CONTRIBUTING.md +# PUSH + +Envoi des modifications après un commit +( qui valides les modifications locales apportées à tel ou tel fichier ) +> git push +( id + TOKEN ) + +préciser la branch à qui envoyer le commit (et fichiers) +> git push --set-upstream origin main +( id + TOKEN ) -BRANCHES +# BRANCHES + TUTO : https://git-scm.com/book/fr/v2/Les-branches-avec-Git-Les-branches-en-bref voir les branches ( locales + distantes ) > git branch --all + +CHECKOUT +Changer de branche + +TUTO https://git-scm.com/book/fr/v2/Les-branches-avec-Git-Gestion-des-branches + changer (basculer de branche) > git checkout -b forkit @@ -209,7 +303,7 @@ revenir/changer à la branche d'origine "main" (ou "forkit") envoyer les modifications à une branche spécifique > git push --set-upstream origin main -merge +# merge > git merge forkit gestion de conflit de versions