一个Jupyter文件典范

[1]NetworkX Developers, Tutorial, Oct 17, 2019
[2]Olivia Smith, Markdown in Jupyter Notebook, August 6th, 2019
[3]Tahsin Mayeesha, Present Your Data Science Projects with Jupyter Notebook Slides!, Feb 12, 2018
[4]大数软体有限公司，「如何安装 Jupyter (Ipython Notebook)」，2017-10-31，

Jupyter是我最喜欢的Python编辑器。我看到一个Jupyter文档典范——NetworkX Tutorial[1]。

Tutorial是networkx module的使用指南，文末可以下载Jupyter文档。

• Download this page as a Jupyter notebook (no outputs);

• Download this page as a Jupyter notebook (with outputs).

下载后请拷贝到Jupyter启动文件夹下，就可以用Jupyter打开，可以看到和网页一模一样。

为什么网页的文字会在Jupyter中rendering完好？因为Jupyter支持两种cell：1）python，2）markdown，都可以运行。Markdown cell双击可看到Markdown源码。Markdown in Jupyter Notebook[2]对Jupyter中使用Markdown有很好的示例。

我初步的直觉是：代码注释自由。

编程有个困难某些情况下没法在注释中说清楚算法，如涉及数学公式。一旦没有说明，代码很难读。注释也不支持图片，所以通常注释啰嗦，有的程序注释不支持中文，还需要另外写文档解释，不是self-contained。Jupyter支持Markdown，便支持数学公式。 

Jupyter是文本和代码的结合。

如果存为Python脚本文档，重点偏向代码硬核，可直接当程序运行了。用Sublime打开，发现所有文字变成注释。

如果安装pandoc了，可存为latex文档。重点偏向数学公式，可以生成pdf。我终于见到了其他文档格式转成Latex。非常复杂，但至少有了，Latex的重点是符合学术论文的模板，也许能做点什么。也支持直接存为pdf文档。

如果存为markdown文档，可直接上传至Github blog repo发布为Github博文。

还可以直接用于技术演讲，将其改成PPT。重点偏向观点的组织和程序演示。Present Your Data Science Projects with Jupyter Notebook Slides![3]介绍了如何做成PPT文档。

还有本例，写Tutorial。如果一个人贡献于Opensource，发布一个Python module，既要写demo故事，又要写代码，又要运行代码得到结果，还要写成网页。

视频「如何安装 Jupyter (Ipython Notebook)」[4]介绍如何安装Jupyter（Ipython notebook）。

在Command window输入安装命令：

1	pip3 install "ipython[notebook]"

安装结束后，转入自己想要的Jupyter工作文件夹，输入以下命令启动Jupyter：

1	python3 -m IPython notebook