Git之GitBook使用

744 阅读2分钟

GitBook

git+ markdown 进行文档编辑操作,同时支持多人对文档进行处理操作 参考:
GitBook 基本使用相关介绍: toolchain.gitbook.com/setup.html
GitBook 私有化部署相关介绍:skyao.gitbooks.io/learning-gi…

名称说明
GitBook EditorGitbook 图书编辑器(可视化markdown进行编辑操作)
GitBook CLiGitbook 提供的命令行工具,进行文件的转换操作
GitBookGitBook服务中心,进行gitbook版本管理、提供在线可视化book查看操作等
Git版本管理工具,类似SVN,可以进行分布式管理

GitBook 官方版本使用方式

使用官方提供的GitBook官方提供进行文档编写
参考:
www.gitbook.com/

前提:
注册GitBook帐号,使用GitBook Editor 进行登录管理操作

1.创建仓库
2.使用gitbook editor 同步仓库
3.编辑仓库文档相关
4.同步更新仓库信息

GitBook 私有服务器搭建使用方式

构建自定义GitBook服务器进行私有文档管理控制操作

自定义GitBook操作流程:

  1. gitbook editor 创建book

image.png

image.png

  1. 打开book并与git仓库进行关联

image.png

  1. 通过Jenkins 创建Job 实现配gitbook实现book 生成操作

GitBook Editor + GitLab 使用步骤

1. GitBook Editor 创建文档
2. GitLib 上创建仓库
3. 通过GitBook Editor >book 选项进行仓库绑定
4. 测试提交文档代码
名称说明
Nodejs安装nodejs 提供服务安装操作(gitbook-cli)
GitLab类似github 形式进行对git仓库的代码提供一个可视化管理操作
Jenkins项目持续集成管理操作
Nignxweb server提供静态资源访问服务

NodeJS

centos7 安装

1.选择安装方式i
源码
1.下载源码
2.配置环境变量
二进制包安装
https://www.digitalocean.com/community/tutorials/how-to-install-node-js-on-a-centos-7-server
https://linuxize.com/post/how-to-install-node-js-on-centos-7/

Jenkins

提供持续集成、自动运行操作 参考: jenkins.io/

安装配置相关

前提:
1.提前准备Java 环境
2.如果需要使用Maven 提前准备Maven环境
3.相关插件安装操作
4.shell 脚本编写了解

1.选择安装方式
二进制方式安装
war 形式运行按照

2.jenkins 执行过程
创建任务---->配置任务相关选项(如下图)------》实现自动化、持续集成
https://jenkins.io/doc/

GitBook CLI

GitBook 提供的基于nodejs的命令行工具主要对源码文档进行文档的生成(如:pdf等) 参考:
www.npmjs.com/package/git…

Nginx

web server ,可以作代理服务器进行使用操作,也可以作为静态资源服务器
参考:
github.com/jaywcjlove/…