RSRSS2

RRCategoryTag
A RRCategoryTag is xxxxxxxxx.
Instance Variables
category:
tag
RRChange
A RRChange is xxxxxxxxx.
Instance Variables
author: <Object>
changedClass: <Object>
changedSelector: <Object>
description: <Object>
sourceCode: <Object>
timestamp: <Object>
title: <Object>
author
- xxxxx
changedClass
- xxxxx
changedSelector
- xxxxx
description
- xxxxx
sourceCode
- xxxxx
timestamp
- xxxxx
title
- xxxxx
addParametersTo:
author
author:
changedClass
changedClass:
changedClassName
changedSelector
changedSelector:
description
description:
hasChangedClass
Some VW changes are not about any specific class
hasChangedSelector
isMeta
sourceCode
sourceCode:
sourceCodeLimitedTo:
timestamp
timestamp:
title
title:
RRChangesDemo
A RRChangesDemo is xxxxxxxxx.
Instance Variables
basePath
baseUrl
canBeRoot
dateOfImage
dateOfLastChange
description
initialize
Subclasses should redefine this method to perform initializations on instance creation
isFeed
recentChanges
renderChange:on:
renderChannelOn:
renderContentOn:
renderDescription:on:
renderRecentChangesOn:
updateRoot:
Here as a reminder
RRCloudTag
<cloud> is an optional sub-element of <channel>.
It specifies a web service that supports the rssCloud interface which can be implemented in HTTP-POST, XML-RPC or SOAP 1.1.
Its purpose is to allow processes to register with a cloud to be notified of updates to the channel, implementing a lightweight publish-subscribe protocol for RSS feeds.
A full explanation of this element and the rssCloud interface is here:
http://www.rssboard.org/rsscloud-interface
beSoap
beXmlRpc
domain:
path:
port:
protocol:
registerProcedure:
tag
tags
RRComponent
Base class for all RSS rendering components. Note that RSS components are stripped down versions of Seaside components. Many things like #call: don't work. Also #initialRequest: and #updateRoot: only get sent to the root component.
addDecoration:
answer:
Give back control to the component from which the receiver was called from. When returning, a component can additionally return anObject to the caller.
call:
Pass control from the receiver to aComponent. The receiver will be temporarily replaced with aComponent. Code can return from here later on by sending #answer: to aComponent.
initializeDecoration
we don't support decorations
registerAsApplication:
renderOn:
Do not override this methods on your component, override instead #renderContentOn: and in addition to not invoke directly renderContentOn: on subcomponent in such method but use instead html render: subcomponent.
rendererClass
Override this method if you want a custom renderer.
session
RRDayTag
A RRDayTag is xxxxxxxxx.
Instance Variables
monday
saturday
sunday
tag
thursday
triday
tuesday
wednesday
RRDemo
A RRDemo is xxxxxxxxx.
Instance Variables
canBeRoot
description
firstPublicationDate
fourthPublicationDate
isFeed
renderChannelOn:
renderContentOn:
renderFirstItemOn:
renderFourthtemOn:
renderSecondItemOn:
renderThirdItemOn:
secondPublicationDate
thirdPublicationDate
RREmailAddress
A RREmailAddress is xxxxxxxxx.
Instance Variables
address: <Object>
username: <Object>
address
- xxxxx
username
- xxxxx
address
address:
address:username:
displayString
printOn:
Append to the argument, aStream, a sequence of characters that
identifies the receiver.
username
username:
RREnclosureTag
A RREnclosureTag is xxxxxxxxx.
Instance Variables
length:
tag
type:
url:
RRGuidTag
A RRGuidTag is xxxxxxxxx.
Instance Variables
beNoPermaLink
bePermaLink
isPermaLink:
the value really must be a string else seaside makes
isPermaLink='isPermaLink'
tag
RRHandlerEditor
A RRHandlerEditor is xxxxxxxxx.
Instance Variables
handler: <Object>
handler
- xxxxx
handler
handler:
renderFormOn:
rootComponents
RRLanguageTag
A RRLanguageTag is xxxxxxxxx.
Instance Variables
afrikaans
albanian
basque
belarusian
bulgarian
catalan
chineseSimplified
chineseTraditional
codes
codesString
croatian
czech
danish
dutch
dutchBelgium
dutchNetherlands
english
englishAustralia
englishBelize
englishCanada
englishIreland
englishJamaica
englishNewZealand
englishPhillipines
englishSouthAfrica
englishTrinidad
englishUnitedKingdom
englishUnitedStates
englishZimbabwe
estonian
faeroese
finnish
french
frenchBelgium
frenchCanada
frenchFrance
frenchLuxembourg
frenchMonaco
frenchSwitzerland
gaelic
galician
generateFor:
generateTags
generatedCategory
german
germanAustria
germanGermany
germanLiechtenstein
germanLuxembourg
germanSwitzerland
greek
hawaiian
hungarian
icelandic
indonesian
irish
italian
italianItaly
italianSwitzerland
japanese
korean
macedonian
norwegian
polish
portuguese
portugueseBrazil
portuguesePortugal
romanian
romanianMoldova
romanianRomania
russian
russianMoldova
russianRussia
serbian
slovak
slovenian
spanish
spanishArgentina
spanishBolivia
spanishChile
spanishColombia
spanishCostaRica
spanishDominicanRepublic
spanishEcuador
spanishElSalvador
spanishGuatemala
spanishHonduras
spanishMexico
spanishNicaragua
spanishPanama
spanishParaguay
spanishPeru
spanishPuertoRico
spanishSpain
spanishUruguay
spanishVenezuela
swedish
swedishFinland
swedishSweden
tag
turkish
ukranian
RRRenderTest
A RRRenderTest is xxxxxxxxx.
Instance Variables
render:
renderFull:
testExample
testRenderExample
testRenderExampleFull
testWithLineBreaks
RRRfc822DateTime
A RRRfc822DateTime is xxxxxxxxx.
Instance Variables
dateAndTime: <Object>
timezoneString: <Object>
dateAndTime
- xxxxx
timezoneString
- xxxxx
dateAndTime
dateAndTime:
dateAndTime:timezoneString:
newDateAndTime:
newDateAndTime:offset:
newUtc:
offsetString:
printString
Answer a String whose characters are a description of the receiver.
If you want to print without a character limit, use fullPrintString.
timezoneString
timezoneString:
RRRfc822DateTimeTest
A RRRfc822DateTimeTest is xxxxxxxxx.
Instance Variables
testOffsetString
RRRssHandler
A RRRssHandler is xxxxxxxxx.
Instance Variables
openDebugger: <Object>
rootComponent: <Object>
openDebugger
- xxxxx
rootComponent
- xxxxx
configurationComponent
createRoot
description
Answer a descriptive text of the receiver.
handleRequest:
Handle aRequest and answer a response.
initialize
Subclasses should redefine this method to perform initializations on instance creation
isFeed
openDebugger
openDebugger:
rootComponent
rootComponent:
RRRssRenderCanvas
Structure of an RSS Document
Elements with a star (*) at the beginning are required. Elements with a plus sign (+) are an extension. Channel is automatically open.
channel
*title
*link
*description
language
copyright
managingEditor
webMaster
publicationDate
lastBuildDate
category
generator
documentation
cloud
timeToLive
image
*url
*title
*link
width
height
description
rating
textInput
*title
*description
*name
*link
skipHours
hour
skipDays
day
item
*title
*link
*description
author
category
comments
enclosure
guid
publicationDate
source
+creator
+comment
+commentRss
+contentEncoded

Email Addresses:
Email addresses must conform to RFC 2822
Convert the email address to a valid form. Examples of valid email addresses:
* joesmith@example.com
* joesmith@example.com (Joe Smith)
* Joe Smith <joesmith@example.com>
* joesmith.nospamplease@nospam.example.com
You can either:
- use correctly formatted strings
- implement #displayString in your domain email address class so that it return a string in a valid form
- implement #renderOn: in your domain email address class so that it renders a string in a valid form
- use RREmailAddress
date times:
The value specified must meet the Date and Time specifications as defined by RFC822, with the exception that the year should be expressed as four digits.
Here are examples of valid RFC822 date-times:
Wed, 02 Oct 2002 08:00:00 EST
Wed, 02 Oct 2002 13:00:00 GMT
Wed, 02 Oct 2002 15:00:00 +0200
If you use Chronos you can use
printStringUsing: printStringUsing: ChronosPrintPolicy rfc822
Else you can use RRRfc822DateTime.
Here is an example of an invalid RFC822 date-time:
2002-10-02T08:00:00-05:00
author
Email address of the author of the item.

It's the email address of the author of the item. For newspapers and magazines syndicating via RSS, the author is the person who wrote the article that the <item> describes. For collaborative weblogs, the author of the item might be different from the managing editor or webmaster. For a weblog authored by a single individual it would make sense to omit the <author> element.
author:
builder
category
---- as optional subelement of channel ----
Specify one or more categories that the channel belongs to. Follows the same rules as the <item>-level category element below.

---- as optional subelement of item ----
Includes the item in one or more categories.

The value of the element is a forward-slash-separated string that identifies a hierarchic location in the indicated taxonomy. Processors may establish conventions for the interpretation of categories.

You may include as many category elements as you need to, for different domains, and to have an item cross-referenced in different parts of the same domain.

It has one optional attribute, domain, a string that identifies a categorization taxonomy.

In RSS 2.0, a provision is made for linking a channel to its identifier in a cataloging system, using the channel-level category feature, described above. For example, to link a channel to its Syndic8 identifier, include a category element as a sub-element of <channel>, with domain 'Syndic8', and value the identifier for your channel in the Syndic8 database. The appropriate category element for Scripting News would be

rss category
domain: 'Syndic8';
with: 1765
category:
cdata:
aString must not include ']]>'

Google says if there is an error in the feed, there is a 0.02% chance
that this is the cause, combined with the fact that about 7% of all feeds
have errors there is a (2 / 10000) * (7 / 100) chance this goes wrong.
Do you deal in chance?

http://googlereader.blogspot.com/2005/12/xml-errors-in-feeds.html
close
cloud
Allows processes to register with a cloud to be notified of updates to the channel, implementing a lightweight publish-subscribe protocol for RSS feeds.

for more info see RRCloudTag
cloud:
comment
This element appears in RSS feeds and contains the URI that comment entries are to be POSTed to. The details of this are outlined in the CommentAPI Specification (http://wellformedweb.org/story/9)
comment:
commentRss
This element also appears in RSS feeds and contains the URI of the RSS feed for comments on that Item. This is documented in Chris Sells' Specification(http://www.sellsbrothers.com/spout/default.aspx?content=archive.htm#exposingRssComments). Note that for quite a while this page has had a typo and erroneously referred to this element as 'commentRSS' as opposed to the correct 'commentRss'. Feed consumers should be aware that they may run into both spellings in the wild. Please see this page (http://www.intertwingly.net/blog/2006/04/16/commentRss) for more information.
commentRss:
comments
URL of a page for comments relating to the item.

If present, it is the url of the comments page for the item.
comments:
contentEncoded
A module for the actual content of websites, in multiple formats.
http://web.resource.org/rss/1.0/modules/content/

example:
rss contentEncoded: '<p>What a <em>beautiful</em> day!</p>'
contentEncoded:
A module for the actual content of websites.

aString must not include ']]>'
context
context:callbacks:
copyright
Copyright notice for content in the channel.
copyright:
creator
An entity primarily responsible for making the resource.
Examples of a Creator include a person, an organization, or a service. Typically, the name of a Creator should be used to indicate the entity.

http://dublincore.org/documents/dces/
http://purl.org/dc/elements/1.1/creator
creator:
day
day:
defaultDocumentation
defaultGenerator
defaultGeneratorString
description
---- as required subelement of channel ----
Phrase or sentence describing the channel.
e.g.: 'The latest news from GoUpstate.com, a Spartanburg Herald-Journal Web site.'

---- a required subelement of item ----
The item synopsis.

---- as required subelement of textInput ----
Explains the text input area.

---- as an optional subelement of image ----
contains text that is included in the TITLE attribute of the link formed around the image in the HTML rendering.
description:
document
documentation
A URL that points to the documentation for the format used in the RSS file. It's probably a pointer to this page. It's for people who might stumble across an RSS file on a Web server 25 years from now and wonder what it is.
e.g. 'http://www.rssboard.org/rss-specification'
see #defaultDocumentation
documentation:
enclosure
Describes a media object that is attached to the item.

It has three required attributes. url says where the enclosure is located, length says how big it is in bytes, and type says what its type is, a standard MIME type.

The url must be an http url.

e.g.:
rss enclosure
url: 'http://www.scripting.com/mp3s/weatherReportSuite.mp3';
length: 12216320;
type: 'audio/mpeg'
enclosure:
encode:
generateBinaryFor:
generateUnaryFor:
generator
A string indicating the program used to generate the channel.
e.g.: 'RSRSS-pmm.3'
see #defaultGenerator
generator:
guid
A string that uniquely identifies the item.

guid stands for globally unique identifier. It's a string that uniquely identifies the item. When present, an aggregator may choose to use this string to determine if an item is new.

e.g.: 'http://some.server.com/weblogItem3207'

There are no rules for the syntax of a guid. Aggregators must view them as a string. It's up to the source of the feed to establish the uniqueness of the string.

If the guid element has an attribute named isPermaLink with a value of true, the reader may assume that it is a permalink to the item, that is, a url that can be opened in a Web browser, that points to the full item described by the <item> element. An example:

e.g.:
rss guid
bePermaLink;
with: 'http://inessential.com/2002/09/01.php#a2'

isPermaLink is optional, its default value is true. If its value is false, the guid may not be assumed to be a url, or a url to anything in particular.
guid:
height
Optional elements include <width> and <height>, numbers, indicating the width and height of the image in pixels.

Maximum value for height is 400, default value is 31.
height:
hour
hour:
html:
image
Specifies a GIF, JPEG or PNG image that can be displayed with the channel.
the following subelements are required:
url
title
link
the following subelements are optional:
width
height
description
image:
initializeWithContext:callbacks:
item
item:
language
The language the channel is written in. This allows aggregators to group all Italian language sites, for example, on a single page. A list of allowable values for this element, as provided by Netscape, is implemented in the 'languages-generated' protocl of RRLanguageTag. You may also use values defined by the W3C (http://www.w3.org/TR/REC-html40/struct/dirlang.html#langcodes).
language:
lastBuildDate
The last time the content of the channel changed.
again an RFC 822 date like all the other dates
e.g.: 'Sat, 07 Sep 2002 09:42:31 GMT'
lastBuildDate:
link
---- as required subelement of channel ----
The URL to the HTML website corresponding to the channel.
e.g.: 'http://www.goupstate.com/'

---- as required subelement of item ----
The URL of the item.

---- as required subelement of image ----
is the URL of the site, when the channel is rendered, the image is a link to the site. (Note, in practice the image <title> and <link> should have the same value as the channel's <title> and <link>

---- as required subelement of textInput ----
The URL of the CGI script that processes text input requests.
link:
managingEditor
Email address for person responsible for editorial content.
e.g.: 'George Matesky <geo@herald.com>'
managingEditor:
name
The name of the text object in the text input area.
name:
publicationDate
---- as optional subelement of channel ----
The publication date for the content in the channel. For example, the New York Times publishes on a daily basis, the publication date flips once every 24 hours. That's when the pubDate of the channel changes. All date-times in RSS conform to the Date and Time Specification of RFC 822(http://asg.web.cmu.edu/rfc/rfc822.html#sec-5), with the exception that the year may be expressed with two characters or four characters (four preferred).

---- as optional subelement of item ----
Indicates when the item was published.
Its value is a date, indicating when the item was published. If it's a date in the future, aggregators may choose to not display the item until that date.

e.g: 'Sat, 07 Sep 2002 00:00:01 GMT'
minimal: '20 Jun 82 23:59 EST'
publicationDate:
rating
The PICS (http://www.w3.org/PICS/) rating for the channel.
rating:
renderContentEncoded:
renders the html content of an item
a render canvas will be passed as an argument to the block
renderHtml:
convenvience method to render html
aOneArgumentBlock will be passed an html canvas
skipDays
A hint for aggregators telling them which days they can skip.

An XML element that contains up to seven <day> sub-elements whose value is Monday, Tuesday, Wednesday, Thursday, Friday, Saturday or Sunday. Aggregators may not read the channel during days listed in the skipDays element.
skipDays:
skipHours
A hint for aggregators telling them which hours they can skip.

An XML element that contains up to 24 <hour> sub-elements whose value is a number between 0 and 23, representing a time in GMT, when aggregators, if they support the feature, may not read the channel on hours listed in the skipHours element. The hour beginning at midnight is hour zero.
skipHours:
source
The RSS channel that the item came from.

Its value is the name of the RSS channel that the item came from, derived from its <title>. It has one required attribute, url, which links to the XMLization of the source.

rss source
url: 'http://www.tomalak.org/links2.xml';
with: 'Tomalak''s Realm'

The purpose of this element is to propagate credit for links, to publicize the sources of news items. It can be used in the Post command of an aggregator. It should be generated automatically when forwarding an item from an aggregator to a weblog authoring tool.
source:
space
spaceEntity
tag:
copy pasted from WAHtmlCanvas
tags
text:
copy pasted from WAHtmlCanvas
textInput
Specifies a text input box that can be displayed with the channel.
The purpose of the <textInput> element is something of a mystery. You can use it to specify a search engine box. Or to allow a reader to provide feedback. Most aggregators ignore it.

It has the following required subelements:
title
description
name
link
textInput:
timeToLive
It's a number of minutes that indicates how long a channel can be cached before refreshing from the source. This makes it possible for RSS sources to be managed by a file-sharing network such as Gnutella.

e.g.: 60
timeToLive:
title
----- as required subelement of channel ----
The name of the channel. It's how people refer to your service. If you have an HTML website that contains the same information as your RSS file, the title of your channel should be the same as the title of your website.
e.g.: 'GoUpstate.com News Headlines'

---- as required subelement of item ----
The title of the item.

---- as required subelement of image ----
describes the image, it's used in the ALT attribute of the HTML <img> tag when the channel is rendered in HTML

---- as required subelement of textInput ----
The label of the Submit button in the text input area.
title:
url
is the URL of a GIF, JPEG or PNG image that represents the channel.
url:
webMaster
Email address for person responsible for technical issues relating to channel.
e.g.: 'Betty Guernsey <betty@herald.com>'
webMaster:
width
Optional elements include <width> and <height>, numbers, indicating the width and height of the image in pixels.

Maximum value for width is 144, default value is 88.
width:
withLineBreaks:
RRRssRoot
A RRRssRoot is xxxxxxxxx.
Instance Variables
channelAttrs: <Object>
charSet: <Object>
rssAttrs: <Object>
styles: <Object>
channelAttrs
- xxxxx
charSet
- xxxxx
rssAttrs
- xxxxx
styles
- xxxxx
channelAttrs
charSet
charSet:
close:
contentType
context:
defaultCharSet
defaultContentType
initialize
Subclasses should redefine this method to perform initializations on instance creation
open:
rssAttrs
styles
stylesheet
writeFootOn:
writeHeadOn:
writePreamleOn:
writeStylesOn:
RRSourceTag
A RRSourceTag is xxxxxxxxx.
Instance Variables
tag
url:
RRStylesOne
A RRStylesOne is xxxxxxxxx.
Instance Variables
selectorsToInclude
The files represented by the selectors this method returns will be automatically added to the html <head> if the receiver is added to the respective Seaside application.
This makes only sense for CSS and JS files
styleCss
RRStylesThree
A RRStylesThree is xxxxxxxxx.
Instance Variables
styleXsl
updateRoot:
Only override if you want to automatically include new types of resources. The default implementation knows how to reference CSS, JS and FavIcons into aHtmlRoot.
RRStylesTwo
A RRStylesTwo is xxxxxxxxx.
Instance Variables
selectorsToInclude
The files represented by the selectors this method returns will be automatically added to the html <head> if the receiver is added to the respective Seaside application.
This makes only sense for CSS and JS files
style2Css
styleCss
RRXmlStyleSheet
A RRXmlStyleSheet is xxxxxxxxx.
Instance Variables
beXsl
encodeOn:
tag
RSRssVWInfo
A RSRssVWInfo is xxxxxxxxx.
Instance Variables
addonName