Affichage d’un bouton Sponsor dans votre dépôt

À propos des fichiers FUNDING

Vous pouvez configurer votre bouton Sponsor en modifiant un fichier FUNDING.yml dans le dossier .github votre dépôt, sur la branche par défaut. Vous pouvez configurer le bouton pour inclure des développeurs sponsorisés dans GitHub Sponsors, des plateformes de financement externes ou une URL de financement personnalisée. Pour plus d’informations sur GitHub Sponsors, consultez « À propos de GitHub Sponsors ».

Vous pouvez ajouter un nom d’utilisateur, un nom de package ou un nom de projet par plateforme de financement externe et jusqu’à quatre URL personnalisées. Vous pouvez ajouter une organisation et jusqu’à quatre développeurs sponsorisés dans GitHub Sponsors. Ajoutez chaque plateforme sur une nouvelle ligne à l’aide de la syntaxe suivante :

Plateforme	Syntaxe
LFX Mentorship (anciennement CommunityBridge)	community_bridge: PROJECT-NAME
GitHub Sponsors	github: USERNAME ou github: [USERNAME, USERNAME, USERNAME, USERNAME]
IssueHunt	issuehunt: USERNAME
Ko-fi	ko_fi: USERNAME
Liberapay	liberapay: USERNAME
Open Collective	open_collective: USERNAME
Otechie	otechie: USERNAME
Patreon	patreon: USERNAME
Tidelift	tidelift: PLATFORM-NAME/PACKAGE-NAME
URL personnalisée	custom: LINK1 ou custom: [LINK1, LINK2, LINK3, LINK4]

Pour Tidelift, utilisez la syntaxe platform-name/package-name avec les noms de plateforme suivants :

Langage	Nom de la plateforme
JavaScript	npm
Python	pypi
Ruby	rubygems
Java	maven
PHP	packagist
C#	nuget

Voici un exemple de fichier FUNDING.yml :

github: [octocat, surftocat]
patreon: octocat
tidelift: npm/octo-package
custom: ["https://www.paypal.me/octocat", octocat.com]

Vous pouvez créer un sponsor par défaut pour votre organisation ou votre compte personnel. Pour plus d’informations, consultez « Création d’un fichier d’intégrité de la communauté par défaut ».

Affichage d’un bouton Sponsor dans votre dépôt

Toute personne disposant d’autorisations d’administration peut activer un bouton Sponsor dans un dépôt.

1. Dans GitHub.com, accédez à la page principale du dépôt. 1. Sous le nom de votre dépôt, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant et cliquez sur Paramètres.

   

2. Sous Fonctionnalités, sélectionnez Sponsorisations.

3. Sous « Sponsorisations », cliquez sur le bouton Configurer un sponsor ou Remplacer des liens de financement.

4. Dans l’éditeur de fichier, suivez les instructions du fichier FUNDING.yml pour ajouter des liens à vos emplacements de financement. 1. En bas de la page, tapez un message de validation court et explicite décrivant la modification que vous avez apportée au fichier. Vous pouvez attribuer la validation à plusieurs auteurs dans le message de validation. Pour plus d’informations, consultez « Création d’une validation avec plusieurs auteurs ». 1. Sous les champs de message de commit, choisissez si vous souhaitez ajouter votre commit à la branche actuelle ou à une nouvelle branche. Si votre branche actuelle est la branche par défaut, vous devez choisir de créer une branche pour votre validation, puis de créer une demande de tirage (pull request). Pour plus d’informations, consultez « Création d’une demande de tirage ». 1. Cliquez sur Proposer un nouveau fichier.

Pour aller plus loin

• « À propos de GitHub Sponsors pour les contributeurs open source »
• « FAQ avec l’équipe GitHub Sponsors team » sur the GitHub Blog