如何在rst2pdf中实现文档内动态变化的页脚？

通用reStructuredText本身不支持动态页脚，因为它是专注于文档结构的标记语言，不直接处理渲染层面的动态内容控制。但rst2pdf提供了扩展功能可以实现这个需求——文本变量替换，这正是你提到的可行方案，具体用法如下：

核心思路 #

通过rst2pdf的.. set::指令定义可动态更新的变量，让页脚引用这个变量，后续在需要切换页脚的位置更新变量值，就能实现页脚随内容动态变化。

示例代码 #

# 初始定义页脚变量
.. set:: footer_text "you are reading table 1"

# 设置页脚引用变量
.. footer:: %(footer_text)s

some text..

.. raw:: pdf
    PageBreak

# 在第二个表格前更新变量值
.. set:: footer_text "now you are reading table 2"

Next page text (table 2 starts here)..

原理说明 #

• .. set::是rst2pdf的扩展指令，用于定义可替换的文本变量；
• 页脚中用%(变量名)s的格式引用变量，渲染时会自动替换为当前变量的值；
• 每次执行.. set::更新变量后，后续页面的页脚都会使用新的变量值，而之前的页面页脚保持不变，完美匹配你需要的“不同内容段对应不同页脚”的需求。

为什么直接多次用.. footer::无效 #

rst2pdf中.. footer::是全局静态设置，解析到该指令时会直接覆盖之前的页脚配置，但它不会追溯修改已渲染页面的页脚，也无法实现“分段动态切换”的效果，这也是文档中说明多次设置无效是预期行为的原因。

内容的提问来源于stack exchange，提问作者valpo