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启动用户换成对静态文件目录有访问权限的用户。