自定义打印格式中Repeat Header and Footer功能异常求助

问题描述 #

当采用文档推荐方案，结合使用#header-html、#footer-html与print_settings.repeat_header_footer配置时，出现异常：页眉仅在第一页渲染，页脚仅在最后一页渲染，未实现每页重复显示的预期效果。

我的配置 #

页眉代码 #

{% if letter_head and not no_letterhead %}
  {% if print_settings.repeat_header_footer %}
    <div id="header-html" class="visible-pdf">
      <div class="letter-head">
        {{ letter_head }}
      </div>
    </div>
  {% else %}
    <div id="header">
      {{ letter_head }}
    </div>
  {% endif %}
{% endif %}

页脚代码 #

{% if print_settings.repeat_header_footer %}
  <div id="footer-html" class="visible-pdf">
    {% if footer and not no_letterhead %}
      <div class="letter-head-footer">
        {{ footer }}
      </div>
    {% endif %}
    <p class="text-center text-small page-number visible-pdf">
      {{ _("Page {0} of {1}").format('<span class="page"></span>', '<span class="topage"></span>') }}
    </p>
  </div>
{% else %}
  {% if footer and not no_letterhead %}
    <div class="letter-head-footer">
      {{ footer }}
    </div>
  {% endif %}
{% endif %}

环境信息 #

• bench version输出：

  bench v5.27.0
  

• 额外版本详情：
  • ERPNext: v15.88.1
  • Frappe: v15.88.1
  • wkhtmltopdf: 0.12.6 (patched qt)

复现步骤 #

• 为多页文档（例如包含长项目表格的文档）创建自定义打印格式。
• 配置页眉代码如下：

  {% if print_settings.repeat_header_footer %}
    <div id="header-html">
      {{ letter_head }}
    </div>
  {% endif %}
  

• 在打印设置中启用「重复页眉页脚」选项。
• 使用系统内置的PDF按钮将文档导出为PDF文件。

观察结果 #

• 页眉仅在PDF的第一页顶部显示
• 页脚仅在PDF的最后一页底部显示（仅当内容扩展至第二页及以上时出现）

预期结果 #

• 页眉应在PDF的每一页顶部重复显示
• 页脚应在PDF的每一页底部重复显示
• 正文内容需自动适配页眉页脚的位置，避免出现内容与页眉/页脚重叠的情况

已尝试方案 #

参考过Frappe社区内关于页眉页脚重复显示问题的相关讨论

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