DITA OT与FOP生成PDF时阿拉伯语脚注对齐异常问题

1. 检查FOP双向文本（BiDi）配置 #

FOP 2.6对RTL（从右到左）语言的脚注处理需额外配置，确认fop.xconf：

• 确保包含<bidi enabled="true"/>
• 检查是否指定正确的BiDi渲染器：<bidi-renderer class="org.apache.fop.render.pdf.PDFBidiRenderer"/>

2. 验证脚注容器的RTL属性继承 #

即便修改了fn__blockcontainer属性集，仍需确认脚注的编号与文本容器都正确继承RTL方向：

• 在topic.fo中检查脚注编号的fo:inline是否设置direction="rtl"和unicode-bidi="embed"
• 脚注文本块需明确设置上述属性，避免仅靠父容器继承导致局部失效

3. 排查自定义插件的样式优先级 #

自定义PDF插件的样式可能被DITA OT默认样式覆盖：

• 确保自定义XSLT模板优先级高于默认模板（比如使用更具体的匹配模式，或设置priority="10"）
• 检查fo:footnote内部的fo:footnote-body是否被正确设置为RTL方向，而非仅配置fn__blockcontainer

4. 测试FOP 2.6的RTL脚注Bug可能性 #

FOP 2.6存在部分RTL排版已知问题，可做以下验证：

• 用仅含阿拉伯语脚注的极简FO文件直接测试FOP渲染，看是否仍有对齐问题
• 若极简测试复现问题，尝试升级到FOP 2.8或更高版本，新版本修复了部分BiDi排版Bug

5. 检查字符编码和字体支持 #

确保使用的字体完整支持阿拉伯语字符，且FO文件正确指定字体：

• 确认font-family指向的字体包含阿拉伯语字形，且已在FOP配置中正确注册
• 避免使用仅支持LTR语言的字体，否则可能导致文本方向异常

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