python-3.x - Sphinx 字段列表 - url 换行符格式

Question

我正在使用 sphinx 为项目生成文档。

我正在使用字段列表，引用一个长网址。

我的休息脚本如下:

**Operação**
^^^^^^^^^^^^

:Fonte: https://google.com.br
:Github: https://github.com/123456789876543221/hello_world/987654321/random/path/lalalalalalallaa/12345678987654321.py
:Tópicos adicionais: lorem ipsum.
:Pós-processamento: \-

生成的html是:



如何将 URL 分成两行，以免用字段类别扼杀左列？

Answer 1

服装化 CSS 似乎是正确的方法。但是，如果您只想使用 reST 指令进行“快速修复”，那么最实用的方法似乎是:

Truncating the URL 。 (有选择地缩短 URL 的缺点。)

使用服装 List Table 。 (更改字段列表格式的缺点。)

**Operacao**
^^^^^^^^^^^^

:Fonte: `a short url`_
:Github: alongurl_
:Tópicos: `https://www.a_very_long_url/..truncated../file.html`_ lorem ipsum.


.. _a short url: http://google.com
.. _alongurl: http://google.com/aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
.. _https://www.a_very_long_url/..truncated../file.html: https://github.com/123456789876543221/hello_world/987654321/random/path/lalalalalalallaa/12345678987654321.py


.. list-table:: 
   :widths: 30

   * - :Fonte: alongurl_ 
   * - :Github: If we took the bones out, it wouldn't be crunchy, now would it?jjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjjj 
   * - :Tópicos: https://github.com/123456789876543221/hello_world/987654321/random/path/lalalalalalallaa/12345678987654321.py 

我想过使用 Hyperlinks References 编辑或替换 Substitution Definitions 但显然 reST 不允许这样做。

您可以 define the HTML in an external file and include it ，或使用 Raw Data Pass-Through 但是，在这种特定情况下，对于本质上应该使用 CSS 实现的内容，那些看起来仍然较差的“解决方法”。

另外，我想在 Line Blocks 中使用 List Table (或类似的)作为手动将 URL 分隔成行的一种方式。但这似乎插入了 reST 标记语法超出​​了它的预期用途......

如果您对 Element Hierarchy 理解得足够好，可能有一种非常聪明的方法来做到这一点，但我会通过 CSS 对最终产品 HTML 进行更改而不是详细自定义 reST 来使事情变得简单。