Sioyek PDF阅读器中的标记与书签功能增强：存储横向偏移与缩放级别

在PDF阅读器Sioyek的开发过程中，开发者对标记(Mark)和书签(Bookmark)功能进行了重要增强。最新版本中，这些功能现在能够存储横向偏移(x_offset)和缩放级别(zoom_level)信息，从而更好地保存用户的阅读视图状态。

功能背景

在技术文档和学术论文阅读场景中，保持特定的视图状态至关重要。特别是在处理双栏排版的论文时，仅保存垂直位置(y_offset)可能导致用户返回到错误的列位置。此外，不同的缩放级别会影响文档内容的呈现方式。这些因素共同构成了用户完整的阅读体验。

技术实现

Sioyek通过扩展标记和书签的数据结构来实现这一功能。标记结构现在包含完整的书籍状态信息(OpenedBookState)，而不仅仅是垂直位置。这一改变使得：

1. 横向滚动位置得以保存
2. 当前的缩放级别被记录
3. 整体阅读状态能够完整恢复

开发者特别考虑了向后兼容性问题，确保新版本能够正确处理旧版本保存的JSON格式数据。

设计考量

在实现过程中，开发团队做出了几个关键设计决策：

1. 对于常规书签，不存储缩放级别，因为书签设计为设备/分辨率无关
2. 使用独立的数据结构来区分不同类型的标记
3. 保持JSON序列化/反序列化接口的一致性

用户价值

这一改进为用户带来了显著的体验提升：

• 在多栏文档中能够精确定位
• 保持偏好的阅读缩放级别
• 视图状态在不同设备间更一致地恢复
• 特别有利于学术研究人员和技术文档阅读者

技术细节

实现上，Sioyek采用了灵活的数据结构设计。标记系统现在可以存储完整的文档视图状态，而不仅仅是位置信息。这种设计既保持了向后兼容性，又为未来可能的扩展留下了空间。

对于需要保存特定视图的场景，用户可以使用"可见书签"(visible bookmarks)和"门户"(portals)功能，这些功能专门设计用于保存包括缩放级别在内的完整视图状态。

这一改进体现了Sioyek对专业PDF阅读场景的深入理解，通过精细的技术实现解决了用户在学术研究和技术文档阅读中的实际痛点。