如何不克隆仓库而直接浏览Github上的Jupyter Notebook文档

在数据分析和机器学习领域的优势是Python变得愈发流行的主要原因之一，而很多数据分析和机器学习的工作是在Jupyter Notebook上进行的，越来越多的notebook（ipynb文件）也被放入了Github仓库里。

诚然自己动手把仓库克隆到本地，用Jupyter Notebook跑一遍代码是最正确的选择，但有时我们只是想看一下跑好的notebook（ipynb），而相当一部分notebook也是当作演示文稿放到仓库里的，所以我们需要一个直接在线观看notebook的途径。幸运的是Jupyter 官网就提供了nbviewer给我们。

nbviewer

nbviewer是Jupyter官方提供的在线notebook查看器，可以直接通过URL，Github 用户名和仓库，Gist ID来查看notebook文档。

例如查看pandas cookbook仓库的示例notebook，直接访问https://nbviewer.jupyter.org/github/jvns/pandas-cookbook/blob/master/cookbook/Chapter%201%20-%20Reading%20from%20a%20CSV.ipynb就可以了。

UserScript脚本

无论是打开nbviewer网站再输入仓库名称，还是直接输入链接访问，都稍微显得麻烦了一点。程序员最擅长创造性地偷懒，于是我写了一个用户脚本来自动在github上的ipynb文件预览页添加一个按钮来访问nbviewer网站。

代码的主要逻辑是：

 if (location.pathname.endsWith('.ipynb')){
        location.assign('https://nbviewer.jupyter.org/github' + location.pathname);
    }

管理用户脚本的浏览器拓展有很多，我最推荐的是TamperMonkey, 支持Chrome, Friefox，Edge和Safari浏览器，并且可以通过云服务备份用户脚本列表。

结语

当然还是希望Github可以直接预览notebook文件，相信微软的产品体验人员也会有这样的看法。

最后祝大家享受生活，享受代码。