目录结构

GitBook 基本的目录结构如下所示

  1. .
  2. ├── book.json
  3. ├── README.md
  4. ├── SUMMARY.md
  5. ├── chapter-1/
  6. |   ├── README.md
  7. |   └── something.md
  8. └── chapter-2/
  9.     ├── README.md
  10.     └── something.md

这里主要讲下 GitBook 预定义的几个文件的作用

book.json

存放配置信息，在下一章中所讲的配置信息都是在这个文件里定义的，关于该文件的配置可以看 配置 这个章节。

Summary

概要文件主要存放 GitBook 的文件目录信息，左侧的目录就是根据这个文件来生成的，默认对应的文件是 SUMMARY.md，可以在 book.json 重新定义该文件的对应值。它通过 Markdown 中的列表语法来表示文件的父子关系，下面是一个简单的示例：

  1. # Summary
  2. * [Introduction](README.md)
  3. * [Part I](part1/README.md)
  4.     * [Writing is nice](part1/writing.md)
  5.     * [GitBook is nice](part1/gitbook.md)
  6. * [Part II](part2/README.md)
  7.     * [We love feedback](part2/feedback_please.md)
  8.     * [Better tools for authors](part2/better_tools.md)

这个配置对应的目录结构如下所示:

目录结构 - 图1

我们通过使用 标题 或者 水平分割线 标志将 GitBook 分为几个不同的部分

  1. # Summary
  3. ### Part I
  5. * [Introduction](README.md)
  6. * [Writing is nice](part1/writing.md)
  7. * [GitBook is nice](part1/gitbook.md)
  9. ### Part II
  11. * [We love feedback](part2/feedback_please.md)
  12. * [Better tools for authors](part2/better_tools.md)
  14. ----
  16. * [Last part without title](part3/title.md)

这个配置对应的目录结构如下所示：

目录结构 - 图2

Glossary

词汇表文件，默认对应的文件是 GLOSSARY.md。该文件主要存储词汇信息，如果在其他页面中出现了该文件中的词汇，鼠标放到词汇上会给出词汇示意，可以将鼠标移到下面两个词汇上看下效果。

Git    Markdown

Glossary 文件的格式如下所示：

  1. ## Git
  2. 分散式版本控制软件
  4. ## Markdown
  5. Aaron Swartz 跟John Gruber共同设计的排版语言