GitBook是一个基于 Node.js 的命令行工具,可使用 Github/Git 和 Markdown 来制作精美的电子书
GitBook支持输出多种文档格式:
1)静态站点:GitBook默认输出该种格式,生成的静态站点可直接托管搭载Github Pages服务上;
2)PDF:需要安装gitbook-pdf依赖;
3)eBook:需要安装ebook-convert;
4)单HTML网页:支持将内容输出为单页的HTML,不过一般用在将电子书格式转换为PDF或eBook的中间过程;
5)JSON:一般用于电子书的调试或元数据提取。
使用GitBook制作电子书,必备两个文件:README.md和SUMMARY.md
下面介绍如何在CentOS7系统下部署GitBook
1)官网下载Node.js的Linux64位的二进制包
下载 wget https://nodejs.org/dist/v12.16.1/node-v12.16.1-linux-x64.tar.xz
2)解压到指定目录
tar -xJf node-v12.16.1-linux-x64.tar.xz -C /usr/local/lib/ cd /usr/local/lib mv node-v12.16.1-linux-x64/ nodejs
3)修改环境变量vi /etc/profile
export PATH=/usr/local/lib/nodejs/bin:$PATH source /etc/profile
并测试是否有npm命令,输入npm -v查看npm的版本
4)利用npm 安装gitbook-cli
npm install -g gitbook-cli
gitbook --version查看版本信息,执行时会自动安装gitbook
5)gitbook初始化gitbook init
gitbook初始化创建README.md和SUMMARY.md目录文件
README.md 就是说明文档,而 SUMMARY.md 其实就是书的章节目录
6)编辑SUMMARY.md文件例如
# Summary * [第一章](Chapter1/README.md) * [第1节:常用脚本](Chapter1/常用脚本.md) * [第2节:常用命令](Chapter1/常用命令.md) * [第3节:Linux发行版本](Chapter1/Linux发行版本.md) * [第4节:CentOS8](Chapter1/CentOS8.md) * [第二章](Chapter2/README.md) * [第三章](Chapter3/README.md) * [第四章](Chapter4/README.md)
再次执行 gitbook init 命令。GitBook 会查找 SUMMARY.md 文件中描述的目录和文件,如果没有则会将其创建
然后 执行gitbook serve
Web浏览器去访问4000端口
当然也可以手动指定端口为80
gitbook serve --port 80
以上就是gitbook的部署,后续编写md文件可以借助markdown编辑工具编写md文件内容,再进行电子书的发布
总结:gitbook 与 Markdown 和 Git 息息相关,一般将它们结合起来使用
1、选择合适的 Markdown 编辑工具以获得更好的写作体验;使用 GitBook 管理文档,预览、制作电子书;
2、同时通过 Git 管理书籍内容的变更,并将其托管到云端(比如 GitHub、GitLab、码云,或者是自己搭建的 Git 服务器),实现多人协作