fix: update RSS feed generation to include EXIF data and improve XML structure

- Modified the RSS feed generation to extract and include EXIF data such as aperture, shutter speed, ISO, and camera model. - Updated the XML structure to remove unnecessary escaping for titles and descriptions, enhancing readability. - Adjusted the example configuration file to use a full URL for the author avatar. Signed-off-by: Innei <tukon479@gmail.com>
2026-02-01 22:48:17 +00:00 · 2025-06-12 21:35:15 +08:00
parent 9a639b9b60
commit 30d2a14e43
3 changed files with 274 additions and 17 deletions
--- a/config.example.json
+++ b/config.example.json
@@ -7,7 +7,7 @@
  "author": {
    "name": "Photo Gallery",
    "url": "https://innei.in/",
-    "avatar": "//cdn.jsdelivr.net/gh/Innei/static@master/avatar.png"
+    "avatar": "https://cdn.jsdelivr.net/gh/Innei/static@master/avatar.png"
  },
  "social": {
    "twitter": "@__oQuery",
--- a/plugins/vite/feed-sitemap.ts
+++ b/plugins/vite/feed-sitemap.ts
@@ -109,24 +109,28 @@ function generateRSSFeed(photos: PhotoData[], config: SiteConfig): string {
        description += ` | Tags: ${tags}`
      }

+      // Extract EXIF data for custom tags
+      const exifTags = generateExifTags(photo.exif, photo)
+
      return `    <item>
-      <title><![CDATA[${escapeXml(photo.title)}]]></title>
+      <title><![CDATA[${photo.title}]]></title>
      <link>${photoUrl}</link>
      <guid isPermaLink="true">${photoUrl}</guid>
-      <description><![CDATA[${escapeXml(description)}]]></description>
+      <description><![CDATA[${description}]]></description>
      <pubDate>${pubDate}</pubDate>
-      ${photo.tags.map((tag) => `<category><![CDATA[${escapeXml(tag)}]]></category>`).join('\n      ')}
+      ${photo.tags.map((tag) => `<category><![CDATA[${tag}]]></category>`).join('\n      ')}
      <enclosure url="${photo.thumbnailUrl.startsWith('http') ? photo.thumbnailUrl : config.url + photo.thumbnailUrl}" type="image/webp" length="${photo.size}" />
+${exifTags}
    </item>`
    })
    .join('\n')

  return `<?xml version="1.0" encoding="UTF-8"?>
-<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:exif="https://exif.org/rss/1.0">
  <channel>
-    <title><![CDATA[${escapeXml(config.title)}]]></title>
+    <title><![CDATA[${config.title}]]></title>
    <link>${config.url}</link>
-    <description><![CDATA[${escapeXml(config.description)}]]></description>
+    <description><![CDATA[${config.description}]]></description>
    <language>zh-CN</language>
    <lastBuildDate>${lastBuildDate}</lastBuildDate>
    <pubDate>${now}</pubDate>
@@ -137,7 +141,7 @@ function generateRSSFeed(photos: PhotoData[], config: SiteConfig): string {
    <generator>Vite RSS Generator</generator>
    <image>
      <url>${config.author.avatar || `${config.url}/favicon.ico`}</url>
-      <title><![CDATA[${escapeXml(config.title)}]]></title>
+      <title><![CDATA[${config.title}]]></title>
      <link>${config.url}</link>
    </image>
 ${rssItems}
@@ -145,6 +149,85 @@ ${rssItems}
 </rss>`
 }

+function generateExifTags(exif: any, photo: PhotoData): string {
+  if (!exif || !exif.Photo) {
+    return ''
+  }
+
+  const tags: string[] = []
+
+  // Aperture (光圈)
+  if (exif.Photo.FNumber) {
+    tags.push(`      <exif:aperture>f/${exif.Photo.FNumber}</exif:aperture>`)
+  }
+
+  // Shutter Speed (快门)
+  if (exif.Photo.ExposureTime) {
+    const shutterSpeed =
+      exif.Photo.ExposureTime >= 1
+        ? `${exif.Photo.ExposureTime}s`
+        : `1/${Math.round(1 / exif.Photo.ExposureTime)}s`
+    tags.push(`      <exif:shutterSpeed>${shutterSpeed}</exif:shutterSpeed>`)
+  }
+
+  // ISO
+  if (exif.Photo.ISOSpeedRatings) {
+    tags.push(`      <exif:iso>${exif.Photo.ISOSpeedRatings}</exif:iso>`)
+  }
+
+  // Exposure Compensation (曝光补偿)
+  if (exif.Photo.ExposureBiasValue !== undefined) {
+    const ev = exif.Photo.ExposureBiasValue
+    const evString = ev > 0 ? `+${ev}` : `${ev}`
+    tags.push(
+      `      <exif:exposureCompensation>${evString} EV</exif:exposureCompensation>`,
+    )
+  }
+
+  // Image Dimensions (图片宽度, 高度)
+  tags.push(
+    `      <exif:imageWidth>${photo.width}</exif:imageWidth>`,
+    `      <exif:imageHeight>${photo.height}</exif:imageHeight>`,
+  )
+
+  // Date Taken (拍摄时间)
+  if (exif.Photo.DateTimeOriginal) {
+    tags.push(
+      `      <exif:dateTaken>${exif.Photo.DateTimeOriginal}</exif:dateTaken>`,
+    )
+  }
+
+  // Camera Model (机型)
+  if (exif.Image?.Make && exif.Image?.Model) {
+    tags.push(
+      `      <exif:camera><![CDATA[${exif.Image.Make} ${exif.Image.Model}]]></exif:camera>`,
+    )
+  }
+
+  // Lens Model (镜头)
+  if (exif.Photo.LensModel) {
+    tags.push(
+      `      <exif:lens><![CDATA[${exif.Photo.LensModel}]]></exif:lens>`,
+    )
+  }
+
+  // Focal Length (焦段)
+  if (exif.Photo.FocalLength) {
+    tags.push(
+      `      <exif:focalLength>${exif.Photo.FocalLength}mm</exif:focalLength>`,
+    )
+  }
+
+  // Focal Length in 35mm equivalent (等效35mm焦距)
+  if (exif.Photo.FocalLengthIn35mmFilm) {
+    tags.push(
+      `      <exif:focalLength35mm>${exif.Photo.FocalLengthIn35mmFilm}mm</exif:focalLength35mm>`,
+    )
+  }
+
+  return tags.join('\n')
+}
+
 function generateSitemap(photos: PhotoData[], config: SiteConfig): string {
  const now = new Date().toISOString()

@@ -177,12 +260,3 @@ ${mainPageXml}
 ${photoUrls}
 </urlset>`
 }
-
-function escapeXml(text: string): string {
-  return text
-    .replaceAll('&', '&amp;')
-    .replaceAll('<', '&lt;')
-    .replaceAll('>', '&gt;')
-    .replaceAll('"', '&quot;')
-    .replaceAll("'", '&#39;')
-}
--- a/rss-spec.md
+++ b/rss-spec.md
@@ -0,0 +1,183 @@
+# Photo Gallery RSS EXIF Extension Specification
+
+## 概述
+
+本规范定义了在 RSS 2.0 feeds 中包含摄影 EXIF 数据的标准方法，专为照片画廊网站设计。该扩展允许 RSS 阅读器和其他应用程序访问详细的摄影技术参数。
+
+## 命名空间
+
+XML 命名空间: `https://exif.org/rss/1.0`  
+推荐前缀: `exif`
+
+在 RSS 根元素中声明命名空间：
+
+```xml
+<rss version="2.0" 
+     xmlns:atom="http://www.w3.org/2005/Atom" 
+     xmlns:exif="https://exif.org/rss/1.0">
+```
+
+## EXIF 标签定义
+
+### 相机设置参数
+
+#### `<exif:aperture>`
+
+**描述**: 光圈值  
+**格式**: `f/{数值}`  
+**示例**: `<exif:aperture>f/1.4</exif:aperture>`  
+**映射**: EXIF FNumber 字段
+
+#### `<exif:shutterSpeed>`
+
+**描述**: 快门速度  
+**格式**:
+
+- 长曝光: `{秒数}s`
+- 短曝光: `1/{分母}s`  
+  **示例**:
+- `<exif:shutterSpeed>1/250s</exif:shutterSpeed>`
+- `<exif:shutterSpeed>2s</exif:shutterSpeed>`  
+  **映射**: EXIF ExposureTime 字段
+
+#### `<exif:iso>`
+
+**描述**: ISO 感光度  
+**格式**: 整数  
+**示例**: `<exif:iso>1000</exif:iso>`  
+**映射**: EXIF ISOSpeedRatings 字段
+
+#### `<exif:exposureCompensation>`
+
+**描述**: 曝光补偿  
+**格式**: `{±数值} EV`  
+**示例**:
+
+- `<exif:exposureCompensation>+0.7 EV</exif:exposureCompensation>`
+- `<exif:exposureCompensation>-1.3 EV</exif:exposureCompensation>`  
+  **映射**: EXIF ExposureBiasValue 字段
+
+### 镜头参数
+
+#### `<exif:focalLength>`
+
+**描述**: 实际焦距  
+**格式**: `{数值}mm`  
+**示例**: `<exif:focalLength>50mm</exif:focalLength>`  
+**映射**: EXIF FocalLength 字段
+
+#### `<exif:focalLength35mm>`
+
+**描述**: 等效35mm焦距  
+**格式**: `{数值}mm`  
+**示例**: `<exif:focalLength35mm>75mm</exif:focalLength35mm>`  
+**映射**: EXIF FocalLengthIn35mmFilm 字段
+
+#### `<exif:lens>`
+
+**描述**: 镜头型号  
+**格式**: CDATA 包装的字符串  
+**示例**: `<exif:lens><![CDATA[BS-Optics FX 50mm F1.4]]></exif:lens>`  
+**映射**: EXIF LensModel 字段
+
+### 设备信息
+
+#### `<exif:camera>`
+
+**描述**: 相机品牌和型号  
+**格式**: CDATA 包装的字符串  
+**示例**: `<exif:camera><![CDATA[FUJIFILM X-T5]]></exif:camera>`  
+**映射**: EXIF Make + Model 字段组合
+
+### 图像属性
+
+#### `<exif:imageWidth>`
+
+**描述**: 图像宽度（像素）  
+**格式**: 整数  
+**示例**: `<exif:imageWidth>7728</exif:imageWidth>`  
+**映射**: 来自图像处理系统的实际宽度
+
+#### `<exif:imageHeight>`
+
+**描述**: 图像高度（像素）  
+**格式**: 整数  
+**示例**: `<exif:imageHeight>5152</exif:imageHeight>`  
+**映射**: 来自图像处理系统的实际高度
+
+#### `<exif:dateTaken>`
+
+**描述**: 拍摄时间（原始时间戳）  
+**格式**: ISO 8601 格式  
+**示例**: `<exif:dateTaken>2025-06-05T16:12:43.000Z</exif:dateTaken>`  
+**映射**: EXIF DateTimeOriginal 字段
+
+## 完整示例
+
+```xml
+<?xml version="1.0" encoding="UTF-8"?>
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:exif="https://exif.org/rss/1.0">
+  <channel>
+    <title><![CDATA[我的摄影画廊]]></title>
+    <link>https://example.com</link>
+    <description><![CDATA[分享我的摄影作品]]></description>
+    
+    <item>
+      <title><![CDATA[夕阳下的城市]]></title>
+      <link>https://example.com/photo123</link>
+      <guid isPermaLink="true">https://example.com/photo123</guid>
+      <description><![CDATA[城市天际线在夕阳下的美丽景象]]></description>
+      <pubDate>Thu, 05 Jun 2025 16:12:43 GMT</pubDate>
+      <category><![CDATA[风景]]></category>
+      <category><![CDATA[城市]]></category>
+      <enclosure url="https://example.com/thumbnails/photo123.webp" type="image/webp" length="1024000" />
+      
+      <!-- EXIF 数据扩展 -->
+      <exif:aperture>f/1.4</exif:aperture>
+      <exif:shutterSpeed>1/250s</exif:shutterSpeed>
+      <exif:iso>1000</exif:iso>
+      <exif:exposureCompensation>0 EV</exif:exposureCompensation>
+      <exif:imageWidth>7728</exif:imageWidth>
+      <exif:imageHeight>5152</exif:imageHeight>
+      <exif:dateTaken>2025-06-05T16:12:43.000Z</exif:dateTaken>
+      <exif:camera><![CDATA[FUJIFILM X-T5]]></exif:camera>
+      <exif:lens><![CDATA[BS-Optics FX 50mm F1.4]]></exif:lens>
+      <exif:focalLength>50mm</exif:focalLength>
+      <exif:focalLength35mm>75mm</exif:focalLength35mm>
+    </item>
+  </channel>
+</rss>
+```
+
+## 兼容性和实现注意事项
+
+### 向后兼容性
+
+- 标准的 RSS 2.0 阅读器将忽略不识别的命名空间元素
+- 核心 RSS 功能（标题、链接、描述等）保持完全兼容
+
+### 可选字段
+
+- 所有 EXIF 标签都是可选的
+- 如果某个 EXIF 数据不可用，应省略对应的标签而不是输出空值
+
+### 数据验证
+
+- 实现者应验证 EXIF 数据的有效性
+- 对于无效或缺失的数据，建议静默跳过而不是输出错误值
+
+### 性能考虑
+
+- EXIF 数据提取可能影响 RSS 生成性能
+- 建议在构建时预处理 EXIF 数据而非实时提取
+
+## 版本历史
+
+- **v1.0** (2025-01-19): 初始规范发布
+  - 定义核心 EXIF 标签集合
+  - 建立命名空间约定
+  - 提供完整实现示例
+
+## 许可证
+
+本规范基于 Creative Commons Attribution 4.0 International License 发布。