Question

我在.rst文件中有以下文字：

Some text.
* Heading
  | The first topic.
  | Another topic which is very verbose and spans multiple lines ad infinitum.
  Topic continued......................................

我希望它呈现为：

Some text.
* Heading
  The first topic.
  Another topic which is very verbose and spans multiple lines ad infinitum....................
  Topic continued.............

然而它在Html中呈现如下：

Some text.
* Heading| The first topic.| Another topic which is very verbose and spans multiple lines ad infinitum .................... Topic continued

Sphinx文档建议使用|符号来表示换行符，就像Stackoverflow上的几个帖子一样，但是我无法让它工作。我想要一个独立于正在使用的Sphinx构建器的方法。

元素之间的空行确实有效，但不能提供我想要的视觉效果。

我需要做什么？

Answer 1

分两步完成。

首先让你的reStructuredText使用正确的空格来生成一个可用的HTML结构，并应用默认的视觉样式。

elig

第二次覆盖默认样式表以生成所需的视觉效果，如此SO帖子How do I set up custom styles for reStructuredText, Sphinx, ReadTheDocs, etc.?中所述。

Answer 2

如果将以下内容添加到主.rst文件中：

.. |br| raw:: html

   <br />

然后在您的标记中添加| br |创建仅用于HTML的换行符。

I want to break this line here: |br| after the break.

Sphinx中普通文本中的换行符

2 个答案: