Penggunaan CLI
Dokumentasi penggunaan ini mengasumsikan kamu sudah mengikuti langkah-langkah instalasi cli.
Catatan singkat: Dibawah ini kami akan menunjukan all-contributors
untuk menjaga hal-hal menjadi sederhana, tapi jika kamu mengalami kesulitan, rute yarn all-contributors
layak untuk dicoba 😺
Perintah
all-contributors init
Jalankan ini ketika kamu pertama kali mulai menggunakan all-contributors-cli. Perintah ini meminta beberapa pertanyaan dan membangun proyek untuk all-contributors. Konfigurasi ini termasuk membuat berkas konfigurasi .all-contributorsrc
dan membuat tabel kontributor di files
yang kamu tentukan (biasanya di README.md
).
all-contributors add
Gunakan add
untuk menambah kontributor baru di proyek kamu, atau tambahkan cara baru di mana mereka berkontribusi. Mereka akan ditambahkan ke file konfigurasi kamu, dan file kontributor akan diperbarui sama seperti jika kamu menggunakan perintah generate.
# Menambah kontributor baru <username>, yang membuat kontribusi berjenis <kontribusi>
all-contributors add <username> <kontribusi>
# Contoh:
all-contributors add jfmengels code,doc
Dimana username
adalah username pengguna GitHub atau Gitlab, dan kontribusi
adalah daftar kontribusi yang dipisah dengan ,
. Lihat Kunci Emoji (Referensi Jenis Kontribusi) untuk daftar jenis kontribusi
yang valid.
Pengguna GitLab: Lihat persyaratan tambahan untuk pengguna GitLab
all-contributors check
Use check
to compare contributors from GitHub with the ones credited in your .all-contributorsrc
file, to make sure that credit is given where it's due.
Karena pembatasan API GitHub, perintah ini hanya berfungsi untuk proyek dengan kontribusi kurang dari 500 (Kecuali jika kamu menetapkan
PRIVATE_TOKEN
seperti yang disebutkan di pengguna GitHub).
all-contributors generate
Gunakan generate
untuk membaca daftar kontributor
dari file .all-contributorsrc
kamu dan memperbarui tabel kontributor yang ditentukan oleh kunci files
.
Please note the command must be able to find the following tags in those files, to update the table:
<!-- ALL-CONTRIBUTORS-LIST:START - Jangan hapus atau ubah bagian ini -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
Also, note that it needs to find the following tags to update the badge:
<!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section -->
<!-- ALL-CONTRIBUTORS-BADGE:END -->
Pengguna GitHub
Dalam beberapa kasus, kamu mungkin melihat pesan kesalahan GitHub API rate limit exceeded for xxx
. You may need to set an environment variable named PRIVATE_TOKEN
to circumvent this GitHub rate limit.
Private token is your Personal Access Token (PAT) to authenticate with the GitHub API.
Pengguna Gitlab
Please note that if you are using a self-hosted GitLab instance, some commands will need you to set an environment variable named PRIVATE_TOKEN
first.
Token privat adalah akses token personal untuk autentikasi dengan API GitLab.
# set private token on Linux
export PRIVATE_TOKEN=your_private_token
# set private token on Windows
set PRIVATE_TOKEN=your_private_token