Customize your RSS Feed in a Ghost Theme
A few days ago, I wanted to adjust my RSS feed for this blog. I wasn’t entirely happy with my previous feed layout, so I wanted to make some changes. One of these changes was, for example, using excerpts, which Ghost offers, to write a kind of summary of the posts I write.
Add a custom route
As preliminary work, we must first add a custom route in the settings of our Ghost instance, which reflects the URL under which our RSS feed should then be accessible. To do this, we navigate to Admin settings -> Labs and download routes.yaml for editing.
Under routes add the URL where your new custom rss
feed will exist and reupload the file. In my case, I configured the following:
1routes:
2/rss/:
3template: rss
4content_type: text/xml
Custom rss
feeds need to be defined with the content_type
property.
Create a new template
To customize our RSS feed we need to create a new template on the root level of our currently used Ghost theme. I am presently using the atilla theme so my path looked like this:
themes/attila-3.8.1/rss.hbs
So create a new file called rss.hbs
and save it under the above-mentioned path.
You can use the following template if you want an RSS feed that looks like the one on this blog:
1<rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:media="http://search.yahoo.com/mrss/" version="2.0">
2<channel>
3<title><![CDATA[ {{@site.title}} ]]></title>
4<description><![CDATA[ {{@site.description}} ]]></description>
5<link>{{@site.url}}</link>
6<image>
7 <url>{{@site.url}}/favicon.png</url>
8 <title>{{@site.title}}</title>
9 <link>{{@site.url}}</link>
10</image>
11<lastBuildDate>{{date format="ddd, DD MMM YYYY HH:mm:ss ZZ"}}</lastBuildDate>
12<atom:link href="{{@site.url}}" rel="self" type="application/rss+xml"/>
13<ttl>60</ttl>
14
15{{#get "posts" limit="all" include="authors,tags"}}
16 {{#foreach posts}}
17 <item>
18 <title><![CDATA[ {{title}} ]]></title>
19 <description><![CDATA[
20 {{excerpt}}
21 <br/><br/>
22 Read the full article here: <a href="{{url absolute="true"}}">{{title}}</a>
23 ]]></description>
24 <link>{{url absolute="true"}}</link>
25 <guid isPermaLink="false">{{id}}</guid>
26 <dc:creator><![CDATA[ {{primary_author.name}} ]]></dc:creator>
27 <pubDate>{{date format="ddd, DD MMM YYYY HH:mm:ss ZZ"}}</pubDate>
28 </item>
29 {{/foreach}}
30{{/get}}
31
32</channel>
33</rss>
This template uses pre-defined variables that Ghost has to offer.
The result of a blog post that is displayed in an RSS reader will look something similar to this:
Once you have completed these steps, you can also use the excerpts provided by Ghost. For example, you can use the template I have shown you to write a summary of your blog post. Readers who are then interested in the whole article can read the entire post on your blog.