RSS 订阅

🤔 什么是 RSS？

RSS (Really Simple Syndication) 是一种内容订阅格式，可以理解为"网站内容的快递服务"。

简单比喻

想象你关注了很多博客和新闻网站，传统方式是：

• ❌ 每天打开 10 个网站查看有没有更新
• ❌ 容易错过更新，浪费时间

使用 RSS 后：

• ✅ 所有网站的更新自动推送到一个地方
• ✅ 像查看微信朋友圈一样，统一阅读所有更新
• ✅ 不错过任何内容，节省大量时间

实际效果

你的 RSS 阅读器
├─ 未读 (5)
│  ├─ cmwrun: 《React Diff 算法详解》
│  ├─ 阮一峰: 《科技爱好者周刊》
│  ├─ MDN: 《CSS Grid 最新特性》
│  └─ ...

---

欢迎订阅 cmwrun 的内容更新！通过 RSS 订阅，您可以在第一时间获取最新的前端知识文章和技术分享。

📡 订阅链接

我们提供多种格式的订阅源，请根据您的 RSS 阅读器选择合适的格式：

• RSS 2.0: /feed.rss
• Atom 1.0: /feed.atom
• JSON Feed: /feed.json

🔧 如何订阅

方法一：使用 RSS 阅读器

1. 选择一个 RSS 阅读器应用：

   • 桌面端: NetNewsWire (macOS/iOS)、Fluent Reader (跨平台)
   • 网页端: Feedly、Inoreader
   • 移动端: Reeder (iOS)、FeedMe (Android)

2. 在阅读器中添加订阅源地址：https://www.cmwrun.com/feed.rss

3. 完成！您将自动接收最新文章的推送

方法二：浏览器扩展

部分浏览器支持 RSS 扩展：

• Chrome/Edge: RSS Feed Reader
• Firefox: 内置 RSS 订阅功能

方法三：邮件订阅

您也可以使用一些服务（如 Blogtrottr）将 RSS 更新转换为邮件推送。

📚 订阅内容

通过订阅，您将获得：

• ✅ 最新的前端技术文章
• ✅ 深度算法与原理解析
• ✅ 实用的代码示例与 Demo
• ✅ 性能优化与最佳实践
• ✅ 浏览器与 Web 标准更新

💡 为什么使用 RSS？

• 无干扰阅读: 没有广告、推荐算法，只有您关心的内容
• 隐私保护: 无需注册账号，无需提供个人信息
• 离线阅读: 大多数 RSS 阅读器支持离线缓存
• 统一管理: 在一个应用中管理多个网站的订阅
• 开放标准: RSS 是开放标准，不受平台限制

🔗 其他订阅方式

如果您不想使用 RSS，也可以通过以下方式获取更新：

• ⭐ GitHub 仓库 - Watch 仓库获取更新通知
• 💬 关注我们的社交媒体（如果有）

---

🛠️ 站长使用指南

如何生成 RSS Feed

本站的 RSS Feed 在每次构建时自动生成：

# 开发模式（不生成 RSS）
pnpm dev

# 构建生产版本（自动生成 RSS）
pnpm build

构建完成后，RSS 文件会生成在 .vitepress/dist/ 目录：

.vitepress/dist/
├── feed.rss      # RSS 2.0 格式
├── feed.atom     # Atom 1.0 格式
└── feed.json     # JSON Feed 格式

测试 RSS Feed

方法一：本地预览

pnpm build    # 先构建
pnpm preview  # 启动预览服务器

# 然后访问：
# http://localhost:4173/feed.rss
# http://localhost:4173/feed.atom
# http://localhost:4173/feed.json

方法二：在线验证

访问 W3C Feed Validator 验证你的 RSS 格式是否正确：

输入: https://www.cmwrun.com/feed.rss
点击 "Check" 验证

自定义 RSS 内容

编辑文章时，在 Markdown 的 frontmatter 中添加元数据：

---
title: 文章标题
description: 文章简介（会显示在 RSS 中）
date: 2024-01-01 # 发布日期
tags: # 分类标签
  - JavaScript
  - React
image: /images/cover.jpg # 封面图
---
# 文章内容...

RSS 生成规则

• ✅ 自动收集所有 .md 文件
• ✅ 按日期排序（最新的在前）
• ✅ 只保留最新的 20 篇文章
• ✅ 排除 index.md 等索引页面
• ⚙️ 配置文件: .vitepress/theme/rss.ts

常见问题

Q: RSS 没有更新？

• 确保运行了 pnpm build（开发模式不生成 RSS）
• 检查文章的 frontmatter 是否包含 title 和 date

Q: 如何修改 RSS 包含的文章数量？

// .vitepress/theme/rss.ts
.slice(0, 20); // 改成你想要的数量

Q: 如何修改 RSS 的描述信息？

// .vitepress/theme/rss.ts
const siteTitle = 'cmwrun';
const siteDescription = '你的站点描述';
const author = {
  name: '你的名字',
  email: 'your-email@example.com',
};

---

📊 推广你的 RSS

1. 在导航栏添加订阅链接：

   // .vitepress/config.mts
   nav: [{ text: 'RSS 订阅', link: '/rss-subscribe' }];

2. 在首页或侧边栏添加 RSS 图标

3. 在文章底部提示读者订阅

---

如有任何问题或建议，欢迎在 GitHub Issues 中反馈！