1.1 拉取镜像到本地

网络问题无法从docker hub拉取镜像，可以选择从下面我的私有仓库中获取（留言联系我）
docker pull registry.cn-beijing.aliyuncs.com/bigdater/gitbook:latest
(2)以下命令使用gitbook镜像

1.2 初始化书籍地址

此操作会自动创建README.md和SUMMARY.md两个文件

docker run --rm -v "$PWD:/gitbook" -p 4000:4000 registry.cn-beijing.aliyuncs.com/bigdater/gitbook gitbook init

1.3 安装插件

插件需要配置在book.json中，使用前先执行如下命令安装

docker run --rm -v "$PWD:/gitbook" -p 4000:4000 registry.cn-beijing.aliyuncs.com/bigdater/gitbook gitbook install

1.3 启动本地server

主要用于在本地编写时能随时看到效果

docker run --rm -v "$PWD:/gitbook" -p 4000:4000 registry.cn-beijing.aliyuncs.com/bigdater/gitbook gitbook serve

1.4 构建书籍

用于将Markdown格式的文件导出成静态页面

docker run --rm -v "$PWD:/gitbook" -p 4000:4000 registry.cn-beijing.aliyuncs.com/bigdater/gitbook gitbook serve

2.VScode中配置picgo图床

picgo是一款vscode插件，用于在vscode中将图片上传至七牛云、阿里云等网络存储上，并返回Markdown格式的图片URL。避免了手动上传图片并获取URL的麻烦，可以提高创作效率。
picgo支持从剪切板获取图片，只需要使用截图工具截取图片，然后使用快捷键上传就行。
初次之外它还支持通过文件浏览器和vscode的文本输入框上传图片。各种上传方式的快捷键见下图：

2.1 picgo安装

在vscode的插件市场直接搜索并安装就行

2.1 配置

安装好之后点右边齿轮，选“Extension Settings”,进去之后选择要使用的图床，我这里选了使用七牛云

紧接着在配置中填上七牛云账户的AK信息，然后截图使用快捷键上传测试，如果上传成功则表示配置没问题。

2.2 其他事项

如果页面配置了https,但是七牛云的图库没有配置https，图片是无法预览的。配置七牛云HTTPS的方法按官网引导就行。

没有https证书可以去阿里云获取免费的有效期为三个月的个人证书。

3.书籍版本管理

书籍的markdown文件可以推送到阿里云免费的代码仓库中，这样做的好处是既能有版本管理，又可以在服务端定时拉取markdown构建，做到本地书籍更新，线上自动同步更新。

4.nginx配置书籍静态文件代理

在nginx.conf文件的server配置中新增location配置
text
location /gitbook/skill/ {
alias /static file path/;
}

这里需要注意的是nginx的启动账户要有权限访问书籍静态文件所在目录的权限。

一般Nginx会在配置文件的开头通过user nginx定义启动Nginx的用户为nginx,这个时候如果nginx用户对static file path没有访问权限就会在页面上报403错误。

解决办法之一就是给Nginx用户赋上对应目录的权限，或者把Nginx启动用户换成对静态文件目录有访问权限的用户。