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\.jupyter\jupyter_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
,成功解決