• Objet : Utilisation de Gitea pour les membres DF
• Niveau requis :

  débutant
• Commentaires : Pour une utilisation basique de Gitea hébergé sur DF.
• Débutant, à savoir : Une introduction à Git, un système de gestion de version décentralisé
• Suivi :

  en-chantier, à-tester, à-placer
  • Création par bendia 04/08/2019
  • Testé par <…> le <…>
• Commentaires sur le forum : Lien vers le forum concernant ce tuto ¹⁾

Nota :

Contributeurs, les sont là pour vous aider, supprimez-les une fois le problème corrigé ou le champ rempli !

Gitea est une forge logicielle web, c'est à dire un outil en ligne permettant à plusieurs personnes (développeurs ou non) de collaborer à la création de logiciels. Elle permet entre autre de :

• Gérer les version du code source grâce à git, soit via la ligne de commande, mais aussi graphiquement avec l'interface web.
• Gérer les droits sur les différents dépôts grâce à la création d'organisations pouvant contenir des équipes.
• Créer et gérer des tickets pour signaler et traiter des bugs, proposer des amélirations et répartir les tâches à accomplire.
• Créer et gérer un wiki, pour documenter le code ou l'utilisation du logiciel par exemple

Ce tuto n'a pas pour objectif d'expliquer l'utilisation de git, il existe pour cela de nombreux tuto, dont un livre sous licence CC²⁾. Il ne traitera également pas de toutes les possibilités offertes par Gitea. SI certains veulent s'y lancer, pourquoi pas des tutos spécifiques pour des fonctions précises (genre les PR, qui doivent s’appeler Demande d'ajout ?

Le Tableau de bord est la page principale qui s'affiche après la connexion.

A partir de ce tableau de bord, on va pourvoir :

• accéder aux réglages et profils du compte
• créer de nouveau dépôts, de nouvelles organisation
• Voir les notifications
• visualiser les dépôts et organisations sur lesquels nous travaillons (notez qu'on peut également en ajouter avec le signe +)
• Changer le contexte du tableau de bord, pour passer naviguer entre votre compte propre et les différentes organisations auxquelles vous appartenez
• On voit également au milieu un graphique montrant votre activité, et l'activité des projets que vous suivez
• Dans la barre de navigation, on peut également se diriger vers les tickets de vos dépôts, les demandes d'ajouts, et l'explorateur permettant de visualiser les dépôts publics du serveur.

Pour modifier son profil (nom, bio, site web, mot de passe …), gérer son mot de passe, gérer ses dépôts et organisations et ajouter une clé SSH, c'est par là

Habituellement, pour pousser des modifications dans un dépôt depuis sa machine personnelle, on utilise SSH. Il va donc falloir ajouter une clé SSH grâce à l'onglet Clés SSH/GPG

On donne ensuite le nom à la clé, et on copie son contenu dans le cadre qui va bien avant de sauvegarder

Avec ça, vous voilà prêt à interagir avec Gitea en ligne de commande directement depuis votre machine

Le dépôt, c'est la collection de fichier qui constitue le code source du logiciel (merci VV222 ). Ce dépôt a un propriétaire (vous ou une organisation). Pour créer un dépôt, nous pouvons cliquer sur Nouveau, puis Nouveau dépôt, ou sur le bouton + du cadre Dépôts/Organisation, et cette page apparaît alors. Outre le nom (qui ne doit contenir que ne doit contenir que des caractères alphanumériques, des tirets -, des tirets bas _, et des points. .), on remarquera les deux cases à cocher :

• Rendre le dépôt privé ne permettra qu'à vous (ou au personnes que vous ajouterez comme collaborateurs de voir ce dépôt.
• Initialiser le dépôt (ajoute les fichiers .gitignore, Licence et LISEZMOI) va créer ces 3 fichiers en même temps que votre dépôt. Vous pouvez choisir le type de licence qui s'appliquera à votre logiciel (GPLV3, MIT …) et une copie de celle-ci sera ajoutée dans le fichier Licence. Le fichier LIZEZMOI se remplira du contenu du cadre Description. Ce fichier peut être formaté en Markdown et son contenu s'affichera converti en HTML sous la liste des fichiers du dépôt.

On peut également créer un dépôt nu. Une fois créer on y trouve alors toutes les commandes permettant de créer son dépôt en local, puis, de le pousser, ou alors de pousser un dépôt local déjà existant.

On a désormais un dépôt avec ses premiers fichiers.

• copier directement l'adresse (ssh ou http) permettant de cloner le dépôt
• télécharger ces fichiers dans une archive.

Les sujets, sont des tags qu'on peut appliquer au dépôts, et qui permettrons de lister tous les dépôts ayant un même sujet dans l'explorateur. Par exemple, si on donne le langage dans lequel est codé l'application, on pourra lister tous les dépôts publics codés dans ce même langage.

permet notamment d'activer ou désactiver le gestionnaire de ticket, le wiki, de modifier la visibilité du dépôt (publique/privé), d'ajouter des collaborateurs, de changer le propriétaire, de l'archiver ou le supprimer.

• créer un nouveau fichier vide, ou de téléverser des fichiers
• Cliquez sur le nom d'un fichier l'affiche, il est alors modifiable directement en ligne avec le bouton .

Ces actions donnerons lieu à des nouveaux commits.