mirror of
https://github.com/reiyua/github-profile-trophy-reiyua-mirror.git
synced 2026-11-17 06:02:09 +11:00
375 lines
9.7 KiB
Markdown
375 lines
9.7 KiB
Markdown
<p align="center">
|
|
<img width="140" src="https://user-images.githubusercontent.com/6661165/91657958-61b4fd00-eb00-11ea-9def-dc7ef5367e34.png" />
|
|
<h2 align="center">Github Profile Trophy</h2>
|
|
<p align="center">🏆 Add dynamically generated GitHub Trophy on your readme</p>
|
|
</p>
|
|
<p align="center">
|
|
<a href="https://github.com/ryo-ma/github-profile-trophy/issues">
|
|
<img src="https://img.shields.io/github/issues/ryo-ma/github-profile-trophy"/>
|
|
</a>
|
|
<a href="https://github.com/ryo-ma/github-profile-trophy/network/members">
|
|
<img src="https://img.shields.io/github/forks/ryo-ma/github-profile-trophy"/>
|
|
</a>
|
|
<a href="https://github.com/ryo-ma/github-profile-trophy/stargazers">
|
|
<img src="https://img.shields.io/github/stars/ryo-ma/github-profile-trophy"/>
|
|
</a>
|
|
<a href="https://github.com/ryo-ma/github-profile-trophy/LICENSE">
|
|
<img src="https://img.shields.io/github/license/ryo-ma/github-profile-trophy"/>
|
|
</a>
|
|
</p>
|
|
<p align="center">
|
|
</a>
|
|
<a href="https://twitter.com/intent/tweet?text=Add%20dynamically%20generated%20GitHub%20Trophy%20on%20your%20readme%0D%0A&url=https%3A%2F%2Fgithub.com%2Fryo-ma%2Fgithub-profile-trophy">
|
|
<img src="https://img.shields.io/twitter/url?style=social&url=https%3A%2F%2Fgithub.com%2Fryo-ma%2Fgithub-profile-trophy"/>
|
|
</a>
|
|
</p>
|
|
|
|
|
|
|
|
# Quick Start
|
|
|
|
Add following code to your readme.
|
|
Change the `?username=` value to your GitHub's username.
|
|
|
|
```
|
|
[](https://github.com/ryo-ma/github-profile-trophy)
|
|
```
|
|
|
|
<p align="center">
|
|
<img alig src="https://github-profile-trophy.vercel.app/?username=ryo-ma&column=6&rank=SSS,SS,S,AAA,AA,A,B,C" />
|
|
</p>
|
|
|
|
## Use theme
|
|
|
|
Add optional parameter of theme.
|
|
|
|
```
|
|
[](https://github.com/ryo-ma/github-profile-trophy)
|
|
```
|
|
<p align="center">
|
|
<img width="660" src="https://user-images.githubusercontent.com/6661165/92327052-d99b9e00-f091-11ea-9a24-c7ec86982370.png">
|
|
</p>
|
|
|
|
**[More detail](#apply-theme)**
|
|
|
|
# About Rank
|
|
|
|
Ranks are `SSS` `SS` `S` `AAA` `AA` `A` `B` `C` `UNKNOWN` `SECRET`.
|
|
|
|
| Rank | Description |
|
|
| ---- | ---- |
|
|
| SSS, SS, S | You are at a hard to reach rank. You can brag. |
|
|
| AAA, AA, A | You can reach the rank if you do your best. Let's aim here first. |
|
|
| B, C | You are in a growing process. |
|
|
| UNKOWN | You have not yet taken action. Let's act first. |
|
|
| SECRET | The rank is very rare. The trophy will not be displayed until the conditions are met. |
|
|
|
|
## Secret Rank
|
|
The acquisition condition is secret, but you can know the condition by reading this code.
|
|
|
|
<p align="center">
|
|
<img width="110" src="https://user-images.githubusercontent.com/6661165/91643641-28cd4780-ea70-11ea-94a9-a51885252700.png" />
|
|
</p>
|
|
|
|
There are still few secret trophies.
|
|
Therefore, if you come up with interesting conditions, I am waiting for contributions.
|
|
|
|
# About Display details
|
|
|
|
<p align="center">
|
|
<img width="220" src="https://user-images.githubusercontent.com/6661165/91642962-6333e600-ea6a-11ea-83af-e371e996bfa6.png" />
|
|
</p>
|
|
|
|
1. Title name of aggregation target.
|
|
2. Current Rank.
|
|
3. Title according to rank.
|
|
4. Target aggregation result.
|
|
5. Next Rank Bar. The road from the current rank to the next rank.
|
|
|
|
|
|
# Optional Request Parameters
|
|
|
|
* [title](#filter-by-titles)
|
|
* [rank](#filter-by-ranks)
|
|
* [column](#specify-the-maximum-row--column-size)
|
|
* [row](#specify-the-maximum-row--column-size)
|
|
* [theme](#apply-theme)
|
|
* [margin-w](#margin-width)
|
|
* [margin-h](#margin-height)
|
|
* [no-bg](#transpalent-background)
|
|
* [no-frame](#hide-frame)
|
|
|
|
|
|
## Filter by titles
|
|
|
|
You can filter the display by specifying the titles of trophy.
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&title=Followers
|
|
```
|
|
|
|
<p align="center">
|
|
<img width="110" src="https://user-images.githubusercontent.com/6661165/92317141-80ebe700-f038-11ea-8501-4015bfbb2cf4.png">
|
|
</p>
|
|
|
|
If You want to specify multiple titles.
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&title=Stars,Followers
|
|
```
|
|
|
|
## Filter by ranks
|
|
|
|
You can filter the display by specifying the ranks.
|
|
`Available values: SECRET SSS SS S AAA AA A B C`
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&rank=S
|
|
```
|
|
<p align="center">
|
|
<img width="110" src="https://user-images.githubusercontent.com/6661165/91642657-1cdd8780-ea68-11ea-994b-4568a55cd22a.png" />
|
|
</p>
|
|
|
|
If you want to specify multiple ranks.
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&rank=S,AAA
|
|
```
|
|
|
|
## Specify the maximum row & column size
|
|
|
|
You can specify the maximum row and column size.
|
|
Trophy will be hidden if it exceeds the range of both row and column.
|
|
|
|
`Available value: number type`
|
|
`Default: column=6 row=3`
|
|
|
|
Restrict only row
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&row=2
|
|
```
|
|
|
|
Restrict only column
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&column=2
|
|
```
|
|
|
|
Restrict row & column
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&row=2&column=3
|
|
```
|
|
|
|
<p align="center">
|
|
<img width="330" src="https://user-images.githubusercontent.com/6661165/91659474-c07f7400-eb0a-11ea-84f2-eb6b42547829.png">
|
|
</p>
|
|
|
|
## Apply theme
|
|
|
|
Available themes.
|
|
|
|
| theme |
|
|
| ---- |
|
|
| [flat](#flat) |
|
|
| [onedark](#onedark) |
|
|
| [gruvbox](#gruvbox) |
|
|
| [dracula](#dracula) |
|
|
| [monokai](#monokai) |
|
|
| [chalk](#chalk) |
|
|
| [nord](#nord) |
|
|
| [alduin](#alduin) |
|
|
| [darkhub](#darkhub) |
|
|
| [juicyfresh](#juicyfresh) |
|
|
|
|
### flat
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&theme=flat
|
|
```
|
|
<p align="center">
|
|
<img width="660" src="https://user-images.githubusercontent.com/6661165/92325601-039b9300-f087-11ea-983a-fce8133549ee.png">
|
|
</p>
|
|
|
|
### onedark
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&theme=onedark
|
|
```
|
|
|
|
<p align="center">
|
|
<img width="660" src="https://user-images.githubusercontent.com/6661165/92327052-d99b9e00-f091-11ea-9a24-c7ec86982370.png">
|
|
</p>
|
|
|
|
### gruvbox
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&theme=gruvbox
|
|
```
|
|
|
|
<p align="center">
|
|
<img width="660" src="https://user-images.githubusercontent.com/6661165/92315152-e9c56600-f01c-11ea-9536-1bfbb158cfcb.png">
|
|
</p>
|
|
|
|
### dracula
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&theme=dracula
|
|
```
|
|
|
|
<p align="center">
|
|
<img width="660" src="https://user-images.githubusercontent.com/6661165/92490273-c91f2b00-f22b-11ea-9481-b5daae4d7bc3.png">
|
|
</p>
|
|
|
|
### monokai
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&theme=monokai
|
|
```
|
|
|
|
<p align="center">
|
|
<img width="660" src="https://user-images.githubusercontent.com/6661165/93725426-2c289e80-fbea-11ea-96a4-f6490ccf2126.png">
|
|
</p>
|
|
|
|
### chalk
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&theme=chalk
|
|
```
|
|
|
|
<p align="center">
|
|
<img width="660" src="https://user-images.githubusercontent.com/6661165/94294003-1de7d300-ff9a-11ea-91d1-60417a4d919b.png">
|
|
</p>
|
|
|
|
### nord
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&theme=nord
|
|
```
|
|
|
|
<p align="center">
|
|
<img width="660" src="https://user-images.githubusercontent.com/6661165/94346857-7ab2be80-006a-11eb-9082-36d377ae2531.png">
|
|
</p>
|
|
|
|
|
|
### alduin
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&theme=alduin
|
|
```
|
|
|
|
<p align="center">
|
|
<img width="660" src="https://user-images.githubusercontent.com/6661165/99085932-2a88bf00-260c-11eb-9b26-d2f125773831.png">
|
|
</p>
|
|
|
|
### darkhub
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&theme=darkhub
|
|
```
|
|
|
|
<p align="center">
|
|
<img width="660" src="https://user-images.githubusercontent.com/6661165/102801126-249ab080-43f8-11eb-91c8-f56f94c35777.png">
|
|
</p>
|
|
|
|
### juicyfresh
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&theme=juicyfresh
|
|
```
|
|
|
|
<p align="center">
|
|
<img width="660" src="https://user-images.githubusercontent.com/6661165/104810094-edbc8c80-5835-11eb-8c20-a76192a00728.png">
|
|
</p>
|
|
|
|
## Margin Width
|
|
|
|
You can put a margin in the width between trophies.
|
|
`Available value: number type`
|
|
`Default: margin-w=0`
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&margin-w=15
|
|
```
|
|
|
|
<p align="center">
|
|
<img width="735" src="https://user-images.githubusercontent.com/6661165/93668661-e0ca9f00-fac8-11ea-9bec-325454f49fb4.png">
|
|
</p>
|
|
|
|
## Margin Height
|
|
|
|
You can put a margin in the height between trophies.
|
|
`Available value: number type`
|
|
`Default: margin-h=0`
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&margin-h=15
|
|
```
|
|
|
|
## Example layout
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&column=3&margin-w=15&margin-h=15
|
|
```
|
|
|
|
<p align="center">
|
|
<img width="360" src="https://user-images.githubusercontent.com/6661165/93668677-ff309a80-fac8-11ea-8ae3-3e3e8adbef39.png">
|
|
</p>
|
|
|
|
## Transpalent background
|
|
|
|
You can turn the background transparent.
|
|
`Available value: boolean type (true or false)`
|
|
`Default: no-bg=false`
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&no-bg=true
|
|
```
|
|
|
|
## Hide frames
|
|
|
|
You can hide the frames around the trophies.
|
|
`Available value: boolean type (true or false)`
|
|
`Default: no-frame=false`
|
|
|
|
```
|
|
https://github-profile-trophy.vercel.app/?username=ryo-ma&no-frame=true
|
|
```
|
|
|
|
# Contribution Guide
|
|
|
|
## Environment
|
|
|
|
* Deno >= v1.3.0
|
|
* typescript == 3.9.7
|
|
* [Vercel](https://vercel.com/)
|
|
* GitHub API v4
|
|
|
|
## Local Run
|
|
|
|
Create `.env` file to project root directory, and write your GitHub token to the `.env` file.
|
|
Please select the authority of `repo` when creating token.
|
|
|
|
```
|
|
GITHUB_TOKEN=XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
|
|
```
|
|
|
|
Run local server.
|
|
|
|
```
|
|
deno run --allow-net --allow-read --allow-env debug.ts
|
|
```
|
|
|
|
Open localhost from your browser.
|
|
|
|
http://localhost:8080/?username=ryo-ma
|
|
|
|
## Editor config
|
|
|
|
Read the [.editorconfig](./.editorconfig)
|
|
|
|
## Run deno lint
|
|
|
|
If you want to contribute to my project, you should check the lint with the following command.
|
|
|
|
```
|
|
deno lint --unstable
|
|
```
|