如文档中所述，家庭目录的结构要求将每个图像都放在images目录中。但是，OptaPlanner 文档在每章的同一目录中包含图像和 asciidoc 文件。请看下面的目录结构：
https://github.com/kiegroup/optaplanner/tree/main/optaplanner-docs/src/main/asciidoc
由于来自外部存储库的现有引用（破坏了向后兼容性），因此不希望更改当前结构。
有没有办法配置 Antora 从pages目录及其子目录中获取图像？
不。
最佳实践答案：Antora 需要特定的目录结构，您必须采用它。
您可以调整 Asciidoc 标记以实现此目标：
image::./relative/path/to/image.jpg[]
但是，这样做可能会破坏您的兼容性。
Antora 3（目前处于 alpha 阶段）将提供符号链接支持，因此您可以在images文件夹中创建指向文件夹中图像的符号链接pages。一旦到位，您就可以像images文件夹中的任何其他图像一样引用这些图像。
使用 Antora 3，您还可以编写一个扩展程序来定位pages文件夹中的图像并将它们添加到 contentCatalog 中，就像它们在images文件夹中一样。那将是显着更多的努力。