FUNDING ファイルについて
デフォルトブランチの、リポジトリ内の .github
フォルダにある FUNDING.yml ファイルを編集することで、スポンサーボタンを設定できます。 ボタンには、GitHub Sponsors のスポンサード開発者、外部の資金獲得プラットフォーム、またはカスタムの資金獲得 URL を含めることができます。 GitHub Sponsors の詳細は、「GitHub Sponsors について」を参照してください。
外部の資金獲得プラットフォームごとに 1 つのユーザ名、パッケージ名、またはプロジェクト名と、最大 4 つのカスタム URL を追加できます。 GitHub Sponsors には、スポンサード開発者または Organization を最大 4 人追加できます。 追加する場合は、プラットフォームごとに改行し、以下の構文に従ってください:
プラットフォーム | 構文 |
---|---|
CommunityBridge | community_bridge: プロジェクト名 |
GitHub Sponsors | github: ユーザ名 または github: [ユーザ名, ユーザ名, ユーザ名, ユーザ名] |
IssueHunt | issuehunt: ユーザ名 |
Ko-fi | ko_fi: ユーザ名 |
Liberapay | liberapay: ユーザ名 |
Open Collective | open_collective: ユーザ名 |
Otechie | otechie: ユーザ名 |
Patreon | patreon: ユーザ名 |
Tidelift | tidelift: プラットフォーム名/パッケージ名 |
カスタム URL | custom: リンク 1 または custom: [リンク 1, リンク 2, リンク 3, リンク 4] |
Tidelift では、platform-name/package-name
の構文で、以下のプラットフォーム名を用います:
言語 | プラットフォーム名 |
---|---|
JavaScript | npm |
Python | pypi |
Ruby | rubygems |
Java | maven |
PHP | packagist |
C# | nuget |
以下は FUNDING.yml ファイルの例です:
github: [octocat, surftocat]
patreon: octocat
tidelift: npm/octo-package
custom: ["https://www.paypal.me/octocat", octocat.com]
注釈: 配列内のカスタム URL に :
が含まれる場合、URL を引用符で囲む必要があります。 たとえば、"https://www.paypal.me/octocat"
です。
所属する Organization またはユーザアカウント用にデフォルトのスポンサーボタンを作成できます。 詳しい情報については「デフォルトのコミュニティ健全性ファイルを作成する」を参照してください。
資金獲得リンクは、オープンソースプロジェクトが、コミュニティから直接的に資金援助を受ける方法を提供します。 資金獲得リンクをその他の目的、たとえば広告や、政治団体、地域団体、または慈善団体を支援する目的で利用することについて、弊社ではサポートいたしかねます。 あなたが意図する利用方法がサポートされているかについてのご質問は、GitHub Support or GitHub Premium Support にお問い合わせください。
リポジトリにスポンサーボタンを表示する
管理者権限があるユーザなら誰でも、リポジトリのスポンサーボタンを有効化できます。
- GitHubで、リポジトリのメインページにアクセスしてください。
- リポジトリ名の下で Settings(設定)をクリックしてください。
- [Features] で [Sponsorships] を選択します。
- [Sponsorships] で、[Set up sponsor button] または [Override funding links] をクリックします。
- ファイルエディタで、FUNDING.yml ファイルにある指示に従って、資金獲得の場所へのリンクを追加します。
- ページの下部で、ファイルに対して行った変更を説明する短く分かりやすいコミットメッセージを入力してください。 コミットメッセージでは、複数の作者にコミットを関連づけることができます。 詳しい情報については「複数の共作者を持つコミットの作成」を参照してください。
- コミットメッセージフィールドの下で、コミットを追加を現在のブランチか新しいブランチから選択してください。 If your current branch is the default branch, you should choose to create a new branch for your commit and then create a pull request. 詳しい情報については「新しいプルリクエストの作成」を参照してください。
- Propose new file(新規ファイルの提案)をクリックしてください。