Skip to main content

在仓库中显示赞助者按钮

你可以在仓库中添加赞助者按钮,以提高开源项目资助选项的可见性。

关于 FUNDING 文件

可通过编辑默认分支上存储库的 .github 文件夹中的 FUNDING.yml 文件来配置赞助者按钮。 你也可以配置此按钮,以通过 GitHub Sponsors、外部资助平台或自定义资助 URL 来包括被赞助的开发者。 有关 GitHub Sponsors 的详细信息,请参阅 关于 GitHub 赞助商

你也可以每个外部赞助平台添加一个用户名、包名称或项目名,以及最多四个自定义 URL。 可在 GitHub Sponsors 中添加一个组织和最多四位被赞助的开发者。 使用以下语法在新行上添加每个平台。

平台语法
LFX Mentorship(以前称为 CommunityBridge)community_bridge: PROJECT-NAME
GitHub Sponsorsgithub: USERNAMEgithub: [USERNAME, USERNAME, USERNAME, USERNAME]
IssueHuntissuehunt: USERNAME
Ko-fiko_fi: USERNAME
Liberapayliberapay: USERNAME
Open Collectiveopen_collective: USERNAME
Patreonpatreon: USERNAME
Tidelifttidelift: PLATFORM-NAME/PACKAGE-NAME
极坐标polar: USERNAME
给我买杯咖啡buy_me_a_coffee: USERNAME
thanks.devthanks_dev: u/gh/USERNAME
自定义 URLcustom: LINK1custom: [LINK1, LINK2, LINK3, LINK4]

对于 Tidelift,请使用带有以下平台名称的 platform-name/package-name 语法。

语言平台名称
JavaScriptnpm
Pythonpypi
Rubyrubygems
Javamaven
PHPpackagist
C#nuget

下面是一个示例 FUNDING.yml 文件:

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

Note

如果数组中的自定义 URL 包含 :,则必须将 URL 用引号括起来。 例如,"https://www.paypal.me/octocat"

你可以为组织或个人帐户创建一个默认赞助者按钮。 有关详细信息,请参阅“创建默认的社区运行状况文件”。

Note

资助链接为开源项目提供了一个获得其社区直接资金支持的方式。 我们不支持出于其他目的使用资助链接,例如出于做广告或支持政治、社区或慈善团体的目的。 如果你对你的预期用途是否受支持存有疑问,请访问 GitHub 支持

在仓库中显示赞助者按钮

任何有管理员权限的人都可以在仓库中启用赞助者按钮。

  1. 在 GitHub 上,导航到存储库的主页面。

  2. 在存储库名称下,单击 “设置”。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”。

    存储库标头的屏幕截图,其中显示了选项卡。 “设置”选项卡以深橙色边框突出显示。

  3. 在“常规”设置页的“功能”部分,选择“赞助”。

  4. 在“赞助”框中,单击“设置赞助者按钮”或“替代资助链接” 。

  5. 在文件编辑器中,按照 FUNDING.yml 文件中的说明将链接添加到你的资助位置。

  6. 单击“提交更改...”

  7. 在“提交消息”字段中,输入简短、有意义的提交消息,以描述对文件的更改。 您可以在提交消息中将提交归于多个作者。 有关详细信息,请参阅“创建有多个作者的提交”。

  8. 在提交消息字段下面,确定是要将提交添加到当前分支还是新分支。 如果当前分支是默认分支,则应选择为提交创建新分支,然后创建拉取请求。 有关详细信息,请参阅“创建拉取请求”。

    GitHub 拉取请求的屏幕截图,其中显示了一个单选按钮,用于直接提交到主分支或创建新分支。 已选择“新建分支”。

  9. 单击“提交更改”或“建议更改” 。

其他阅读材料