Did you know that it was possible to easily share your Stackoverflow statistics using small dynamic images called "Flair"? This small image simply allows you to embellish your different READMEs like the one on GitHub or your online CV:
... and that just by adding the following Markdown:
![SO's Flair](https://stackoverflow.com/users/flair/USER_ID.png?theme=dark)
You can check them out at the URL https://stackoverflow.com/users/YOUR_USER_ID/YOUR_USER_NAME/flair :
This service proposed by Stackoverflow works very well, however since it hasn't be updated since a few years, there is some negative point that I noticed:
- the avatar image is weirdly cropped
- the only infos are the username, reputation score and badges amount
- it's a png so there is no fancy animation
- the image is very pixelated because of its small size (208x58)
- and most importantly: you cannot improve it because the project is not open-sourced
That's why I developed my own version of this service that would solve all these problems: stackoverflow-readme-profile
johannchopin / stackoverflow-readme-profile
Easily share your Stackoverflow's profile on your README
stackoverflow-readme-profile
Easily share your Stackoverflow's profile on your README.
βοΈ How to use?
You can generate your SO profile by calling this url with the corresponding template name and you SO user id:
https://stackoverflow-readme-profile.johannchopin.fr/:template/:id
Use it like that in your README:
[![johannchopin's SO profile](https://stackoverflow-readme-profile.johannchopin.fr/:template/:id)](https://github.com/johannchopin/stackoverflow-readme-profile)
π Templates
profile
Render a profile image by using the profile
template:
https://stackoverflow-readme-profile.johannchopin.fr/profile/:id
Params (as query strings)
param | default | description |
---|---|---|
theme |
default |
Theme to use. Check them out here! |
website |
true |
Show or not the website URL (true | false ) |
location |
true |
Show or not the location (true | false ) |
profile-small
Render a smaller profile image without the location and the website
Params (as query strings)
param | default | description |
---|---|---|
theme |
default |
Theme to use. Check them out here! |
π³ Docker
Build the image
You can build the image by using the following command:
docker build -t johannchopin/stackoverflow-readme-profile .
Push the
β¦This project allows you to embed improved version of those flairs wherever you want:
Default Stackoverflow profile:
Just use the following markdown schema to get your flair:
[![my SO profile](https://stackoverflow-readme-profile.johannchopin.fr/TEMPLATE_NAME/USER_ID?theme=dark)](https://github.com/johannchopin/stackoverflow-readme-profile)
Not yet convinced to use this project? I can understand why using an "unofficial" service doesn't seem like a good idea but here are some points that might change your mind:
- stackoverflow-readme-profile proposes a higher customisation with multiple themes and templates
- stackoverflow-readme-profile render a svg so the final image is pixel clear and is animated
- the project is open-sourced: You want a new feature or improve something? Just open an issue so we can collaborate together
- you want to self host the application? No problem there is already a docker image for that.
Thanks again for reading. If you are willing to see this project growing don't hesitate to leave a β to the repo and push your ideas of improvement.
johannchopin / stackoverflow-readme-profile
Easily share your Stackoverflow's profile on your README
stackoverflow-readme-profile
Easily share your Stackoverflow's profile on your README.
βοΈ How to use?
You can generate your SO profile by calling this url with the corresponding template name and you SO user id:
https://stackoverflow-readme-profile.johannchopin.fr/:template/:id
Use it like that in your README:
[![johannchopin's SO profile](https://stackoverflow-readme-profile.johannchopin.fr/:template/:id)](https://github.com/johannchopin/stackoverflow-readme-profile)
π Templates
profile
Render a profile image by using the profile
template:
https://stackoverflow-readme-profile.johannchopin.fr/profile/:id
Params (as query strings)
param | default | description |
---|---|---|
theme |
default |
Theme to use. Check them out here! |
website |
true |
Show or not the website URL (true | false ) |
location |
true |
Show or not the location (true | false ) |
profile-small
Render a smaller profile image without the location and the website
Params (as query strings)
param | default | description |
---|---|---|
theme |
default |
Theme to use. Check them out here! |
π³ Docker
Build the image
You can build the image by using the following command:
docker build -t johannchopin/stackoverflow-readme-profile .
Top comments (0)