forge.april.org-faq/README.md

FAQ forge.april.org

Ce fichier recueille des astuces et informations pour l'utilisation de la forge April.

Quel gestionnaire de tickets utiliser ?

Par défaut, le gestionnaire de tickets à utiliser est celui choisi par l'April pour tous ses projets : https://agir.april.org/ (Redmine).

Redmine peut sembler archaïque mais il reste terriblement efficace pour la gestion des tickets. Continuer à l'utiliser permettra d'éviter de multiplier les outils pour une même fonction.

Gitea permet définir un gestionnaire de tickets externe dans les paramètres de dépôt :

• aller à la page de dépôt en tant qu'administrateur ;
• cliquer sur le bouton « Paramètres » en haut à droite ;
• cocher « Activer le suivi de tickets du dépôt ;
• sélectionner « Utiliser un système de suivi de tickets externe »
• champ « Adresse du système de tickets externe »
  • mettre l'URL de l'onglet « Demandes » du projet Agir,
  • exemple : https://agir.april.org/projects/admins/issues
• champ « Format de l'URL du système de tickets » :
  • mettre https://agir.april.org/issues/{index}
• champ « Format du nombre de tickets du système de tickets externe »
  • cocher « Numérique (#1234) »
• cliquer sur « Valider ».

Comment faire reconnaître ses différents courriels dans les commits ?

Lorsqu'on commite, il arrive souvent qu'on le fasse avec des adresses de courriel différentes. Résultat, dans la page qui liste les commits, votre avatar s'affiche uniquement pour le courriel associé à votre compte de forge.

Gitea permet d'ajouter d'autres courriels à son compte et ceux-ci seront utilisés pour reconnaître vos commits :

• menu avatar en haut à droite > Configuration ;
• onglet « compte » ;
• section Gérer les adresses de courriel ;
• ajouter une adresse e-mail.

Quelles sont les conventions markdown ?

Pour les *markdowns, Gitea utilise le logiciel de rendu Goldmark (licence MIT) qui est compatible CommonMark (https://commonmark.org/)