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

docs: update README [skip ci]

Browse Source
This commit is contained in:
lowlighter
2022-01-15 00:18:53 -05:00
parent de9f3e336e
commit 20f3f4c869
1 changed files with 73 additions and 818 deletions
Download Patch File Download Diff File Expand all files Collapse all files

867
README.md
View File

@@ -2,11 +2,7 @@
[![Build, test, analyze and publish](https://github.com/lowlighter/metrics/actions/workflows/workflow.yml/badge.svg)](https://github.com/lowlighter/metrics/actions/workflows/workflow.yml) [![Metrics (examples)](https://github.com/lowlighter/lowlighter/actions/workflows/metrics.yml/badge.svg)](https://github.com/lowlighter/lowlighter/actions/workflows/metrics.yml)
Generate your metrics that you can embed everywhere, including your GitHub profile readme! It works for both user and organization accounts, and even for repositories!
> <sup>*⚠️ This is the documentation of **v3.18-beta** (`@master` branch) which includes [unreleased features](https://github.com/lowlighter/metrics/compare/latest...master), see documentation of [**v3.17** (`@latest` branch) here](https://github.com/lowlighter/metrics/blob/latest/README.md).*</sup>
Generate metrics that can be embedded everywhere, including your GitHub profile readme! For users, organizations, and even repositories!
<table>
<tr>
@@ -23,15 +19,9 @@ Generate your metrics that you can embed everywhere, including your GitHub profi
<img width="900" height="1" alt="">
</td>
</tr>
</table>
And you can customize these heavily with plugins, templates and hundreds of options!
<table>
<tr>
<th colspan="2" align="center">
<a href="source/plugins/README.md">🧩 35+ plugins</a>
<a href="/source/plugins/README.md">🧩 Customizable with 38 plugins and 234 options!</a>
</th>
</tr>
<tr>
@@ -384,70 +374,57 @@ And you can customize these heavily with plugins, templates and hundreds of opti
</tr>
<tr>
<th colspan="2" align="center">
<a href="https://github.com/lowlighter/metrics#-community-plugins">🎲 Community plugins</a>
<a href="/#-plugins">🎲 See also community plugins</a>
</th>
</tr>
</table>
<table>
<tr>
<th colspan="2" align="center">
<a href="source/templates/README.md">🖼️ 4+ templates</a>
<a href="/source/templates/README.md">🖼️ And even more with 4+ templates!</a>
</th>
</tr>
<tr>
<th><a href="source/templates/classic/README.md">📗 Classic template</a></th>
<th><a href="source/templates/repository/README.md">📘 Repository template</a></th>
<th><a href="/source/templates/classic/README.md">📗 Classic template</a></th>
<th><a href="/source/templates/repository/README.md">📘 Repository template</a></th>
</tr>
<tr>
<td align="center">
<img alt="" width="400" src="https://github.com/lowlighter/lowlighter/blob/master/metrics.classic.svg">
<img alt="" width="400" src="https://github.com/lowlighter/lowlighter/blob/master/metrics.classic.svg" alt=""></img>
<img width="900" height="1" alt="">
</td>
<td align="center">
<img alt="" width="400" src="https://github.com/lowlighter/lowlighter/blob/master/metrics.repository.svg">
<img alt="" width="400" src="https://github.com/lowlighter/lowlighter/blob/master/metrics.repository.svg" alt=""></img>
<img width="900" height="1" alt="">
</td>
</tr>
<tr>
<th><a href="source/templates/terminal/README.md">📙 Terminal template</a></th>
<th><a href="source/templates/markdown/README.md">📒 Markdown template</a></th>
<th><a href="/source/templates/terminal/README.md">📙 Terminal template</a></th>
<th><a href="/source/templates/markdown/README.md">📒 Markdown template</a></th>
</tr>
<tr>
<td align="center">
<img alt="" width="400" src="https://github.com/lowlighter/lowlighter/blob/master/metrics.terminal.svg">
<img alt="" width="400" src="https://github.com/lowlighter/lowlighter/blob/master/metrics.terminal.svg" alt=""></img>
<img width="900" height="1" alt="">
</td>
<td align="center">
<img alt="" width="400" src="https://github.com/lowlighter/lowlighter/blob/master/metrics.markdown.png">
<img alt="" width="400" src="https://github.com/lowlighter/lowlighter/blob/master/metrics.markdown.png" alt=""></img>
<img width="900" height="1" alt="">
</td>
</tr>
<tr>
<th colspan="2"><a href="source/templates/community/README.md">📕 Community templates</a></th>
<th colspan="2"><a href="/source/templates/community/README.md">📕 See also community templates</a></th>
</tr>
<tr>
<td align="center" colspan="2">See <a href="/source/templates/community/README.md">documentation</a> 🌍</td>
<th colspan="2"><h2>🦑 Try it now!</h2></th>
</tr>
</table>
## 🦑 Interested to get your own?
For a fully-featured experience you should use **metrics** as a [GitHub Action](https://github.com/marketplace/actions/metrics-embed), but you can also try it now at [metrics.lecoq.io](https://metrics.lecoq.io/) with your GitHub username!
Choose `📊 Metrics embed` if you want to customize your GitHub profile and `✨ Metrics insights` to get a quick overview of your GitHub statistics:
<table>
<tr>
<th><a href="https://metrics.lecoq.io">📊 Metrics embed</a></th>
<th><a href="https://metrics.lecoq.io/about">✨ Metrics insights</a></th>
</tr>
<tr>
<td align="center">
Embed metrics images on your profile readme or blog!<br>
Use GitHub actions for even more features!<br>
Embed metrics images on your profile or blog!<br>
Use <a href="https://github.com/marketplace/actions/metrics-embed">GitHub actions</a> for even more features!<br>
<img src="/.github/readme/imgs/features_embed.gif" width="441">
</td>
<td align="center">
@@ -456,690 +433,45 @@ Choose `📊 Metrics embed` if you want to customize your GitHub profile and `
<img src="/.github/readme/imgs/features_insights.gif" width="441">
</td>
</tr>
<tr>
<td align="center" colspan="2">
<b>Power user?</b><br>
<a href="https://github.com/lowlighter/metrics/fork">Fork this repository</a> and edit HTML, CSS, JS and <a href="https://github.com/mde/ejs"> for even more customization!
</td>
</tr>
</table>
### 🐙 Features
* Create infographics from **38 plugins**, **4 templates** and **233 options**
* Even more **customization** with [community templates](source/templates/community) or by [forking this repository](https://github.com/lowlighter/metrics/network/members) and editing HTML/CSS/EJS
* Support **users**, **organizations** and even **repositories**
* Transparent by default so it'll blend well whether light or dark mode is used
* Save your metrics as **images** (SVG, PNG or JPEG), **markdown**, **PDF** or **JSON**
* Upload them to GitHub through commits, pull requests and gists, or handle renders yourself
* Works either as [GitHub action](https://github.com/marketplace/actions/metrics-embed) or as [web instance](https://metrics.lecoq.io)
# 📜 How to use?
## ⚙️ Using GitHub Action on your profile repository (~5 min setup)
Setup a GitHub Action which runs periodically and pushes your generated metrics image to your repository.
See all supported options in [action.yml](/action.yml).
Assuming your username is `my-github-user`, you can then embed rendered metrics in your readme like below:
```markdown
<!-- If you're using "master" as default branch -->
![Metrics](https://github.com/my-github-user/my-github-user/blob/master/github-metrics.svg)
<!-- If you're using "main" as default branch -->
![Metrics](https://github.com/my-github-user/my-github-user/blob/main/github-metrics.svg)
```
<details>
<summary><b>💬 How to setup?</b> <i>(click to expand)</i></summary>
<!-- -->
### 0. Setup your personal repository
Create a repository with the same name as your GitHub login (if it's not already done).
![Setup personal repository](/.github/readme/imgs/setup_personal_repository.png)
Its `README.md` will be displayed on your user profile:
![GitHub Profile Example](/.github/readme/imgs/example_github_profile.png)
### 1. Create a GitHub personal token
From the `Developer settings` of your account settings, select `Personal access tokens` to create a new token.
No additional scopes are needed for basic metrics, but you may have to grant additional scope depending on what features you're planning to use:
- `public_repo` scope for some plugins
- `read:org` scope for all organizations related metrics
- `repo` scope for all private repositories related metrics
- `read:user` scope may also be required for some private repositories related metrics
![Setup a GitHub personal token](/.github/readme/imgs/setup_personal_token.png)
A scope-less token can still display private contributions by enabling `Include private contributions on my profile` in your account settings:
![Enable "Include private contributions on my profile`"](/.github/readme/imgs/setup_private_contributions.png)
If a plugin has not enough scopes to operate (and `plugins_errors_fatal` isn't enabled), it'll be reported in the rendering like below:
![Plugin error example](https://github.com/lowlighter/lowlighter/blob/master/metrics.plugin.error.svg)
### 2. Put your GitHub personal token in your repository secrets
Go to the `Settings` of your repository to create a new secret and paste your freshly generated GitHub token there.
![Setup a repository secret](/.github/readme/imgs/setup_repository_secret.png)
### 3. Create a GitHub Action workflow in your repository
Create a new workflow from the `Actions` tab of your repository and paste the following:
```yaml
name: Metrics
on:
# Schedule updates (each hour)
schedule: [{cron: "0 * * * *"}]
# Lines below let you run workflow manually and on each commit (optional)
workflow_dispatch:
push: {branches: ["master", "main"]}
jobs:
github-metrics:
runs-on: ubuntu-latest
steps:
# See action.yml for all options
- uses: lowlighter/metrics@latest
with:
# Your GitHub token
token: ${{ secrets.METRICS_TOKEN }}
```
See all supported options in [action.yml](/action.yml).
Rendered metrics will be committed to your repository on each run.
![Action update example](/.github/readme/imgs/example_action_update.png)
#### Choosing between `@latest`, `@master` or a fork
If you wish to use new features as they're being released, you can switch from `@latest` to `@master`.
As the latter is used as a development branch, jobs may fail from time to time (although we try to mitigate this).
For convenience, it is possible to use `@main` instead of `@master`.
When using a token with additional permissions, it is advised to fork this repository and use it instead to minimize security risks:
```yaml
- uses: my-github-username/metrics@master
# If you make changes on your fork, be sure not leave @latest as tag!
```
In this case, please consider watching new releases to stay up-to-date and enjoy latest features!
`@latest` will be updated on each release. Metrics doesn't introduce breaking changes **from an user point of view** (i.e. your workflows will always be valid) so you can follow release cycles without worrying.
#### Examples workflows
Metrics displayed on this page are rendered from this [workflow](https://github.com/lowlighter/lowlighter/blob/master/.github/workflows/metrics.yml) so you can check it out for some code examples about plugins usage.
You can also take a look at this [user workflow](https://github.com/lowlighter/lowlighter/blob/master/.github/workflows/personal.yml) if you want.
### 4. Embed link into your README.md
Update your README.md to embed your metrics:
```markdown
<!-- If you're using "master" as default branch -->
![Metrics](https://github.com/my-github-user/my-github-user/blob/master/github-metrics.svg)
<!-- If you're using "main" as default branch -->
![Metrics](https://github.com/my-github-user/my-github-user/blob/main/github-metrics.svg)
<!-- If you're using the "columns" display mode -->
<img src="https://github.com/my-github-user/my-github-user/blob/master/github-metrics.svg" alt="Metrics" width="100%">
```
</details>
## 💕 Using the shared instance (~1 min setup, but with limitations)
For convenience, you can use the shared instance available at [metrics.lecoq.io](https://metrics.lecoq.io) without any additional setup.
```markdown
![Metrics](https://metrics.lecoq.io/my-github-user)
```
This is mostly intended for previews, to enjoy all features consider using GitHub Action instead.
Availability is not guaranteed.
<details>
<summary><b>💬 Fair use</b> <i>(click to expand)</i></summary>
<!-- -->
To ensure service availability, shared instance has a few limitations:
* Images are cached for 1 hour
* Rendered metrics **won't be updated** during this time window when queried
* You can manually update rendering again your metrics on [metrics.lecoq.io](https://metrics.lecoq.io)
* A rate limiter is enabled to prevent denial of service (it doesn't affect already cached metrics)
* Some plugins may not be available
Service is provided free of charge, so please be gentle with it 🙂
</details>
## 🏗️ Deploying your own web instance (~15 min setup, depending on your sysadmin knowledge)
Setup a metrics instance on your server if you don't want to use GitHub Actions and [metrics.lecoq.io](https://metrics.lecoq.io).
See all supported options in [settings.example.json](/settings.example.json).
Assuming your username is `my-github-user`, you can then embed rendered metrics in your readme like below:
```markdown
![Metrics](https://my-personal-domain.com/my-github-user)
```
<details>
<summary><b>💬 How to setup?</b> <i>(click to expand)</i></summary>
<!-- -->
### 0. Prepare your server
You'll need a server with a recent version of [Docker](https://www.docker.com/).
### 1. Create a GitHub personal token
From the `Developer settings` of your account settings, select `Personal access tokens` to create a new token.
No additional scopes are needed.
![Setup a GitHub personal token](/.github/readme/imgs/setup_personal_token.png)
### 2. Configure your instance
Fetch [settings.example.json](/settings.example.json) which contains all supported option.
```shell
wget https://raw.githubusercontent.com/lowlighter/metrics/master/settings.example.json
```
Edit `settings.json` to configure your instance.
```javascript
{
//GitHub API token
"token":"GITHUB_TOKEN",
//Other options...
}
```
If you plan to make your web instance public, it is advised to restrict its access thanks to rate limiter and access list.
### 3. Start docker container
Metrics docker images are published on [GitHub Container Registry](https://github.com/lowlighter/metrics/pkgs/container/metrics).
Configure the following variables (or hardcode them in the command in the next block):
```shell
# Select an existing docker image tag
VERSION=latest
# Path to configured `settings.json`
SETTINGS=/path/to/settings.json
# Port used internally (use the same one than in `settings.json`)
SERVICE_PORT=3000
# Port to publish
PUBLISHED_PORT=80
```
And start the container using the following command:
```shell
docker run -d --workdir=/metrics --entrypoint="" -p=127.0.0.1:$PUBLISHED_PORT:$SERVICE_PORT --volume=$SETTINGS:/metrics/settings.json ghcr.io/lowlighter/metrics:$VERSION npm start
```
### 4. Embed link into your README.md
Edit your repository readme and add your metrics image from your server domain:
```markdown
![Metrics](https://my-personal-domain.com/my-github-user)
```
### 5. (optional) Setup your instance as a service
To ensure that your instance will restart if it reboots or crashes, you should set it up as a service.
This is described below for Linux-like systems which support *systemd*.
Create a new service file `/etc/systemd/system/github_metrics.service` and paste the following after editing paths inside:
```ini
[Unit]
Description=Metrics
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
ExecStart=(command to run as service)
[Install]
WantedBy=multi-user.target
```
Reload services, enable it, start it and check if it is up and running:
```shell
systemctl daemon-reload
systemctl enable github_metrics
systemctl start github_metrics
systemctl status github_metrics
```
### Alternative option: run an instance locally (intended for testing and development)
To run an instance without docker, you'll need to have [NodeJS](https://nodejs.org) (see used version in [Dockerfile](/Dockerfile#L1-L2)) installed.
Clone repository, install dependencies and copy configuration example to `settings.json`:
```shell
git clone https://github.com/lowlighter/metrics.git
cd metrics/
npm install --only=prod
cp settings.example.json settings.json
```
Once you've finished configuring metrics, start your instance using the following command:
```shell
npm start
```
You should now be able to access your server with provided port in `setting.json` from your browser.
</details>
<details>
<summary><b>🔗 HTTP parameters</b> <i>(click to expand)</i></summary>
<!-- -->
Most of options from [action.yml](/action.yml) are actually supported by web instance, though syntax is slightly different.
All underscores (`_`) must be replaced by dots (`.`) and `plugin_` prefixes must be dropped.
For example, to configure pagespeed plugin you'd use the following:
```
https://my-personal-domain.com/my-github-user?pagespeed=1&pagespeed.detailed=1&pagespeed.url=https%3A%2F%2Fexample.com
```
Note that url parameters must be [encoded](https://developer.mozilla.org/fr/docs/Web/JavaScript/Reference/Objets_globaux/encodeURIComponent).
As for `base` content, which is enabled by default, sections are available through "`base.<section>`".
For example, to display only `repositories` section, use:
```
https://my-personal-domain.com/my-github-user?base=0&base.repositories=1
```
</details>
# 📚 Documentation
### 🧰 Plugin compatibility matrix
> <sup>*⚠️ This is the documentation of **v3.18-beta** (`@master`/`@main` branches) which includes [unreleased features](https://github.com/lowlighter/metrics/compare/latest...master). See documentation for [**v3.17** (`@latest` branch) here](https://github.com/lowlighter/metrics/blob/latest/README.md).*</sup>
<table>
<tr>
<th nowrap="nowrap">Template/Plugin</th>
<th nowrap="nowrap" align="center" title="🗃️ Base content">🗃️</th>
<th nowrap="nowrap" align="center" title="📅 Isometric commit calendar">📅</th>
<th nowrap="nowrap" align="center" title="🈷️ Most used languages">🈷️</th>
<th nowrap="nowrap" align="center" title="📌 Starred topics">📌</th>
<th nowrap="nowrap" align="center" title="🌟 Recently starred repositories">🌟</th>
<th nowrap="nowrap" align="center" title="📜 Repository licenses">📜</th>
<th nowrap="nowrap" align="center" title="💡 Coding habits">💡</th>
<th nowrap="nowrap" align="center" title="🏅 Repository contributors">🏅</th>
<th nowrap="nowrap" align="center" title="🎟️ Follow-up of issues and pull requests">🎟️</th>
<th nowrap="nowrap" align="center" title="🎭 Comment reactions">🎭</th>
<th nowrap="nowrap" align="center" title="🧑‍🤝‍🧑 People plugin">🧑‍🤝‍🧑</th>
<th nowrap="nowrap" align="center" title="✨ Stargazers over last weeks">✨</th>
<th nowrap="nowrap" align="center" title="🗂️ Active projects">🗂️</th>
<th nowrap="nowrap" align="center" title="♐ Code snippet of the day">♐</th>
<th nowrap="nowrap" align="center" title="📰 Recent activity">📰</th>
<th nowrap="nowrap" align="center" title="🏆 Achievements">🏆</th>
<th nowrap="nowrap" align="center" title="🎩 Notable contributions">🎩</th>
<th nowrap="nowrap" align="center" title="💬 Discussions">💬</th>
<th nowrap="nowrap" align="center" title="💭 GitHub Community Support">💭</th>
<th nowrap="nowrap" align="center" title="👨‍💻 Lines of code changed">👨‍💻</th>
<th nowrap="nowrap" align="center" title="🧮 Repositories traffic">🧮</th>
<th nowrap="nowrap" align="center" title="📓 Repositories">📓</th>
<th nowrap="nowrap" align="center" title="🎫 Gists">🎫</th>
<th nowrap="nowrap" align="center" title="🙋 Introduction">🙋</th>
<th nowrap="nowrap" align="center" title="💕 GitHub Sponsors">💕</th>
<th nowrap="nowrap" align="center" title="💫 Starlists">💫</th>
<th nowrap="nowrap" align="center" title="🌇 GitHub Skyline 3D calendar">🌇</th>
<th nowrap="nowrap" align="center" title="⏱️ Website performances">⏱️</th>
<th nowrap="nowrap" align="center" title="🎼 Music plugin">🎼</th>
<th nowrap="nowrap" align="center" title="🗨️ Stackoverflow plugin">🗨️</th>
<th nowrap="nowrap" align="center" title="🌸 Anilist watch list and reading list">🌸</th>
<th nowrap="nowrap" align="center" title="🐤 Latest tweets">🐤</th>
<th nowrap="nowrap" align="center" title="✒️ Recent posts">✒️</th>
<th nowrap="nowrap" align="center" title="🗼 Rss feed">🗼</th>
<th nowrap="nowrap" align="center" title="⏰ WakaTime plugin">⏰</th>
<th nowrap="nowrap" align="center" title="💹 Stock prices">💹</th>
</tr>
<tr>
<td nowrap="nowrap">📗 Classic template</td>
<td nowrap="nowrap" align="center" data-plugin="base">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="isocalendar">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="languages">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="topics">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="stars">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="licenses">❌</td>
<td nowrap="nowrap" align="center" data-plugin="habits">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="contributors">❌</td>
<td nowrap="nowrap" align="center" data-plugin="followup">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="reactions">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="people">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="stargazers">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="projects">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="code">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="activity">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="achievements">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="notable">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="discussions">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="support">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="lines">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="traffic">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="repositories">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="gists">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="introduction">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="sponsors">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="starlists">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="skyline">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="pagespeed">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="music">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="stackoverflow">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="anilist">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="tweets">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="posts">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="rss">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="wakatime">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="stock">✔️</td>
</tr>
<tr>
<td nowrap="nowrap">📘 Repository template</td>
<td nowrap="nowrap" align="center" data-plugin="base">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="isocalendar">❌</td>
<td nowrap="nowrap" align="center" data-plugin="languages">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="topics">❌</td>
<td nowrap="nowrap" align="center" data-plugin="stars">❌</td>
<td nowrap="nowrap" align="center" data-plugin="licenses">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="habits">❌</td>
<td nowrap="nowrap" align="center" data-plugin="contributors">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="followup">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="reactions">❌</td>
<td nowrap="nowrap" align="center" data-plugin="people">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="stargazers">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="projects">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="code">❌</td>
<td nowrap="nowrap" align="center" data-plugin="activity">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="achievements">❌</td>
<td nowrap="nowrap" align="center" data-plugin="notable">❌</td>
<td nowrap="nowrap" align="center" data-plugin="discussions">❌</td>
<td nowrap="nowrap" align="center" data-plugin="support">❌</td>
<td nowrap="nowrap" align="center" data-plugin="lines">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="traffic">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="repositories">❌</td>
<td nowrap="nowrap" align="center" data-plugin="gists">❌</td>
<td nowrap="nowrap" align="center" data-plugin="introduction">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="sponsors">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="starlists">❌</td>
<td nowrap="nowrap" align="center" data-plugin="skyline">❌</td>
<td nowrap="nowrap" align="center" data-plugin="pagespeed">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="music">❌</td>
<td nowrap="nowrap" align="center" data-plugin="stackoverflow">❌</td>
<td nowrap="nowrap" align="center" data-plugin="anilist">❌</td>
<td nowrap="nowrap" align="center" data-plugin="tweets">❌</td>
<td nowrap="nowrap" align="center" data-plugin="posts">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="rss">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="wakatime">❌</td>
<td nowrap="nowrap" align="center" data-plugin="stock">✔️</td>
</tr>
<tr>
<td nowrap="nowrap">📙 Terminal template</td>
<td nowrap="nowrap" align="center" data-plugin="base">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="isocalendar">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="languages">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="topics">❌</td>
<td nowrap="nowrap" align="center" data-plugin="stars">❌</td>
<td nowrap="nowrap" align="center" data-plugin="licenses">❌</td>
<td nowrap="nowrap" align="center" data-plugin="habits">❌</td>
<td nowrap="nowrap" align="center" data-plugin="contributors">❌</td>
<td nowrap="nowrap" align="center" data-plugin="followup">❌</td>
<td nowrap="nowrap" align="center" data-plugin="reactions">❌</td>
<td nowrap="nowrap" align="center" data-plugin="people">❌</td>
<td nowrap="nowrap" align="center" data-plugin="stargazers">❌</td>
<td nowrap="nowrap" align="center" data-plugin="projects">❌</td>
<td nowrap="nowrap" align="center" data-plugin="code">❌</td>
<td nowrap="nowrap" align="center" data-plugin="activity">❌</td>
<td nowrap="nowrap" align="center" data-plugin="achievements">❌</td>
<td nowrap="nowrap" align="center" data-plugin="notable">❌</td>
<td nowrap="nowrap" align="center" data-plugin="discussions">❌</td>
<td nowrap="nowrap" align="center" data-plugin="support">❌</td>
<td nowrap="nowrap" align="center" data-plugin="lines">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="traffic">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="repositories">❌</td>
<td nowrap="nowrap" align="center" data-plugin="gists">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="introduction">❌</td>
<td nowrap="nowrap" align="center" data-plugin="sponsors">❌</td>
<td nowrap="nowrap" align="center" data-plugin="starlists">❌</td>
<td nowrap="nowrap" align="center" data-plugin="skyline">❌</td>
<td nowrap="nowrap" align="center" data-plugin="pagespeed">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="music">❌</td>
<td nowrap="nowrap" align="center" data-plugin="stackoverflow">❌</td>
<td nowrap="nowrap" align="center" data-plugin="anilist">❌</td>
<td nowrap="nowrap" align="center" data-plugin="tweets">❌</td>
<td nowrap="nowrap" align="center" data-plugin="posts">❌</td>
<td nowrap="nowrap" align="center" data-plugin="rss">❌</td>
<td nowrap="nowrap" align="center" data-plugin="wakatime">❌</td>
<td nowrap="nowrap" align="center" data-plugin="stock">❌</td>
</tr>
<tr>
<td nowrap="nowrap">📒 Markdown template</td>
<td nowrap="nowrap" align="center" data-plugin="base">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="isocalendar">✓</td>
<td nowrap="nowrap" align="center" data-plugin="languages">✓</td>
<td nowrap="nowrap" align="center" data-plugin="topics">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="stars">✓</td>
<td nowrap="nowrap" align="center" data-plugin="licenses">✓</td>
<td nowrap="nowrap" align="center" data-plugin="habits">✓</td>
<td nowrap="nowrap" align="center" data-plugin="contributors">✓</td>
<td nowrap="nowrap" align="center" data-plugin="followup">✓</td>
<td nowrap="nowrap" align="center" data-plugin="reactions">✓</td>
<td nowrap="nowrap" align="center" data-plugin="people">✓</td>
<td nowrap="nowrap" align="center" data-plugin="stargazers">✓</td>
<td nowrap="nowrap" align="center" data-plugin="projects">✓</td>
<td nowrap="nowrap" align="center" data-plugin="code">✓</td>
<td nowrap="nowrap" align="center" data-plugin="activity">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="achievements">✓</td>
<td nowrap="nowrap" align="center" data-plugin="notable">✓</td>
<td nowrap="nowrap" align="center" data-plugin="discussions">✓</td>
<td nowrap="nowrap" align="center" data-plugin="support">✓</td>
<td nowrap="nowrap" align="center" data-plugin="lines">✓</td>
<td nowrap="nowrap" align="center" data-plugin="traffic">✓</td>
<td nowrap="nowrap" align="center" data-plugin="repositories">✓</td>
<td nowrap="nowrap" align="center" data-plugin="gists">✓</td>
<td nowrap="nowrap" align="center" data-plugin="introduction">✓</td>
<td nowrap="nowrap" align="center" data-plugin="sponsors">✓</td>
<td nowrap="nowrap" align="center" data-plugin="starlists">✓</td>
<td nowrap="nowrap" align="center" data-plugin="skyline">✓</td>
<td nowrap="nowrap" align="center" data-plugin="pagespeed">✓</td>
<td nowrap="nowrap" align="center" data-plugin="music">✓</td>
<td nowrap="nowrap" align="center" data-plugin="stackoverflow">✓</td>
<td nowrap="nowrap" align="center" data-plugin="anilist">✓</td>
<td nowrap="nowrap" align="center" data-plugin="tweets">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="posts">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="rss">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="wakatime">✓</td>
<td nowrap="nowrap" align="center" data-plugin="stock">✓</td>
</tr>
<tr>
<td colspan="40"></td>
</tr>
<tr>
<th nowrap="nowrap">Mode/Plugin</th>
<th nowrap="nowrap" align="center" title="🗃️ Base content">🗃️</th>
<th nowrap="nowrap" align="center" title="📅 Isometric commit calendar">📅</th>
<th nowrap="nowrap" align="center" title="🈷️ Most used languages">🈷️</th>
<th nowrap="nowrap" align="center" title="📌 Starred topics">📌</th>
<th nowrap="nowrap" align="center" title="🌟 Recently starred repositories">🌟</th>
<th nowrap="nowrap" align="center" title="📜 Repository licenses">📜</th>
<th nowrap="nowrap" align="center" title="💡 Coding habits">💡</th>
<th nowrap="nowrap" align="center" title="🏅 Repository contributors">🏅</th>
<th nowrap="nowrap" align="center" title="🎟️ Follow-up of issues and pull requests">🎟️</th>
<th nowrap="nowrap" align="center" title="🎭 Comment reactions">🎭</th>
<th nowrap="nowrap" align="center" title="🧑‍🤝‍🧑 People plugin">🧑‍🤝‍🧑</th>
<th nowrap="nowrap" align="center" title="✨ Stargazers over last weeks">✨</th>
<th nowrap="nowrap" align="center" title="🗂️ Active projects">🗂️</th>
<th nowrap="nowrap" align="center" title="♐ Code snippet of the day">♐</th>
<th nowrap="nowrap" align="center" title="📰 Recent activity">📰</th>
<th nowrap="nowrap" align="center" title="🏆 Achievements">🏆</th>
<th nowrap="nowrap" align="center" title="🎩 Notable contributions">🎩</th>
<th nowrap="nowrap" align="center" title="💬 Discussions">💬</th>
<th nowrap="nowrap" align="center" title="💭 GitHub Community Support">💭</th>
<th nowrap="nowrap" align="center" title="👨‍💻 Lines of code changed">👨‍💻</th>
<th nowrap="nowrap" align="center" title="🧮 Repositories traffic">🧮</th>
<th nowrap="nowrap" align="center" title="📓 Repositories">📓</th>
<th nowrap="nowrap" align="center" title="🎫 Gists">🎫</th>
<th nowrap="nowrap" align="center" title="🙋 Introduction">🙋</th>
<th nowrap="nowrap" align="center" title="💕 GitHub Sponsors">💕</th>
<th nowrap="nowrap" align="center" title="💫 Starlists">💫</th>
<th nowrap="nowrap" align="center" title="🌇 GitHub Skyline 3D calendar">🌇</th>
<th nowrap="nowrap" align="center" title="⏱️ Website performances">⏱️</th>
<th nowrap="nowrap" align="center" title="🎼 Music plugin">🎼</th>
<th nowrap="nowrap" align="center" title="🗨️ Stackoverflow plugin">🗨️</th>
<th nowrap="nowrap" align="center" title="🌸 Anilist watch list and reading list">🌸</th>
<th nowrap="nowrap" align="center" title="🐤 Latest tweets">🐤</th>
<th nowrap="nowrap" align="center" title="✒️ Recent posts">✒️</th>
<th nowrap="nowrap" align="center" title="🗼 Rss feed">🗼</th>
<th nowrap="nowrap" align="center" title="⏰ WakaTime plugin">⏰</th>
<th nowrap="nowrap" align="center" title="💹 Stock prices">💹</th>
</tr>
<tr>
<td nowrap="nowrap">👤 User</td>
<td nowrap="nowrap" align="center" data-plugin="base">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="isocalendar">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="languages">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="topics">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="stars">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="licenses">❌</td>
<td nowrap="nowrap" align="center" data-plugin="habits">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="contributors">❌</td>
<td nowrap="nowrap" align="center" data-plugin="followup">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="reactions">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="people">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="stargazers">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="projects">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="code">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="activity">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="achievements">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="notable">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="discussions">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="support">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="lines">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="traffic">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="repositories">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="gists">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="introduction">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="sponsors">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="starlists">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="skyline">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="pagespeed">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="music">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="stackoverflow">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="anilist">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="tweets">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="posts">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="rss">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="wakatime">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="stock">✔️</td>
</tr>
<tr>
<td nowrap="nowrap">👥 Organization</td>
<td nowrap="nowrap" align="center" data-plugin="base">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="isocalendar">❌</td>
<td nowrap="nowrap" align="center" data-plugin="languages">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="topics">❌</td>
<td nowrap="nowrap" align="center" data-plugin="stars">❌</td>
<td nowrap="nowrap" align="center" data-plugin="licenses">❌</td>
<td nowrap="nowrap" align="center" data-plugin="habits">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="contributors">❌</td>
<td nowrap="nowrap" align="center" data-plugin="followup">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="reactions">❌</td>
<td nowrap="nowrap" align="center" data-plugin="people">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="stargazers">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="projects">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="code">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="activity">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="achievements">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="notable">❌</td>
<td nowrap="nowrap" align="center" data-plugin="discussions">❌</td>
<td nowrap="nowrap" align="center" data-plugin="support">❌</td>
<td nowrap="nowrap" align="center" data-plugin="lines">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="traffic">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="repositories">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="gists">❌</td>
<td nowrap="nowrap" align="center" data-plugin="introduction">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="sponsors">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="starlists">❌</td>
<td nowrap="nowrap" align="center" data-plugin="skyline">❌</td>
<td nowrap="nowrap" align="center" data-plugin="pagespeed">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="music">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="stackoverflow">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="anilist">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="tweets">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="posts">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="rss">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="wakatime">❌</td>
<td nowrap="nowrap" align="center" data-plugin="stock">✔️</td>
</tr>
<tr>
<td nowrap="nowrap">📓 Repository</td>
<td nowrap="nowrap" align="center" data-plugin="base">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="isocalendar">❌</td>
<td nowrap="nowrap" align="center" data-plugin="languages">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="topics">❌</td>
<td nowrap="nowrap" align="center" data-plugin="stars">❌</td>
<td nowrap="nowrap" align="center" data-plugin="licenses">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="habits">❌</td>
<td nowrap="nowrap" align="center" data-plugin="contributors">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="followup">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="reactions">❌</td>
<td nowrap="nowrap" align="center" data-plugin="people">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="stargazers">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="projects">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="code">❌</td>
<td nowrap="nowrap" align="center" data-plugin="activity">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="achievements">❌</td>
<td nowrap="nowrap" align="center" data-plugin="notable">❌</td>
<td nowrap="nowrap" align="center" data-plugin="discussions">❌</td>
<td nowrap="nowrap" align="center" data-plugin="support">❌</td>
<td nowrap="nowrap" align="center" data-plugin="lines">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="traffic">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="repositories">❌</td>
<td nowrap="nowrap" align="center" data-plugin="gists">❌</td>
<td nowrap="nowrap" align="center" data-plugin="introduction">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="sponsors">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="starlists">❌</td>
<td nowrap="nowrap" align="center" data-plugin="skyline">❌</td>
<td nowrap="nowrap" align="center" data-plugin="pagespeed">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="music">❌</td>
<td nowrap="nowrap" align="center" data-plugin="stackoverflow">❌</td>
<td nowrap="nowrap" align="center" data-plugin="anilist">❌</td>
<td nowrap="nowrap" align="center" data-plugin="tweets">❌</td>
<td nowrap="nowrap" align="center" data-plugin="posts">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="rss">✔️</td>
<td nowrap="nowrap" align="center" data-plugin="wakatime">❌</td>
<td nowrap="nowrap" align="center" data-plugin="stock">✔️</td>
</tr>
</table>
*Note: **markdown template** can actually render any kind of SVG metrics using [`embed` function](https://github.com/lowlighter/metrics/blob/master/source/templates/markdown/example.md#embedding-svg-metrics)*
## 🦮 Setup
There are several ways to setup metrics, each having its advantages and disadvantages:
* [⚙️ Using GitHub Action on a profile repository *(~10 min)*](/.github/readme/partials/setup/action.md)
* ✔️ All features
* ✔️ High availability (no downtimes)
* ➖ Configuration can be a bit time-consuming
* [💕 Using the shared instance *(~1 min)*](/.github/readme/partials/setup/shared.md)
* ✔️ Easily configurable and previewable
* ➖ Limited features *(compute-intensive features are disabled)*
* 🐳 Using command line with docker *(~5 min)* *(documentation not available yet)*
* ✔️ Suited for one-time rendering
* [🏗️ Deploying your own web instance *(~20 min)*](/.github/readme/partials/setup/web.md)
* ➖ Mostly intended for development, or to create another shared instance
Additional resources for setup:
* [🏦 Configuring metrics for organizations](/.github/readme/partials/organizations.md)
* [🧰 Template/Plugin compatibility matrix](/.github/readme/partials/compatibility.md)
## 🖼️ Templates
Templates lets you change general appearance of rendered metrics.
See their respective documentation for more informations about how to setup them:
* [📗 Classic template](/source/templates/classic/README.md)
* [📘 Repository template](/source/templates/repository/README.md)
@@ -1149,10 +481,9 @@ See their respective documentation for more informations about how to setup them
## 🧩 Plugins
Plugins are features which provide additional content and lets you customize your rendered metrics.
See their respective documentation for more informations about how to setup them.
Plugins provide additional content and lets you customize your rendered metrics.
The following plugins are maintained by Metric's core team:
**📦 Maintained by core team**
* **Core**
* [🗃️ Base content](/source/plugins/base/README.md)
@@ -1194,76 +525,25 @@ The following plugins are maintained by Metric's core team:
* [💹 Stock prices](/source/plugins/stock/README.md)
* [🐤 Latest tweets](/source/plugins/tweets/README.md)
* [⏰ WakaTime plugin](/source/plugins/wakatime/README.md)
**🎲 Maintained by community**
* [💉 Nightscout](/source/plugins/nightscout/README.md) by [@legoandmars](https://github.com/legoandmars)
* [💩 PoopMap plugin](/source/plugins/poopmap/README.md) by [@matievisthekat](https://github.com/matievisthekat)
* [📸 Website screenshot](/source/plugins/screenshot/README.md) by [@lowlighter](https://github.com/lowlighter)
### 🎲 Community plugins
## 💪 Contributing
The following plugins are provided and maintained by Metrics's user community:
* [💉 Nightscout](/source/plugins/nightscout/README.md) by [@legoandmars](https://github.com/legoandmars)
* [💩 PoopMap plugin](/source/plugins/poopmap/README.md) by [@matievisthekat](https://github.com/matievisthekat)
* [📸 Website screenshot](/source/plugins/screenshot/README.md) by [@lowlighter](https://github.com/lowlighter)
If you are interested in contributing, the following resources may interest you:
### 🏦 Organizations metrics
* [💪 Contribution guide](/CONTRIBUTING.md)
* [🧬 Architecture](/ARCHITECTURE.md)
* [📜 License](/LICENSE)
* **:octocat: GitHub resources**
* [📖 GitHub GraphQL API](https://docs.github.com/en/graphql)
* [📖 GitHub GraphQL Explorer](https://docs.github.com/en/free-pro-team@latest/graphql/overview/explorer)
* [📖 GitHub Rest API](https://docs.github.com/en/rest)
* [📖 GitHub Octicons](https://github.com/primer/octicons)
While metrics targets mainly user accounts, it's possible to render metrics for organization accounts.
![Metrics (organization account)](https://github.com/lowlighter/lowlighter/blob/master/metrics.organization.svg)
<details>
<summary><b>💬 Metrics for organizations</b> <i>(click to expand)</i></summary>
<!-- -->
Setup is the same as for user accounts, though you'll need to add `read:org` scope, **whether you're member of target organization or not**.
![Add read:org scope to personal token](/.github/readme/imgs/setup_token_org_read_scope.png)
You'll also need to set `user` option with your organization name.
If you're encounting errors and your organization is using single sign-on, try to [authorize your personal token](https://docs.github.com/en/free-pro-team@latest/github/authenticating-to-github/authorizing-a-personal-access-token-for-use-with-saml-single-sign-on).
Most of plugins supported by user accounts will work with organization accounts, but note that rendering metrics for organizations consume way more APIs requests.
To support private repositories, add full `repo` scope to your personal token.
#### ℹ️ Example workflow
```yaml
- uses: lowlighter/metrics@latest
with:
# ... other options
token: ${{ secrets.METRICS_TOKEN }} # A personal token from an user account with read:org scope
user: organization-name # Organization name
```
</details>
<details>
<summary><b>💬 Organizations memberships for user accounts</b> <i>(click to expand)</i></summary>
<!-- -->
Only public memberships can be displayed by metrics by default.
You can manage your membership visibility in the `People` tab of your organization:
![Publish organization membership](/.github/readme/imgs/setup_public_membership_org.png)
For organization memberships, add `read:org` scope to your personal token.
![Add read:org scope to personal token](/.github/readme/imgs/setup_token_org_read_scope.png)
</details>
## 💪 Customizing and contributing
Metrics is built to be easily customizable.
Fork this repository, switch used action from `lowlighter/metrics@latest` to your fork and start coding!
See [ARCHITECTURE.md](/ARCHITECTURE.md) for more informations about how code is structured.
To report a bug fill an [issue](https://github.com/lowlighter/metrics/issues) describing it.
To suggest new features or requesting help to setup metrics, check out [discussions](https://github.com/lowlighter/metrics/discussions).
If you want to contribute, submit a [pull request](https://github.com/lowlighter/metrics/pulls).
Be sure to read [CONTRIBUTING.md](/CONTRIBUTING.md) for more information about this.
Use [`💬 discussions`](https://github.com/lowlighter/metrics/discussions) for feedback, new features suggestions, bugs reports or to request help for installation.
## 📜 License
@@ -1273,32 +553,7 @@ MIT License
Copyright (c) 2020-present lowlighter
```
![License details](https://github.com/lowlighter/lowlighter/blob/master/metrics.licenses.svg)
See full license in [LICENSE.md](/LICENSE.md)
![Sponsors](https://github.com/lowlighter/lowlighter/blob/master/metrics.sponsors.svg)
![Contributors](https://github.com/lowlighter/lowlighter/blob/master/metrics.contributors.svg)
[`♥️ Become a sponsor`](https://github.com/sponsors/lowlighter)
## 📖 Useful references
* [GitHub GraphQL API](https://docs.github.com/en/graphql)
* [GitHub GraphQL Explorer](https://docs.github.com/en/free-pro-team@latest/graphql/overview/explorer)
* [GitHub Rest API](https://docs.github.com/en/rest)
* [GitHub Octicons](https://github.com/primer/octicons)
* See [GitHub Logos and Usage](https://github.com/logos) for more information.
### ✨ Inspirations
* [anuraghazra/github-readme-stats](https://github.com/anuraghazra/github-readme-stats)
* [jstrieb/github-stats](https://github.com/jstrieb/github-stats)
* [ankurparihar/readme-pagespeed-insights](https://github.com/ankurparihar/readme-pagespeed-insights)
* [jasonlong/isometric-contributions](https://github.com/jasonlong/isometric-contributions)
* [jamesgeorge007/github-activity-readme](https://github.com/jamesgeorge007/github-activity-readme)
* [vvo/sourcekarma](https://github.com/vvo/sourcekarma)
* [ryo-ma/github-profile-trophy](https://github.com/ryo-ma/github-profile-trophy)
* [teoxoy/profile-readme-stats](https://github.com/teoxoy/profile-readme-stats)