如何在Lektor模板中访问附件元数据以添加图片说明？

问题背景 #

我正在按Lektor指南搭建作品集网站，目标是在projects.html和project.html模板中为每张显示的图片添加下方说明文字。

最初打算用附件元数据自定义每张图片的说明内容，比如给项目first-project的附件image001.jpg创建了元数据文件/content/projects/first-project/image001.jpg.lr，内容如下：

_model: image
---
description: An example caption for image001.jpg
---
photographer: Photographer
---
copyright: 2023 by Photographer

但尝试在模板中通过{{ image.description }}、{{ image.photographer }}访问这些字段时，没有返回任何内容。我知道可以访问image.width、image.exif.description这类图片数据，但希望避免用EXIF描述存储说明文字。

现在想明确：

• 如何在模板中访问这些附件元数据字段？
• 用附件元数据实现需求是否合理？还是用EXIF更简单？或者应该采用其他方法（比如内容流）？

解决方案及分析 #

1. 正确访问附件元数据的方法 #

在Lektor中，图片附件的元数据需要通过**attachment对象**访问，而非直接从图片对象获取。你需要先获取当前页面的附件记录，筛选出图片类型后，直接调用元数据字段：

模板示例代码：

{# 遍历当前项目下的所有图片附件 #}
{% for attachment in this.attachments if attachment.is_image %}
  <img src="{{ attachment.thumbnail(800)|url }}" alt="{{ attachment.description }}">
  <div class="image-caption">
    <p>{{ attachment.description }}</p>
    <p>摄影师：{{ attachment.photographer }}</p>
    <p>版权：{{ attachment.copyright }}</p>
  </div>
{% endfor %}

核心逻辑是通过this.attachments获取页面所有附件，筛选图片后，用attachment.字段名直接读取.lr文件中定义的元数据。

2. 方案合理性对比 #

• 附件元数据：这是完全贴合Lektor设计的用法，能将图片的自定义信息与图片文件本身解耦，无需依赖图片的EXIF数据，编辑维护更灵活，是最推荐的方案。
• EXIF描述：虽然读取简单，但修改需要专门工具，且图片替换时EXIF数据易丢失，不适合作为作品集说明的存储方式。
• 内容流（Flow）：如果需要更复杂的排版（比如图片与文字混排、自定义布局），内容流会更灵活。但如果只是给每张图片加固定格式的说明，附件元数据的方式更轻量化，无需额外配置Flow模型，维护成本更低。

总结 #

优先选择附件元数据的方式，通过attachment对象即可轻松访问自定义字段实现需求。如果后续需要更复杂的内容布局，再考虑切换到内容流方案。

内容的提问来源于stack exchange，提问作者bitdexteam