gitbook命令行&markdown编辑

1. 首先介绍下一本书的主要文件:

README.md

这个文件相当于一本Gitbook的简介,最上层(和SUMMARY.md同级)的是本书的Introduction。

SUMMARY.md()

这个文件是一本书的目录结构,使用Markdown语法, 这个文件在使用gitbook命令行之前要先写好,以便之后生成书籍目录,如我们这本书的SUMMARY.md

  1. * [基本安装](howtouse/README.md)
  2. - [Node.js安装](howtouse/Nodejsinstall.md)
  3. - [Gitbook安装](howtouse/gitbookinstall.md)
  4. - [Gitbook命令行速览](howtouse/gitbookcli.md)
  5. * [图书编辑](book/README.md)
  6. - [gitbook命令行&markdown编辑](book/gitbook-cli.md)
  7. - [gitbook editor编辑](book/editor.md)
  8. * [图书输出](output/README.md)
  9. - [输出为静态网站](output/outfile.md)
  10. - [输出PDF](output/pdfandebook.md)
  11. * [发布](publish/README.md)
  12. - [发布到gitbook.com](publish/gitbook.md)
  13. - [Github集成](publish/github.md)
  14. - [发布到Github Pages](publish/gitpages.md)
  15. * [结束](end/README.md)

列表加链接,链接中可以使用目录,也可以不必使用。

2. 书籍目录初始化&内容编写

当这个目录文件创建好之后,我们可以使用Gitbook的命令行工具将这个目录结构生成相应的目录及文件,步骤如下:

  • 打开cmd,cd命令进入创建的存书籍的目录,如:E:\gitbook\gitbook-studying;
  • 在这个目录下我们创建了上述的SUMMARY.md文件;
  • 然后使用命令gitbook init,则生成一系列目录文件,见下方;
  1. $ gitbook init
  2. $ ls
  3. LICENSE SUMMARY.md book output
  4. README.md howtouse publish
  5. $ tree .
  6. .
  7. ├── LICENSE
  8. ├── README.md
  9. ├── SUMMARY.md
  10. ├── book
  11. ├── README.md
  12. ├── gitbook-cli.md
  13. └── editor.md
  14. ├── howtouse
  15. ├── Nodejsinstall.md
  16. ├── README.md
  17. ├── gitbookcli.md
  18. └── gitbookinstall.md
  19. ├── output
  20. ├── README.md
  21. ├── outfile.md
  22. └── pdfandebook.md
  23. └── publish
  24. ├── README.md
  25. ├── gitbook.md
  26. ├── github.md
  27. └── gitpages.md

我们可以看到,gitbook给我们生成了与SUMMARY.md所对应的目录及文件。

每个目录中,都有一个README.md文件,相当于一章的说明。

最后,我们在对应目录中用markdown编辑器(这里推荐使用markdownpad)编辑自己想要的内容即可.