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)
有什么方法可以在 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)