Kit de survie GitLab en ligne

🌵 Comment créer mon contenu sur mon beau site tout neuf ?

Attention

• Ce tutoriel est destiné aux grands débutants, ne connaisssant pas du tout GitLab.
• Il ne présente que le strict minimum pour être autonome dans la création d'un site.

Travailler en ligne

L'IDE utilisée en ligne est VS Code Web.

Attention : noms de répertoires et noms de fichiers

Eviter les accents, caractères spéciaux, espaces. Pour séparer les éléments de nommage, utiliser les underscores :
Par exemple : écrire chapitre_intro

I. Ajouter un répertoire dans docs

II. Ajouter un répertoire dans un autre

Vous aurez souvent besoin d'ajouter d'autres répertoires comme :

• images
• a_telecharger
• scripts

III. Créer en ligne un fichier .md ou .py

Editeur de texte intégré pour créer des fichiers .md ou .py

Sur le répertoire désiré, faire un clic droit, puis sélectionner New File

Saisir le nom du fichier que vous désirez créer, sans oublier son extension : par exemple cours_1.md.

Appuyer sur la touche "entrée" ↵ du clavier pour créer le fichier. Vous pouvez maintenant écrire dans la partie éditeur, à droite.

😊 Ce procédé est utilisable aussi pour écrire un fichier .py par exemple.

👉 Vous pouvez aussi travailler hors ligne et utiliser un éditeur de texte comme Notepad++ pour créer vos fichiers .md, puis les télécharger ensuite dans votre dépôt.

Comment écrire vos pages

👀 Vous pouvez explorer toutes les autres rubriques de ce tutoriel ...
😊 Bonne lecture ...

IV. Télécharger un fichier

Vous pourrez ainsi télécharger vos fichiers .md, .py, .jpg, .ipynb, etc.

V. Faire un commit pour un nouveau répertoire, le téléchargement de fichiers, la création d'un fichier

Attention

Pour qu'une modification soit réellement effectuée (création de répertoire, modification de fichier ...) il faut faire un commit.

On peut réliser un seul commit pour plusieurs actions effectuées.

⏳ Attention ... savoir patienter entre deux commits ...

La construction du site après un commit prend quelques instants. Il est vivement conseillé de vérifier sur le rendu du site que les modifications ont été prises en compte, avant de se lancer dans un nouveau commit. Il est parfois nécessaire de rafraichir plusieurs fois la page de rendu du site pour voir les modifications réalisées.

Commit pour nouveau répertoire, téléchargement fichier

Attention

Il ne faut pas faire un commit pour un répertoire qui a été créé, mais est encore vide.

😨 Ce répertoire serait supprimé après le commit.

Sur la barre d'outil latérale gauche :

Au début, la construction est en cours :

Une fois la construction terminée, on obtient :

Rafraichir la page du rendu de votre site. Il faut attendre un peu, et parfois recommencer, pour voir apparaître les modifications.

Les commits

Un commit, c’est la sauvegarde des modifications, accompagnée d'un commentaire qui résume les modifications effectuées.

VI. Modifier un fichier

Modifier un fichier

Réaliser les modifications

Commit pour modification de fichier

On procède comme précédemment.

Observer les modifications

Si les modifications conviennent

Procéder ensuite comme au IV.

VII. Renommer un fichier

Attention

Si vous avez renommé un fichier (ou un répertoire) qui était écrit dans un fichier .pages, modifier ce fichier .pages avec le nouveau nom, avant de réaliser le commit.

VIII. L'interface Web IDE et le dépôt

Pour revenir sur le dépôt (⚠ attention ne pas oublier de faire un commit s'il y a eu une modification, avant de revenir sur le dépôt)

En bas à gauche :

Puis en haut :