主题指令无法正确显示(使用 "agogo" 主题)

Topic directive won't display correctly (using "agogo" theme)

我正在使用 Sphinx 和 reStructuredtext 创建文档。我想使用主题指令使页面上的重要信息更加引人注目。

Stuff
=====
Things I need to say.

.. topic:: before using this:

    -You must do the thing

    -Do the other thing

Continue
========

Other stuff

但是输出是:

东西

有话要说

使用前:

-你必须做这件事

-做另一件事

继续

主题指令不起作用,我做错了什么?我有一个参数,指令调用和主题正文之间有一个空行。 html 构建并且没有抛出任何错误。

reStructuredText 项目符号列表项需要紧跟在项目符号之后的白色 space。参见 Bullet Lists

修复:

Stuff
=====
Things I need to say.

.. topic:: before using this:

    - You must do the thing

    - Do the other thing

Continue
========

Other stuff