Перейти к содержимому

Конфигурация бота

You can configure the all-contributors bot behaviour by updating the .all-contributorsrc JSON file. 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.

You are viewing the 🤖Bot Configuration, which is similar to the CLI Configuration

Ниже приведены ключи, которые можно задать:

ОпцияОписаниеПример/По-умолчанию
projectNameОбязательно, имя проекта.Example: all-contributors-cli
projectOwnerОбязательно, имя пользователя, на котором размещается проект.Example: tenshiAMD
repoTypeТип репозитория. Must be either github or gitlab.Default: github
repoHostУказывает имя хоста репозитория. Измените его, если вы используете собственный репозиторий.Default: https://github.com if repoType is github, and https://gitlab.com if repoType is gitlab
filesМассив файлов для обновления.Default: ['README.md']
imageSizeРазмер аватара пользователя (в пикселях).Default: 100
commitАвтоматически коммитить значек (badge) при добавлении участников.Default: false
commitConventionCommit convention (angular, atom, or none).Default: angular
contributorsPerLineМаксимальное количество столбцов для таблицы участников.Default: 7
contributorsSortAlphabeticallytrue: Sort alphabetically. false: Display in order of addition.Default: false
badgeTemplateУстанавливает пользовательский шаблон lodash для генерации значка.
contributorTemplateУстанавливает пользовательский шаблон lodash для генерации участника.
wrapperTemplateОпределите собственный шаблон lodash для переноса списка участников
typesУказывает пользовательские символы или шаблоны ссылок для типов вкладов. Может переопределять документированные типы.
linkToUsageAdds a footer with link to usage (either true or false)Default: true
skipCiЗаставляет CI игнорировать коммит. (either true or false)Default: true
contributorsList of contributors for this project, this is updated by @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": "[![All Contributors](https://img.shields.io/github/all-contributors/<%= projectOwner %>/<%= projectName %>?color=ee8449&style=flat-square)](#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": []
}

Перемещение таблицы All Contributors в другой файл

Заголовок раздела «Перемещение таблицы All Contributors в другой файл»

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. Вместо этого можно использовать для этого другой файл.

Ниже приведены шаги, которые могут помочь вам в достижении этого. For the sake of this tutorial, the different file that we’ll use is going to be named CONTRIBUTORS.md.

  1. Установите бот. See the Installation page for instructions.

  2. Добавьте своего первого участника. See the Bot Usage page for instructions.

  3. Create the CONTRIBUTORS.md file.

  4. Copy the code which can be found in this guide.

  5. Modify the files key in the .all-contributorsrc JSON file to match your new file name.

    .all-contributorsrc
    {
    "files": [
    "CONTRIBUTORS.md"
    ],
    ...
    }
  6. Теперь можно приступать к работе. New contributors will be added to this new file instead of the README.md file.