使用Firefox的Asciidoctor.js Live Preview渲染.adoc时遇引用解析错误

排查及解决步骤 #

• 核对文件路径与名称
  确认a.adoc、b.adoc和主文件Summary.adoc的相对位置：
  • 若在同一目录，确保文件名拼写完全一致（注意大小写，Linux/macOS环境下区分大小写）
  • 若被包含文件在子目录，需写出完整相对路径，比如include::docs/a.adoc[]
• 检查扩展文件访问权限
  Firefox的该扩展可能未获得本地文件读取权限：
  • 打开Firefox扩展管理页，找到“Asciidoctor.js Live Preview”
  • 开启“访问文件和文件数据”权限
• 确认扩展配置
  部分版本的扩展默认关闭include指令支持：
  • 打开扩展设置界面，勾选“Enable Include Directives”选项
• 验证文件编码
  确保所有.adoc文件使用UTF-8编码，避免因编码不兼容导致解析失败

出现的错误信息：

Unresolved directive in Summary.adoc - include::a.adoc[]

Unresolved directive in Summary.adoc - include::b.adoc[]

内容的提问来源于stack exchange，提问作者Rudolf Starosta - Rudi