Jupyter 使用指南¶
0. 介绍¶
目前分为两个版本：JupyterLab 和 Jupyter Notebook
JupyterLab ：下一代的 Notebook 接口
JupyterLab 是一个基于 web 的交互式开发环境，用于处理 Jupyter Notebook，代码和数据。它是灵活的：配置用户界面，以支持数据科学、科学计算和机器学习等大量工作流。它是可扩展和模块化的：编写插件、添加新组件以及和现有组件集成。
Jupyter Notebook
Jupyter Notebook 是一个开源的 web 应用，允许你创建和共享包含实时代码、方程式、可视化和叙事文本的文档。用途包括:数据清理和转换，数值模拟，统计建模，数据可视化，机器学习，等等。
Voilà
Voilà 帮助您沟通的见解，通过将一个 Jupyter Notebook 转换成一个独立的 web 应用程序，您可以分享。它让您可以在一个安全且可定制的交互式仪表板中控制读者的体验。
如果要稳定使用并提供中文建议使用 Jupyter Notebook，尝鲜且使用英文可以使用 JupyterLab 。
1. 安装 Jupyter¶
# 安装 JupyterLab
pip install jupyterlab
# 安装 中文语言包，可能提示无法找到满足要求的版本，而无法安装
pip install jupyterlab-language-pack-zh-CN
# 启动 JupyterLab
jupyter-lab
# 安装 Jupyter Notebook
pip install notebook
# 启动 Jupyter Notebook
jupyter notebook2. 使用 Jupyter Notebook¶
cd 我们希望启动为NoteBook的根目录
jupyter notebook
# 中文可使用下面方式
# Windows Powershell
$env:LANG="zh_CN.UTF-8"
# Windows CMD
set LANG="zh_CN.UTF-8"
# macOS
export LANG="zh_CN.UTF-8"
# Linux
export LANG="zh_CN.UTF-8"
# 运行
jupyter notebook这样就会以该目录为根目录启动 jupyter notebook 了。
绿色：可编辑状态
蓝色：可操作状态（例如删除操作需要单元格变为蓝色）
蓝绿切换使用 Esc 和 Enter 切换。
编辑时快捷键：
Ctrl+Enter ： 运行当前单元格。
Shift+Enter ：运行当前单元格，并选中下一单元格。
Alt+Enter ：运行当前单元格，并选中上一单元格。
都为蓝色时：
s ：保存文件。
a ：在前面添加新单元格。
b ：在后面添加新单元格。
x ：剪切当前单元格。
c ：复制当前单元格。
v ：粘贴复制的单元格，在当前单元格之后。
Shift+v ：粘贴复制的单元格，在当前单元格之前。
d,d ：连按两下，删除当前单元格。
z ：撤销上次操作。
y ：更改单元格类型为 Code。
m ：更改单元格类型为 Markdown。
r ：更改单元格类型为 Raw NBConvert。
3. 高级使用¶
代码字体容易混淆，没有代码的智能提示等问题。
3.1. 调整字体(使用 jupyter-themes)¶
安装 jupyter-themes
# 安装
pip install jupyterthemes
# 更新
pip install --upgrade jupyterthemes参数说明：
| cl options | arg | default |
|---|---|---|
| Usage help 用法帮助 | -h | -- |
| List Themes 列出主题 | -l | -- |
| Theme Name to Install 要安装的主题名称 | -t | -- |
| Code Font 代码字体 | -f | -- |
| Code Font-Size 代码字体大小 | -fs | 11 |
| Notebook Font 笔记本字体 | -nf | -- |
| Notebook Font Size 笔记本字体大小 | -nfs | 13 |
| Text/MD Cell Font 文本/Markdown 字体 | -tf | -- |
| Text/MD Cell Fontsize 文本/Markdown 字体大小 | -tfs | 13 |
| Pandas DF Fontsize | -dfs | 9 |
| Output Area Fontsize 输出区字体大小 | -ofs | 8.5 |
| Mathjax Fontsize (%) Mathjax 字体大小百分比 | -mathfs | 100 |
| Intro Page Margins 介绍页边距 | -m | auto |
| Cell Width 宽度 | -cellw | 980 |
| Line Height 行间距 | -lineh | 170 |
| Cursor Width 光标宽度 | -cursw | 2 |
| Cursor Color 光标颜色 | -cursc | -- |
| Alt Prompt Layout Alt 提示布局 | -altp | -- |
| Alt Markdown BG Color Alt Markdown BG 颜色 | -altmd | -- |
| Alt Output BG Color Alt 输出 BG 颜色 | -altout | -- |
| Style Vim NBExt* | -vim | -- |
| Toolbar Visible 工具栏可见 | -T | -- |
| Name & Logo Visible 名称和徽标可见 | -N | -- |
| Kernel Logo Visible 内核徽标可见 | -kl | -- |
| Reset Default Theme 重置默认主题 | -r | -- |
| Force Default Fonts 强制默认字体 | -dfonts | -- |
我常用命令如下：字体列表
主题设置为：onedork
行间距为：120
宽度设为：1200
光标颜色：r (red)【这个要根据主题变化否则看不清光标位置】
代码字体使用：Consolamono
文本使用字体：PT Mono
字体全部设置为：14
显示工具栏，显示名称和标徽
jt -t onedork -lineh 120 -cellw 1200 -cursc r -f consolamono -tf ptmono -fs 14 -nfs 14 -ofs 14 -tfs 14 -T -N3.2. 调整字体(不使用 jupyter-themes)¶
打开文件： C:\Tools\PVEs\TensorFlow\Lib\site-packages\notebook\static\components\codemirror\lib\codemirror.css
修改文件中的 .CodeMirror 样式的字体即可修改代码样式：
/* 例如修改为如下样式 */
@font-face {
font-family: "Source Code Pro";
font-weight: normal;
font-style: normal;
src: local('"Source Code Pro"'), url("SourceCodePro-Regular.ttf.woff2") format("truetype");
}
@font-face {
font-family: "Source Han Sans";
font-weight: normal;
font-style: normal;
src: local('"Source Han Sans"'), url("SourceHanSansSC-VF.ttf") format("truetype");
}
.CodeMirror {
/* Set height, width, borders, and global font properties here */
font-family: "Source Code Pro", "Source Han Sans", monospace;
height: 300px;
color: black;
direction: ltr;
}同时将 SourceCodePro-Regular.ttf.woff2 和 SourceHanSansSC-VF.ttf 复制到该文件夹。
搜索 font-family 修改为 18px ， line-height 修改为 22px
3.3. 智能提示¶
# 安装
pip install jupyter_contrib_nbextensions
pip install jupyter_nbextensions_configurator
# 安装插件
jupyter contrib nbextension install
jupyter nbextensions_configurator enable安装后启动 notebook 会看到 nbextensions 菜单，勾选下列项目：【如果为灰色去掉 disable 的勾即可】
- Hinterland：自动补全
- Code prettify：代码格式化（需要安装 yapf）
- Table of Contents (2)：生成一个浮动的 TOC
最后更新: 2022-07-30 02:00:00