使用Sphinx,如何删除侧栏上下文中出现的标题？

Question

说我的some.rst文件看起来像这样:

============
My Title
============

1. Section
================

2. Section
=================

编译完成后,在some.html侧栏中会出现一个目录,显示为:

我的头衔

1. 部分
2. 部分

有没有一种简单的方法可以从目录中删除"我的标题" some.html？

Answer 1

我能够通过使用上述.. raw:: html方法解决这个问题，稍作调整（避免破坏自动生成的 TOC）。如前所述，如果您的文件只包含.. raw:: html标题，则会破坏 Sphinx 自动生成的目录。但是，如果您在其下方使用.. raw:: html和添加---------------------，它不会显示在左侧导航中，也不会破坏 TOC。例如

所以我终于意外地想出了如何让标题不显示在左侧 TOC 中。如果您的文件只包含.. raw:: htmlh2 标题，它将破坏 sphinx 自动生成的目录（如 stackoverflow 文章中所述）。但是，如果您使用.. raw:: html和---------------------在它下方，它不会显示在左侧导航中，也不会破坏 TOC :star2: eg

.. raw:: html

   <h2>What Can I Do With KSQL?</h2>

---------------------

Answer 2

最简单的方法是使用 TOC 指令忽略的对象类型：

.. rubric:: My Title

这将创建看起来有点像标题的文本，但从目录中排除。您可以使用您想要的类的任何样式来更新 CSS 文件.rubric，如果您愿意，甚至可以模仿 h1 样式。

有关如何定义标题样式类的信息，请参阅“重构文本页面中的非 TOC 标题”。