创建书籍

初始化书籍

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

$ gitbook init testbook

info: init book at testbook
info: detect structure from SUMMARY (if it exists)
info: create SUMMARY.md
info: create README.md
info: initialization is finished

Done, without error

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

$ cd testbook/
$ ls
README.md  SUMMARY.md

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

# Summary

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

# Introduction

查看内容

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

在 testbook 目录下运行命令 gitbook serve

Live reload server started on port: 35729
Press CTRL+C to quit ...

info: loading book configuration....OK
info: load plugin gitbook-plugin-highlight ....OK
info: load plugin gitbook-plugin-search ....OK
info: load plugin gitbook-plugin-sharing ....OK
info: load plugin gitbook-plugin-fontsettings ....OK
info: load plugin gitbook-plugin-livereload ....OK
info: >> 5 plugins loaded
info: start generation with website generator
info: clean website generatorOK
info: generation is finished

Starting server ...
Serving book on http://localhost:4000

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

修改

修改README.md 文件为:

# 介绍

这是一个例子。

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

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

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