章節設定
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. 你可以看到「第一部」與「第二部」有實際連結到檔案,可以擺放一個簡單的「分部頁」(或俗稱的「章前頁」),你可以擺放特殊的標題、簡單的抽言或引言,甚至連結呈現一張圖片都行。
舊版範例可以在分章節時不實際對應到內容檔案(僅作為目錄上的區隔),但新版已經移除這個範例,建議還是實際對應一個檔案,比較不會造成解析錯誤。