BookStack项目中使用WeasyPrint实现PDF页码计数功能

背景介绍

BookStack是一款开源的文档管理系统，支持将内容导出为PDF格式。在最新版本中，部分用户选择使用WeasyPrint作为PDF渲染引擎替代原生渲染器时，遇到了页码计数功能失效的问题。

问题现象

当用户通过WeasyPrint导出PDF时，所有页面都显示页码为"1"，无法正确显示当前页码和总页数。这种情况在使用原生PDF渲染器时工作正常。

技术分析

经过分析，这个问题源于CSS处理方式的差异。WeasyPrint作为现代PDF渲染引擎，对CSS规范的支持与原生渲染器有所不同。特别是对于页码计数这类特殊功能，需要使用符合CSS Paged Media Module标准的语法。

解决方案

要实现正确的页码计数功能，需要使用CSS的@page规则和计数器功能。具体实现方式如下：

@page {
  @bottom-right {
    content: "Page " counter(page) " of " counter(pages);
    font-family: Arial, sans-serif;
    font-size: 10pt;
    color: #666;
    margin: 10mm;
  }
}

这段CSS代码会在每页的右下角显示当前页码和总页数，格式为"Page X of Y"。其中：

• counter(page)表示当前页码
• counter(pages)表示文档总页数
• 可以通过调整font-family、font-size、color等属性自定义显示样式
• margin属性可以控制页码与页面边缘的距离

实现建议

1. 在BookStack的PDF导出模板中添加上述CSS代码
2. 根据实际需求调整样式参数
3. 测试不同长度的文档，确保页码计数在各种情况下都能正确显示

注意事项

1. WeasyPrint对CSS规范的支持可能随版本变化，建议使用最新稳定版
2. 复杂的页面布局可能需要额外的CSS调整
3. 如果文档包含封面页等特殊页面，可能需要使用:first、:right等伪类进行特殊处理

通过以上方法，可以完美解决WeasyPrint导出PDF时的页码计数问题，为用户提供更专业的文档输出体验。