Jupyter 的通用配置方法#

摘要#

通用 Jupyter 配置系统 Jupyter 应用程序具有一个通用配置系统和一个通用的 config 目录。默认情况下,此目录为 ~/.jupyter

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

Python 配置文件#

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

jupyter {application} --generate-config

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

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

c.NotebookApp.port = 8754

注意拼写。拼写不正确将直接被忽略,不会出现错误消息。

要添加到可能已在其他地方定义的集合,您可以使用列表、字典和集合上的方法: appendextendprepend()(类似于 extend,但位于前面)、addupdate(适用于字典和集合)

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

此配置系统的底层架构。