New Message: mySubscriptions.opml

[webmaster at userland.com]

A new message was posted:

Address: http://manila.userland.com/discuss/msgReader$123

By: Jake Savin (jake at userland.com)

<rules><!-- 1.5 spacing -->
   <rule level="1" to="infinity"><outlineSpacing>1.5</outlineSpacing></rule>
   </rules>
A new feature was released today for Manila sites which run a news aggregator: mySubscriptions.opml. This OPML file lists all of the news feeds a Manila site is subscribed to.
This feature has been available to Radio UserLand users since version 7.0, and today it's available for Manila as well.
<rules><!-- internal link, bold headings -->
   <rule level="1" to="1"><textStyle>bold</textStyle></rule>
   <rule level="1" to="1"><internalLink/></rule>
   </rules>
How To
   1. Follow the instructions <a href="http://manila.userland.com/newsAggregator#managingEditorHowTo">here</a> to subscribe to some sites.
   (Note: The news aggregator must be enabled on the server. Instructions for enabling it are <a href="http://manila.userland.com/newsAggregator#serverManagerHowTo">here</a>.)
   2. In your browser, open mySubscriptions.opml. Its url will be the URL of your site plus gems/mySubscriptions.opml.
   Here's a sample mySubscriptions.opml file:
   http://jake.userland.com/gems/mySubscriptions.opml
mySubscriptions.opml and the opmlBlogroll macro
   One obvious use for mySubscriptions.opml is to use it to add a blogroll to your home page, which links to all of the sites that you read in your aggregator. Here's how:
   1. Edit your template -- Click the Prefs link in the Editors Only menu, click Advanced, and then click Template. (If your site uses the Home Page Template, edit that instead.)
   2. Add the following macro to your template, where you want your blogroll to appear:
      &#123;opmlBlogroll (relativeUrl ("gems/mySubscriptions.opml"))&#125;
      Then click the Submit button.
   3. Go to your home page. The sites you're subscribed to will be listed in place of the macro.
Head links
   If your site is subscribed to one or more news feed, Manila will add a &lt;link> to the head section of your home page, which points at your mySubscriptions.opml file. Here's an example:
      <link rel="subscriptions" type="text/x-opml" title="Subscriptions" href="http://jake.userland.com/gems/mySubscriptions.opml">
   As more content management systems support head-link elements, new kinds of crawlers, harvesters and directories will be possible.
See also
   Manila: <a href="http://manila.userland.com/newsAggregator">News Aggregator for Manila</a>
   Macros: <a href="http://macros.userland.com/basic/opmlBlogroll">opmlBlogroll</a>
   Radio UserLand: <a href="http://radio.userland.com/radioMacrosHeadLinks">Links for Blogroll, RSS and Subscriptions</a>
   <a href="http://www.opml.org/spec">OPML 1.0 Specification</a>