一、Gitbook是什么
GitBook 是一个基于 Node.js 的命令行工具,支持 Markdown 和 AsciiDoc 两种语法格式,可以输出 HTML、PDF、eBook 等格式的电子书。所以,GitBook 不是 Markdown 编辑工具,也不是 Git 版本管理工具。
- Markdown编辑器对比(推荐使用vscode、Typora 、Gitbook官方编辑器)
名称 | 说明 | 平台 | 是否免费 |
---|---|---|---|
Visual Studio Code | 插件:Paste Image、Docs Markdown、Markdown Preview Enhanced | Mac OS、Windows、Linux | 免费 |
Typora | 支持实时预览的 Markdown 文本编辑器 | Mac OS、Windows、Linux | 免费 |
MacDown | Mac OS | 免费 | |
Bear | 笔记应用中的瑞士军刀 | Mac OS 、iPhone、iPad | 免费+内购 |
MarkdownPad | Windows下的一个多功能Markdown编辑器 | Windows | 免费+收费 |
MarkdownX | Android轻量级编辑器 | Android | 免费 |
二、安装、使用Gitbook
首先安装node.js,node版本要求:V4.0.0以上。按步骤执行如下命令
1、通过npm,全局安装Gitbook ,执行命令npm install gitbook-cli -g
2、查看是否安装成功,gitbook -V
3、在 mybook 文件夹(初始化)创建一本书gitbook init
,会自动生成两个必要的文件 README.md 和 SUMMARY.md。
README.md —— 书籍的介绍写在这个文件里
SUMMARY.md —— 书籍的目录结构在这里配置
4、预览书籍gitbook serve . --port 4200
。此时可以通过http://localhost:4200/预览
5、编辑 SUMMARY.md 文件,内容修改为:
# Summary
* [简介](README.md)
* [1.Docker入门](chapter1/README.md)
* [1.1 什么是Docker](chapter1/section1.md)
* [1.2 Docker基本概念](chapter1/section2.md)
* [1.3 安装Docker](chapter1/section3.md)
* [1.4 使用Docker镜像](chapter1/section4.md)
* [1.5 操作容器](chapter1/section5.md)
* [1.6 访问仓库](chapter1/section6.md)
* [1.6 数据管理](chapter1/section7.md)
* [2.使用Docker部署web应用](chapter2/README.md)
* [2.1 编写DockerFile](chapter2/section1.md)
* [2.2 编写web应用](chapter2/section2.md)
* [2.3 构建镜像](chapter2/section3.md)
* [2.4 运行web应用](chapter2/section4.md)
* [2.5 分享镜像](chapter2/section5.md)
* [结束](end/README.md)
6、在 mybook 文件夹中再次执行 gitbook init
命令。GitBook 会查找 SUMMARY.md 文件中描述的目录和文件,如果没有则会将其创建。
7、发布书籍,执行
gitbook build
命令构建书籍,默认将生成的静态网站输出到 _book 目录。
gitbook build [书籍路径] [输出路径]
gitbook pdf ./ ./mybook.pdf
gitbook epub ./ ./mybook.epub
gitbook mobi ./ ./mybook.mobi
辅助工具: ebook-convert。 Typora + Pandoc 进行导出。
三、fixbugs
1、用gitbook想生成HTML,执行了gitbook serve时报错:Error: ENOENT: no such file or directory, stat 'C:UserscjfGitBookLibraryImportprepare_bookgitbookgitbook-plugin-fontsettingsfontsettings.js'
在book目录下,如下代码新建book.json,将如下代码copy&paste。保存文件后,运行gitbook install
安装插件依赖。重新执行gitbook serve
{
"plugins": [
"fontsettings",
"sharing",
"lunr",
"search",
"highlight",
"livereload"
]
}
其他办法:我使用gitbook serve遇到同样的问题,改为 gitbook serve .\ 就OK了。我是win10平台,gitbook 3.2.3
参考地址:
1、http://www.lijiam.com/part2/gitbook/install.html
2、https://www.cnblogs.com/xiaoqi/p/8194350.html