这是一种无需使用插件即可将 RSS 提要添加到基于 Kirby 的博客的快速而简单的方法。
我使用卡比已经一年多了,我仍然非常喜欢它。然而,一路走来,我学到了很多东西,但我并没有很好地记录下来。所以我想我应该开始将它们写成帖子,主要是为了我可以参考它们,但也(希望)能够帮助你们中的一些人。
在第一篇文章中,我将解释如何将 RSS 提要添加到您的 Kirby 博客,而无需安装插件。
第 1 步 – 创建 RSS 片段
您需要做的第一件事是在您的代码片段文件夹中创建一个名为rss.php
的新文件。默认情况下,该位置应该是:
[site root]/site/snippets/
然后,您需要将此文件的内容粘贴到刚刚创建的rss.php
文件中。
粘贴后,您需要确保第 9 行和第 22 行的date()
字段与博客文章蓝图中的日期字段名称匹配。
例如,如果您使用已published
作为日期字段的名称,则第 9 行将如下所示:
<lastBuildDate><?= $posts->first()->published()->toDate('r') ?></lastBuildDate>
此代码片段的作用是循环浏览您的帖子并提取标题、发布日期和所有内容(这非常重要)。
现在,Kirby 拥有了 RSS 提要所需的数据,我们需要告诉它如何使用它。
第 2 步 – 创建路线
下一步是在配置文件中创建一条路由,以便 Kirby 期望看到 RSS 提要并知道如何处理它。为此,请打开config.php
文件并将该文件的内容添加到routes
部分。
完成此操作后,您需要编辑路线中的几行:
- 第 9 行是您设置 Feed 的 URL 的位置。默认为
/feed
,但如果您想更改 URL,请更改此行的/feed
部分 - 在第 12 和 13 行编辑详细信息,使其包含您的博客名称和简短摘要
- 第 14 行配置 RSS 提要中包含的项目数。默认为 20,但如果您想要更多或更少,请更改
limit(20)
值
字面意思就是这样。通过执行这几个简单的步骤,您应该拥有一个易于配置的有效 RSS 源。例如,如果您像我一样想要在 RSS 提要项目的末尾添加一条小消息,则可以在结束</description>
标记之前添加一些内容。
所以这个:
<![CDATA[<?= $item->text()->kt() ?>]]> </description>
就变成这样了:
<![CDATA[<?= $item->text()->kt() ?>]]> <![CDATA[ <hr> <p>Thanks for reading this post via RSS. RSS is great, and you're great for using it. ❤️</p> ]]> </description>
最后的想法
有许多插件可用于向 Kirby 添加 RSS 支持,但我往往对这些插件创建提要的方式及其有效性存在疑问。由于它是一个插件,故障排除很困难,所以我决定构建自己的插件。
此解决方案很简单,因此您不应引入任何破坏网站的代码,并且它使您可以根据需要灵活地自定义提要。
我已经创建了一个 GitHub 存储库来补充这些帖子,因此我将在继续记录这些内容时添加内容。
同时,如果您有 Kirby 博客并且遇到问题,我很乐意为您提供帮助,只需使用下面的按钮给我发送电子邮件即可
感谢您通过 RSS 阅读这篇文章。 RSS 很棒,您也很擅长使用它。 ❤️
原文: https://kevquirk.com/blog/how-to-add-an-rss-feed-to-your-kirby-blog