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/ 整个目录复制到项目根目录或者定的docs

  gitbook build
  cp -r _book/* .

• gitbook build，可以指定输入文件

  gitbook build ./ ./docs

• book.json中设置output参数。（无效，不知道是什么原因。如果你知道，欢迎在下方给我留言）

  # book.json
  {
  	"output": "./docs"
  }

Openwrite

OpenWrite（官网：https://www.openwrite.cn）一文多发平台。只需要你使用 markdown 完成内容写作，通过文章扩散工具，就能轻松将文章内容到科技人汇聚的内容平台。从而让各个平台的读者都能看到你的内容，从而了解你，并提升你的综合影响力！

一文多发

OpenWrite 提供的众多功能中最吸引我的地方莫过于一文多发功能了：我在用的平台它都有，我没用的平台它也有！

image-20200501205202688

平台整体上使用体验非常不错，大致步骤是先提前登陆各大目标平台，然后通过 OpenWrite 提供的插件自动进行渠道认证，配置各大渠道后就可以愉快发文啦！

公众号引流

如果你有自己独立博客，也在运营者微信公众号，但是苦于没有很好的手段引导读者关注公众号，那么Openwrite 推出的 ReadMore 工具绝对可以解决燃眉之急。

• 静态博客网站集成 ReadMore 工具后，全站博客文章内容自动隐藏一半，同时浮现出阅读全文的按钮引导读者点击解锁。

• 一旦读者想要阅读全文就会主动点击按钮，此时就会自动弹出引导用户关注公众号的弹窗。

• 接下来读者应该是关注公众号回复关键字获取验证码进而解锁文章。

• 读者关注公众号后，发送关键字获取文字链接并点击该链接，此时就会获取验证码,离成功只差一步!

• 再次回到博客平台的受限文章，输入刚刚获取到的验证码，不仅解锁了当前文章，博客内的其他文章也全部自动解锁，并不会造成不好体验,完美！

gitbook集成openwrite

• 安装 openwrite 插件。即在 book.json 配置，然然gitbook install

  {
      "plugins" : ["openwrite"],
      "pluginsConfig":{
          "openwrite":{
              "blogId": "",
              "name": "",
              "qrcode": "",
              "keyword": ""
          }
      }
  }

参数链接

雪之梦技术驿站