使用Jekyll使用GitHub页面生成特定于类别的RSS源

时间:2017-02-05 16:24:35

标签: jekyll github-pages

我正在尝试为GitHub Pages Jekyll网站生成特定于帖子类别的RSS Feed。

我了解jekyll-feed plugin可以为所有帖子生成RSS Feed,但根据this GitHub Issue,尚不支持特定类别的Feed。

GitHub页面不支持生成特定于类别的Feed的其他方法(即herehere,因为它不支持自定义插件。

有没有办法使用Jekyll和GitHub页面生成特定于类别的RSS源?

3 个答案:

答案 0 :(得分:4)

您可以创建自己的XML或RSS文件。对于这个答案,我使用了this example来构建。我还使用Wikipedia作为示例RSS提要。

filename:categoryname.rss

---
layout: null
---
<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0">
<channel>
 <title>RSS Title</title>
 <description>This is an example of an RSS feed</description>
 <link>http://www.example.com/main.html</link>
 <lastBuildDate>Mon, 06 Sep 2010 00:01:00 +0000 </lastBuildDate>
 <pubDate>Sun, 06 Sep 2009 16:20:00 +0000</pubDate>
 <ttl>1800</ttl>

 {% for post in site.categories.categoryname %}
 <item>
  <title>{{ post.title }}</title>
  <description>{{ post.description }}</description>
  <link>{{ post.url }}</link>
  <guid isPermaLink="true">{{ site.url }}{{ post.url }}</guid>
  <pubDate>{{ post.date }}</pubDate>
 </item>
 {% endfor %}

</channel>
</rss>

标题应该是:'mysitenames categoryname archive'。描述可能是您的类别描述。 Link是该类别的链接。 'lastBuildDate'值可能是您上一篇文章的日期,'pubDate'可能是相同的。

如果您有任何疑问,请与我们联系。

答案 1 :(得分:0)

以下是我为托管在GitHub Pages上的集合发布的内容,但是,对其进行修改也可能对类别有用。


通过Git的子模块功能可以方便地在另一个项目中下载...

cd your-project
git checkout gh-pages

mkdir -vp _layouts/modules

git submodule add -b master --name feed-rss2\
 https://github.com/liquid-utilities/feed-rss2.git\
 _layouts/modules/feed-rss2
  

注意, https 是GitHub Pages兼容性所必需的URL。

...这将导致类似于以下内容的代码可用...

_layouts/modules/feed-rss2/feed-rss2.html

---
layout: null
version: 0.0.1
license: AGPL-3.0
author: S0AndS0
---
{% capture workspace__rss2 %}
  {% assign date_format = '%a, %d %b %Y %T %z' %}
  {% assign collection_name = page.collection_name | default: include.collection_name | default: nil %}
  {% assign target_collection = site[collection_name] %}

  {% assign collection_home = page.collection_home | default: collection_name %}
  {% assign collection_description = page.description | default: site.description %}
  {% assign this_time_stamp = page.date | date: '%s' %}
  {% assign latest_time_stamp = page.date | date: '%s' %}

  {% assign rss_items_has_output = false %}
  {% capture workspace__rss2__entries %}
    {% for post in target_collection %}
      {% if page.relative_path == post.relative_path or post.slug == 'feed' %}
        {% continue %}
      {% elsif post.slug == collection_name or post.slug == 'index' %}
        {% continue %}
      {% endif %}

      {% assign rss_items_has_output = true %}
      {% assign post_synopsis = post.description | default: post.excerpt %}
      {% assign post_date_updated = post.date_updated | default: post.date %}

      {% assign this_time_stamp = post_date_updated | date: '%s' %}
      {% if latest_time_stamp < this_time_stamp %}{% comment %}> Syntax highlighting work-around{% endcomment %}
        {% assign latest_time_stamp = this_time_stamp %}
      {% endif %}

      <item>
        <title>{{- post.title | xml_escape -}}</title>
        <link>{{- post.url | absolute_url -}}</link>
        <guid isPermaLink="true">{{- post.url | absolute_url -}}</guid>
        <pubDate>{{- post_date_updated | date: date_format -}}</pubDate>
        <description>{{- post_synopsis | xml_escape -}}</description>
      </item>

      {% assign post_synopsis = nil %}
    {% endfor %}
  {% endcapture %}

  {% assign page_rights = page.copyright | default: collection_home.copyright | default: site.copyright %}
  {% assign page_rights = page_rights | default: site.github.license.name | default: 'All rights reserved' %}

  <?xml version="1.0" encoding="UTF-8" ?>
  <rss version="2.0">
    <channel>
      <title>{{- page.title | default: 'RSS Title' | xml_escape -}}</title>
      <link>{{- page.url | absolute_url -}}</link>
      <description>{{ collection_description | xml_escape }}</description>
      <copyright>Copyright {{ site.time | date: '%Y' }} {{ page_author | xml_escape }}. {{ page_rights | xml_escape }}</copyright>
      <lastBuildDate>{{- site.time | date: date_format -}}</lastBuildDate>
      <pubDate>{{- latest_time_stamp | date: date_format -}}</pubDate>
      <ttl>{{- page.time_to_live | default: '1800' -}}</ttl>
      {% if rss_items_has_output %}
        {{ workspace__rss2__entries | strip }}{% assign workspace__rss2__entries = nil %}
      {% endif %}
    </channel>
  </rss>
{% endcapture %}{{ workspace__rss2 | strip }}{% assign workspace__rss2 = nil %}

...然后在集合目录中设置供稿文件,就像...

_example-collection/example-collection.rss

---
layout: modules/feed-rss2/feed-rss2
title: Example Collection
collection_name: example-collection
collection_home: /example-collection/
date: 2019-07-23 21:12:13 -0700
content_type: xhtml
permalink: /:collection/:name:output_ext
---

...以及每个帖子/页面的FrontMatter的少量添加...

_example-collection/something-about-something.markdown

---
layout: post
title: Something About Something
description: Example collection page about something
date: 2019-07-21 11:42:11 -0300
time_to_live: 1800
---

...应该呈现与GitHub Pages托管的live演示类似的结果。

  

请注意,请检查documentation,以获取更新和克隆的提示和警告。


无论您是否使用上述项目的代码,我都建议您研究submodule功能(提示git help submodule),因为这样可以在多个存储库中重复使用代码,同时可以跟踪和跟踪版本轻松更新。 Plus子模块与GitHub Pages兼容,这意味着子模块在不探索持续集成解决方案的情况下,与第三方 plugin 的支持程度差不多。

另一个关键是要尝试利用这些类型的解决方案的布局。

如果您被卡住或上面的东西令人困惑,请随时发表评论。

答案 2 :(得分:0)

扩展JoostS答案:

---
layout: null
---
<?xml version="1.0" encoding="UTF-8" ?>
<rss version="2.0">
  <channel>
    <title>{{ site.title }}</title>
    <description>{{ site.description }}</description>
    <link>{{ site.url }}</link>
    <lastBuildDate>{{ site.time | date_to_rfc822 }}</lastBuildDate>
    <pubDate>{{ site.time | date_to_rfc822 }}</pubDate>
    <ttl>1800</ttl>
    {% for post in site.pages %}
    {% if post.title %}
    <item>
      <title>{{ post.title }}</title>
      <description>{{ post.description }}</description>
      <link>{{ site.url }}{{ post.url }}</link>
      <guid isPermaLink="true">{{ site.url }}{{ post.url }}</guid>
      <pubDate>{{ post.date | date_to_rfc822 }}</pubDate>
    </item>
    {% endif %}
    {% endfor %}
  </channel>
</rss>