Reader项目EPUB导出样式优化：首行缩进问题解析

在Reader项目的使用过程中，用户反馈了一个关于EPUB导出样式的问题：当从WEB界面导出EPUB或TXT格式时，文本的首行缩进显示为4个字符（2em），而WEB阅读时正常显示为2个字符缩进。这个问题在MacOS和IOS多个阅读器中均可重现。

技术背景分析

EPUB是一种基于HTML和CSS的电子书格式标准。在Reader项目中，导出功能会将内容转换为EPUB格式，其中CSS样式控制着文本的显示效果。原始CSS中定义了段落(p标签)的text-indent属性为2em，这导致了导出文件中首行缩进过大的问题。

问题根源

经过技术分析，该问题源于EPUB导出模板中的CSS样式定义。虽然WEB界面通过其他样式覆盖实现了2字符缩进，但导出时使用了独立的样式表，其中的text-indent: 2em设置直接生效，导致了显示差异。

解决方案

项目维护者已经针对此问题进行了修复，主要调整了EPUB导出时的CSS样式定义。新的样式表将首行缩进调整为更符合用户预期的1em（约2个字符），确保了导出文件与WEB界面显示的一致性。

技术实现细节

1. 修改了EPUB导出模板中的CSS文件
2. 调整了p标签的text-indent属性值
3. 保持其他样式属性（如text-align和line-height）不变
4. 确保修改后的样式在各种阅读器中都能正确渲染

用户影响

这一改进使得：

• 导出EPUB的首行缩进与WEB阅读体验保持一致
• 在各种阅读器（包括Calibre和系统自带应用）中显示更加统一
• 提升了电子书的整体阅读体验

总结

Reader项目团队及时响应了用户反馈，通过调整EPUB导出样式解决了首行缩进不一致的问题。这体现了项目对用户体验的重视和对细节的关注，也展示了开源项目通过社区反馈持续改进的良好机制。