reStructuredText длинное название раздела

Question

Есть ли способ перестроить длинный заголовок раздела в reStructuredText?

Мой Линтер продолжает жаловаться на превышение максимальной длины строки, что сводит меня с ума.

Заголовок раздела, о котором идет речь, включает в себя:any: ссылки, которые по своей природе нельзя перефразировать, чтобы они были короче.

Я искал учебники RST слева и справа, но не нашел никакого синтаксиса для этого.

Рассматриваемый интерпретатор RSTSphinx v1.8.5 на Python 3.6.

Answer 1

Нет способа переназначить заголовок раздела в RestructuredText.

Однако вы, вероятно, можете использовать RestructuredText Substitutiontions , чтобы выполнить то, что вы хотите.

, например

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

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