git - 很难让 GitBook 站点显示在 GitHub 页面中

Question

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

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

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

我假设(虽然没有在任何地方说明)他们正在手动创建一个 gh-pages 分支，因为这神奇地将 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-pages 分支上发布:

$ grunt publish