38 lines
2.0 KiB
Markdown
38 lines
2.0 KiB
Markdown
# 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/)
|