有没有办法在 reStructuredText 的表格单元格中跨多行拆分单词，使其在输出中显示为单个单词？答案

【问题标题】：Is there a way to break a word across multiple lines in a table cell in reStructuredText so it appears as a single word in the output?有没有办法在 reStructuredText 的表格单元格中跨多行拆分单词，使其在输出中显示为单个单词？
【发布时间】：2012-11-14 09:04:53
【问题描述】：

假设我在reStructuredText 有一张桌子，比如：

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

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

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

【问题讨论】：

标签： python-sphinx restructuredtext

【解决方案1】：

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

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

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

【讨论】：

这对我不起作用，结果仍然在同一行。
@Zitrax 我可能解释得很糟糕。我想要的是它在最终的 html 文档中的一行上显示为一个单词，但我希望能够将它写成多行。因此，如果您发现它在同一行结束，那么这就是我想要的行为。

【解决方案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>` 类似的问题，你真的不能轻易地跨行。换人解决了。

【讨论】：

【解决方案3】：

在你的行前添加一个条和一个空格：

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

【讨论】：

这会在表格单元格中创建一个缩进。