我是靠谱客的博主 正直长颈鹿,这篇文章主要介绍Centos之GitBook文档工具安装与使用-yellowcong,现在分享给大家,希望可以做个参考。

我看了GitBook这个文档工具,用得都挺多的,而且看起来很简约,是很适合做文档工具的。GitBook的安装是依赖于nodejs的npm,所以需要将nodejs安装好,然后通过npm工具安装GitBook。然后本次还做了一GitBook的案例,直接就可以访问我的文档了,老爽了。

首先Gitbook和Git/Github都没有什么关系。它只是一个build book的工具而已。但它的Git前缀的确引起了许多人的迷惑,起初我认为至少它也是个和Github类似的Git平台吧,但其实没什么关系,你只要懂几条markdown语法,不必理解任何与Git相关的东西就能用Gitbook了,不要为其名字迷惑。

生成的文档效果图,看起来很漂亮吧
这里写图片描述

看我做的效果
这里写图片描述

Nodejs安装

复制代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
#创建目录 mkdir -p /usl/local/nodejs && cd $_ #官方下载地址 wget https://nodejs.org/dist/v8.9.0/node-v8.9.0-linux-x64.tar.xz #我的七牛地址 wget http://yellowcong.qiniudn.com/node-v8.9.0-linux-x64.tar.xz #解压,这个是tar.xz文件,NMD,直接就是二进制的,加压后不需要编译就可以了 tar -xvf node-v8.9.0-linux-x64.tar.xz #配置环境变量 vim /etc/profile export NODEJS=/usl/local/nodejs/node-v8.9.0-linux-x64/bin export PATH=$PATH:$JAVA_HOME/bin:$JRE_HOME/bin:$NODOEJS #环境生效 source /etc/profile #查看版本信息 npm -v node -v

大家可以发现npm和npx是软连接的
这里写图片描述

环境变量配置
这里写图片描述

版本查看
这里写图片描述

GitBook安装

复制代码
1
2
3
4
5
6
7
8
9
10
11
npm install gitbook -g #想在系统上的任何地方的gitbook命令,需要安装“gitbook CLI”,执行以下命令 npm install gitbook-cli #查看gitbook版本,注意: V 是要大写的,小写不生效 gitbook -V #开启端口,后面一个.表示的是当前文件夹 gitbook serve -p 8080 .

后面看到了gitbook版本3.2.3,就表示安装成功了
列表内容

大家可以发现在nodejs的bin目录,发现了gitbook的命令
这里写图片描述

查看到的版本号
这里写图片描述

启动github服务
这里写图片描述

GitBook插件

复制代码
1
插件没用到,所以不讲拉。。。。。。。又需要再说

GitBook Editor 使用

官方的最新版本不能使用Markdown语法编辑,所以不爽,我用的还是老版本。我用的是gitbook-editor-4.2.1的版本

复制代码
1
2
3
4
5
6
7
8
9
#官网下载地址 https://www.gitbook.com/editor/ #我自己七牛云的下载地址(老版本4.2.1) #window下解压安装,这个window程序安装,我就不用教你了吧 http://yellowcong.qiniudn.com/gitbook-editor-4.2.1-windows-ia32.zip #这个是当前(2017/11)最新版7.x版本 http://yellowcong.qiniudn.com/GitBook.Editor.Setup.exe

登录到gitbook,这个玩意不能离线工作,必须在线操作,没有帐号的,自己注册一个

这里写图片描述

创建书

创建一本书
这里写图片描述

添加名称
这里写图片描述

创建完成后
这里写图片描述

目录结构说明

这里写图片描述

添加章节

新建文件和文件夹
这里写图片描述

添加文章的名称,后缀需要自己加上 .md,这样markdown才能打开
这里写图片描述

设置目录结构

目录结构需要和相应的文件对应上
这里写图片描述

下面是SUMMARY.md的代码,这个就是用来管理目录结构的

复制代码
1
2
3
4
5
6
7
8
9
# 我爱打酱油系列 ##第一章 * [1.1 我](第一章/chapter1.1.md) * [1.2 爱](第一章/chapter1.2.md) ##第二章 * [2.1 打](第二章/chapter2.1.md) * [2.2 酱油](第二章/chapter2.2.md)

发布到服务器上

1 上传到服务器

复制代码
1
2
#xxx 是替换的路径,看你自己的用户了, Import目录,有我们自己建立的那个demo的所有文件 C:UsersxxxGitBookLibraryImportdemo

这里写图片描述

上传到服务器上,然后通过服务器上的gitlab启动服务
这里写图片描述

2 启动文档服务

必须到bin目录下面才能使用gitbook命令

复制代码
1
2
3
4
5
#进入到这个目录,然后启动服务器 #必须在node的bin目录才能启动gitbook的命令 #启动gitbook服务器 gitbook serve -p 8080 /usl/local/nodejs/demo

大家可以看到,我指定的是8080端口,人家最后启动的是4000端口,我很无奈啊
这里写图片描述

看了一下后台,发现8080端口,它也在使用,这是想要闹哪样样啊
这里写图片描述

3 浏览器查看

注意,浏览器使用的地址的端口是4000端口,并不是8080端口
这里写图片描述

参考文章

Gitbook安装与使用教程 http://blog.csdn.net/feosun/article/details/72806825
Gitbook简易教程 https://segmentfault.com/a/1190000005859901
GitBook 简明教程 https://segmentfault.com/a/1190000004482449

最后

以上就是正直长颈鹿最近收集整理的关于Centos之GitBook文档工具安装与使用-yellowcong的全部内容,更多相关Centos之GitBook文档工具安装与使用-yellowcong内容请搜索靠谱客的其他文章。

本图文内容来源于网友提供,作为学习参考使用,或来自网络收集整理,版权属于原作者所有。
点赞(64)

评论列表共有 0 条评论

立即
投稿
返回
顶部