文章目录
Jupyter-slides制作PPT入门指导
环境依赖
- IDE选择Visual Studio Code(简称VScode)
- VScode需要配置的插件如下:
- Jupyter
- Python
- Jupyter
- Python环境
- 纯Python编译器 + pip,笔者没有测试,但是只要配置好环境变量后肯定是没有问题的。
- Anaconda环境,使用Anaconda提供好的虚拟Python环境,下载链接
1.1 在官网完成登记后便可以下载win64版本的Anaconda安装包,根据安装程序一步步地完成安装,笔者暂时没有测试用的环境,以后会用win11的虚拟机做一次全过程。不过整个过程还是比较简易的,相信读者肯定可以完美通关。
1.2 将Anaconda加入到环境变量中,不同于一般的应用放置可执行程序的位置,Anaconda将可执行程序放置到了\Scripts
文件夹下,所以配置环境变量的时候请读者注意。
初级使用Jupyter-slides
前提知识
- 基础的HTML+CSS知识
- 基础的Markdown知识
- 基础的Anaconda使用
- 基础的Jypyter notebook使用
Demo
Step 1. 创建Anaconda的虚拟环境 Demo
在windows10/11 电脑上可以使用cmd或者powershell使用Anaconda。为了简单起见,笔者在cmd中创建演示如何创建一个虚拟的Python环境,后续再补充powershell的方法。
(1) 在cmd中输入conda create -n Demo python=3.10
,下面介绍这个命令:
conda create
是Anaconda创建虚拟Python环境的命令;
-n Demo
是我们要新建的Python虚拟环境的名称;
python=3.10
是可选自定参数,指定我们使用3.10版本的Python。
(2) 激活新建的 Python 虚拟环境 Demo。
在cmd中输入下面的命令:
conda activate Demo
(3) 在Python 虚拟环境 Demo 中下载 Jupyter
在 cmd 终端中输入下面的命令:
conda install jupyter
Step 2. VScode中使用Python虚拟环境 Demo
Step 3. VScode中制作 Jupyter-slides
(1) 选定Jupyter编辑内容的类型为slides/subslides类型
(2) 创建如下结构的Demo PPT
总的来说,我们应该总是自左向右扫描每一个分支,主干是slides类型,分支为subslides类型。受限于sldies类型的层级数量,一定不要超过三级目录。
(3) 将创建的Demo PPT变成Jupyter-slides
我们需要在 VScode 集成的 cmd 终端窗口中输入jupyter nbconvert <filename> --to slides --post serve
命令,可能有些读者的 VScode 默认集成终端是 powershell,这时候我们需要新打开一个 cmd 终端,如下图所示:
我们新打开的 cmd终端不一定是我们想使用的虚拟 Python 环境,这时我们需要在 cmd 终端输入
conda activate Demo
激活我们新建的 Demo 虚拟 Python 环境,如下图所示:
最后输入命令
jupyter nbconvert demo.ipynb --to slides --post serve
等待片刻浏览器会自动为我们打开创建好的Jupyter-slides,如下图所示:
按下ESC键,可以查看整个PPT的详细布局:
笔者已将 Demo 的代码免费放在了 优快云 上了,下载地址
总结
实质上,jupyter nbconvert demo.ipynb --to slides --post serve
就是使用 Jupyter 的 nbconvert
库具备的功能将我们的 Markdown 内容转换成一个排版精美的HTML网页,我们在工作目录下是可以看到一个名为demo.slides.html,这就是 Jupyter 帮我们自动生成的 HTML 网页。