一、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.更多插件:参考链接