有没有办法在reStructuredText中的表格单元格中的多行中断一个单词,以便它在输出中显示为单个单词?

时间:2012-11-14 09:04:54

标签: python-sphinx restructuredtext

假设我在reStructuredText中有一张表:

+---------------+---------------------------+
| key           | value                     |
+===============+===========================+
| short_word    | value_1                   |
+---------------+---------------------------+
| really_long_  | value 2                   |
| word_I_want_  |                           |
| to_break      |                           |
+---------------+---------------------------+

有没有办法打破左下方单元格中的单词,即使用行继续转义字符或类似的东西,以便它仍然在输出中显示为单个单词?

特别是我使用Sphinx来记录我的Python文档,并且由于尾随下划线字符,它将第一行解释为生成错误的链接目标。

3 个答案:

答案 0 :(得分:3)

好的,经过一些实验,它看起来像通常的反斜杠\ 行继续字符有效,即

+---------------+---------------------------+
| key           | value                     |
+===============+===========================+
| short_word    | value_1                   |
+---------------+---------------------------+
| really_long\  | value 2                   |
| _word_I_want\ |                           |
| _to_break     |                           |
+---------------+---------------------------+

我发现我仍然需要将下划线字符移动到下一行 否则第一行仍然被解释为链接目标,尽管生成的HTML表中的单词被写为连续的单词。

答案 1 :(得分:2)

结帐this suggestion使用reST substitutions通过更短的内容来引用长篇大论。

+---------------+---------------------------+
| key           | value                     |
+===============+===========================+
| short_word    | value_1                   |
+---------------+---------------------------+
| |long_word|   | value 2                   |
+---------------+---------------------------+

.. |long_word| replace:: really_long_word_I_want_to_break

我在表格中遇到类似:ref:`Long Title <even-longer-name>`的问题,你真的不能轻易突破这些问题。替换解决了它。

答案 2 :(得分:0)

在您的线前添加一个条形和一个空格:

+------------------+---------------------------+
| key              | value                     |
+==================+===========================+
| short_word       | value_1                   |
+------------------+---------------------------+
| | really_long    | value 2                   |
| | _word_I_want   |                           |
| | _to_break      |                           |
+------------------+---------------------------+