伟明部落格

CentOS7下部署GitBook

--发布于 2022-11-14 20:42:10

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.mdSUMMARY.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.mdSUMMARY.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 服务器),实现多人协作

参考

CentOS7下部署GitBook

--更新于 2023-03-09 10:51:41