├── .github
    └── FUNDING.yml
├── LICENSE.md
├── README.md
├── feed.articles.xml
├── feed.category.xml
├── feed.links.xml
└── feed.xml


/.github/FUNDING.yml:
--------------------------------------------------------------------------------
 1 | # These are supported funding model platforms
 2 | 
 3 | github: georgemandis
 4 | patreon: 
 5 | open_collective: # Replace with a single Open Collective username
 6 | ko_fi: # Replace with a single Ko-fi username
 7 | tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
 8 | community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
 9 | liberapay: # Replace with a single Liberapay username
10 | issuehunt: # Replace with a single IssueHunt username
11 | otechie: # Replace with a single Otechie username
12 | custom: 
13 | 


--------------------------------------------------------------------------------
/LICENSE.md:
--------------------------------------------------------------------------------
 1 | The MIT License (MIT)
 2 | 
 3 | Copyright (c) 2014 George Mandis
 4 | 
 5 | Permission is hereby granted, free of charge, to any person obtaining a copy
 6 | of this software and associated documentation files (the "Software"), to deal
 7 | in the Software without restriction, including without limitation the rights
 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 9 | copies of the Software, and to permit persons to whom the Software is
10 | furnished to do so, subject to the following conditions:
11 | 
12 | The above copyright notice and this permission notice shall be included in all
13 | copies or substantial portions of the Software.
14 | 
15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21 | SOFTWARE.
22 | 


--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
 1 | Jekyll RSS Feed Templates
 2 | =========================
 3 | 
 4 | **NOTE:** If you're a fan of this project you should checkout the sister project: [jekyll-json-feeds](https://github.com/snaptortoise/jekyll-json-feeds).
 5 | 
 6 | A few Liquid templates to use for rendering RSS feeds for your Jekyll blog.  Featuring four kinds of feeds:
 7 | 
 8 | - **feed.xml** — Renders the 10 most recent posts.
 9 | - **feed.category.xml** — Only renders posts for a specific category. This example renders posts for a "miscellaneous" category.
10 | - **feed.links.xml** &mdash; Only contains posts that link to external websites noted by a <code>link</code> variable in the [YAML Front Matter](https://github.com/mojombo/jekyll/wiki/YAML-Front-Matter).  Not a common Jekyll convention, but a good way to generating a linked list.
11 | - **feed.articles.xml** &mdash; Only showing articles that don't link to external sites; The opposite of <code>feed.links.xml</code>
12 | 
13 | How to use
14 | ----------
15 | - Update \_config.yml as noted below, or manually replace the variables.
16 | - Copy one of the xml (ie, <code>feed.xml</code>) files to the root directory of your Jekyll blog.
17 | - Run <code>jekyll</code>.
18 | 
19 | In your generated <code>\_site</code> folder you should find a properly formatted feed at <code>feed.xml</code>.
20 | 
21 | Customizing \_config.yml
22 | ------
23 | These templates rely on a customized version of <code>\_config.yml</code>.  The following lines have been added:
24 | 
25 | 	name: Your Blog's Name
26 | 	description: A description for your blog
27 | 	url: http://your-blog-url.example.com
28 | 	feed_items: 10
29 | 	feed_update_period: daily
30 | 	feed_update_frequency: 1
31 | 
32 | This makes it easy to reference the title, description and URL for your site in the feed templates using <code>{{ site.name }}</code>, <code>{{ site.description }}</code> and <code>{{ site.url }}</code>.  Even if you're not using these feed templates, you might find these variables useful when you're designing your layouts.
33 | 
34 | The `feed_*` items shown above are the default. You can safely omit them.
35 | 
36 | Miscellany
37 | -----------
38 | - **Note on YAML Front Matter block**: The xml files contain an empty [YAML Front Matter](https://github.com/mojombo/jekyll/wiki/YAML-Front-Matter) block. This is necessary because Jekyll will not process a page with Liquid unless there is a YAML block at the top of the file. 
39 | 
40 | - **Note on layouts**: Previously, this block contained the line <code>layout: none</code> but that was found to cause a separate issue for some: https://github.com/snaptortoise/jekyll-rss-feeds/commit/209b83b504fde14722491ea5d9753189566c8598. However, if you've specified a *default* layout in your `_config.yml` file then you **will** most likely want to specify `layout: none` for your RSS feeds. Otherwise they will render in the default layout which is likely to be an HTML page. See this issue for reference: [https://github.com/snaptortoise/jekyll-rss-feeds/issues/32](https://github.com/snaptortoise/jekyll-rss-feeds/issues/32)
41 | 
42 | - **RSS Autodiscovery**: If your template is not already setup to do so, make sure the RSS feeds are discoverable by browsers, bots, etc. by providing proper link tags to your Jekyll layout files (adapt `href` and `title` appropriately):
43 | 
44 |     	<link href="/blog/feed.xml" type="application/rss+xml" rel="alternate" title="Latest 10 blog posts (atom)" />
45 | 
46 |     Refer to [rssboard.org/rss-autodiscovery](http://www.rssboard.org/rss-autodiscovery) for details.
47 | - **Validation**: You can use the W3C Validator to make sure your feeds are formatted correctly: [http://validator.w3.org/feed/](http://validator.w3.org/feed/)
48 | 
49 | - If you're a [Pinboard](https://pinboard.in) user and found this repo useful, take a look at [jekyll-pinboard](https://github.com/snaptortoise/jekyll-pinboard-plugin). It allows you to load your Pinboard bookmarks into your Jekyll site with just a couple lines.
50 | 
51 | - If you're looking for [JSON feed](jsonfeed.org) templates to add to your Jekyll blog please checkout the sister project: [jekyll-json-feeds](https://github.com/snaptortoise/jekyll-json-feeds).
52 | 


--------------------------------------------------------------------------------
/feed.articles.xml:
--------------------------------------------------------------------------------
 1 | ---
 2 | ---
 3 | <?xml version="1.0" encoding="UTF-8"?>
 4 | <rss version="2.0"
 5 | 	xmlns:atom="http://www.w3.org/2005/Atom"
 6 | 	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
 7 | >
 8 | 	<channel>
 9 | 		<title>{{ site.name | xml_escape }} - Articles</title>
10 | 		<description>{% if site.description %}{{ site.description | xml_escape }}{% endif %}</description>
11 | 		<sy:updatePeriod>{{ site.feed_update_period | default: "daily" | xml_escape }}</sy:updatePeriod>
12 | 		<sy:updateFrequency>{{ site.feed_update_frequency | default: 1 | xml_escape }}</sy:updateFrequency>
13 | 		<link>{{ site.url }}</link>
14 | 		<atom:link href="{{ site.url }}/{{ page.path }}" rel="self" type="application/rss+xml" />
15 | 		<lastBuildDate>{% for post in site.posts limit:1 %}{% unless post.link %}{{ post.date | date_to_rfc822 }}{% endunless %}{% endfor %}</lastBuildDate>
16 | 		{% for post in site.posts %}
17 | 			{% unless post.link %}
18 | 			<item>
19 | 				<title>{{ post.title | xml_escape }}</title>
20 | 				{% if post.excerpt %}
21 | 					<description>{{ post.excerpt | xml_escape }}</description>
22 | 				{% else %}
23 | 					<description>{{ post.content | xml_escape }}</description>
24 | 				{% endif %}
25 | 				<pubDate>{{ post.date | date_to_rfc822 }}</pubDate>
26 | 				<link>{{ site.url }}{{ post.url }}</link>
27 | 				<guid isPermaLink="true">{{ site.url }}{{ post.url }}</guid>
28 | 			</item>
29 | 			{% endunless %}
30 | 		{% endfor %}
31 | 	</channel>
32 | </rss>
33 | 


--------------------------------------------------------------------------------
/feed.category.xml:
--------------------------------------------------------------------------------
 1 | ---
 2 | ---
 3 | <?xml version="1.0" encoding="UTF-8"?>
 4 | <rss version="2.0"
 5 | 	xmlns:atom="http://www.w3.org/2005/Atom"
 6 | 	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
 7 | >
 8 | 	<channel>
 9 | 		<title>{{ site.name | xml_escape }} - Miscellaneous</title>
10 | 		<description>Posts categorized as 'miscellaneous'</description>
11 | 		<sy:updatePeriod>{{ site.feed_update_period | default: "daily" | xml_escape }}</sy:updatePeriod>
12 | 		<sy:updateFrequency>{{ site.feed_update_frequency | default: 1 | xml_escape }}</sy:updateFrequency>
13 | 		<link>{{ site.url }}</link>
14 | 		<atom:link href="{{ site.url }}/{{ page.path }}" rel="self" type="application/rss+xml" />
15 | 		<lastBuildDate>{% for post in site.categories.miscellaneous limit:1 %}{{ post.date | date_to_rfc822 }}{% endfor %}</lastBuildDate>
16 | 		{% assign feed_items = site.feed_items | default: 10 %}
17 | 		{% for post in site.categories.miscellaneous limit:feed_items %}
18 | 			<item>
19 | 				<title>{{ post.title | xml_escape }}</title>
20 | 				{% if post.excerpt %}
21 | 					<description>{{ post.excerpt | xml_escape }}</description>
22 | 				{% else %}
23 | 					<description>{{ post.content | xml_escape }}</description>
24 | 				{% endif %}
25 | 				<pubDate>{{ post.date | date_to_rfc822 }}</pubDate>
26 | 				<link>{{ site.url }}{{ post.url }}</link>
27 | 				<guid isPermaLink="true">{{ site.url }}{{ post.url }}</guid>
28 | 			</item>
29 | 		{% endfor %}
30 | 	</channel>
31 | </rss>
32 | 


--------------------------------------------------------------------------------
/feed.links.xml:
--------------------------------------------------------------------------------
 1 | ---
 2 | ---
 3 | <?xml version="1.0" encoding="UTF-8"?>
 4 | <rss version="2.0"
 5 | 	xmlns:atom="http://www.w3.org/2005/Atom"
 6 | 	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
 7 | >
 8 | 	<channel>
 9 | 		<title>{{ site.name | xml_escape }} - Links</title>
10 | 		<description>{% if site.description %}{{ site.description | xml_escape }}{% endif %}</description>
11 | 		<sy:updatePeriod>{{ site.feed_update_period | default: "daily" | xml_escape }}</sy:updatePeriod>
12 | 		<sy:updateFrequency>{{ site.feed_update_frequency | default: 1 | xml_escape }}</sy:updateFrequency>
13 | 		<link>{{ site.url }}</link>
14 | 		<atom:link href="{{ site.url }}/{{ page.path }}" rel="self" type="application/rss+xml" />
15 | 		<lastBuildDate>{% for post in site.posts limit:1 %}{% if post.link %}{{ post.date | date_to_rfc822 }}{% ifunless %}{% endfor %}</lastBuildDate>
16 | 		{% for post in site.posts %}
17 | 			{% if post.link %}
18 | 			<item>
19 | 				<title>{{ post.title | xml_escape }}</title>
20 | 				{% if post.excerpt %}
21 | 					<description>{{ post.excerpt | xml_escape }}</description>
22 | 				{% else %}
23 | 					<description>{{ post.content | xml_escape }}</description>
24 | 				{% endif %}
25 | 				<pubDate>{{ post.date | date_to_rfc822 }}</pubDate>
26 | 				<link>{{ post.link | escape }}</link>
27 | 				<guid isPermaLink="true">{{ site.url }}{{ post.url }}</guid>
28 | 			</item>
29 | 			{% endif %}
30 | 		{% endfor %}
31 | 	</channel>
32 | </rss>
33 | 


--------------------------------------------------------------------------------
/feed.xml:
--------------------------------------------------------------------------------
 1 | ---
 2 | ---
 3 | <?xml version="1.0" encoding="UTF-8"?>
 4 | <rss version="2.0"
 5 | 	xmlns:atom="http://www.w3.org/2005/Atom"
 6 | 	xmlns:dc="http://purl.org/dc/elements/1.1/"
 7 | 	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
 8 | >
 9 | 	<channel>
10 | 		<title>{{ site.name | xml_escape }}</title>
11 | 		<description>{% if site.description %}{{ site.description | xml_escape }}{% endif %}</description>		
12 | 		<sy:updatePeriod>{{ site.feed_update_period | default: "daily" | xml_escape }}</sy:updatePeriod>
13 | 		<sy:updateFrequency>{{ site.feed_update_frequency | default: 1 | xml_escape }}</sy:updateFrequency>
14 | 		<link>{{ site.url }}</link>
15 | 		<atom:link href="{{ site.url }}/{{ page.path }}" rel="self" type="application/rss+xml" />
16 | 		<lastBuildDate>{% for post in site.posts limit:1 %}{{ post.date | date_to_rfc822 }}{% endfor %}</lastBuildDate>
17 | 		{% assign feed_items = site.feed_items | default: 10 %}
18 | 		{% for post in site.posts limit:feed_items %}
19 | 			<item>
20 | 				<title>{{ post.title | xml_escape }}</title>
21 | 				{% if post.author.name %}
22 | 					<dc:creator>{{ post.author.name | xml_escape }}</dc:creator>
23 | 				{% endif %}
24 | 				{% if post.excerpt %}
25 | 					<description>{{ post.excerpt | xml_escape }}</description>
26 | 				{% else %}
27 | 					<description>{{ post.content | xml_escape }}</description>
28 | 				{% endif %}
29 | 				<pubDate>{{ post.date | date_to_rfc822 }}</pubDate>
30 | 				<link>{{ site.url }}{{ post.url }}</link>
31 | 				<guid isPermaLink="true">{{ site.url }}{{ post.url }}</guid>
32 | 			</item>
33 | 		{% endfor %}
34 | 	</channel>
35 | </rss>
36 | 


--------------------------------------------------------------------------------