Python “存储Jupyter笔记本”；“孤儿”；百分比格式脚本中的元数据

我有一个Jupyter笔记本，我想把它添加到其中。这可能吗

到目前为止，我已经尝试：

在UI中编辑元数据并保存（不更新脚本）

将其保存为.ipynb，编辑元数据，并使用

jupytext--转换回py:percent

（不保留元数据）

如中所述，手动添加YAML标头，如下所示：

---

所有这些似乎都不起作用，因为sphinx仍在生成一个“警告：文档未包含在任何目录树中”。

我没有尝试过，但这可能有效：

# ---
# jupyter:
#   nbsphinx:
#     orphan: true
# ---

---

Sphinx发出的警告意味着其扩展名在Sphinx处理的

conf.py

中配置的文档不会列在Sphinx处理的任何其他文件的

toctree

指令中。见@StevePiercy的文档是的，我知道。孤儿指令是禁用该警告，同时仍允许将笔记本链接到（而不在toc中显示）。如果笔记本元数据在翻译过程中丢失，则应在以下位置创建问题：。

# ---
# jupyter:
#   nbsphinx:
#     orphan: true
# ---