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

问题描述 投票:0回答:1

我正在使用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是:

enter image description here

我怎样才能把URL分成两行,以避免左列的字段类别被勒死?

python-3.x python-sphinx restructuredtext
1个回答
2
投票

将CSS成本化似乎是正确的方法。但如果你想 "快速修复",只使用 reST 指令似乎是最实用的。

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

enter image description here

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

© www.soinside.com 2019 - 2024. All rights reserved.