Indico项目时间表PDF页码显示问题分析与解决方案

在Indico项目的事件管理系统中，时间表PDF生成功能出现了一个页码显示不一致的问题。本文将深入分析该问题的技术背景、产生原因以及最终的解决方案。

问题现象描述 当用户生成事件时间表PDF时，目录页显示的页码编号与正文页的实际页码存在不一致。具体表现为目录中显示的页码是绝对页码（例如第一个条目显示为第3页），而实际对应的正文页底部页码却显示为第1页。

技术背景分析 这个问题源于PDF生成过程中对页码计数器的处理方式。系统原本采用了类似LaTeX的分段页码计数策略：

1. 目录部分使用独立的罗马数字计数器
2. 正文部分重新从1开始计数

这种设计本意是为了模仿传统出版物的页码编排方式，但在实现上存在逻辑缺陷。

问题根源 经过代码审查发现，CSS样式表中虽然设置了不同的页码计数器，但在目录生成时错误地引用了绝对页码而非相对页码。具体表现为：

• 目录项链接错误地指向了包含封面和目录在内的总页码
• 正文页脚却正确地显示了仅计算正文部分的页码

解决方案设计 开发团队提出了以下修复方案：

1. 统一使用连续页码计数方式
2. 修正目录项的页码引用逻辑
3. 保持页脚显示的页码与目录引用的一致性

实现细节 在CSS样式表中，对页码计数器进行了重新配置：

• 移除了分段计数逻辑
• 确保所有页码引用都指向同一计数器
• 优化了页码显示格式

技术价值 这个修复不仅解决了表面的显示问题，还：

1. 提高了PDF文档的专业性和一致性
2. 消除了用户可能产生的混淆
3. 为后续的PDF导出功能改进奠定了基础

用户影响 修复后的版本将带来以下改进：

• 目录页码与正文页码完全对应
• 提升文档的整体可读性
• 符合大多数用户对页码编排的预期

该问题已在最新版本中得到修复，用户现在可以生成页码显示完全一致的时间表PDF文档。