Jupyter 的通用配置方法#

摘要#

Jupyter 通用配置系统 Jupyter 应用程序有一个通用的配置系统,以及一个通用的 配置目录。默认情况下,该目录是 ~/.jupyter

内核配置目录 如果内核使用配置文件,这些文件通常会为每个内核组织在单独的目录中。例如,IPython 内核会在 IPython 目录 中查找文件,而不是默认的 Jupyter 目录 ~/.jupyter

Python 配置文件#

要创建一个默认配置文件,请运行:

jupyter {application} --generate-config

生成的文件将被命名为 jupyter_application_config.py

通过编辑 jupyter_application_config.py 文件,您可以像这样配置类属性:

c.NotebookApp.port = 8754

注意拼写。错误的名称将被直接忽略,不会有错误信息。

要向可能在别处已经定义的集合中添加内容,可以使用类似于列表、字典和集合中的方法:appendextendprepend`(类似于extend,但在前面)、``add`()``update``(对字典和集合都适用):

c.TemplateExporter.template_path.append('./templates')

配置的命令行选项#

每个可配置的值也可以通过命令行设置并作为参数传递,使用以下语法:

jupyter notebook --NotebookApp.port=8754

常用的选项也会有短别名和标志,例如 --port 8754--no-browser

要查看缩写选项,请按如下方式传递 --help--help-all

jupyter {application} --help       # Just the short options
jupyter {application} --help-all   # Includes options without short names

命令行选项 将覆盖 配置文件中设置的选项。

参见

traitlets.config

此配置系统的底层架构。