reStructuredText长节标题

Question

在reStructuredText中有没有办法对长节标题进行换行？

我的Linter一直抱怨超过了最大行长度，这让我发疯。

有问题的部分标题包括:any:参考，本质上不能改写为更短。

我到处搜索了RST教程，但没有找到任何与此相关的语法。

正在讨论的RST解释器是Python 3.6上的Sphinx v1.8.5。

Answer 1

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

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

例如：

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

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