GitBook站点难以显示在GitHub页面

Question

我正在尝试关注https://github.com/GitbookIO/gitbook，但有一些假设的知识，显然我没有。我已经使用GitHub一段时间了，但我仍然有很多东西需要学习。

我的目标是有一个GitHub page在http://martynchamberlin.github.io/GitBook/对应于此存储库：https://github.com/martynchamberlin/GitBook。

所以这里是我的问题：GitBook究竟是如何做到这一点？

我假设（尽管没有任何说明）他们手动创建一个gh页面分支，因为这会奇迹般地将Github回购变成一个Github页面。

要做到这一点，我已按照https://help.github.com/articles/creating-project-pages-manually

GitHub的文档，但这里是我的问题：所有的HTML（的index.html等）坐落在/ _book /代替的父目录gh-pages分支。这意味着当我加载https://github.com/martynchamberlin/GitBook时，我得到了404。

请注意，当我在本地运行gitbook serve时，我看到当我在localhost：4000上启动浏览器时应该看到的内容。

我确定我在这里错过了一些简单的东西。有任何想法吗？

感谢， 马丁

Answer 1

看看这本书：https://github.com/GitbookIO/git。

它使用grunt来设置几个任务：测试，发布和构建。

您应该通过复制的package.json做同样的，Gruntfile.js和运行：

$ npm install . 

来进行测试：

$ grunt test 

对于发布的GH-页面分支：

$ grunt publish 

Answer 2

对于仍然有问题使用上述命令的人来说，这里是我的场景。

我以前在我的Windows机器上使用tortoise-git来管理我的github项目，它们是完全好用的工具。但是，当涉及到gitbook publish命令，它在某种程度上停留在分支机构等之间切换过程中...

我的解决方法是下载GitHub的Windows客户端，它有这个随之而来，如果您运行对github套件git工具的gitbook publish命令，一切工作正常。

Answer 3

关于gh-pages分支，你是正确的，它可以在这里找到：

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

它确实有一个index.html文件根目录：

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