Pigallery2 中 XMP 侧边文件的使用指南

Pigallery2 是一个开源的图片和视频管理工具，它支持通过 XMP 侧边文件为媒体文件添加元数据。本文将详细介绍如何在 Pigallery2 中正确使用 XMP 侧边文件功能。

XMP 侧边文件的基本概念

XMP (Extensible Metadata Platform) 是一种由 Adobe 开发的元数据标准，它允许将描述性信息嵌入到文件中或存储为单独的侧边文件。在 Pigallery2 中，XMP 侧边文件可以用来为图片和视频添加标签等元数据。

正确的 XMP 文件命名规则

经过测试，Pigallery2 对 XMP 侧边文件的命名有特定要求：

1. 对于文件 video.mp4，正确的 XMP 文件名应为 video.mp4.XMP
2. 错误的命名方式（如 video.xmp）将不会被识别

这种命名规则与许多专业图像管理软件的惯例一致，确保了文件关联的明确性。

XMP 文件内容格式

一个有效的 XMP 文件应包含以下基本结构：

<?xpacket begin='' id='W5M0MpCehiHzreSzNTczkc9d'?>
<x:xmpmeta xmlns:x='adobe:ns:meta/' x:xmptk='Image::ExifTool 12.74'>
<rdf:RDF xmlns:rdf='http://www.w3.org/1999/02/22-rdf-syntax-ns#'>

 <rdf:Description rdf:about=''
  xmlns:dc='http://purl.org/dc/elements/1.1/'>
  <dc:subject>
   <rdf:Bag>
    <rdf:li>标签1</rdf:li>
    <rdf:li>标签2</rdf:li>
   </rdf:Bag>
  </dc:subject>
 </rdf:Description>

</rdf:RDF>
</x:xmpmeta>
<?xpacket end='w'?>

其中，dc:subject 部分用于定义标签，多个标签应放在 rdf:Bag 容器中。

常见问题排查

如果 XMP 侧边文件未被正确识别，可以检查以下几点：

1. 确认文件名符合 原文件名.扩展名.XMP 的格式
2. 检查 XML 文件结构是否完整且格式正确
3. 确保 XMP 文件与媒体文件位于同一目录
4. 验证 Pigallery2 使用的是最新版本（某些早期版本可能存在兼容性问题）

技术实现原理

Pigallery2 使用 exifr 库来解析 XMP 文件。该库能够处理嵌入式和侧边 XMP 数据。当检测到符合命名规则的 XMP 文件时，系统会自动解析其中的元数据并与对应的媒体文件关联。

最佳实践建议

1. 使用专业的 XMP 编辑工具（如 Adobe Bridge 或 ExifTool）创建和修改 XMP 文件
2. 对于批量操作，可以考虑编写脚本自动生成 XMP 文件
3. 定期检查元数据是否被正确识别，特别是在升级 Pigallery2 后

通过正确使用 XMP 侧边文件，用户可以高效地为大量媒体文件添加丰富的元数据，提升 Pigallery2 中的搜索和组织能力。