考虑这个表,其中pyeval
是一个宏,它评估一个表达式并用它的值替换它(所以我可以避免文档中的硬编码值):
======================= =========================================== Subsytem Default path ======================= =========================================== :pyeval:`constants.FOO` :pyeval:`pathutils.DEFAULT_FOO_STORAGE_DIR` :pyeval:`constants.BAR` :pyeval:`pathutils.DEFAULT_BAR_STORAGE_DIR` :pyeval:`constants.BAZ` :pyeval:`pathutils.DEFAULT_BAZ_STORAGE_DIR` ======================= ===========================================
这将使用此HTML呈现:
Subsystem | Default storage path |
---|---|
foo | /srv/badp/foo-path/ |
bar | /srv/badp/bar-path/ |
baz | /var/run/badp/baz-path/ |
由于宏,我必须给Subsytem
列的宽度仅略小于列Default path
,但其列的内容要短得多.由于Sphinx试图"有用",它会尝试将源文件中宽度的比例传递给HTML页面(注意colgroup
标记),结果非常不均匀:
请注意,Chrome(就像Firefox一样)在连字点处"有用"地断开,因为这是一条路径,所以我不会将连字符更改为非连字符; 人们太可能复制粘贴这些值.
colgroup
但是,如果我删除元素,我会得到我想要的表格.
我如何告诉Sphinx请不要对我的桌子不太聪明?