<h2>Welcome to ROME<aname="Welcome_to_ROME"></a></h2>
<p><i>"...ending syndication feed confusion by supporting all of 'em. "</i><i><aclass="externalLink"href="http://blogs.sun.com/roller/page/webmink/20040616#rome_wasn_t_built_in">*</a></i></p>
<p><b>ROME is a set of</b><b>R</b><b>SS and At</b><b>om</b><b>Utiliti</b><b>e</b><b>s for Java that is open source under the Apache 2.0 license.</b></p>
<p>ROME includes a set of parsers and generators for the various flavors of syndication feeds, as well as converters to convert from one format to another. The parsers can give you back Java objects that are either specific for the format you want to work with, or a generic normalized SyndFeed class that lets you work on with the data without bothering about the incoming or outgoing feed type.</p>
<p>If you use ROME for your site or software, please add it to the wiki page <ahref="./ProductsOrSitesPoweredByROME.html">PoweredByRome</a>, or drop us an email</p>
<p>Some of the links in the Navigation are out of date. This is because no one can edit them at present. However any registered user can edit the content of the pages and you'll find most of the links updated there, notably the Tutorials and Articles.</p>
<tdalign="left">Supports publishing protocols, specifically the Atom Publishing Protocol and the legacy MetaWeblog API. Propono includes an Atom client library, an Atom server framework and a Blog client that supports both Atom protocol and the MetaWeblog API.</td>
<li><ahref="./WhatPartOfTheAPIYouShouldBeUsing.html">What part of the API you should be using (rome)</a></li>
<li><ahref="./TutorialsAndArticles.html">Tutorials and Articles (rome)</a></li></ul></li>
<li>Articles about ROME
<ul>
<li><ahref="./WhyThisProject.html">Project Motivation</a> - why we started ROME</li>
<li><ahref="./RomeAPIFAQ.html">API FAQ</a>, why things are like they are</li>
<li><ahref="./WhatSWrongWithOtherExistingRSSParsingLibraries.html">Evaluation of existing RSS parsing libraries</a></li></ul></li>
<li>Inside ROME, How Things Work
<ul>
<li><ahref="./HowRomeWorks/index.html">How ROME Works</a>, Understanding ROME, a detailed overview by Dave Johnson (This doc is based on ROME v0.4)</li>
<li><ahref="./RssAndAtOMUtilitiEsROMEV0.5AndAboveTutorialsAndArticles/RssAndAtOMUtilitiEsROMEPluginsMechanism.html">ROME Plugins Mechanism</a>, bootstrap, adding and changing parsers, generators, converters and modules</li>
<li><ahref="./RssAndAtOMUtilitiEsROMEV0.5AndAboveTutorialsAndArticles/FeedsDateElementsMappingToSyndFeedAndSyndEntry.html">Feeds Date Elements</a>, how Date data is mapped to SyndFeed and SyndEntry</li>
<li><ahref="./RssAndAtOMUtilitiEsROMEV0.5AndAboveTutorialsAndArticles/FeedAndEntryURIMappingHowSyndFeedAndSyndEntryUriPropertiesMapToRSSAndAtomElements.html">Feed and Entry URI Mapping</a>, how SyndFeed and SyndEntry 'uri' properties map to concrete feed elements</li>
<li><ahref="./RssAndAtOMUtilitiEsROMEV0.5AndAboveTutorialsAndArticles/XMLCharsetEncodingDetectionHowRssAndAtOMUtilitiEsROMEHelpsGettingTheRightCharsetEncoding.html">XML Charset Encoding Detection</a>, how ROME helps getting the right charset encoding</li>
<li><ahref="./RssAndAtOMUtilitiEsROMEV0.5AndAboveTutorialsAndArticles/RssAndAtOMUtilitiEsROMEV0.5TutorialDefiningACustomModuleBeanParserAndGenerator.html">Creating a custom Module</a>, creating all necessary pieces, bean, parser and generator</li>
<li><ahref="./RssAndAtOMUtilitiEsROMEV0.5AndAboveTutorialsAndArticles/UnderstandingRssAndAtOMUtilitiEsROMEBeanUtilities.html">ROME bean utilities, equals, toString and cloning</a></li>
<li><ahref="./RssAndAtOMUtiliEsROMEV0.7DateAndTimeParsing.html">Customizing Date and time parsing</a> in the rome.properties file</li>
<li><ahref="./ROMEAndMaven2.html">Using ROME from Maven2</a></li>
<li><ahref="./ROMEAndOSGI.html">Using ROME with OSGi</a></li>
<li><ahref="./PreservingWireFeeds.html">Preserving Wire Feeds to obtain access to Atom/RSS specific fields</a></li></ul></li>
<li>ROME development
<ul>
<li><ahref="./HowToBuildRome.html">How to build ROME</a> (ROME uses <aclass="externalLink"href="http://maven.apache.org/">Maven</a>)</li>
<li><ahref="./ChangeLog.html">Changes Log</a>, what and when</li>
<li><ahref="./ROMEDevelopmentProcess.html">ROME Development Process (rome)</a></li>
<li><ahref="./ROMEDevelopmentProposals/index.html">ROME Development Proposals (rome)</a> - proposals for new ROME features and releases</li></ul></li></ul></div></div>
