GitHub - DenverCoder1/github-readme-streak-stats: 🔥 Stay motivated and show off...
source link: https://github.com/DenverCoder1/github-readme-streak-stats
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.
Github Readme Streak Stats
Display your total contributions, current streak,
and longest streak on your GitHub profile README
Table of Contents
Quick setup
- Copy-paste the markdown below into your GitHub profile README
- Replace the value after
?user=
with your GitHub username
[![GitHub Streak](https://github-readme-streak-stats.herokuapp.com/?user=DenverCoder1)](https://git.io/streak-stats)
Note: See below for information about deploying the app on your own
Demo Site
Here you can customize your Streak Stats card with a live preview.
http://github-readme-streak-stats.herokuapp.com/demo/
Themes
To enable a theme, append &theme=
followed by the theme name to the end of the source url:
[![GitHub Streak](https://github-readme-streak-stats.herokuapp.com/?user=DenverCoder1&theme=dark)](https://git.io/streak-stats)
Theme
Preview
default
dark
highcontrast
More themes! See a list of all available themes
If you have come up with a new theme you'd like to share with others, open an issue to add it!
Options
The user
field is the only required option. All other fields are optional.
If the theme
parameter is specified, any color customizations specified will be applied on top of the theme, overriding the theme's values.
user
GitHub username to show stats for
DenverCoder1
theme
The theme to apply (Default: default
)
dark
, radical
, etc.
hide_border
Make the border transparent (Default: false
)
true
or false
background
Background color
hex code without #
or css color
border
Border color
hex code without #
or css color
stroke
Stroke line color between sections
hex code without #
or css color
ring
Color of the ring around the current streak
hex code without #
or css color
fire
Color of the fire in the ring
hex code without #
or css color
currStreakNum
Current streak number
hex code without #
or css color
sideNums
Total and longest streak numbers
hex code without #
or css color
currStreakLabel
Current streak label
hex code without #
or css color
sideLabels
Total and longest streak labels
hex code without #
or css color
dates
Date range text color
hex code without #
or css color
type
Output format (Default: svg
)
Current options: svg
or json
Example
[![GitHub Streak](https://github-readme-streak-stats.herokuapp.com/?user=denvercoder1&currStreakNum=2FD3EB&fire=pink&sideLabels=F00)](https://git.io/streak-stats)
How these stats are calculated
This tool uses the contribution graphs on your GitHub profile to calculate which days you have contributed.
To include contributions in private repositories, turn on the setting for "Private contributions" from the dropdown menu above the contribution graph on your profile page.
Contributions include commits, pull requests, and issues that you create in standalone repositories (Learn more about what is considered a contribution).
The longest streak is the highest number of consecutive days on which you have made at least one contribution.
The current streak is the number of consecutive days ending with the current day on which you have made at least one contribution. If you have made a contribution today, it will be counted towards the current streak, however, if you have not made a contribution today, the streak will only count days before today so that your streak will not be zero.
Note: You may need to wait up to 24 hours for new contributions to show up (Learn how contributions are counted)
Deploying it on your own
If you can, it is preferable to host the files on your own server.
Doing this can lead to better uptime and more control over customization (you can modify the code for your usage).
You can deploy the PHP files on any website server with PHP installed or as a Heroku app.
Deploy Streak Stats instantly
Deploying to HerokuDeploying to Zeet
Contributing
Contributions are welcome! Feel free to open an issue or submit a pull request if you have a way to improve this project.
Make sure your request is meaningful and you have tested the app locally before submitting a pull request.
Installing Requirements
Requirements
Linux
sudo apt-get install php sudo apt-get install php-curl sudo apt-get install composer
Windows
Install PHP from XAMPP or php.net
Clone the repository
git clone https://github.com/DenverCoder1/github-readme-streak-stats.git cd github-readme-streak-stats
Authorization
To get the GitHub API to run locally you will need to provide a token.
- Visit this link to create a new Personal Access Token
- Scroll to the bottom and click "Generate token"
- Create a file
config.php
in thesrc
directory and replaceghp_example123
with your token andDenverCoder1
with your username:
# /src/config.php <?php putenv("TOKEN=ghp_example123"); putenv("USERNAME=DenverCoder1");
Running the app locally
composer start
Open http://localhost:8000/?user=DenverCoder1 to run the project locally.
Open http://localhost:8000/demo/ to run the demo site.
Running the tests
Before you can run tests, PHPUnit must be installed. You can install it using Composer by running the following command.
composer install
Run the following command to run the PHPUnit test script which will verify that the tested functionality is still working.
composer test
Support
If you like this project, give it a and share it with friends!
Made with and PHP
Recommend
About Joyk
Aggregate valuable and interesting links.
Joyk means Joy of geeK