难以让GitBook网站显示在GitHub页面中

Question

我试图关注https://github.com/GitbookIO/gitbook,但有一些假设的知识显然我没有.我已经使用过GitHub一段时间,但我还有很多需要学习的地方.

我的目标是在http://martynchamberlin.github.io/GitBook/ 上有一个与此存储库对应的GitHub页面:https://github.com/martynchamberlin/GitBook.

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

我假设(虽然它没有说明)他们手动创建一个gh-pages分支,因为这神奇地将Github repo变成了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-pages分支上发布:

$ grunt publish