|
|
Tutoriel pour utilisation de Gitlab
|
|
|
===================================
|
|
|
|
|
|
Ce tutoriel a pour objectif de permettre l'utilisation de GitLab via un navigateur web. Il présente les principales fonctionnalités avec la navigation dans le projet, le téléchargement du projet, l'ajout d'un nouveau fichier, l'édition d'un fichier déjà présent... À noter que GitLab.com a un support du français relativement limité.
|
|
|
|
|
|
GitLab
|
|
|
------
|
|
|
|
|
|
GitLab est un projet [open core](https://fr.wikipedia.org/wiki/Open_core). Cela signifie que le coeur du projet est [open source](https://fr.wikipedia.org/wiki/Open_source) (le code source du projet est ouvert) mais certaines fonctionnalités spécifiques "en plus" sont payantes.
|
|
|
|
|
|
GitLab est une [forge](https://fr.wikipedia.org/wiki/Forge_(informatique)). C'est-à-dire que GitLab a pour objectif de permettre à plusieurs personnes de participer au développement d'un même projet. GitLab.com est le service web correspondant.
|
|
|
|
|
|
[git](https://fr.wikipedia.org/wiki/Git) est un logiciel de gestion de version. Dans un projet, il va permettre de conserver les évolutions du projet au travers des versions de chacun de ces fichiers. GitLab.com héberge des projets utilisant git.
|
|
|
|
|
|
Écran d'accueil
|
|
|
---------------
|
|
|
|
|
|
![1_Accueil](/uploads/cdb37f0636138cb034d99deadf6d0827/1_Accueil.PNG)
|
|
|
|
|
|
L'écran d'accueil est divisé en plusieurs partie:
|
|
|
- la partie du haut et lié à GitLab.com avec la navigation à travers l'ensemble de vos projets (**1**), vos différents groupes (**2**) ou la gestion de votre profil (**3**)
|
|
|
- la partie de gauche est centrée sur le projet courant avec par exemple le wiki (**6**)
|
|
|
- le coeur de la page se concentre sur l'exploration des fichiers, le README et diverses fonctionnalités comme le téléchargement (**5**) ou le code permettant de télécharger le projet en ligne de commande (**4**)
|
|
|
- La barre de recherche (**7**) permet d'effectuer une recherche dans le projet à la fois sur les noms de fichiers mais aussi dans le contenus de ceux-ci
|
|
|
|
|
|
![3_Acceuil_Fin](/uploads/3ecad1327f7ad55746d9219939f0b402/3_Acceuil_Fin.PNG)
|
|
|
|
|
|
En faisant défiler vers le bas on voit plus précisément:
|
|
|
- Le dernier commit sur le projet
|
|
|
- Le système de fichier, cela permet une navigation à travers les dossiers et fichiers présents dans le projet
|
|
|
- Le README, il expose rapidement l'objectif du projet. Il peut être présent dans l'ensemble de l'arborescence de fichiers pour préciser le rôle de tel ou tel dossier. À noter que le README est en [markdown](https://fr.wikipedia.org/wiki/Markdown)
|
|
|
|
|
|
![10_settings](/uploads/41f36a2fa1404d6f38e8035c5e2d258d/10_settings.PNG)
|
|
|
|
|
|
Les paramètres courants de votre utilisateur sont consultable en cliquant sur le bouton en haut à droite puis sur "Settings"
|
|
|
|
|
|
Téléchargement du projet
|
|
|
-----------------------
|
|
|
|
|
|
![2_Accueil_Download](/uploads/ce76be8bf16908c11b048fa41c92e119/2_Accueil_Download.PNG)
|
|
|
|
|
|
Pour télécharger le projet il suffit de clique sur le "bouton nuage" et cliquer ensuite sur "Download zip" dans le menu déroulant.
|
|
|
|
|
|
Navigation dans le système de fichier
|
|
|
-----------------------
|
|
|
|
|
|
La navigation se fait aisément en cliquant sur les dossiers ou fichiers.
|
|
|
|
|
|
![4_Système_de_fichier](/uploads/4165baa0caec6d7c75d68323bdede207/4_Système_de_fichier.PNG)
|
|
|
|
|
|
Ajout d'un nouveau fichier
|
|
|
--------------------------
|
|
|
|
|
|
Une fois dans le bon dossier on peut ajouter un fichier en cliquant sur le "+" à la suite de quoi plusieurs choix sont possibles
|
|
|
|
|
|
![5_Ajout_d_un_fichier](/uploads/d0147b03d3db4ca2d3bb03296d098420/5_Ajout_d_un_fichier.PNG)
|
|
|
|
|
|
Il y a trois choix possibles:
|
|
|
- "New file" qui permet la création d'un fichier *via* GitLab.com. L'édition de se fichier se fera ensuite en utilisant l'éditeur de texte dans un navigateur. Cette utilisation est plutôt conseillée dans le cas d'un README
|
|
|
- "Upload file" qui permet l'ajout d'un fichier depuis son ordinateur
|
|
|
- "New directory" qui permet la création d'un nouveau dossier
|
|
|
|
|
|
![6_Upload_file](/uploads/bb00f2c45214b35d3aaa5e95af965357/6_Upload_file.PNG)
|
|
|
|
|
|
Quand l'option "Upload file" est choisie, il est possible de faire glisser le fichier depuis l'explorateur de fichier ou simplement cliquer pour le retrouver dans votre système de fichier.
|
|
|
|
|
|
Il est important d'indiquer un message de commit clair. Celui-ci permet de bien comprendre l'historique du projet et le pourquoi de l'ajout/modification d'un fichier.
|
|
|
|
|
|
"Upload file" permet d'exécuter l'opération.
|
|
|
|
|
|
Modification d'un fichier existant
|
|
|
--------------------------
|
|
|
Quand on clique sur un fichier on obtient l'écran suivant:
|
|
|
![7_Modification_d_un_fichier](/uploads/6ba2b6d242a21d48292dd26fac8fb3b3/7_Modification_d_un_fichier.PNG)
|
|
|
On peut faire plusieurs manipulations depuis cette interface:
|
|
|
- Il est possible de copier l'ensemble du fichier (**1**), équivalent à un ```Ctrl+A Ctrl+C```
|
|
|
- Il est possible d'utiliser l'éditeur de GitLab pour directement modifier le fichier dans son navigateur web via le bouton "Edit" (**2**)
|
|
|
- Le "Replace" (**3**) permet de revenir à un écran équivalent de l'"Upload file" précédent. La nouvelle version du fichier remplacera le fichier existant
|
|
|
- On peut supprimer le fichier (**4**)
|
|
|
|
|
|
Edition d'un fichier existant
|
|
|
----------------------------
|
|
|
En cliquant sur le bouton "Edit" précédent on se retrouve sur l'écran suivant:
|
|
|
|
|
|
![8_Edition_haut](/uploads/70466d6f9c38c415b2474c83c58dd576/8_Edition_haut.PNG)
|
|
|
|
|
|
L'onglet "Write" permet de modifier le fichier. Le "Preview changes" permet de voir le "diff" sur ce fichier c'est-à-dire l'interprétation que git a sur les modifications apportées à ce fichier. Dans le cas d'un fichier en markdown (.md) comme par exemple README.md le bouton "Preview changes" devient "Preview" et permet de voir le résultat des modifications du fichier.
|
|
|
|
|
|
![9_Edition_fin](/uploads/25c4c269ef138ec2f6a4cb6f21105273/9_Edition_fin.PNG)
|
|
|
|
|
|
Une fois l'édition finie on peut indiquer le message de commit approprié, ajouter les changements ou annuler la modification. |
|
|
\ No newline at end of file |