Sphinx字段列表 - url换行格式化

Question

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

我使用的是字段列表，引用了一个长的url。

我的reST脚本如下。

**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 指令似乎是最实用的。

1. Truncating the URL. (选择性地缩短URL的缺点。)
2. 使用costum 列表表. 改变字段列表格式的缺点）。

**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 

我想过编辑或替换 超链接 参考资料 使用 替换定义 但显然 reST 不允许的。

你可以 在外部文件中定义HTML并将其包含在内或使用 原始数据通过 但是，在这种特定的情况下，这些似乎仍然是低劣的 "变通"，基本上应该使用CSS来实现。

此外，我还想到了使用 线路块 内 列表表 作为手动将URL分成几行的方法。但这似乎是把 reST 标注语法超出了它应有的用途... ...

如果你理解了 元素层次结构 足够好，但我会保持简单，通过CSS对终端产品的HTML进行修改，而不是详细地定制 reST.