Sphinx及RST如何将表格标题移至下方,与图片等元素标题位置一致
无需修改源码的两种实现方案
两种方案都不需要掌握Python知识,操作成本极低:
方案1:使用Sphinx内置指令(版本要求Sphinx≥2.4,优先推荐)
直接在现有表格指令中添加:caption-position: bottom参数即可,修改后的代码如下:.. table:: *Table 1: Power Connector* :align: center :caption-position: bottom该参数是Sphinx原生支持的配置项,默认值为
top,修改为bottom后表格标题会自动渲染在表格下方,和你之前用到的:align:参数使用逻辑完全一致。方案2:CSS自定义样式(适配所有Sphinx版本)
如果你使用的Sphinx版本较低不支持上述参数,只需要通过CSS调整即可:- 在Sphinx项目的
_static目录下新建custom.css文件(如果已有就直接编辑) - 在
conf.py中添加配置确保自定义CSS被加载:html_css_files = ["custom.css"] - 在
custom.css中添加如下样式:
如果只需要指定部分表格标题放在下方,可以给对应表格加/* 全局所有表格标题都放在下方 */ table .caption { caption-side: bottom; }:class: caption-bottom参数,CSS改成:table.caption-bottom .caption { caption-side: bottom; }
- 在Sphinx项目的
绝大多数常规文档排版需求都可以通过Sphinx内置指令、扩展、前端样式配置实现,不需要掌握Python开发知识,只有需要开发自定义插件、特殊指令的时候才需要用到Python相关能力。
内容的提问来源于stack exchange,提问作者Dare The Darkness
相关产品推荐
相关产品推荐

