• 章節設定
    • 簡單的範例
    • 以次章節將書分成 三大部 的範例

    章節設定

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

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

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

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

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

    簡單的範例

    1. # Summary
    3. * [第一章](chapter1.md)
    4. * [第二章](chapter2.md)
    5. * [第三章](chapter3.md)

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

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

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

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