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
文件夹中一样。那将需要更多的努力。
家庭目录的结构,如 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
文件夹中一样。那将需要更多的努力。