Skip to content

Commit 7c196e9

Browse files
committed
Updated docs
1 parent bd8f6de commit 7c196e9

File tree

5 files changed

+120
-44
lines changed

5 files changed

+120
-44
lines changed

.gitignore

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,3 +6,4 @@ node_modules
66
*.env
77
.DS_Store
88
package-lock.json
9+
.bloggify/*

LICENSE

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
The MIT License (MIT)
22

3-
Copyright (c) 2015-19 Ionică Bizău <[email protected]> (https://ionicabizau.net)
3+
Copyright (c) 2015-20 Ionică Bizău <[email protected]> (https://ionicabizau.net)
44

55
Permission is hereby granted, free of charge, to any person obtaining a copy
66
of this software and associated documentation files (the "Software"), to deal

README.md

Lines changed: 116 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -1,20 +1,47 @@
11
<!-- Please do not edit this file. Edit the `blah` field in the `package.json` instead. If in doubt, open an issue. -->
22

33

4+
5+
6+
7+
8+
9+
410
[![git-stats](http://i.imgur.com/Q7TQYHx.png)](#)
511

12+
13+
14+
15+
16+
17+
18+
19+
20+
21+
622
# `$ git-stats`
723

824
[![Support me on Patreon][badge_patreon]][patreon] [![Buy me a book][badge_amazon]][amazon] [![PayPal][badge_paypal_donate]][paypal-donations] [![Ask me anything](https://img.shields.io/badge/ask%20me-anything-1abc9c.svg)](https://github.com/IonicaBizau/ama) [![Version](https://img.shields.io/npm/v/git-stats.svg)](https://www.npmjs.com/package/git-stats) [![Downloads](https://img.shields.io/npm/dt/git-stats.svg)](https://www.npmjs.com/package/git-stats) [![Get help on Codementor](https://cdn.codementor.io/badges/get_help_github.svg)](https://www.codementor.io/johnnyb?utm_source=github&utm_medium=button&utm_term=johnnyb&utm_campaign=github)
925

1026
<a href="https://www.buymeacoffee.com/H96WwChMy" target="_blank"><img src="https://www.buymeacoffee.com/assets/img/custom_images/yellow_img.png" alt="Buy Me A Coffee"></a>
1127

28+
29+
30+
31+
32+
33+
1234
> Local git statistics including GitHub-like contributions calendars.
1335
1436

37+
38+
39+
40+
41+
1542
I'd be curious to see your calendar with all your commits. Ping me on Twitter ([**@IonicaBizau**](https://twitter.com/IonicaBizau)). :smile: Until then, here's my calendar:
1643

17-
![](http://i.imgur.com/PpM0i3v.png)
44+
![](http://i.imgur.com/PpM0i3v.png "")
1845

1946
## Contents
2047

@@ -30,6 +57,17 @@ I'd be curious to see your calendar with all your commits. Ping me on Twitter ([
3057
- [How to contribute](#yum-how-to-contribute)
3158

3259

60+
61+
62+
63+
64+
65+
66+
67+
68+
69+
70+
3371
## :cloud: Installation
3472

3573
You can install the package globally and use it as command line tool:
@@ -56,18 +94,18 @@ Local git statistics including GitHub-like contributions calendars.
5694
5795
Options:
5896
-r, --raw Outputs a dump of the raw JSON data.
59-
--record <data> Records a new commit. Don't use this unless you are
60-
a mad scientist. If you are a developer just use
61-
this option as part of the module.
62-
-s, --since <date> Optional start date.
63-
-u, --until <date> Optional end date.
6497
-g, --global-activity Shows global activity calendar in the current
6598
repository.
66-
-n, --disable-ansi Forces the tool not to use ANSI styles.
67-
-l, --light Enables the light theme.
6899
-d, --data <path> Sets a custom data store file.
100+
-l, --light Enables the light theme.
101+
-n, --disable-ansi Forces the tool not to use ANSI styles.
69102
-a, --authors Shows a pie chart with the author related
70103
contributions in the current repository.
104+
-u, --until <date> Optional end date.
105+
-s, --since <date> Optional start date.
106+
--record <data> Records a new commit. Don't use this unless you are
107+
a mad scientist. If you are a developer just use
108+
this option as part of the module.
71109
-h, --help Displays this help.
72110
-v, --version Displays version information.
73111
@@ -83,6 +121,12 @@ Your commit history is kept in ~/.git-stats by default. You can create
83121
Documentation can be found at https://github.com/IonicaBizau/git-stats.
84122
```
85123

124+
125+
126+
127+
128+
129+
86130
## Usage
87131

88132
### Importing and deleting commits
@@ -123,20 +167,6 @@ $ cd repository-downloader
123167
# Install the dependencies
124168
$ npm install
125169

126-
# Enter your username and password for GitHub and BitBucket into the config.json
127-
$ vim config.json
128-
repository-downloader/config.json
129-
- {
130-
- "github": {
131-
- "username": "your GitHub username",
132-
- "password": "your GitHub password"
133-
- },
134-
- "bitbucket": {
135-
- "username": "your BitBucket username",
136-
- "password": "your BitBucket password"
137-
- }
138-
- }
139-
140170
# Start downloading and importing
141171
$ ./start
142172
```
@@ -221,7 +251,7 @@ git-stats --raw | git-stats-html -o out.html
221251

222252
# Export data since 2015 (save the results in out.html)
223253

224-
git-stats --since '1 January 2015' --raw | git-stats-html -o out.html --big
254+
git-stats --since '1 January 2015' --raw | ./bin/git-stats-html -o out.html --big
225255

226256
```
227257

@@ -255,18 +285,17 @@ If you run `git-stats` to display graph on Windows, please use a terminal that c
255285
Cygwin Terminal is known to work, while Windows Command Prompt and Git Bash do not. Improvements are more than welcome! :dizzy:
256286

257287

258-
## :clipboard: Example
259288

260289

261-
Here is an example how to use this package as library. To install it locally, as library, you can do that using `npm` (or `yarn`):
262290

263-
```sh
264-
# Using npm
265-
npm install --save git-stats
266291

267-
# Using yarn
268-
yarn add git-stats
269-
```
292+
293+
294+
## :clipboard: Example
295+
296+
297+
298+
Here is an example how to use this package as library. To install it locally, as library, you can use `npm install git-stats` (or `yarn add git-stats`):
270299

271300

272301

@@ -287,32 +316,53 @@ g1.ansiCalendar({
287316

288317

289318

319+
320+
321+
322+
323+
324+
325+
326+
290327
## :question: Get Help
291328

292329
There are few ways to get help:
293330

331+
332+
294333
1. Please [post questions on Stack Overflow](https://stackoverflow.com/questions/ask). You can open issues with questions, as long you add a link to your Stack Overflow question.
295334
2. For bug reports and feature requests, open issues. :bug:
296-
297335
3. For direct and quick help, you can [use Codementor](https://www.codementor.io/johnnyb). :rocket:
298336

299337

300338

339+
340+
301341
## :memo: Documentation
302342

303343
For full API reference, see the [DOCUMENTATION.md][docs] file.
304344

345+
346+
347+
348+
349+
305350
## :newspaper: Press Highlights
306351

307352
- [*A GitHub-like contributions calendar, but locally, with all your git commits*, The Changelog](https://changelog.com/github-like-contributions-calendar-locally-git-commits/)
308353

309354

355+
356+
357+
358+
359+
360+
310361
## :yum: How to contribute
311362
Have an idea? Found a bug? See [how to contribute][contributing].
312363

313364

314365
## :sparkling_heart: Support my projects
315-
316366
I open-source almost everything I can, and I try to reply to everyone needing help using these projects. Obviously,
317367
this takes time. You can integrate and use these projects in your applications *for free*! You can even change the source code and redistribute (even resell it).
318368

@@ -331,28 +381,53 @@ However, if you get some profit from this or just want to encourage me to contin
331381
Thanks! :heart:
332382

333383

384+
385+
386+
387+
388+
389+
390+
391+
392+
393+
394+
395+
396+
397+
334398
## :dizzy: Where is this library used?
335399
If you are using this library in one of your projects, add it in this list. :sparkles:
336400

401+
- `git-stats-fcc-importer`
402+
- `git-stats-importer`
403+
404+
405+
406+
407+
408+
409+
410+
411+
337412

338-
- [`git-stats-fcc-importer`](https://github.com/cmal/git-stats-fcc-importer#readme) (by Yu Zhao)—git-stats importer for FreeCodeCamp users
339-
- [`git-stats-importer`](https://github.com/IonicaBizau/git-stats-importer)—Imports your commits from a repository into git-stats history.
340413

341414
## :scroll: License
342415

343416
[MIT][license] © [Ionică Bizău][website]
344417

345418

419+
420+
421+
422+
423+
[license]: /LICENSE
424+
[website]: https://ionicabizau.net
425+
[contributing]: /CONTRIBUTING.md
426+
[docs]: /DOCUMENTATION.md
346427
[badge_patreon]: https://ionicabizau.github.io/badges/patreon.svg
347428
[badge_amazon]: https://ionicabizau.github.io/badges/amazon.svg
348429
[badge_paypal]: https://ionicabizau.github.io/badges/paypal.svg
349430
[badge_paypal_donate]: https://ionicabizau.github.io/badges/paypal_donate.svg
350-
351431
[patreon]: https://www.patreon.com/ionicabizau
352432
[amazon]: http://amzn.eu/hRo9sIZ
353433
[paypal-donations]: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=RVXDDLKKLQRJW
354-
355-
[license]: http://showalicense.com/?fullname=Ionic%C4%83%20Biz%C4%83u%20%3Cbizauionica%40gmail.com%3E%20(https%3A%2F%2Fionicabizau.net)&year=2015#license-mit
356-
[website]: https://ionicabizau.net
357-
[contributing]: /CONTRIBUTING.md
358-
[docs]: /DOCUMENTATION.md

package-lock.json

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -286,4 +286,4 @@
286286
"bloggify.json",
287287
"bloggify/"
288288
]
289-
}
289+
}

0 commit comments

Comments
 (0)