gitbook的使用

初始化

创建一个文件夹,用于生成gitbook,在控制台输入下面命令:

gitbook init

执行结果:

warn: no summary file in this book 
info: create README.md 
info: create SUMMARY.md 
info: initialization is finished

在文件夹中,生成 README.md 和 SUMMARY.md 这两个文件:

  • README.md 是说明文档
  • SUMMARY.md 是书的章节目录

SUMMARY.md文件

初始化创建的 SUMMARY.md 文件内容如下所示:

# Summary

* [Introduction](README.md)

增加章节

内容格式如下:

# Summary

* [一级标题](text1.md)
* [一级标题](doc/text1.md)
    * [二级标题(doc/text/text1.md)
        *[三级标题](..)

类似以上的内容
例如你在* [一级标题](doc/text1.md)这里后面的引用地址写了doc/text1.md

生成html

gitbook build

运行命令后,会生成_book文件夹,将SUMMARY.md文件中引用的 *.md文件生成*.html文件,保存到_book文件夹

启动web服务

执行下面命令:

gitbook serve

操作如下:

  1. 执行gitbook build
  2. 启动web服务,根目录是_book文件夹,默认端口号是4000

指定端口号

gitbook serve --port 8081

感谢:
https://blog.csdn.net/cn_1937/article/details/102802611


原文出处:/show_1EF57tdrW841.html