sudacode/metrics
1
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Update README.md

Browse Source
This commit is contained in:
Simon Lecoq
2020-12-08 13:25:59 +01:00
committed by GitHub
parent 133a9e8d5c
commit f1e8ee16fb
1 changed files with 36 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files

73
README.md
View File

@@ -30,9 +30,9 @@ Try it now at [metrics.lecoq.io](https://metrics.lecoq.io/) with your GitHub use
Because some plugins required additional configuration and setup, not all of them are available at [metrics.lecoq.io](https://metrics.lecoq.io/), for a fully-featured experience, consider using this as a [GitHub Action](https://github.com/marketplace/actions/github-metrics-as-svg-image) ! Because some plugins required additional configuration and setup, not all of them are available at [metrics.lecoq.io](https://metrics.lecoq.io/), for a fully-featured experience, consider using this as a [GitHub Action](https://github.com/marketplace/actions/github-metrics-as-svg-image) !
## 📜 How to use ? # 📜 How to use ?
### ⚙️ Using GitHub Action on your profile repo (~5 min setup) ## ⚙️ Using GitHub Action on your profile repo (~5 min setup)
Setup a GitHub Action which is run periodically and push a generated SVG image on your repository. Setup a GitHub Action which is run periodically and push a generated SVG image on your repository.
See all supported options in [action.yml](https://github.com/lowlighter/metrics/blob/master/action.yml). See all supported options in [action.yml](https://github.com/lowlighter/metrics/blob/master/action.yml).
@@ -46,7 +46,7 @@ Assuming your username is `my-github-user`, you can then embed your metrics in y
<details> <details>
<summary>💬 How to setup ?</summary> <summary>💬 How to setup ?</summary>
#### 0. Prepare your personal repository ### 0. Prepare your personal repository
If you don't know yet or haven't done it yet, create a repository with the same name as your GitHub username. If you don't know yet or haven't done it yet, create a repository with the same name as your GitHub username.
@@ -56,7 +56,7 @@ The `README.md` of this repository will be displayed on your GitHub user profile
![GitHub Profile](https://github.com/lowlighter/metrics/blob/master/.github/readme/imgs/github_profile.png) ![GitHub Profile](https://github.com/lowlighter/metrics/blob/master/.github/readme/imgs/github_profile.png)
#### 1. Setup a GitHub token ### 1. Setup a GitHub token
Go to `Developer settings` from your GitHub account settings and select `Personal access tokens` to create a new token. Go to `Developer settings` from your GitHub account settings and select `Personal access tokens` to create a new token.
@@ -66,13 +66,13 @@ You'll need to create a token with the `public_repo` right so this GitHub Action
If you choose to use a bot account, you can put `public_repo` rights to the bot token and invite it as a collaborator on your personal profile repository so it has push access. This way, you can use a personnal token with no rights instead and reduce security issues. If you choose to use a bot account, you can put `public_repo` rights to the bot token and invite it as a collaborator on your personal profile repository so it has push access. This way, you can use a personnal token with no rights instead and reduce security issues.
#### 2. Put your GitHub token in your personal repository secrets ### 2. Put your GitHub token in your personal repository secrets
Go to the `Settings` of your personal repository to create a new secret and paste your GitHub token here. Go to the `Settings` of your personal repository to create a new secret and paste your GitHub token here.
![Setup secret](https://github.com/lowlighter/metrics/blob/master/.github/readme/imgs/repo_secrets.png) ![Setup secret](https://github.com/lowlighter/metrics/blob/master/.github/readme/imgs/repo_secrets.png)
#### 3. Create a new GitHub Action workflow on your personal repo ### 3. Create a new GitHub Action workflow on your personal repo
Create a new workflow from the `Actions` tab of your personal repository and paste the following : Create a new workflow from the `Actions` tab of your personal repository and paste the following :
@@ -110,7 +110,7 @@ If you don't want to use a bot token, you can use the `plugin_selfskip` which wi
If you're using a token with additional permissions, it is advised to fork this repository. If it ever gets compromised, you'll be safe. If you're using a token with additional permissions, it is advised to fork this repository. If it ever gets compromised, you'll be safe.
But don't forget to check it from time to time for new features ! But don't forget to check it from time to time for new features !
#### 4. Embed the link into your README.md ### 4. Embed the link into your README.md
Edit your README.md on your repository and link it your image : Edit your README.md on your repository and link it your image :
@@ -120,7 +120,7 @@ Edit your README.md on your repository and link it your image :
</details> </details>
### 💕 Using the shared instance (~1 min setup, but with limitations) ## 💕 Using the shared instance (~1 min setup, but with limitations)
For conveniency, you can use the shared instance available at [metrics.lecoq.io](https://metrics.lecoq.io) without any additional setup. For conveniency, you can use the shared instance available at [metrics.lecoq.io](https://metrics.lecoq.io) without any additional setup.
@@ -145,7 +145,7 @@ If you're appreciating this project, consider using it as a GitHub Action or dep
</details> </details>
### 🏗️ Deploying your own instance (~15 min setup, depending on your sysadmin knowledge) ## 🏗️ Deploying your own instance (~15 min setup, depending on your sysadmin knowledge)
You can setup your own instance if you choose to not use the GitHub Action or you want to allow others users to use your instance. You can setup your own instance if you choose to not use the GitHub Action or you want to allow others users to use your instance.
@@ -158,18 +158,18 @@ See all supported options in [settings.example.json](https://github.com/lowlight
<details> <details>
<summary>💬 How to setup ?</summary> <summary>💬 How to setup ?</summary>
#### 0. Prepare your server ### 0. Prepare your server
You'll need a server where you can install and configure apps. You'll need a server where you can install and configure apps.
#### 1. Create a GitHub token ### 1. Create a GitHub token
In your account settings, go to `Developer settings` and select `Personal access tokens` to create a new token. In your account settings, go to `Developer settings` and select `Personal access tokens` to create a new token.
As explained above, you do not need to grant additional permissions to the token unless you want to enable additional plugins. As explained above, you do not need to grant additional permissions to the token unless you want to enable additional plugins.
![Create a GitHub token](https://github.com/lowlighter/metrics/blob/master/.github/readme/imgs/personal_token_alt.png) ![Create a GitHub token](https://github.com/lowlighter/metrics/blob/master/.github/readme/imgs/personal_token_alt.png)
#### 2. Install the dependancies ### 2. Install the dependancies
Connect to your server and ensure [NodeJS](https://nodejs.org/en/) is installed (see tested versions in the [build workflows](https://github.com/lowlighter/metrics/blob/master/.github/workflows/build.yml)). Connect to your server and ensure [NodeJS](https://nodejs.org/en/) is installed (see tested versions in the [build workflows](https://github.com/lowlighter/metrics/blob/master/.github/workflows/build.yml)).
@@ -185,7 +185,7 @@ npm install --only=prod
cp settings.example.json settings.json cp settings.example.json settings.json
``` ```
#### 3. Configure your instance ### 3. Configure your instance
Open and edit `settings.json` to configure your instance using a text editor of your choice. Open and edit `settings.json` to configure your instance using a text editor of your choice.
@@ -199,7 +199,7 @@ Open and edit `settings.json` to configure your instance using a text editor of
See all supported options in [settings.example.json](https://github.com/lowlighter/metrics/blob/master/settings.example.json). See all supported options in [settings.example.json](https://github.com/lowlighter/metrics/blob/master/settings.example.json).
#### 4. Start your instance ### 4. Start your instance
Start your instance once you've finished configuring it : Start your instance once you've finished configuring it :
@@ -209,7 +209,7 @@ npm start
And you should be able to access it on the port you provided ! And you should be able to access it on the port you provided !
#### 5. Embed the link into your README.md ### 5. Embed the link into your README.md
Edit your `README.md` on your repository and include your metrics from your server domain : Edit your `README.md` on your repository and include your metrics from your server domain :
@@ -217,7 +217,7 @@ Edit your `README.md` on your repository and include your metrics from your serv
![GitHub metrics](https://my-personal-domain.com/my-github-user) ![GitHub metrics](https://my-personal-domain.com/my-github-user)
``` ```
#### 6. (optional) Setup as service on your instance ### 6. (optional) Setup as service on your instance
If you want to ensure that your instance will be restarted after reboots or crashes, you should setup it as a service. If you want to ensure that your instance will be restarted after reboots or crashes, you should setup it as a service.
This is described below for linux-like systems with *systemd*. This is described below for linux-like systems with *systemd*.
@@ -285,9 +285,9 @@ For example, to configure `music` plugin, you could add the following to url : `
</details> </details>
## 📚 Documentations # 📚 Documentations
### 🖼️ Templates ## 🖼️ Templates
Templates allows you to style your metrics. Templates allows you to style your metrics.
The default is the classic one, but you can change it for something more stylish. The default is the classic one, but you can change it for something more stylish.
@@ -296,12 +296,12 @@ Some metrics may be displayed differently, and it is possible that not all plugi
Consider trying them at [metrics.lecoq.io](https://metrics.lecoq.io) ! Consider trying them at [metrics.lecoq.io](https://metrics.lecoq.io) !
### 🧩 Plugins ## 🧩 Plugins
Plugins are features which are disabled by default but they can provide additional metrics. Plugins are features which are disabled by default but they can provide additional metrics.
In return they may require additional configuration and tend to consume additional API requests. In return they may require additional configuration and tend to consume additional API requests.
#### 🗃️ Base content ### 🗃️ Base content
Generated metrics contains a few sections that are enabled by default, such as recent activity, community stats and repositories stats. Generated metrics contains a few sections that are enabled by default, such as recent activity, community stats and repositories stats.
This can be configured by explicitely opt-out from them. This can be configured by explicitely opt-out from them.
@@ -328,7 +328,7 @@ For example, to keep only `header` and `repositories` sections, add the followin
</details> </details>
#### ⏱️ PageSpeed ### ⏱️ PageSpeed
The *pagespeed* plugin allows you to add the performances of the website attached to the GitHub user account : The *pagespeed* plugin allows you to add the performances of the website attached to the GitHub user account :
@@ -355,11 +355,11 @@ Add the following to your workflow :
</details> </details>
#### 🎼 Music ### 🎼 Music
The *music* plugin can work in the following modes : The *music* plugin can work in the following modes :
##### Playlist mode #### Playlist mode
Select randomly a few tracks from a given playlist so you can suggest your favorite tracks to your visitors. Select randomly a few tracks from a given playlist so you can suggest your favorite tracks to your visitors.
@@ -432,7 +432,7 @@ Once you've extracted the embed url you can finish the setup by adding the follo
</details> </details>
##### Recently played mode #### Recently played mode
Display the track you played recently. Display the track you played recently.
@@ -524,7 +524,7 @@ Now that you've got your `client_id`, `client_secret` and `refresh_token` you ca
</details> </details>
#### 📅 Isometric calendar ### 📅 Isometric calendar
The *isocalendar* plugin allows you to display an isometric view of your commits calendar, along with a few stats like your current streak and your commit average per day. The *isocalendar* plugin allows you to display an isometric view of your commits calendar, along with a few stats like your current streak and your commit average per day.
@@ -556,7 +556,7 @@ It is possible to extend display a full-year by adding the following instead :
</details> </details>
#### 👨‍💻 Lines ### 👨‍💻 Lines
The *lines* of code plugin allows you to compute the number of lines of code you added and removed across all of your repositories. The *lines* of code plugin allows you to compute the number of lines of code you added and removed across all of your repositories.
@@ -577,7 +577,7 @@ Add the following to your workflow :
</details> </details>
#### 🧮 Traffic ### 🧮 Traffic
The repositories *traffic* plugin allows you to compute the number of pages views across your repositories. The repositories *traffic* plugin allows you to compute the number of pages views across your repositories.
@@ -604,7 +604,7 @@ Add the following to your workflow :
</details> </details>
#### 💡 Habits ### 💡 Habits
The coding *habits* plugin allows you to add deduced coding about based on your recent activity, from up to 100 events. The coding *habits* plugin allows you to add deduced coding about based on your recent activity, from up to 100 events.
@@ -629,7 +629,7 @@ Add the following to your workflow :
</details> </details>
#### ✒️ Posts ### ✒️ Posts
The recent *posts* plugin allows you to display recent articles you wrote on an external source, like [dev.to](https://dev.to). The recent *posts* plugin allows you to display recent articles you wrote on an external source, like [dev.to](https://dev.to).
@@ -652,7 +652,7 @@ Add the following to your workflow :
</details> </details>
#### 🎟️ Follow-up ### 🎟️ Follow-up
The *follow-up* plugin allows you to compute the ratio of opened/closed issues and the ratio of opened/merged pull requests on your repositories, which shows whether most of them are maintened or not. The *follow-up* plugin allows you to compute the ratio of opened/closed issues and the ratio of opened/merged pull requests on your repositories, which shows whether most of them are maintened or not.
@@ -671,7 +671,7 @@ Add the following to your workflow :
</details> </details>
#### 🈷️ Languages ### 🈷️ Languages
The *languages* plugin allows you to compute which languages you use the most in your repositories. The *languages* plugin allows you to compute which languages you use the most in your repositories.
@@ -690,7 +690,7 @@ Add the following to your workflow :
</details> </details>
#### 🎫 Gists ### 🎫 Gists
The *gists* plugin allows you to display [gists](https://gist.github.com) metrics. The *gists* plugin allows you to display [gists](https://gist.github.com) metrics.
@@ -711,7 +711,7 @@ Add the following to your workflow :
</details> </details>
#### 📌 Topics *Available in pre-release* ### 📌 Topics *(pre-release)*
The *topics* plugin allows you to display your [starred topics](https://github.com/stars?filter=topics). The *topics* plugin allows you to display your [starred topics](https://github.com/stars?filter=topics).
Check out [GitHub topics](https://github.com/topics) to search interesting topics. Check out [GitHub topics](https://github.com/topics) to search interesting topics.
@@ -741,8 +741,7 @@ Add the following to your workflow :
</details> </details>
### ⏭️ Selfskip
#### ⏭️ Selfskip
The *selfskip* plugin allows you to count out all commits tagged with `[Skip GitHub Action]` you authored on your personal repository from your reported commit counts. The *selfskip* plugin allows you to count out all commits tagged with `[Skip GitHub Action]` you authored on your personal repository from your reported commit counts.
@@ -761,7 +760,7 @@ Add the following to your workflow :
</details> </details>
### 💪 Contributing and customizing ## 💪 Contributing and customizing
If you would like to suggest a new feature, find a bug or need help, you can fill an [issue](https://github.com/lowlighter/metrics/issues) describing your problem. If you would like to suggest a new feature, find a bug or need help, you can fill an [issue](https://github.com/lowlighter/metrics/issues) describing your problem.
@@ -769,7 +768,7 @@ If you're motivated enough, you can submit a [pull request](https://github.com/l
Read [contributing.md](https://github.com/lowlighter/metrics/blob/master/CONTRIBUTING.md) for more information about this. Read [contributing.md](https://github.com/lowlighter/metrics/blob/master/CONTRIBUTING.md) for more information about this.
### 📖 Useful references ## 📖 Useful references
* [GitHub GraphQL API](https://docs.github.com/en/graphql) * [GitHub GraphQL API](https://docs.github.com/en/graphql)
* [GitHub GraphQL Explorer](https://developer.github.com/v4/explorer/) * [GitHub GraphQL Explorer](https://developer.github.com/v4/explorer/)