如何将blogdown博客接入R-Bloggers？及RSS订阅源问题解决

我来一步步给你梳理流程：

• 先确认你的博客符合R-Bloggers的核心要求：内容必须以R语言相关主题为主（比如数据分析、可视化、统计建模、包开发这些），而且要有稳定更新的原创内容，搬运或无关内容大概率会被拒。
• 检查你的博客是否有正常可用的RSS订阅源。因为blogdown基于Hugo，默认会自动生成RSS feed，一般地址是你的博客域名加上/index.xml或者/rss.xml，你可以直接在浏览器里访问这个地址，确认feed能正常打开且显示文章列表。
• 准备好这些后，去R-Bloggers的官方提交入口填写信息：包括博客名称、博客主页URL、RSS feed地址，再简单描述下你的博客专注的R领域方向。
• 提交后就等审核就行，R-Bloggers的团队会人工检查内容，一般几天到一周内会给你反馈结果。

针对你遇到的两个问题，咱们分开来解决：

1. 修复XML未声明实体错误 #

你看到的Undeclared entity error基本都是因为内容里有XML解析器不认可的特殊字符，最常见的就是&符号（比如链接里的参数、代码里的逻辑符，甚至普通文本里的“&”）。XML里&必须转义成&，不然就会报错。你可以这么做：

• 根据错误提示的行号和列号，找到对应的博客markdown文件，定位到那个位置的内容，检查是否有&、©、®这类特殊字符。
• 如果是普通文本里的&，直接手动替换成&；如果是代码块里的，正常来说Hugo会自动转义，但如果还是出问题，你可以把代码块用反引号包裹好，确保Hugo能正确识别。
• 另外，智能引号（“”‘’）这类符号也可能触发错误，建议换成普通的双引号或单引号（"" ''）。
• 修改完后，运行blogdown::build_site()重新生成博客，再访问你的RSS feed，确认XML能正常加载，没有报错。

2. 让RSS订阅源包含完整内容 #

默认情况下，Hugo生成的RSS可能只输出文章摘要，这不符合R-Bloggers的要求。你可以通过修改配置文件来解决：

• 打开博客根目录下的config.toml（如果用的是yaml格式就打开config.yaml）。
• 如果是toml格式，添加或修改以下配置：

  [params]
    rss_full_content = true
  

  要是这个参数没用，你可以直接设置summaryLength为一个足够大的数值，比如10000，这样Hugo会把整篇文章内容作为“摘要”输出到RSS里：

  [outputs]
    home = ["HTML", "RSS"]
  [params]
    summaryLength = 10000
  

• 有些主题可能有自己的RSS配置选项，你也可以看看主题的文档，找开启完整RSS内容的设置。
• 修改配置后重新生成博客，然后检查你的RSS feed，确认每篇文章的<description>标签里包含了完整的文章内容，而不是只显示开头一部分。

内容的提问来源于stack exchange，提问作者nathaneastwood