reStructuredText 长节标题

Question

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

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

有问题的章节标题包括:any:参考文献，本质上不能将其改写得更短。

我左右搜索了 RST 教程，但没有找到任何语法。

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

Answer 1

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

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

例如

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

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