ボットの設定
.all-contributorsrc
JSON ファイルからall-contributorsボットの設定を変更できます。 The data used to generate the contributors list will be stored there, and you can configure how you want @all-contributors
to generate the list.
これはボット設定に関するページです。CLI設定をお探しですか?
指定できるキーは以下のとおりです:
オプション | 説明 | 例/デフォルト |
---|---|---|
projectName | 必須、プロジェクトの名前 | 例: all-contributors-cli |
projectOwner | 必須、プロジェクトのホストユーザー名 | Example: tenshiAMD |
repoType | リポジトリのタイプ。 github あるいはgitlab のどちらか。 | デフォルト: github |
repoHost | リポジトリのホスト名。 セルフホストされたリポジトリの場合は変更してください。 | デフォルト: repoType がgithub ならhttps://github.com 、gitlab ならhttps://gitlab.com |
files | 更新対象のファイル配列 | デフォルト: ['README.md'] |
imageSize | ユーザーアバターのサイズ (px) | デフォルト: 100 |
commit | コントリビューターを追加するときにバッジを自動コミットする。 | Default: false |
commitConvention | Commit convention (angular , atom , ember , eslint , jshint , gitmoji , or none ). | Default: angular |
contributorsPerLine | コントリビューターテーブルの最大カラム数 | デフォルト: 7 |
contributorsSortAlphabetically | true : Sort alphabetically. false : Display in order of addition. | Default: false |
badgeTemplate | バッジを生成するための独自のlodashテンプレート定義 | |
contributorTemplate | コントリビューターを生成するための独自のlodashテンプレート定義 | |
wrapperTemplate | Define your own lodash template to wrap the list of contributors | |
types | コントリビュータータイプのカスタムシンボルかリンクテンプレートの指定。 記述されたタイプを上書き可能 | |
linkToUsage | Adds a footer with link to usage (either true or false ) | Default: true |
skipCi | Makes the CI ignore the commit. (either true or false ) | Default: true |
contributors | プロジェクトのコントリビューターリスト、@all-contributors addで更新される |
{
"projectName": "all-contributors",
"projectOwner": "all-contributors",
"repoType": "github",
"repoHost": "https://github.com",
"files": ["README.md"],
"imageSize": 100,
"commit": false,
"contributorsPerLine": 7,
"contributorsSortAlphabetically": false,
"badgeTemplate": "[](#contributors)",
"contributorTemplate": "<a href=\"<%= contributor.profile %>\"><img src=\"<%= contributor.avatar_url %>\" width=\"<%= options.imageSize %>px;\" alt=\"\"/><br /><sub><b><%= contributor.name %></b></sub></a>",
"wrapperTemplate": "\n<table>\n <tbody><%= bodyContent %> </tbody>\n<%= tableFooterContent %></table>\n\n",
"types": {
"custom": {
"symbol": "🔭",
"description": "A custom contribution type.",
"link": "[<%= symbol %>](<%= url %> \"<%= description %>\"),"
}
},
"linkToUsage": true,
"skipCi": true,
"contributors": []
}
Moving the All Contributors table into a different file
As you know, the default file for the contributors table is README.md
. But if your project has tons of contributors, it doesn't make sense to include the All Contributors table in the README.md
file. Instead, you can use a different file to do so.
Here are the steps that may help you in achieving that. For the sake of this tutorial, the different file that we'll use is going to be named CONTRIBUTORS.md
.
Install the bot. See the Installation page for instructions.
Add your first contributor. See the Bot Usage page for instructions.
Create the
CONTRIBUTORS.md
file.Copy the code which can be found in this guide.
Modify the
files
key in the.all-contributorsrc
JSON file to match your new file name.{ "files": [ "CONTRIBUTORS.md" ], ... }
Now you should be good to go. New contributors will be added to this new file instead of the
README.md
file.