콘텐츠로 이동
All Contributors

CLI 설치

This guide explains how you can add the Command Line Interface to your project.

  1. How to Install the All Contributors CLI tool

    The all-contributors CLI module is distributed via npm which is bundled with node and should be installed as one of your project’s devDependencies.

    To install it run:

    터미널 창
    npm i -D all-contributors-cli

    Alternatively, Arch Linux users can install the all-contributors-cli package from the AUR.

  2. Initialize the Project

    Run init and answer a few questions. The command creates an .all-contributorsrc file in the root of your project.

    터미널 창
    npx all-contributors init

    A typical session looks like this:

    ? What's the name of the repository? all-contributors
    ? Who is the owner of the repository? all-contributors
    ? What is the repository type? GitHub
    ? Where is the repository hosted? Hit Enter if it's on GitHub or GitLab https://github.com
    ? In which file should contributors be listed? README.md
    ? Do you want a badge tallying the number of contributors? Yes
    ? In which file should the badge be shown? README.md
    ? How big should the avatars be? (in px) 100
    ? Do you want this badge to auto-commit when contributors are added? Yes
    ? What commit convention would you want it to use? Angular
    ? Do you want to add a footer with link to usage? Yes

  3. 기여자 추가

    터미널 창
    npx all-contributors add jfmengels doc
    npx all-contributors generate

    For more on the commands see CLI usage.

  4. 기여 문서 업데이트

    Consider updating your CONTRIBUTING.md or similar with steps on how your contributors can add themselves. You can even link to the cli usage documentation.

  5. Optionally add shortcut scripts to your package.json

    You can optionally add shortcuts to your commands in your package.json scripts field.

    예:

    package.json
    {
        "scripts": {
            "contributors:add": "all-contributors add",
            "contributors:generate": "all-contributors generate"
        }
    }

    To support shortcuts such as:

    터미널 창
    npx contributors:add jfmengels doc