Gitbook进阶篇
集成 github 网站
为什么选择集成到github?
- 使用零成本: github pages 集成在 github 中, 直接和代码管理绑定在一起, 随着代码更新自动重新部署, 使用非常方便.
免费: 免费提供 http://username.github.io 的域名, 免费的静态网站服务器.
无数量限制: github pages 没有使用的数量限制, 每一个 github repository 都可以部署为一个静态网站.
什么是 GitHub Pages ?
Github Pages
是 github
网站推出的一种免费的静态网页托管服务,适合搭建静态的项目主页或个人官网。
其中,网站项目的源码直接托管在 github
仓库中,当仓库文件更新后,该仓库所关联的网站自动更新,从而实现了源码与官网的联动更新。
每个账号有且只有一个主页站点,但允许无限制多的项目站点。
主页站点:https://<username>.github.io/
项目站点:https://<username>.github.io/repository/
如何集成 gitbook ?
我们已经知道 Github Pages
是提供静态网站的免费托管,而 gitbook
默认生成的内容就是静态网站。gitbook
默认输出目录 _book/
包括了静态网站所需的全部资源,其中就包括 index.html
首页文件。我们需要做的就是,这_book下的所有文件复制一份到根目录或./docs
(取决于你github中的设置)。以为复制到./docs为例:
每次生成后将
_book/
整个目录复制到项目根目录或者定的docsgitbook build cp -r _book/* .
gitbook build,可以指定输入文件
gitbook build ./ ./docs
book.json中设置output参数。(无效,不知道是什么原因。如果你知道,欢迎在下方给我留言)
# book.json { "output": "./docs" }
Openwrite
OpenWrite(官网:https://www.openwrite.cn)一文多发平台。只需要你使用 markdown 完成内容写作,通过文章扩散工具,就能轻松将文章内容到科技人汇聚的内容平台。从而让各个平台的读者都能看到你的内容,从而了解你,并提升你的综合影响力!
一文多发
OpenWrite
提供的众多功能中最吸引我的地方莫过于一文多发功能了:我在用的平台它都有,我没用的平台它也有!
平台整体上使用体验非常不错,大致步骤是先提前登陆各大目标平台,然后通过 OpenWrite
提供的插件自动进行渠道认证,配置各大渠道后就可以愉快发文啦!
公众号引流
如果你有自己独立博客,也在运营者微信公众号,但是苦于没有很好的手段引导读者关注公众号,那么Openwrite
推出的 ReadMore
工具绝对可以解决燃眉之急。
- 静态博客网站集成
ReadMore
工具后,全站博客文章内容自动隐藏一半,同时浮现出阅读全文的按钮引导读者点击解锁。 - 一旦读者想要阅读全文就会主动点击按钮,此时就会自动弹出引导用户关注公众号的弹窗。
- 接下来读者应该是关注公众号回复关键字获取验证码进而解锁文章。
- 读者关注公众号后,发送关键字获取文字链接并点击该链接,此时就会获取验证码,离成功只差一步!
- 再次回到博客平台的受限文章,输入刚刚获取到的验证码,不仅解锁了当前文章,博客内的其他文章也全部自动解锁,并不会造成不好体验,完美!
gitbook集成openwrite
安装
openwrite
插件。即在book.json
配置,然然gitbook install
{ "plugins" : ["openwrite"], "pluginsConfig":{ "openwrite":{ "blogId": "", "name": "", "qrcode": "", "keyword": "" } } }