覆盖 # 样式嵌套列表的空格缩进数量

Question

将 Sphinx 3.2.1 与 reST 结合使用

你好， 我想进行 3 个空格的缩进，以便图像与上面的文本右对齐。 但是，它会破坏列表并执行 2 个单独的嵌套列表。因此，我必须手动定义列表的数量，但我宁愿使用 # 样式。

这是我想要的清单：

#. Nested list point 1 
   
   .. image:: image.png
        :alt: This is an image
        :scale: 100%
|

#. Nested list point 2

这是我需要编写的正确列表（带有选项卡）的列表：

#. Nested list point 1 
   
        .. image:: image.png
                :alt: This is an image
                :scale: 100%
|

#. Nested list point 2

有什么解决方案可以覆盖 Sphinx 中的该规则吗？此版本的 Sphinx 的替代解决方案？或者有最新的吗？

我尝试了不同的缩进组合并移除管道|

提前致谢！

Answer 1

下面的代码片段对我有用，除了右对齐。 reStructuredText 的

image

指令是一个块指令，不直接支持内联属性。您可以注入原始 HTML，但这将是一个丑陋的黑客行为。

重新结构化文本

#.  Nested list point 1

    .. image:: image.png
        :alt: This is an image
        :scale: 100%
        :class: my-right-align-class

#.  Nested list point 2

HTML

<ol class="arabic">
<li><p>Nested list point 1</p>
<a class="my-right-align-class reference internal image-reference" href="image.png"><img alt="This is an image" class="my-right-align-class" src="image.png" style="width: 958.0px; height: 276.0px;"></a>
</li>
<li><p>Nested list point 2</p></li>
</ol>

显示

但是可以通过使用替换来解决。

重新结构化文本

.. |myimage| image:: image.png
    :alt: This is an image
    :scale: 100%
    :class: my-right-align-class

#.  Nested list point 1 |myimage|

#.  Nested list point 2

HTML

<ol class="arabic">
<li><p>Nested list point 1<a class="my-right-align-class reference internal image-reference" href="image.png"><img alt="This is an image" class="my-right-align-class" src="image.png" style="width: 958.0px; height: 276.0px;"></a></p></li>
<li><p>Nested list point 2</p></li>
</ol>

现在图像已内联于

<p>

。

从现在开始，您可以将其放入您的

conf.py

中。

html_css_files = [
    'css/custom.css',
]

...然后创建一个类名为

my-right-align-class

的自定义样式，并将其放入文件

css/custom.css

中，然后进行修改以获得您想要的效果。您可以使用浮动，但这会将其排除在列表流之外。样式留给您根据自己的喜好进行设计。现在它是内联的，您可能不希望它右对齐。

我还建议使用 4 个空格进行缩进。有关说明，请参阅 https://stackoverflow.com/a/48313531/2214933 和 https://stackoverflow.com/a/45683081/2214933。