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