阿拉伯语Lam-Alif(لاَ)在Asciidoctor-Web-PDF中渲染异常排查

以下是针对性的排查方向和解决方法：

1. 确认字体嵌入与加载是否正确 #

Asciidoctor-Web-PDF依赖Chromium内核生成PDF，若字体未被完整嵌入，会导致特殊连字（如Lam-Alif）缺失。检查你的@font-face配置：

@font-face {
  font-family: 'KacstBook';
  /* 确保路径相对于adoc构建上下文，避免相对路径错误 */
  src: url('./fonts/KacstBook.ttf') format('truetype');
  font-weight: normal;
  font-style: normal;
  /* 强制嵌入完整字体，避免PDF仅引用系统字体 */
  font-display: block;
}

• 验证字体文件路径是否正确：构建时确保字体文件能被Chromium访问到，可尝试使用绝对路径测试。
• 检查字体完整性：用FontForge等工具打开KacstBook.ttf，确认包含Lam-Alif（لاَ）对应的连字字形。

2. 启用阿拉伯文OpenType布局特性 #

HTML浏览器会自动处理阿拉伯文的连字、RTL布局，但PDF生成时需显式启用OpenType特性：

.arabic-text {
  font-family: 'KacstBook', serif;
  direction: rtl;
  unicode-bidi: embed;
  /* 启用连字、上下文替代等阿拉伯文必需的特性 */
  font-feature-settings: 'liga' on, 'calt' on, 'kern' on;
  text-rendering: optimizeLegibility;
}

• 确保所有阿拉伯文本元素都应用了上述样式，可通过给adoc中的阿拉伯文本添加[.arabic-text]块或内联标记来指定样式。

3. 覆盖Asciidoctor-Web-PDF的默认样式 #

Asciidoctor-Web-PDF自带默认PDF样式，可能覆盖你的自定义字体设置。尝试提高样式优先级：

/* 直接覆盖body或核心文本容器样式 */
body, #content, .paragraph, .section {
  font-family: 'KacstBook', serif !important;
  direction: rtl !important;
}

4. 检查Asciidoctor文档配置 #

在adoc文件头部添加阿拉伯文相关配置，避免文本预处理时被错误拆分：

:language: ar
:dir: rtl

这会让Asciidoctor正确识别文本方向和语言，避免Lam-Alif字符被意外拆分。

5. 分步验证定位问题 #

• 先通过asciidoctor命令生成HTML，确认HTML中Lam-Alif渲染正常：若HTML异常，问题出在Asciidoctor的文本处理而非PDF生成。
• 若HTML正常，用Chromium直接打开生成的HTML，再通过浏览器的"打印为PDF"功能导出：若此PDF正常，说明问题出在Asciidoctor-Web-PDF的特定配置，需检查其CLI参数（如是否禁用了字体嵌入）。

内容的提问来源于stack exchange，提问作者Ahmad Ismail