创建书籍

初始化书籍

执行命令 gitbook init testbook ,则会自动生成一个最基本的书籍骨架:

  1. $ gitbook init testbook
  2. info: init book at testbook
  3. info: detect structure from SUMMARY (if it exists)
  4. info: create SUMMARY.md
  5. info: create README.md
  6. info: initialization is finished
  7. Done, without error

进入 testbook 目录,可以看到只有两个文件:

  1. $ cd testbook/
  2. $ ls
  3. README.md SUMMARY.md

其中 SUMMARY.md 是书籍的目录和排版,目前文件为空,里面只有一行注释:

  1. # Summary

README.md 是书籍的介绍信息,目前只有一个标题:

  1. # Introduction

查看内容

即使如此简陋,也足以运行。

在 testbook 目录下运行命令 gitbook serve

  1. Live reload server started on port: 35729
  2. Press CTRL+C to quit ...
  3. info: loading book configuration....OK
  4. info: load plugin gitbook-plugin-highlight ....OK
  5. info: load plugin gitbook-plugin-search ....OK
  6. info: load plugin gitbook-plugin-sharing ....OK
  7. info: load plugin gitbook-plugin-fontsettings ....OK
  8. info: load plugin gitbook-plugin-livereload ....OK
  9. info: >> 5 plugins loaded
  10. info: start generation with website generator
  11. info: clean website generatorOK
  12. info: generation is finished
  13. Starting server ...
  14. Serving book on http://localhost:4000

此时打开浏览器,输入地址 http://localhost:4000

创建书籍 - 图1

修改

修改README.md 文件为:

  1. # 介绍
  2. 这是一个例子。

这是浏览器会自动刷新(Live reload,见上面的命令行输出),非常方便:

创建书籍 - 图2

注: gitbook 使用markdown语法来编写书籍内容,具体的markdown语法请自行学习。

后面介绍如何增加新的章节。