一、gitbook的使用

Gitbook介绍

Gitbook 是基于 Node.js 的命令行工具,用来创建漂亮的电子书,它使用 Markdown 或 AsciiDoc 语法来撰写内容,用 Git 进行版本控制,且可以托管在 Github 上。Gitbook 可以将作品编译成网站、 PDF、 ePub 和 MOBI 等多重格式。

如果你不擅长自己搭建 gitbook 环境,还可以使用 gitbook.com 在线服务来创建和托管你的作品,他们还提供了基于桌面的 编辑器

如何使用

1.首先在全局安装 gitbook 客户端工具:

npm install gitbook-cli -g
2.创建一个文件夹book,并在这个文件夹中创建一个book.json文件,并填入基本信息:

{
  "gitbook":"3.2.3",
  "title":"学习笔记",
  "author":"geewonii",
  "language": "zh-Hans",
  "plugins":[
      "sectionx",
      "expandable-chapters"
  ]
}
3.安装插件:

gitbook install
4.创建README.md 和 SUMMARY.md:

gitbook init
5.在你的作品目录中创建两个必需的文件 README.md 和 SUMMARY.md,README.md 是作品的介绍,SUMMARY.md 是作品的目录结构,里面要包含一个章节标题和文件索引的列表:

6.运行服务,在编辑内容保存后实时预览:

gitbook serve
7.撰写完后可以生成静态网站用来发布:

gitbook build
8.更多命令帮助:

gitbook help
9.自由切换版本:

gitbook ls-remote           //罗列出所有的版本号
gitbook fetch 2.1.0         //选择其中一个版本切换安装
10.更多插件:参考链接