Difficulty in getting GitBook site to show up in GitHub page

Question

I am trying to follow https://github.com/GitbookIO/gitbook but there is some assumed knowledge that clearly I don\'t have. I\'ve used GitHub for some time but I\'ve still got a

Answer 1

for people who still have issues using the command above, here is my scenario.

I used to use tortoise-git on my windows machine to manage my github projects, and they are totally fine tool to use. But when it comes to gitbook publish command, it somehow stuck in the middle of switching between branches etc...

My solution is to download the github windows client, and it has this git shell come with it , if you run the gitbook publish command against the github suite git tooling, everything works fine.

Answer 2

Take a look at this book: https://github.com/GitbookIO/git.

It uses grunt to set up a few tasks: test, publish and build.

You should do the same by copying the package.json, Gruntfile.js and running:

$ npm install .

For testing:

$ grunt test

For publishing on the gh-pages branch:

$ grunt publish

Answer 3

Regarding the gh-pages branch, you are correct, it can be found here:

https://github.com/GitbookIO/git/tree/gh-pages

It does indeed have an index.html file in the root directory:

https://github.com/GitbookIO/git/blob/gh-pages/index.html