You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

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调整即可:

    1. 在Sphinx项目的_static目录下新建custom.css文件(如果已有就直接编辑)
    2. 在conf.py中添加配置确保自定义CSS被加载:
      html_css_files = ["custom.css"]
      
    3. 在custom.css中添加如下样式:
      /* 全局所有表格标题都放在下方 */
      table .caption {
        caption-side: bottom;
      }
      
      如果只需要指定部分表格标题放在下方,可以给对应表格加:class: caption-bottom参数,CSS改成:
      table.caption-bottom .caption {
        caption-side: bottom;
      }
      

绝大多数常规文档排版需求都可以通过Sphinx内置指令、扩展、前端样式配置实现,不需要掌握Python开发知识,只有需要开发自定义插件、特殊指令的时候才需要用到Python相关能力。

内容的提问来源于stack exchange,提问作者Dare The Darkness

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.09.28 00:24:04