章節設定

GitBook 使用一個 SUMMARY.md 檔案來定義書籍的目錄架構,也就是多層次章節的設定。SUMMARY.md 檔案同時也被用來製作書籍目錄(TOC - Tables Of Contents)。

SUMMARY.md 的格式只是簡單的連結列表,連結的「名稱」就是章節的「標題」,連結標的則是實際的內容「檔案」(包含路徑在內)。

章節的層級,就根據清單的層級進行定義。

GitBook 的這個設定方式相當彈性,在目錄中使用的「名稱」即使與實際檔案中的第一級大標題不同也無妨(但應注意不要造成讀者的困惑);多層級可以將書分成「部」、「章」、「節」或是「小節」皆可,而且不會自動賦予編號或固定名稱,選擇自己想要的組織架構即可。

沒有在 SUMMARY.md 文件裏指定的檔案,GitBook 在轉製書籍時都不會使用,所以你可以自由撰寫草稿、參考文件等。

簡單的範例

# Summary

* [第一章](chapter1.md)
* [第二章](chapter2.md)
* [第三章](chapter3.md)

以次章節將書分成 三大部 的範例

# Summary

* [第一部](part1/README.md)
    * [寫作是美好的](part1/writing.md)
    * [GitBook 也不錯](part1/gitbook.md)
* [第二部](part2/README.md)
    * [我們歡迎讀者回饋](part2/feedback_please.md)
    * [對作者更好的工具](part2/better_tools.md)

ps. 你可以看到「第一部」與「第二部」有實際連結到檔案,可以擺放一個簡單的「分部頁」(或俗稱的「章前頁」),你可以擺放特殊的標題、簡單的抽言或引言,甚至連結呈現一張圖片都行。

舊版範例可以在分章節時不實際對應到內容檔案(僅作為目錄上的區隔),但新版已經移除這個範例,建議還是實際對應一個檔案,比較不會造成解析錯誤。