mirror of
https://github.com/anuraghazra/github-readme-stats.git
synced 2024-12-15 06:04:17 +08:00
350 lines
17 KiB
Markdown
350 lines
17 KiB
Markdown
<p align="center">
|
|
<img width="100px" src="https://res.cloudinary.com/anuraghazra/image/upload/v1594908242/logo_ccswme.svg" align="center" alt="GitHub Readme Stats" />
|
|
<h2 align="center">GitHub Readme Stats</h2>
|
|
<p align="center">あなたの README に自動生成された GitHub の統計情報を載せましょう！</p>
|
|
</p>
|
|
<p align="center">
|
|
<a href="https://github.com/anuraghazra/github-readme-stats/actions">
|
|
<img alt="Tests Passing" src="https://github.com/anuraghazra/github-readme-stats/workflows/Test/badge.svg" />
|
|
</a>
|
|
<a href="https://codecov.io/gh/anuraghazra/github-readme-stats">
|
|
<img src="https://codecov.io/gh/anuraghazra/github-readme-stats/branch/master/graph/badge.svg" />
|
|
</a>
|
|
<a href="https://github.com/anuraghazra/github-readme-stats/issues">
|
|
<img alt="Issues" src="https://img.shields.io/github/issues/anuraghazra/github-readme-stats?color=0088ff" />
|
|
</a>
|
|
<a href="https://github.com/anuraghazra/github-readme-stats/pulls">
|
|
<img alt="GitHub pull requests" src="https://img.shields.io/github/issues-pr/anuraghazra/github-readme-stats?color=0088ff" />
|
|
</a>
|
|
<br />
|
|
<br />
|
|
<a href="https://a.paddle.com/v2/click/16413/119403?link=1227">
|
|
<img src="https://img.shields.io/badge/Supported%20by-VSCode%20Power%20User%20%E2%86%92-gray.svg?colorA=655BE1&colorB=4F44D6&style=for-the-badge"/>
|
|
</a>
|
|
<a href="https://a.paddle.com/v2/click/16413/119403?link=2345">
|
|
<img src="https://img.shields.io/badge/Supported%20by-Node%20Cli.com%20%E2%86%92-gray.svg?colorA=61c265&colorB=4CAF50&style=for-the-badge"/>
|
|
</a>
|
|
</p>
|
|
|
|
<p align="center">
|
|
<a href="#demo">View Demo</a>
|
|
·
|
|
<a href="https://github.com/anuraghazra/github-readme-stats/issues/new/choose">Report Bug</a>
|
|
·
|
|
<a href="https://github.com/anuraghazra/github-readme-stats/issues/new/choose">Request Feature</a>
|
|
</p>
|
|
<p align="center">
|
|
<a href="/docs/readme_fr.md">Français</a>
|
|
·
|
|
<a href="/docs/readme_cn.md">简体中文</a>
|
|
·
|
|
<a href="/docs/readme_es.md">Español</a>
|
|
·
|
|
<a href="/docs/readme_de.md">Deutsch</a>
|
|
·
|
|
<a href="/docs/readme_ja.md">日本語</a>
|
|
·
|
|
<a href="/docs/readme_pt-BR.md">Português Brasileiro</a>
|
|
·
|
|
<a href="/docs/readme_it.md">Italiano</a>
|
|
·
|
|
<a href="/docs/readme_kr.md">한국어</a>
|
|
</p>
|
|
</p>
|
|
<p align="center">このプロジェクトを気に入っていただけましたか？<br>もしよろしければ、プロジェクトのさらなる改善のために<a href="https://www.paypal.me/anuraghazra">寄付</a>を検討して頂けると嬉しいです！</p>
|
|
|
|
# 主な機能
|
|
|
|
- [GitHub Stats Card](#github-stats-card)
|
|
- [GitHub Extra Pins](#github-extra-pins)
|
|
- [Top Languages Card](#top-languages-card)
|
|
- [Themes](#テーマの変更)
|
|
- [Customization](#テーマを自分でカスタマイズする)
|
|
- [Deploy Yourself](#自分の-Vercel-インスタンスにデプロイする)
|
|
|
|
# GitHub Stats Card
|
|
|
|
以下のコードをコピーして、あなたの Markdown ファイルに貼り付けるだけです。
|
|
簡単ですね！
|
|
|
|
`?username=` の値は、あなたの GitHub アカウントのユーザー名に変更してください。
|
|
|
|
```md
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
```
|
|
|
|
_Note: カードに表示されるランクはユーザの統計情報に基づいて計算されています。詳しくは、[src/calculateRank.js](../src/calculateRank.js)をご覧ください。_
|
|
|
|
### 特定の統計情報を隠す
|
|
|
|
クエリパラメータ `?hide=` に値をカンマ区切りで渡すことで、特定の統計情報を隠すことができます。
|
|
|
|
> Options: `&hide=stars,commits,prs,issues,contribs`
|
|
|
|
```md
|
|
|
|
```
|
|
|
|
### プライベートリポジトリへのコミットをカウントする
|
|
|
|
クエリパラメータ `?count_private=true` を使用することで、プライベートリポジトリへのコミット数を総数に追加することができます。
|
|
|
|
_Note: このプロジェクトを自分でデプロイしている場合、デフォルトではプライベートリポジトリへのコミットがカウントされます。_
|
|
|
|
> Options: `&count_private=true`
|
|
|
|
```md
|
|
|
|
```
|
|
|
|
### アイコンを表示する
|
|
|
|
クエリパラメータ `?show_icons=true` を使用することで、アイコンの表示が有効になります。
|
|
|
|
```md
|
|
|
|
```
|
|
|
|
### テーマの変更
|
|
|
|
内蔵されているテーマを使用すれば、[手動のカスタマイズ](#customization)を行うことなくカードの外観を変更することができます。
|
|
|
|
`?theme=THEME_NAME` は以下のように使います。
|
|
|
|
```md
|
|
|
|
```
|
|
|
|
#### 内蔵テーマの一覧
|
|
|
|
dark, radical, merko, gruvbox, tokyonight, onedark, cobalt, synthwave, highcontrast, dracula
|
|
|
|
<img src="https://res.cloudinary.com/anuraghazra/image/upload/v1595174536/grs-themes_l4ynja.png" alt="GitHub Readme Stat Themes" width="600px"/>
|
|
|
|
その他の使用可能なテーマの[プレビュー](../themes/README.md)や[設定ファイル](../themes/index.js)もご覧ください。もしよろしければ、**新しいテーマを投稿してみてください** :smile:
|
|
|
|
### テーマを自分でカスタマイズする
|
|
|
|
`Stats Card` や `Repo Card` の外観を URL パラメータを使って好きなようにカスタマイズすることができます。
|
|
|
|
#### 共通のオプション
|
|
|
|
- `title_color` - タイトルの色 _(16 進数カラーコード)_
|
|
- `text_color` - 中身のテキストの色 _(16 進数カラーコード)_
|
|
- `icon_color` - アイコンの色（変更可能な場合のみ） _(16 進数カラーコード)_
|
|
- `bg_color` - 背景の色 _(16 進数カラーコード)_ **または** _angle,start,end_ の形式でグラデーションを指定することも可
|
|
- `theme` - [使用可能なテーマ一覧](../themes/README.md) から選んだテーマ名
|
|
- `cache_seconds` - キャッシュ時間の秒数 _(最小値: 1800, 最大値: 86400)_
|
|
|
|
##### bg_color の グラデーション指定
|
|
|
|
bg_color オプションで複数のカンマ区切りの値を指定してグラデーションをレンダリングすることができます。フォーマットは以下の通りになります。
|
|
|
|
```
|
|
&bg_color=DEG,COLOR1,COLOR2,COLOR3...COLOR10
|
|
```
|
|
|
|
> キャッシュに関する注意点: Repo cards のデフォルトのキャッシュは、フォーク数とスター数が 1k 未満の場合は 30 分(1800 秒) で、それ以外の場合は 2 時間(7200) です。また、キャッシュは最低でも 30 分、最大でも 24 時間に制限されていることに注意してください。
|
|
|
|
#### Stats Card だけに存在するオプション
|
|
|
|
- `hide` - 特定の統計情報を隠す _(カンマ区切りで指定)_
|
|
- `hide_title` - _(boolean)_
|
|
- `hide_rank` - _(boolean)_
|
|
- `hide_border` - _(boolean)_
|
|
- `show_icons` - _(boolean)_
|
|
- `include_all_commits` - 今年度のコミット数だけでなく、コミット数の総数をカウントする _(boolean)_
|
|
- `count_private` - プライベートリポジトリへのコミットをカウントする _(boolean)_
|
|
- `line_height` - テキストの行の高さ _(number)_
|
|
|
|
#### Repo Card だけに存在するオプション
|
|
|
|
- `show_owner` - リポジトリのオーナーを表示する _(boolean)_
|
|
|
|
#### Language Card だけに存在するオプション
|
|
|
|
- `hide` - 特定の言語を隠す _(カンマ区切りで指定)_
|
|
- `hide_title` - _(boolean)_
|
|
- `hide_border` - _(boolean)_
|
|
- `layout` - `default` か `compact` のいずれかのレイアウトに切り替える
|
|
- `card_width` - カードの横幅 _(number)_
|
|
|
|
> :warning: **重要:**
|
|
> [Percent Encoding](https://en.wikipedia.org/wiki/Percent-encoding) で指定されているように、プログラミング言語の名前は URL エンコードされている必要があります。
|
|
> (例: `c++` は `c%2B%2B`, `jupyter notebook` は `jupyter%20notebook`, など)
|
|
|
|
---
|
|
|
|
# GitHub Extra Pins
|
|
|
|
GitHub extra pins を使うと、GitHub の readme プロフィールを使って、自分のプロフィールに 6 つ以上のリポジトリをピン留めすることができます。
|
|
|
|
やったー! もはや、リポジトリをピン留めできる数が 6 つに制限されることはありません。
|
|
|
|
### 使い方
|
|
|
|
以下のコードをあなたの readme にコピー & ペーストし、リンクを変更してください。
|
|
|
|
エンドポイント: `api/pin?username=anuraghazra&repo=github-readme-stats`
|
|
|
|
```md
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
```
|
|
|
|
### デモ
|
|
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
|
|
リポジトリのオーナーのユーザー名を含める場合は、show_owner 変数を使用します。
|
|
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
|
|
# Top Languages Card
|
|
|
|
Top languages card には、その GitHub ユーザーが最も利用している Top languages が表示されます。
|
|
|
|
_NOTE: Top languages は、ユーザのスキルレベルを示すものではなく、GitHub 上でどの言語で最も多くのコードを書いているかを示す GitHub の指標です。_
|
|
|
|
### 使い方
|
|
|
|
以下のコードをあなたの readme にコピー & ペーストし、リンクを変更してください。
|
|
|
|
エンドポイント: `api/top-langs?username=anuraghazra`
|
|
|
|
```md
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
```
|
|
|
|
### 特定の言語を隠す
|
|
|
|
クエリパラメータ `?hide=language1,language2` 使用することで、特定の言語を非表示にすることができます。
|
|
|
|
```md
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
```
|
|
|
|
### レイアウトをコンパクトにする
|
|
|
|
クエリパラメータ `&layout=compact` を使用することで、カードのデザインを変更することができます。
|
|
|
|
```md
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
```
|
|
|
|
### デモ
|
|
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
|
|
- Compact layout の場合
|
|
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
|
|
---
|
|
|
|
### 全てのデモ
|
|
|
|
- デフォルト
|
|
|
|
|
|
|
|
- 特定の統計情報を隠す
|
|
|
|
|
|
|
|
- アイコンを表示する
|
|
|
|
|
|
|
|
- コミット数の総数をカウントする
|
|
|
|
|
|
|
|
- テーマの変更
|
|
|
|
任意の[テーマ](#themes)を選択できます。
|
|
|
|
|
|
|
|
- グラデーション
|
|
|
|
|
|
|
|
- stats card のカスタマイズ
|
|
|
|
|
|
|
|
- repo card のカスタマイズ
|
|
|
|
|
|
|
|
- Top languages
|
|
|
|
[](https://github.com/anuraghazra/github-readme-stats)
|
|
|
|
---
|
|
|
|
### クイックヒント (カードを並べる)
|
|
|
|
通常、画像を並べてレイアウトすることはできません。画像を並べるには、以下のような方法があります。
|
|
|
|
```md
|
|
<a href="https://github.com/anuraghazra/github-readme-stats">
|
|
<img align="center" src="https://github-readme-stats.vercel.app/api/pin/?username=anuraghazra&repo=github-readme-stats" />
|
|
</a>
|
|
<a href="https://github.com/anuraghazra/convoychat">
|
|
<img align="center" src="https://github-readme-stats.vercel.app/api/pin/?username=anuraghazra&repo=convoychat" />
|
|
</a>
|
|
```
|
|
|
|
## 自分の Vercel インスタンスにデプロイする
|
|
|
|
#### [@codeSTACKr によるチュートリアルはこちら](https://youtu.be/n6d4KHSKqGk?t=107)
|
|
|
|
GitHub API は 1 時間あたり 5k リクエストしか受け付けていないので、私の `https://github-readme-stats.vercel.app/api` がレートリミッターを超えてしまう可能性があります。自分の Vercel サーバーでホストしているのであれば、何も心配する必要はありません。デプロイボタンをクリックして始めましょう！
|
|
|
|
NOTE: [#58](https://github.com/anuraghazra/github-readme-stats/pull/58) 以降は 5k 以上のリクエストに対応できるようになり、ダウンタイムの問題もなくなりました :smile:
|
|
|
|
[](https://vercel.com/import/project?template=https://github.com/anuraghazra/github-readme-stats)
|
|
|
|
<details>
|
|
<summary>Vercelの設定ガイド</summary>
|
|
|
|
1. [vercel.com](https://vercel.com/)に行きます。
|
|
1. `Log in`をクリックします。
|
|
|
|
1. `Continue with GitHub` を押して GitHub にサインインします。
|
|
|
|
1. GitHub にサインインし、すべてのリポジトリへのアクセスを許可します。
|
|
1. このリポジトリをフォークします。
|
|
1. [Vercel dashboard](https://vercel.com/dashboard)に戻ります。
|
|
1. `Import Project` を選択します。
|
|
|
|
1. `Import Git Repository` を選択します。
|
|
|
|
1. root を選択して、すべてをそのままにしておき、PAT_1 という名前の環境変数を（下図のように）追加します。これには個人アクセストークン (PAT) が含まれており、[ここ](https://github.com/settings/tokens/new)で簡単に作成することができます (すべてをそのままにしておいて、何かに名前を付けてください。)
|
|
|
|
1. デプロイをクリックすれば完了です。API を使用するためにあなたのドメインを参照してください!
|
|
|
|
</details>
|
|
|
|
## :sparkling_heart: このプロジェクトを支援する
|
|
|
|
私はできる限りのことをオープンソースで行い、また、このプロジェクトを利用する上で困っている皆さん全員に返信するようにしています。もちろん返信には時間が掛かる場合がありますが。
|
|
このプロジェクトは無料でご利用いただけます。
|
|
|
|
しかしながら、もしあなたがこのプロジェクトに満足しているのであれば、あるいはただ、私がソフトウェアを作り続けるよう励ましたいのであれば、いくつかの方法があります。
|
|
|
|
- あなたの readme で github-readme-stats を使用して適切なクレジットを付与し、それにリンクします :smile:
|
|
- このプロジェクトにスターを贈り、他の人達にもシェアしてください :rocket:
|
|
- [](https://www.paypal.me/anuraghazra) - PayPal を介して 1 回限りの寄付を行うことができます。私はおそらく ~~コーヒー~~ お茶を買うでしょう。 :tea:
|
|
|
|
Thanks! :heart:
|
|
|
|
---
|
|
|
|
|
|
|
|
コントリビュートは大歓迎です！ :heart_eyes:
|
|
|
|
このプロジェクトは :heart: と JavaScript で作られています。
|