图片目录和文件

图片家族目录

模块目录可以包含一个名为images的可选家族目录。

📂 模块
  📂 ROOT (1)
    📂 images (2)
      📄 图片源文件.ext (3)
    📁 页面
    📄 nav.adoc
  📂 命名模块 (4)
    📁 示例
    📂 images (5)
      📄 图片源文件.ext
      📂 图片子目录 (6)
        📄 图片源文件.ext
    📁 页面
1 一个ROOT模块目录。
2 一个images家族目录。Antora将存储在images目录中的源文件分类为图片。
3 一个图片源文件。
4 一个命名模块目录。
5 一个images家族目录。
6 images中的子目录。存储在images目录子目录中的源文件被分类为图片。

Antora在生成站点时会对存储在images目录中的源文件应用预设行为。

图片文件

图片是资源，如照片、图表和截图。图片的源文件存储在images家族目录中。Antora支持PNG、JPG、SVG和GIF（静态和动画）图片文件格式。

无论图片属于哪个组件版本，都可以使用图片的资源ID和AsciiDoc 块图片宏或内联图片宏将图片嵌入到页面或部分中。

Antora会自动发布每个图片文件，除非该图片文件被标记为隐藏或缺少文件扩展名。Antora在构建图片的URL时使用图片文件的家族段和相对路径段。

资源

模块目录还可以包含一个名为assets的目录。这是Antora识别的另一个位置，attachments和images家族目录可以放置在这里。

📒 仓库
  📄 antora.yml
  📂 模块
    📂 ROOT
      📂 assets
        📂 attachments
          📄 附件源文件.ext
        📂 images
          📄 图片源文件.ext
      📁 页面
      📄 nav.adoc

您不需要在页面头部设置这些预定义目录的路径。这由Antora自动管理。