【问题标题】:Topic directive won't display correctly (using "agogo" theme)主题指令将无法正确显示(使用“agogo”主题)
【发布时间】:2019-12-14 09:25:45
【问题描述】:

我正在使用 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 构建并且没有抛出任何错误。

【问题讨论】:

  • 我认为截图会有所帮助。修复了项目符号后,“主题框”有什么问题?你用什么主题?
  • @mzjn,我想要一个框来包围项目符号,在几个地方我看到人们使用主题指令将以下文本/项目符号包围在一个框中。我正在使用agogo。
  • 是的,agogo 主题的默认主题显示似乎不太好。

标签: python-sphinx restructuredtext


【解决方案1】:

reStructuredText 项目符号列表项需要紧跟在项目符号后面的空格。见Bullet Lists

修复:

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

.. topic:: before using this:

    - You must do the thing

    - Do the other thing

Continue
========

Other stuff

【讨论】:

  • 这对项目符号有帮助,但我如何让主题框显示在它周围
  • 你的主题支持主题吗?如果没有,那么您要么必须切换到使用它的主题,要么添加您自己的自定义 CSS。
  • 我认为我使用的主题 agogo 不支持它
猜你喜欢
  • 1970-01-01
  • 2023-04-10
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 1970-01-01
  • 2012-10-05
  • 1970-01-01
  • 1970-01-01
相关资源
最近更新 更多