Skip Menu |

This queue is for tickets about the AnnoCPAN CPAN distribution.

Report information
The Basics
Id: 13751
Status: resolved
Worked: 30 min
Priority: 0/
Queue: AnnoCPAN
People
Owner: Nobody in particular
Requestors: todd [...] brainsick.com
Cc:
AdminCc:
Bug Information
Severity: Important
Broken in: (no value)
Fixed in: (no value)

History Show all quoted text
  Mon Jul 18 09:34:10 2005 Guest - Ticket created
Subject: POD markup vs RSS
"Now you can write your notes in POD! Well, on a subset of it, at least. You can use formatting sequences such as L<> (link), B<> (bold), I<> (italic), C<> (code), etc, and verbatim paragraphs (lines that start with a space). What you can't use are the pod commands, such as =item, =head1, etc. For more information about the POD format, see perlpod." Just so you know -- RSS is an XML dialect. This means that characters like < and > need to be escaped if you're including them in your RSS feed. I would strip the POD from the RSS feed altogether because it won't display as intended in most aggregators.
  Mon Jul 18 09:54:00 2005 itub [...] cpan.org - Correspondence added
[guest - Mon Jul 18 09:34:10 2005]: Show quoted text
> Just so you know -- RSS is an XML dialect. This means that characters > like < and > need to be escaped if you're including them in your > RSS feed. I would strip the POD from the RSS feed altogether > because it won't display as intended in most aggregators.
I know, and they *are* escaped (at least the opening brackets, which I think should be enough). This is from recent.rss: ---- <item rdf:about="http://annocpan.org/~GAAS/libwww-perl-5.803/lib/LWP/UserAgent.pm#note_109"> <title>LWP::UserAgent</title> <link>http://annocpan.org/~GAAS/libwww-perl-5.803/lib/LWP/UserAgent.pm#note_109</link> <description>Other interesting extensions: L&lt;LWPx::ParanoidAgent>, which is "[...]paranoid against attackers. It's to be used when you're fetching a remote resource on behalf of a possibly malicious user." L&lt;LWP::Parallel>, which takes a list of URLs and connects to all of them I&lt;in parallel>, and then waits for the results to come in.</description> ---- However, I did notice that Thunderbird doesn't display these correctly. I haven't tried others, so I assumed it was a bug in Thunderbird. Or am I supposed to escape these things twice?
  Mon Jul 18 13:32:13 2005 itub [...] cpan.org - Correspondence added 30 min
Ok, after some browsing, I found out that one really does have to escape things twice in RSS! (For example, http://www.tbray.org/atom/RSS-and-Atom#payload says that this is the case for RSS 2.0 at least) Sorry, I would have never imagined that. I've changed the RSS feeds to use the singly-escaped HTML version of the notes. They look nice in Thunderbird and even the links work properly. I think this fixes the problem, but let me know if some other RSS readers interpret them differently. If that's the case, I'll consider just using plain text (with doubly-escaped ampersands and left brackets. Argh! Or maybe I'll consider Atom; they claim that it doesn't have this problem).
  Mon Jul 18 13:32:14 2005 itub [...] cpan.org - Status changed from 'new' to 'resolved'
  Mon Jul 18 17:00:38 2005 The RT System itself - Status changed from 'resolved' to 'open'
  Mon Jul 18 17:00:38 2005 Guest - Correspondence added
From: Todd Ross
[ITUB - Mon Jul 18 13:32:13 2005]: Show quoted text
> I've changed the RSS feeds to use the singly-escaped HTML version of the > notes. They look nice in Thunderbird and even the links work properly. I > think this fixes the problem, but let me know if some other RSS readers > interpret them differently.
I personally use Sage and it looks like things are properly escaped now. Thanks!
  Mon Jul 18 17:15:14 2005 itub [...] cpan.org - Status changed from 'open' to 'resolved'