用 Sphinx 搭建博客时，如何自定义插件？

之前有不少同学看过我的个人博客（http://python-online.cn），也根据我写的教程完成了自己个人站点的搭建。

点此：使用 Python 30分钟 教你快速搭建一个博客

为防有的同学不清楚 Sphinx ，这里还是做下简单的介绍。

它是一个能够把一组 reStructuredText 或者 Markdown 格式的文件转换成各种输出格式，而且自动地生成交叉引用，生成目录等的一个文档编排工具。

不得不说，它的排版功能强大、非常清晰，顔值非常高。

但是使用这个方法搭建的博客，一直有一个痛点，就是无法自定义页面，自由度非常的低（和 WordPress 真的没法比）。

这就导致我一直不知道到底有没有人访问我的网站？

他们都是从哪来访问的，Google 还是 百度？

每篇文章都有多少人访问，哪篇文章受欢迎？

我一直在我的博客上贴上我的公众号二维码，可到底因此关注我的人有多少呢？

因此我一直希望能找到一个能够收集网站访问数据、并且能将博客上的访客引导到公众号上来的方法。

终于在昨天，我找到了，并花了两天的时间成功上线。

方法就是引入两个 JavaSript 插件实现（这个在早期的 Sphinx 版本中是不支持的）。

个插件：导流工具

作用：这个主要用来将自己博客上流量引到自己的公众号上。

具体是思路是：

游客无法阅读博客的全部内容，因为会有一半的内容会被隐藏。就像这样。

如想要阅读全文，可以点击全文进行解锁：用微信扫描二维码关注我的个人公众号，发送 more ，将获取到的验证码填入如下文本框提交即可解锁本博客的所有干货文章。

思路有了，那么如何实现呢？

以上功能其实已经有人已经做出来并可以提供免费使用。

你可以在 https://openwrite.cn/ 注册一个帐号，然后在里面你可以看到一个导流工具，填写你的公众号及引流的相关信息后，就初始化成功，获得一串js代码。

接下来，你要做的就是将这串js接入你的博客页面中。

由于我去年搭建这个博客时使用的 Sphinx 的版本是 1.7 ，这个版本是不支持自定义css/js 文件的。

因此，你要使用引入这段js代码，需要将你的 Sphinx 升级到 1.8+，我使用的是新版本的 2.1 ，这个版本只支持 Python 3.5+。

因此在使用之前，我得先将环境的切换至 Python 3.5+。

virtualenv -p /usr/bin/python3.6 myblog