Skip to content

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 阅读器:

  1. Feedly - https://feedly.com
  2. Inoreader - https://www.inoreader.com
  3. NewsBlur - https://www.newsblur.com
  4. 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

本地测试

  1. 构建网站:npm run build
  2. 检查生成的 feed 文件:cat docs/public/feed.xml
  3. 在浏览器中访问:http://localhost:4173/feed.xml(预览模式)

在线验证

使用在线工具验证 RSS feed 格式:

订阅测试

在 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 设置正确
  • 检查文件权限

最佳实践

  1. 定期更新:保持博客文章定期更新,吸引订阅用户
  2. 质量优先:提供高质量内容,增加用户粘性
  3. 完整描述:在 frontmatter 中提供准确的文章描述
  4. 合理分类:使用合适的分类标签,便于用户筛选
  5. SEO 优化:在文章中包含关键词,提高搜索引擎排名

参考资料