在GitHub页面中显示GitBook网站的困难

Question

我试图按照https://github.com/GitbookIO/gitbook的步骤进行操作，但其中有些假定的知识显然我没有。虽然我已经使用GitHub有一段时间了，但我还有很多东西需要学习。

我的目标是在http://martynchamberlin.github.io/GitBook/上拥有一个GitHub页面，对应于这个仓库：https://github.com/martynchamberlin/GitBook。

那么我的问题是：GitBook究竟是如何做到的呢？ 我假设（尽管没有明确说明）他们是手动创建了gh-pages分支，因为这样会将Github存储库神奇地转换成Github页面。

为了实现这一点，我遵循了GitHub文档https://help.github.com/articles/creating-project-pages-manually的说明。

但是我有一个问题：所有的HTML文件（index.html等）都位于/_book/而不是gh-pages分支的父目录中。这意味着当我加载https://github.com/martynchamberlin/GitBook时，会得到404错误。

请注意，当我在本地运行gitbook serve时，在localhost:4000打开浏览器时，我看到了我应该看到的内容。

我相信我错过了一些简单的东西。有什么想法吗？

谢谢， Martyn

- Martyn Chamberlin

Answer 1

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

书中使用grunt设置了几个任务：测试、发布和构建。

你可以通过复制package.json、Gruntfile.js并运行以下命令来完成相同的任务：

$ npm install .

供测试使用：

$ grunt test

在 gh-pages 分支上发布：

$ grunt publish

- Samy Pessé

---

哇！！！看这个。嘭。神奇。我猜你认为其他人都知道这个。我肯定不知道...可能是我错过了备忘录。但这个解决了问题。非常感谢。 - Martyn Chamberlin

我再也看不到那个项目中的package.json和Gruntfile.js文件了。 - akauppi

同样的问题。@samy-pessé，您能否确认您发布的存储库链接是否仍然有效？ - gprasant

我在标签_0.0.5_中找到了Gruntfile.js文件。 - Mike

Answer 2

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

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

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

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

- Bastiaan Quast

Answer 3

对于那些仍然在使用上述命令时遇到问题的人，这是我的情况。

我曾经在我的Windows机器上使用tortoise-git来管理我的GitHub项目，它们是非常好用的工具。但是当涉及到gitbook publish命令时，它在切换分支等方面会卡住。

我的解决方案是下载GitHub Windows客户端，它带有git shell，如果你使用GitHub套件的git工具运行gitbook publish命令，一切都能正常工作。

- zinking