pages 文件夹中的 .adoc 文件旁边是否可以有图像?

Is it possible to have images next to .adoc files in the pages folder?

家庭目录的结构,如 docs 中所述,要求每个图像都放在 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 文件夹中一样。那将需要更多的努力。