reStructuredText 长节标题

reStructuredText long section title

有什么方法可以在 reStructuredText 中对长节标题进行换行?

我的 Linter 一直抱怨超过最大行长度,这让我抓狂。

有问题的章节标题包括 :any: 个参考文献,这些参考文献本质上不能改写得更短。

我已经左右搜索了 RST 教程,但找不到任何语法。

有问题的 RST 解释器是 Python 3.6 上的 Sphinx v1.8.5。

无法在 RestructuredText 中对节标题进行换行。

但是您可以使用 RestructuredText Substitutions 来完成您想要的。

例如

====================================
This is a |subst| long section title
====================================

.. |subst| replace:: (Insert this very long text,
                     which can even be line-wrapped)