前言
- gitbook使用可以在官方在线编辑进行发布使用,但是国内用户访问会很慢,需要梯子等比较麻烦,在这里采用docker + gitbook+typora + git自建方式进行搭建
一、环境准备
- 本地下载typora,用于编辑md文件,编辑方便,有丰富的模板可以套用
https://typora.io/windows/typora-setup-x64.exe
- 码云上创建仓库,同时本地下载git,这里就略过
二、使用步骤
1.创建文件夹
- D:\book
2.打开typora
3.通过typora打开文件夹D:\book
4.选择文档树,结构清晰,方便管理和编辑
5.如果使用gitbook,这里创建gitbook需要的两个文件
README.md
SUMMARY.mdREADME.md 为说明文件,描述书的大致内容
SUMMARY.md 为书的目录及结构定义
6.创建“安装”目录 install 以及md文件
7.编辑1.md,选择帮助–>选择模板,找到后复制过来
8.进入码云创建仓库,然后进入,推送到仓库
git init
git remote add origin http://xxxx/.git
git commit -m "add"
git push origin master
9.准备服务器linux centos7/8
mkdir -p /docker/gitbook/
- 下载book信息
git clone http://xxxx/.git
- 安装docker,个人喜欢用docker,安装方便
docker run -d --name gitbook -p 4000:4000 -v /docker/gitbook/heibao:/srv/gitbook fellah/gitbook