jupyter notebook
是一个比较比较不错的网页版python编辑器,但是,由于很多“技术文档”都是直接以markdown(.md格式的文件)的格式编写的,而且jupyter notebook
的代码文件(.ipynb)也可以转换成.md格式的文件,更为重要的是,我们从github
上下载的很多学习资料也都是.md文件格式的。因此,为了能够在jupyter notebook
上实现:
- 使用
jupyter notebook
浏览技术文档; - 将转换成.md格式的python代码在不用转换格式的情况下直接由
jupyter notebook
上打开并且运行代码; - 更加方便的由
jupyter notebook
看github
下载的资料。
我们需要在jupyter notebook
中加入能够阅读.md文件的功能。
安装流程:
anaconda
的下载与安装;- 如果在windows环境下需要配置一下
anaconda
的环境变量,即将anaconda
安装目录的bin
目录在环境变量中进行设置; - 现在,你就可以使用
anaconda
的命令conda
,使用命令conda create -n torch python=3.6
;(其中的torch是你所设置的环境名称,以后你可以将自己工作所需要的python库在该环境下下载,它可以根据自己的需求修改;python=3.6 是对该环境下所需的python版本的配置,可以根据需求修改) - 命令
conda activate torch
,激活刚才创建的环境,相当于进入到该环境下,如果要退出该环境,可以使用conda deactivate
;(但是,我在windows
环境下使用时,不需要加前面的conda
,自己可以试一试) - 进入刚才创建的环境后,
jupyter notebook
命令打不开相应的编辑器,因此我们需要安装它,安装命令conda install jupyter notebook
; - 安装成功后,使用命令
jupyter notebook
,就会弹出一个网页,并且将该目录的内容在在网页端编辑器中显示出来;(如图所示,是我打开的一个jupyter notebook
编辑器,对于每一个文件,都能打开并且进行编辑)
- 但是,当我们打开一个md文件时,仅仅只会显示markdown格式的源码,无法显示渲染后的格式,因此,我们需要为
jupyter notebook
添加可以相应的功能,
pip install notedown
,下载notedown
;- 修改jupyter notebook的配置文件
C:用户jluaa.jupyterjupyter_notebook_config.py
:添加c.NotebookApp.contents_manager_class = 'notedown.NotedownContentsManager'
;如果是ubuntu系统,在~/.jupyter/jupyter_notebook_config.py
中,有时需要命令jupyter notebook --generate-config
生成该配置文件;(前面无需加#) - 之后,通过
jupyter notebook编辑器
就能实现打开md文件的功能。
注意
本人在配置好上述所示的jupyter_notebook_config.py
文件后,在做其他项目时,另外创建了一个环境,下载好jupyter notebook
后启动时,有如下报错:
[C 07:13:23.105 NotebookApp] Bad config encountered during initialization:
[C 07:13:23.105 NotebookApp] The 'contents_manager_class' trait of <notebook.notebookapp.NotebookApp object at 0x0000013EA754BB38> instance must be a type, but 'notedown.NotedownContentsManager' could not be imported
对于该错误,其中提到了contents_manager_class
,所以可能和notedown
在该环境下未下载有关,经过pip install notedown
,成功解决