# 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/)