跳转至

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 notebook

2. 使用 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 了。

绿色:可编辑状态

蓝色:可操作状态(例如删除操作需要单元格变为蓝色)

蓝绿切换使用 EscEnter 切换。

编辑时快捷键:

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 -N

3.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.woff2SourceHanSansSC-VF.ttf 复制到该文件夹。

搜索 font-family 修改为 18pxline-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

创建日期: 2017-01-11 17:00:00
最后更新: 2022-07-30 02:00:00

评论