About FUNDING files
You can configure your sponsor button by editing a FUNDING.yml file in your repository's .github
folder, on the default branch. You can configure the button to include sponsored developers in GitHub 赞助者, external funding platforms, or a custom funding URL. For more information about GitHub 赞助者, see "About GitHub Sponsors."
You can add one username, package name, or project name per external funding platform and up to four custom URLs. You can add up to four sponsored developers or organizations in GitHub 赞助者. Add each platform on a new line, using the following syntax:
Platform | Syntax |
---|---|
LFX Mentorship (formerly CommunityBridge) | community_bridge: PROJECT-NAME |
GitHub 赞助者 | github: USERNAME or 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 |
Custom URL | custom: LINK1 or custom: [LINK1, LINK2, LINK3, LINK4] |
For Tidelift, use the platform-name/package-name
syntax with the following platform names:
Language | Platform name |
---|---|
JavaScript | npm |
Python | pypi |
Ruby | rubygems |
Java | maven |
PHP | packagist |
C# | nuget |
Here's an example FUNDING.yml file:
github: [octocat, surftocat]
patreon: octocat
tidelift: npm/octo-package
custom: ["https://www.paypal.me/octocat", octocat.com]
Note: If a custom URL in an array includes :
, you must wrap the URL in quotes. For example, "https://www.paypal.me/octocat"
.
You can create a default sponsor button for your organization or personal account. For more information, see "Creating a default community health file."
Funding links provide a way for open source projects to receive direct financial support from their community. We don’t support the use of funding links for other purposes, such as for advertising, or supporting political, community, or charity groups. If you have questions about whether your intended use is supported, please contact GitHub Support.
Displaying a sponsor button in your repository
Anyone with admin permissions can enable a sponsor button in a repository.
- 在 GitHub.com 上,导航到仓库的主页面。
- 在仓库名称下,单击 Settings(设置)。
- Under Features, select Sponsorships.
- Under "Sponsorships", click Set up sponsor button or Override funding links.
- In the file editor, follow the instructions in the FUNDING.yml file to add links to your funding locations.
- 在页面底部,输入一条简短、有意义的提交消息,描述您对文件所作的更改。 您可以在提交消息中将提交归于多个作者。 更多信息请参阅“创建有多个合作作者的提交”。
- 在提交消息字段下面,确定是要将提交添加到当前分支还是新分支。 如果当前分支是默认分支,则应选择为提交创建新分支,然后创建拉取请求。 更多信息请参阅“创建新的拉取请求”。
- 单击 Propose new file(提议新文件)。