前往小程序,Get更优阅读体验!
立即前往
首页
学习
活动
专区
工具
TVP
发布
社区首页 >专栏 >CentOS7下部署GitBook

CentOS7下部署GitBook

作者头像
yuanfan2012
发布2020-03-26 17:38:30
3K0
发布2020-03-26 17:38:30
举报
文章被收录于专栏:WalkingCloudWalkingCloud

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

本文参与 腾讯云自媒体分享计划,分享自微信公众号。
原始发表:2020-03-16,如有侵权请联系 cloudcommunity@tencent.com 删除

本文分享自 WalkingCloud 微信公众号,前往查看

如有侵权,请联系 cloudcommunity@tencent.com 删除。

本文参与 腾讯云自媒体分享计划  ,欢迎热爱写作的你一起参与!

评论
登录后参与评论
0 条评论
热度
最新
推荐阅读
相关产品与服务
命令行工具
腾讯云命令行工具 TCCLI 是管理腾讯云资源的统一工具。使用腾讯云命令行工具,您可以快速调用腾讯云 API 来管理您的腾讯云资源。此外,您还可以基于腾讯云的命令行工具来做自动化和脚本处理,以更多样的方式进行组合和重用。
领券
问题归档专栏文章快讯文章归档关键词归档开发者手册归档开发者手册 Section 归档