RSS Feed 配置说明
概述
营销官网已配置 RSS Feed 功能,用户可以订阅博客更新,自动获取最新文章。
RSS Feed 地址
- Feed URL:
https://www.zuguanjia.net/feed.xml - Feed 类型: application/rss+xml
- 编码: UTF-8
- 语言: zh-CN
功能特性
自动生成
RSS feed 在每次构建时自动生成,包含所有博客文章的信息:
- 文章标题
- 文章描述
- 发布日期
- 文章作者
- 文章分类
- 文章 URL
动态更新
- 每次运行
npm run build时重新生成 - 只包含非草稿文章(draft: true 的文章会被排除)
- 自动按发布日期排序
SEO 优化
- RSS feed 被添加到页面 head 标签中
- 搜索引擎可以发现和索引
- 支持 RSS 阅读器订阅
订阅方式
通过浏览器
用户可以直接访问 https://www.zuguanjia.net/feed.xml 查看订阅源。
通过 RSS 阅读器
推荐使用的 RSS 阅读器:
- Feedly - https://feedly.com
- Inoreader - https://www.inoreader.com
- NewsBlur - https://www.newsblur.com
- FreshRSS - 开源自托管方案
添加订阅源:https://www.zuguanjia.net/feed.xml
在网页中添加订阅按钮
在网站适当位置添加订阅链接:
html
<a href="/feed.xml" target="_blank" rel="noopener">
<svg xmlns="http://www.w3.org/2000/svg" width="20" height="20" viewBox="0 0 24 24" fill="currentColor">
<path d="M6.18 15.64a2.18 2.18 0 0 1 2.18 2.18C8.36 19 7.38 20 6.18 20C5 20 4 19 4 17.82a2.18 2.18 0 0 1 2.18-2.18M4 4.44A15.56 15.56 0 0 1 19.56 20h-2.83A12.73 12.73 0 0 0 4 7.27V4.44m0 5.66a9.9 9.9 0 0 1 9.9 9.9h-2.83A7.07 7.07 0 0 0 4 12.93V10.1z"/>
</svg>
订阅更新
</a>博客文章配置
要在 RSS feed 中包含文章,需要在文章 frontmatter 中添加相应信息:
markdown
---
title: 电脑租赁业务如何数字化转型
description: 本文介绍了电脑租赁业务数字化转型的关键步骤和最佳实践...
date: 2025-01-15
author: 租管家数据科技有限公司
category: 业务管理
# draft: true # 设置为 true 则不会出现在 RSS feed 中
---
文章内容...测试 RSS Feed
本地测试
- 构建网站:
npm run build - 检查生成的 feed 文件:
cat docs/public/feed.xml - 在浏览器中访问:
http://localhost:4173/feed.xml(预览模式)
在线验证
使用在线工具验证 RSS feed 格式:
- W3C Feed Validation Service: https://validator.w3.org/feed/
- RSS Board Validator: https://www.rssboard.org/rss-validator/
订阅测试
在 RSS 阅读器中添加订阅源,确认:
- 文章列表显示正常
- 文章内容完整
- 链接可点击
- 日期显示正确
自定义配置
修改 Feed 信息
编辑 .vitepress/config.js 中的配置:
javascript
await generateRSSFeed(pages, {
baseUrl: 'https://www.zuguanjia.net',
title: '租管家 - 电脑租赁管理系统', // Feed 标题
description: '...', // Feed 描述
author: '租管家数据科技有限公司', // 默认作者
feedPath: 'public/feed.xml' // 输出路径
})添加更多分类
修改 rss.js 中的默认分类:
javascript
categories: ['电脑租赁', '租赁管理', 'ERP系统', '企业管理', '业务转型']调整更新频率
修改 TTL(Time To Live)参数:
javascript
const feed = new RSS({
// ... 其他配置
ttl: 1440, // 单位:分钟,默认60分钟,1440=24小时
})故障排查
Feed 未生成
- 检查
docs/public/目录是否存在 - 确认构建过程中没有错误
- 查看构建日志中的 RSS 生成信息
文章未显示
- 确认文章在
blog/目录下 - 检查 frontmatter 是否包含必要字段
- 确认
draft: true未设置
Feed 无法访问
- 检查服务器配置是否允许访问
.xml文件 - 确认 CORS 设置正确
- 检查文件权限
最佳实践
- 定期更新:保持博客文章定期更新,吸引订阅用户
- 质量优先:提供高质量内容,增加用户粘性
- 完整描述:在 frontmatter 中提供准确的文章描述
- 合理分类:使用合适的分类标签,便于用户筛选
- SEO 优化:在文章中包含关键词,提高搜索引擎排名
参考资料
- RSS 2.0 规范:https://www.rssboard.org/rss-specification
- VitePress 官方文档:https://vitepress.dev/
- RSS 包文档:https://www.npmjs.com/package/rss