开发者社区> yuanfan_2012> 正文
阿里云
为了无法计算的价值
打开APP
阿里云APP内打开

CentOS7下部署GitBook

简介: CentOS7下部署GitBook
+关注继续查看

640.jpg

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位的二进制包

640.jpg



下载 wget https://nodejs.org/dist/v12.16.1/node-v12.16.1-linux-x64.tar.xz


640.png

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


640.png

3)修改环境变量vi /etc/profile


export PATH=/usr/local/lib/nodejs/bin:$PATH
source /etc/profile


并测试是否有npm命令,输入npm -v查看npm的版本


640.png

4)利用npm 安装gitbook-cli


npm install -g gitbook-cli


gitbook --version查看版本信息,执行时会自动安装gitbook


640.png

5)gitbook初始化gitbook init


gitbook初始化创建README.md和SUMMARY.md目录文件


README.md 就是说明文档,而 SUMMARY.md 其实就是书的章节目录


640.png


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 文件中描述的目录和文件,如果没有则会将其创建


640.png

然后 执行gitbook serve

640.png


Web浏览器去访问4000端口


640.png

当然也可以手动指定端口为80


gitbook serve --port 80


640.png


640.png

以上就是gitbook的部署,后续编写md文件可以借助markdown编辑工具编写md文件内容,再进行电子书的发布


总结:gitbook 与 Markdown 和 Git 息息相关,一般将它们结合起来使用


1、选择合适的 Markdown 编辑工具以获得更好的写作体验;使用 GitBook 管理文档,预览、制作电子书;


2、同时通过 Git 管理书籍内容的变更,并将其托管到云端(比如 GitHub、GitLab、码云,或者是自己搭建的 Git 服务器),实现多人协作

版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。

相关文章
centos7 安装Git
centos7 安装Git
0 0
CentOS 安装,更新 Git
查看 Linux 发行版名称和版本号,使用 yum 命令安装 git,默认安装的 Git 版本为 1.x 版本,而不是最新2.x。
0 0
Gitlab在CentOS的安装
Gitlab在CentOS的安装
0 0
Centos 7.x 配置Gitlab
GitLab 是一个用于仓库管理系统的开源项目,使用Git作为代码管理工具,并在此基础上搭建起来的web服务。    1. 安装并配置必要的依赖关系 如果你想使用 Postfix 发送邮件,请在安装过程中根据提示选择 'Internet Site'。
1179 0
基于CentOS搭建 Git 服务
官方安装详细介绍 https://git-scm.com/download/linux 本文介绍通过源码安装 1、下载安装 git 此实验以 CentOS 7.2 x64 的系统为环境,搭建 git 服务器。
1347 0
centos 6.5 Git搭建
<p style="margin:10px auto; padding-top:0px; padding-bottom:0px; font-size:14px; color:rgb(64,50,38); font-family:verdana,'ms song',宋体,Arial,微软雅黑,Helvetica,sans-serif; line-height:24px"> 1. 环境部署<
1868 0
+关注
文章
问答
文章排行榜
最热
最新
相关电子书
更多
低代码开发师(初级)实战教程
立即下载
阿里巴巴DevOps 最佳实践手册
立即下载
冬季实战营第三期:MySQL数据库进阶实战
立即下载