173 lines
12 KiB
HTML
173 lines
12 KiB
HTML
<!DOCTYPE html>
|
|
|
|
<head>
|
|
<title>What Is RSS?</title>
|
|
<meta name="description" content="This page seeks to explain what RSS is, and why
|
|
and how to use it on your website.">
|
|
<meta charset="utf-8">
|
|
<meta name="title" content="What Is RSS?">
|
|
<link rel="stylesheet" href="./css/rssstyles.css">
|
|
|
|
</head>
|
|
|
|
|
|
<body>
|
|
|
|
<div id="flex-container">
|
|
<div id="main-content">
|
|
<h1 class=orange id="part1">What Is RSS?</h1>
|
|
<img src="./images/articleimages/rsspic3.png" alt="What is Really Smart Syndication and how can we use it to make a healthier internet?" id="articleimage" style="max-width: 640px;
|
|
display: block;
|
|
margin-left: auto;
|
|
margin-right: auto;">
|
|
<div class="padded">
|
|
<p> <i>Article by Dalm.</i><br>
|
|
<b>RSS</b> AKA Really Smart Syndication, Really Simple Syndication or RDF Site Summary is a kind of standardised format for publishing site updates using only a single
|
|
XML-formatted text file! An RSS Feed can be published <b>anywhere on the web that allows you to upload text files and view them on the public web!</b>
|
|
From Neocities, to self-hosted solutions, to Github, to Google Drive! (but also, don't use google.)<br><br>
|
|
RSS relies on two things to work:
|
|
<ul>
|
|
<li>A specially formatted plain text file that's uploaded somewhere on the web. When the publisher of the feed wants to add something new, they simply change this file. Each time the publisher updates this file, it is then checked by...</li>
|
|
<li>A "News Aggregator" or RSS Reader application, which is installed by the person following the feed. This checks for updates to the text file above
|
|
every so often. When it discovers a difference, it adds the new entry to the feed!
|
|
</li>
|
|
</ul>
|
|
<h2>Why use it?</h2>
|
|
<p>
|
|
In the modern day we've become accustomed to personalised feeds run by algorithms... But to some degree, these actually make it HARDER for you to see the things you want to see and keep up
|
|
with what your friends are up to! However, technologies exist that can help us keep up to date with what our favourite artists, writers and musicians are up to without relying on centralised
|
|
social media feeds which tend to hide things that don't fit their corporate idea of what constitutes "content."<br><br>
|
|
The real world, the real internet, cannot be boiled down to 'content.' Not everything is easily shareable in a chunk divorced from context. Rather than bringing works to you, RSS is a system
|
|
which brings you to the work. Allows you to understand it in its own context on the internet. It is also not reliant on huge companies which do not have your best interests in mind, unlike Twitter, for
|
|
example (which was just bought by noted union buster & ape mutilator Elon Musk.)<br><br>
|
|
It also allows you to better sort your news-- On many feed-based websites such as Facebook or Twitter, you find everything everyone's doing in one big long slurry. You might see someone's personal essay, then you might see
|
|
a shared piece of news about conservative attacks on transgender people, then a poem, then some porn. Using a curated feed means that you can see all those things in a big slurry if you want, or you can keep them separate... It's just
|
|
better for your mental health! It also allows you to create an experience of catching up with people's sites that is not addictive or manipulative, but is instead self-directed and relaxed... Your RSS feed also won't notify anyone when you update your page, unless you want it to! This means
|
|
that your followers won't get spammed with everything you've done or liked or what-have-you... After all, the Like button is just another Retweet button!<br><br>
|
|
RSS is extremely easy to set up by hand, totally free (as long as you have hosting), and does exactly what it says on the tin. It's a sensible existing format which solves some of the problems that social media giants have invented,
|
|
and it already exists! Read on in this article for instructions on how to set up an RSS feed on your website, some programs you can use to follow the RSS feeds belonging to your friends, and some goodies and badges made by me.
|
|
<br>For more information
|
|
on the project of reclaiming the internet and creating smaller, healthier spaces, check out <a href="https://indieweb.org/">The Indieweb</a> and <a href="https://yesterweb.org/">Yesterweb</a> communities!
|
|
|
|
</p>
|
|
</div>
|
|
<hr>
|
|
</p>
|
|
<h1 class=orange id="part2">How To Add An RSS Feed To Your Site!</h1>
|
|
<div id="section2container">
|
|
<img src="./images/articleimages/rssanatomy.png" id="articleimage" style="width: 800px; margin-right: 5px;
|
|
float:left;">
|
|
<p class="padded" style="min-height: 600px;">
|
|
Adding an RSS feed to your site is extremely simple. All you really need to do is format a file in notepad in the proper way, then upload it anywhere that allows you to directly link to it and modify/reupload the file at the same URL.
|
|
Neocities is ideal for this, but anywhere you're hosting a static site will work.<br><br>
|
|
The file can be either a .txt or a .xml file. I prefer .xml as in Firefox, it causes a popup to appear asking if the user wants to subscribe using a couple of popular RSS readers. Either can be read by most readers, however.<br><br>
|
|
Below is a guide by <a href="mailto:adrian_neumann@gmx.de">Adrian Neumann</a> made for <a href="https://rssguide.neocities.org">https://rssguide.neocities.org</a>. (this guide is CC-BY-SA)<br><hr>
|
|
</p>
|
|
</div>
|
|
<div id="neumannguide" style="margin-top: 10px" class="padded">
|
|
<h1>RSS Howto</h1>
|
|
|
|
<p>This is a simple guide to adding an RSS Feed to your Neocities site, by hand.</p>
|
|
|
|
<h2>Your First RSS Feed</h2>
|
|
|
|
<p>RSS is a simple format, similar to HTML. To can create an RSS Feed for your site in any text editor, including the one provided by Neocities in the browser. Just like with HTML you need a bit of boilerplate to get started. It looks like this:</p>
|
|
|
|
<pre>
|
|
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<rss version="2.0">
|
|
<channel>
|
|
<title>Your RSS Feed Title</title>
|
|
<description>This is the description of your RSS feed</description>
|
|
<link>https://rssguide.neocities.org</link>
|
|
<lastBuildDate>
|
|
Tue, 10 Jul 2018 09:58 +0100
|
|
</lastBuildDate>
|
|
<ttl>20000</ttl>
|
|
</channel>
|
|
</rss>
|
|
</pre>
|
|
|
|
<p>That's an empty RSS Feed. The <code>lastBuildDate</code> tag together with the <code>ttl</code> tag provide hints for RSS readers how often they should update the feed. It is important to adhere to the format of the timestamp. It must be compliant to <a href="https://tools.ietf.org/html/rfc2822#section-3.3">RFC 2822</a>. Since understanding RFCs is a bit complicated, I recommend you use a handy timestamp generator, for example <a href="http://www.timestampgenerator.com/">here</a>.
|
|
|
|
<h2>Adding the RSS Feed to your site</h2>
|
|
|
|
<p>After saving the above text in a file on your server, e.g. <a href="https://rssguide.neocities.org/feed.txt"><code>feed.txt</code></a> you can add a link somewhere on your site to let people know where to find your feed. Additionally you can add a tag to the header of your website let browsers know that your site has an RSS feed so that they can activate RSS support if they have it. Add the following next to the <code>meta</code> tags in the header: <code><link href="https://rssguide.neocities.org/feed.txt" rel="alternate" type="application/rss+xml" title="What's new on rssguide.neociites.org" /></code>.</p>
|
|
|
|
<h2>Adding Items to your RSS Feed</h2>
|
|
|
|
<p>Adding items to your feed is easy too. An item looks something like this:</p>
|
|
|
|
<pre>
|
|
<item>
|
|
<title>The title of your item</title>
|
|
<description>
|
|
An arbitrary description of your item, for example the content of your new article, or a short excerpt.
|
|
</description>
|
|
<link>https://rssguide.neocities.org/the_article.html</link>
|
|
<pubDate>
|
|
Tue, 10 Jul 2018 09:58 +0100
|
|
</pubDate>
|
|
</item>
|
|
</pre>
|
|
|
|
<p>The <code>pubDate</code> tag again must contain the date in the RFC 2822 format. Don't forget to adapt the <code>lastBuildDate</code> as well.</p>
|
|
<p>If you want to add HTML in the description that's possible as well, but you first have to run it through a tool that escapes special characters like <. <a href="https://www.freeformatter.com/html-escape.html">Here is such a tool</a>.</p>
|
|
<p>You can add files to your item with the <code>enclosure</code> tag. Check <a href="https://en.wikipedia.org/wiki/RSS_enclosure">Wikipedia</a> for an example.</p>
|
|
<p>Now you just add the <code>item</code> after the <code>ttl</code> and you're done. The finished feed looks like this:</p>
|
|
<pre>
|
|
<?xml version="1.0" encoding="UTF-8" ?>
|
|
<rss version="2.0">
|
|
<channel>
|
|
<title>Your RSS Feed Title</title>
|
|
<description>This is the description of your RSS feed</description>
|
|
<link>https://rssguide.neocities.org</link>
|
|
<lastBuildDate>
|
|
Tue, 10 Jul 2018 09:58 +0100
|
|
</lastBuildDate>
|
|
<ttl>20000</ttl>
|
|
|
|
<item>
|
|
<title>The title of your item</title>
|
|
<description>
|
|
An arbitrary description of your item, for example the content of your new article, or a short excerpt.
|
|
</description>
|
|
<link>https://rssguide.neocities.org/the_article.html</link>
|
|
<pubDate>
|
|
Tue, 10 Jul 2018 09:58 +0100
|
|
</pubDate>
|
|
</item>
|
|
</channel>
|
|
</rss>
|
|
</pre>
|
|
|
|
<p>Eventually you might want to purge old items from the bottom of your feed, but that's not strictly necessary.</p>
|
|
--<a href="mailto:adrian_neumann@gmx.de">Adrian Neumann</a>, Source: <a href="https://rssguide.neocities.org">https://rssguide.neocities.org</a>
|
|
</div>
|
|
<hr>
|
|
<h1 class=orange id="part3">Feed Readers: Keep Up With Your Friends!</h1>
|
|
<p>
|
|
A Feed reader is an application that's used to view RSS feeds and notifies you when you update. I like to use Mozilla Thunderbird, as it doubles as a
|
|
fairly solid Email client and lets you customise your various feeds, but below are some ones that my friends recommend:
|
|
</p>
|
|
|
|
<h1 class=orange id="part4">Goodies and Downloads</h1>
|
|
|
|
</div>
|
|
|
|
<div id="sidebar">
|
|
<div id="sidebarscroll">
|
|
<h1 style="text-align: center; display: block; background-color: antiquewhite; padding: 5px; border-width: 1px 3px 3px 2px;
|
|
border-style: solid double double solid;
|
|
border-radius: 8px;
|
|
border-color: black;">Navigation</h1>
|
|
<img src="./icons/RSS img.png" style="display:block; width: 100%; max-width: 150px; margin-left: auto; margin-right: auto; margin-bottom: 10px;">
|
|
<a href="#part1" class=navlink><h2>What Is RSS?</h1></a>
|
|
<a href="#part2" class=navlink><h2>How to set up RSS on your Site</h2></a>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<footer>This page and its contents are Public Domain and can be downloaded and used for any purpose for free.</footer>
|
|
</body>
|
|
|
|
</html> |