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
注意拼写。拼写不正确将直接被忽略,不会出现错误消息。
要添加到可能已在其他地方定义的集合,您可以使用列表、字典和集合上的方法: append
、extend
、prepend()
(类似于 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
此配置系统的底层架构。