yindeqiang / giab

a tool for "giab" (github issue as blog) guys

giab

A tool for "giab" (github issue as blog) guys

This tool will generate an issue(blog post) list in your README.md.

Install

npm install giab

Usage

1. Go to your repository's root dir

2. Make sure you have a readme file named README.md

3. Add placeholder to README.md, like this:

<!--giab:issue_list_start-->
your articles will be shown here
<!--giab:issue_list_end-->

4. Add a config file named .giabrc, sample content:

{
  "type": "basic",
  "username": "simongfxu",
  "password": "password here",
  "issues": {
    "repo": "simongfxu.github.com",
    "owner": "simongfxu"
  }
}

GitHub token also supported to hide your password.

5. Edit .gitignore file in your repository's root dir, add a line

.giabrc

NOTE: this is very important, I do not think you will let everybody know your password.

6. Execute the following command

node node_modules/giab

That is all!

Example

• My personal blog
• giab-code - learn js from famous framework's code fragment
• giab-issue - read blog post from giab buys