• gitbook命令行&markdown编辑
    • 1. 首先介绍下一本书的主要文件:
      • README.md
      • SUMMARY.md()
    • 2. 书籍目录初始化&内容编写

    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)编辑自己想要的内容即可.