Signer les contributions#

Signature automatique#

Le site se repose sur l'extension mkdocs-git-authors-plugin qui utilise l'historique Git pour déterminer qui a contribué à quelle page :

Pourcentage de contribution#

Le pourcentage de contribution est proportionnel au nombre de lignes créées ou modifiées.

Informations remontées et personnalisation#

Les informations (nom, adresse email) correspondent à la configuration locale de Git utilisées lors du commit. C'est l'adresse email qui fait office d'identifiant unique.

Si vous en utilisez plusieurs ou si vous souhaitez personnaliser le nom d'affichage, il est possible d'établir une table de correspondance en modifiant le fichier .mailmap.

Signer pour quelqu'un d'autre#

Si la personne ayant contribué ne dispose pas d'un compte GitHub ou ne souhaite pas mettre les mains dans la mécanique de contribution, il est tout de même possible de lui attribuer au moment de faire le commit :

1

git commit --author="Boris Mericksay <bmericskay@users.noreply.github.com>"

Bloc auteur#

Les contributeurs/rices réguliers peuvent se créer une page contenant une brève présentation dans content/team/ en respectant le nommage des fichiers déjà créés.

Syntaxe d'intégration#

On utilise ensuite les capacités d'insertion héritée d'un fichier Markdown dans un autre : Snippets.

Une fois la page créée, la syntaxe est la suivante : --8<-- "content/team/filename.extension".

Exemple :

--8<-- "content/team/jmou.md"