Update README.md
This commit is contained in:
75
README.md
75
README.md
@@ -341,13 +341,15 @@ The *pagespeed* plugin allows you to add your website performances.
|
|||||||
|
|
||||||
These are computed through [Google's pagespeed API](https://developers.google.com/speed/docs/insights/v5/get-started), which returns the same results as [web.dev](https://web.dev).
|
These are computed through [Google's pagespeed API](https://developers.google.com/speed/docs/insights/v5/get-started), which returns the same results as [web.dev](https://web.dev).
|
||||||
|
|
||||||
To setup this plugin, you'll need an API key that you can generated in the [pagespeed API presentation](https://developers.google.com/speed/docs/insights/v5/get-started).
|
<details>
|
||||||
|
<summary>💬 About</summary>
|
||||||
|
|
||||||
|
To setup this plugin, you'll need an API key that you can generate in the [pagespeed API presentation](https://developers.google.com/speed/docs/insights/v5/get-started).
|
||||||
|
|
||||||
The website attached to your GitHub profile will be the one to be audited.
|
The website attached to your GitHub profile will be the one to be audited.
|
||||||
It will take about 10 to 15 seconds to generate the results, so it is advised to use this plugin alongside caching system or for automated image generation.
|
It will take about 10 to 15 seconds to generate the results, so it is advised to use this plugin alongside caching system or for automated image generation.
|
||||||
|
|
||||||
<details>
|
##### Setup with GitHub actions
|
||||||
<summary>💬 Setup with GitHub actions</summary>
|
|
||||||
|
|
||||||
Add the following to your workflow :
|
Add the following to your workflow :
|
||||||
|
|
||||||
@@ -359,6 +361,21 @@ Add the following to your workflow :
|
|||||||
pagespeed_token: ${{ secrets.PAGESPEED_TOKEN }}
|
pagespeed_token: ${{ secrets.PAGESPEED_TOKEN }}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
##### Setup in your own instance
|
||||||
|
|
||||||
|
Add the following to your `settings.json`
|
||||||
|
|
||||||
|
```json
|
||||||
|
"plugins":{
|
||||||
|
"pagespeed":{
|
||||||
|
"enabled":true,
|
||||||
|
"token":"****************************************"
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
And pass `?pagespeed=1` in url when generating metrics.
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
#### 👨💻 Lines
|
#### 👨💻 Lines
|
||||||
@@ -367,10 +384,12 @@ The *lines* plugin allows you to add the number of lines of code you added and r
|
|||||||
|
|
||||||

|

|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>💬 About</summary>
|
||||||
|
|
||||||
It will consume an additional GitHub request per repository.
|
It will consume an additional GitHub request per repository.
|
||||||
|
|
||||||
<details>
|
##### Setup with GitHub actions
|
||||||
<summary>💬 Setup with GitHub actions</summary>
|
|
||||||
|
|
||||||
Add the following to your workflow :
|
Add the following to your workflow :
|
||||||
|
|
||||||
@@ -381,6 +400,20 @@ Add the following to your workflow :
|
|||||||
plugin_lines: yes
|
plugin_lines: yes
|
||||||
```
|
```
|
||||||
|
|
||||||
|
##### Setup in your own instance
|
||||||
|
|
||||||
|
Add the following to your `settings.json`
|
||||||
|
|
||||||
|
```json
|
||||||
|
"plugins":{
|
||||||
|
"lines":{
|
||||||
|
"enabled":true,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
And pass `?lines=1` in url when generating metrics.
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
#### 🧮 Traffic
|
#### 🧮 Traffic
|
||||||
@@ -389,14 +422,16 @@ The *traffic* plugin allows you to add the number of pages views across your rep
|
|||||||
|
|
||||||

|

|
||||||
|
|
||||||
|
<details>
|
||||||
|
<summary>💬 About</summary>
|
||||||
|
|
||||||
It will consume an additional GitHub request per repository.
|
It will consume an additional GitHub request per repository.
|
||||||
|
|
||||||
Due to GitHub Rest API limitation, the GitHub token you provide will requires "repo" permissions instead of "public_repo" to allow this plugin accessing traffic informations.
|
Due to GitHub Rest API limitation, the GitHub token you provide will requires "repo" permissions instead of "public_repo" to allow this plugin accessing traffic informations.
|
||||||
|
|
||||||

|

|
||||||
|
|
||||||
<details>
|
##### Setup with GitHub actions
|
||||||
<summary>💬 Setup with GitHub actions</summary>
|
|
||||||
|
|
||||||
Add the following to your workflow :
|
Add the following to your workflow :
|
||||||
|
|
||||||
@@ -408,6 +443,20 @@ Add the following to your workflow :
|
|||||||
plugin_traffic: yes
|
plugin_traffic: yes
|
||||||
```
|
```
|
||||||
|
|
||||||
|
##### Setup in your own instance
|
||||||
|
|
||||||
|
Add the following to your `settings.json`
|
||||||
|
|
||||||
|
```json
|
||||||
|
"plugins":{
|
||||||
|
"traffic":{
|
||||||
|
"enabled":true,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
And pass `?traffic=1` in url when generating metrics.
|
||||||
|
|
||||||
</details>
|
</details>
|
||||||
|
|
||||||
### 🗂️ Project structure
|
### 🗂️ Project structure
|
||||||
@@ -427,11 +476,11 @@ Add the following to your workflow :
|
|||||||
|
|
||||||
The following errors code can be encountered if your using a server instance :
|
The following errors code can be encountered if your using a server instance :
|
||||||
|
|
||||||
* 403 Forbidden : User is not whitelisted in `restricted` users list
|
* `403 Forbidden` : User is not whitelisted in `restricted` users list
|
||||||
* 404 Not found : GitHub API did not found the requested user
|
* `404 Not found` : GitHub API did not found the requested user
|
||||||
* 429 Too many requests : Thrown when rate limiter is trigerred
|
* `429 Too many requests` : Thrown when rate limiter is trigerred
|
||||||
* 500 Internal error : An error ocurred while generating metrics images (logs can be seen if you're the owner of the instance)
|
* `500 Internal error` : An error ocurred while generating metrics images (logs can be seen if you're the owner of the instance)
|
||||||
* 503 Service unavailable : Maximum user capacity reached, only already cached images can be accessed for now
|
* `503 Service unavailable` : Maximum user capacity reached, only already cached images can be accessed for now
|
||||||
|
|
||||||
### 📖 Useful references
|
### 📖 Useful references
|
||||||
|
|
||||||
@@ -452,7 +501,7 @@ Below is a list of primary dependencies :
|
|||||||
* [octokit/graphql.js](https://github.com/octokit/graphql.js/)
|
* [octokit/graphql.js](https://github.com/octokit/graphql.js/)
|
||||||
* To perform request to GitHub GraphQL API
|
* To perform request to GitHub GraphQL API
|
||||||
* [ptarjan/node-cache](https://github.com/ptarjan/node-cache)
|
* [ptarjan/node-cache](https://github.com/ptarjan/node-cache)
|
||||||
* To cache generated content and reduce
|
* To cache generated content
|
||||||
* [renanbastos93/image-to-base64](https://github.com/renanbastos93/image-to-base64)
|
* [renanbastos93/image-to-base64](https://github.com/renanbastos93/image-to-base64)
|
||||||
* To generate base64 representation of users' avatars
|
* To generate base64 representation of users' avatars
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user