「这是我参与2022首次更文挑战的第24天,活动详情查看:2022首次更文挑战」
发布至gitee
-
上面我们已经可以发布书籍项目了。 但是我们写书就是为了共享,仅仅在本地是满足不了共享的目的的。笔者一直写的博客就是通过hexo 放在gitee上的。那么我们的book也是可以用同样的方式实现的。
-
基于之前hexo实现的博客系统,本次笔者采用git 分支来管理项目的源码和html统一管理。
-
首先我们在gitee上创建一个项目,创建细节不多说。需要注意的是在gitee上创建好之后我们需要立马再创建一个分支。这样两个分支用来存放不同的项目文件
-
这里时候两个分支都是空的。然后我们将刚才的oschina/gitbook文件夹上传至刚才那个项目,但是我们需要忽略doc文件夹因为这个分支我们用来
-
存放项目md格式源码
-
同理我们在将content忽略,将doc提交到另外一个分支。
-
这里的具体细节不多少,分支的切换 , 创建, 管理 建议大家网上百度
廖雪峰老师的博客
新增章节
- 写书是一个过程,章节也是不断的新增的,所以我们以后会慢慢的新增章节,我们新增只需要在content中新增,新增好我们在content中执行gitbook init ,然后在oschina/gitbook中执行构建命令,执行完之后我们只需要将doc目录同步到page分支就行了。到这里我们就设置完成了,接下来我们需要设置gitee的page服务了
gitee page
- 在我们项目中有服务选项,选择page服务,然后选择page分支下的doc目录。 开启之后等待几分钟就可以了
-
我们在master分支中执行
npm run build之后会生成doc, 但是我们发现现在是master分支,这个doc不需要上传,但是需要上传到page分支。 我们可以直接将doc提交到远程page分支 git push -u origin master:page 其中是将master(当前分支)提交到page(远程分支) -
因为我们master已经将doc过滤了,所以这里我们上处提交应该会报错
-
我们可以先将doc提交到本地的page分支
git checkout origin/page ./doc page就是本地的分支 ./doc 将doc提交到本地page分支。
- 然后切换到page分支进行add、commit、push
总结
- 读者可以不用这么麻烦创建分支。在gitee的page服务中选择我们的master分支的doc文件夹是一样的效果。前提是master分支将doc提交上来。