|
@@ -1,70 +1,4 @@
|
1
|
1
|
<?xml version="1.0" encoding="utf-8"?>
|
2
|
|
-<!--
|
3
|
|
-
|
4
|
|
-# Pretty Feed
|
5
|
|
-
|
6
|
|
-Styles an RSS/Atom feed, making it friendly for humans viewers, and adds a link
|
7
|
|
-to aboutfeeds.com for new user onboarding. See it in action:
|
8
|
|
-
|
9
|
|
- https://interconnected.org/home/feed
|
10
|
|
-
|
11
|
|
-
|
12
|
|
-## How to use
|
13
|
|
-
|
14
|
|
-1. Download this XML stylesheet from the following URL and host it on your own
|
15
|
|
- domain (this is a limitation of XSL in browsers):
|
16
|
|
-
|
17
|
|
- https://github.com/genmon/aboutfeeds/blob/main/tools/pretty-feed-v3.xsl
|
18
|
|
-
|
19
|
|
-2. Include the XSL at the top of the RSS/Atom feed, like:
|
20
|
|
-
|
21
|
|
-```
|
22
|
|
-<?xml version="1.0" encoding="UTF-8"?>
|
23
|
|
-<?xml-stylesheet href="/PATH-TO-YOUR-STYLES/pretty-feed-v3.xsl" type="text/xsl"?>
|
24
|
|
-```
|
25
|
|
-
|
26
|
|
-3. Serve the feed with the following HTTP headers:
|
27
|
|
-
|
28
|
|
-```
|
29
|
|
-Content-Type: application/xml; charset=utf-8 # not application/rss+xml
|
30
|
|
-x-content-type-options: nosniff
|
31
|
|
-```
|
32
|
|
-
|
33
|
|
-(These headers are required to style feeds for users with Safari on iOS/Mac.)
|
34
|
|
-
|
35
|
|
-
|
36
|
|
-
|
37
|
|
-## Limitations
|
38
|
|
-
|
39
|
|
-- Styling the feed *prevents* the browser from automatically opening a
|
40
|
|
- newsreader application. This is a trade off, but it's a benefit to new users
|
41
|
|
- who won't have a newsreader installed, and they are saved from seeing or
|
42
|
|
- downloaded obscure XML content. For existing newsreader users, they will know
|
43
|
|
- to copy-and-paste the feed URL, and they get the benefit of an in-browser feed
|
44
|
|
- preview.
|
45
|
|
-- Feed styling, for all browsers, is only available to site owners who control
|
46
|
|
- their own platform. The need to add both XML and HTTP headers makes this a
|
47
|
|
- limited solution.
|
48
|
|
-
|
49
|
|
-
|
50
|
|
-## Credits
|
51
|
|
-
|
52
|
|
-pretty-feed is based on work by lepture.com:
|
53
|
|
-
|
54
|
|
- https://lepture.com/en/2019/rss-style-with-xsl
|
55
|
|
-
|
56
|
|
-This current version is maintained by aboutfeeds.com:
|
57
|
|
-
|
58
|
|
- https://github.com/genmon/aboutfeeds
|
59
|
|
-
|
60
|
|
-
|
61
|
|
-## Feedback
|
62
|
|
-
|
63
|
|
-This file is in BETA. Please test and contribute to the discussion:
|
64
|
|
-
|
65
|
|
- https://github.com/genmon/aboutfeeds/issues/8
|
66
|
|
-
|
67
|
|
--->
|
68
|
2
|
<xsl:stylesheet version="3.0" xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
|
69
|
3
|
xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/"
|
70
|
4
|
xmlns:itunes="http://www.itunes.com/dtds/podcast-1.0.dtd">
|