python-sphinx - reStructuredText 换行符会破坏代码块

Question

我正在使用 reStructuredText 和 Sphinx 来生成一组文档。每个页面都必须符合 PEP8，因此每行最多包含 80 个字符。这是一个新的要求，并且打破了好几页。
当我们曾经有:

.. code-block:: bash
    really really long line of code that I would want a new user to copy and paste into a terminal

我们现在有:

.. code-block:: bash
    really really long line of code that
    I would want a new user to copy and
    paste into a terminal

这是一个问题，因为在粘贴到终端时，每一行都被视为单独的命令。阅读我看到的文档，我可以执行以下操作:

| really really long line of code that I 
  would want a new user to copy and paste
  into a terminal

使我的文本适合 1 行，但这并不能保持我想要的 block 样式或语法突出显示。有谁知道实现我正在寻找的方法？提前感谢您的任何和所有反馈!

Answer 1

您应该能够使用反斜杠来指示该行继续。它转义换行符。

.. code-block:: bash

   really really long line of code that \
   I would want a new user to copy and \
   paste into a terminal

该命令在粘贴到终端时被解释为一长行。

见 http://www.gnu.org/software/bash/manual/bashref.html#Escape-Character .