<?xml version="1.0" encoding="ISO-8859-1"?><!-- OPML generated by Radio UserLand v8.1 on Sun, 02 Jan 2005 01:32:07 GMT -->
<opml version="1.1">	<head>		<title>api.opml</title>		<dateCreated>Thu, 29 Jan 2004 22:14:29 GMT</dateCreated>		<dateModified>Sun, 02 Jan 2005 01:32:07 GMT</dateModified>		<ownerName>Marc Barrot</ownerName>		<ownerEmail>info@prec-it.com</ownerEmail>		<expansionState>3, 8, 11</expansionState>		<vertScrollState>1</vertScrollState>		<windowTop>88</windowTop>		<windowLeft>453</windowLeft>		<windowBottom>775</windowBottom>		<windowRight>1106</windowRight>		</head>	<body>		<outline text="#title &quot;activeRenderer API&quot;"/>		<outline text="activeRenderer provides rendering web services through both REST and XML-RPC APIs."/>		<outline text="RESTful API calls are regular HTTP GET requests.">			<outline text="REST APIs are very easy to experiment with.">				<outline text="To test all the API parameters, click the 'settings' button on the activeRenderer &lt;a href=&quot;http://demo.activerenderer.com/&quot; target=&quot;demo&quot;&gt;demo&lt;/a&gt; page at http:\//demo.activerenderer.com/"/>				<outline text="Check the 'display in new window' box, and use your browser's 'View source' menu option to study the rendered output, according to the value of the 'output' parameter." type="link" url="http://www.activerenderer.com/images/aRParams.gif"/>				</outline>			<outline text="The activeRenderer REST server answers at http:\//api.activerenderer.com/activeRenderer/render/">				<outline text="If you are running Radio on the same machine as the service's client, you may call the server at http:\//127.0.0.1:5335/activeRenderer/render/ "/>				</outline>			<outline text="You need to add parameters to the server's URL: http:\//api.activerenderer.com/activeRenderer/render/?param=value&amp;amp;param=value...">				<outline text="As you can see, the separator between the URL and the first parameter name is a question mark (?)."/>				<outline text="Values are assigned to their parameter name by the equal sign (=)."/>				<outline text="Separators between a value and the next parameter name are ampersands (&amp;amp;)."/>				<outline text="You can add any number of parameters from the following list, only the first one, src, is mandatory."/>				</outline>			<outline text="Parameters list">				<outline text="Generic">					<outline text="src (mandatory)">						<outline text="URL of the RSS or OPML file to render.">							<outline text="Must start with &quot;http://&quot; for online documents,"/>							<outline text="or &quot;file://&quot; for local ones."/>							</outline>						</outline>					<outline text="output">						<outline text="Specifies output format."/>						<outline text="Defaults to 'html': fully formed HTML page">							<outline text="Use the default format to render 'src' in an IFRAME, a FRAME or a different browser window."/>							</outline>						<outline text="Other values:">							<outline text="text: ">								<outline text="HTML rendering of 'src', without the full HTML header/body structure."/>								<outline text="Use this output format to retrieve the HTML rendering of 'src' in a  string variable when using another programming language, such as Perl, Python or PHP."/>								</outline>							<outline text="js:">								<outline text="Javascript call to the 'includeHtml' function, with the HTML rendering of 'src' passed as a string parameter."/>								<outline text="Use this output format from Javascript, defining the includeHtml function according to your needs."/>								</outline>							</outline>						</outline>					<outline text="uniqId">						<outline text="Stem for all outline node ids generation."/>						</outline>					<outline text="cssClassName">						<outline text="CSS class name stem for rendered outline nodes, defaults to 'active'"/>						</outline>					<outline text="cssClassLevel">						<outline text="starting depth for all generated outline nodes, default is 0."/>						</outline>					<outline text="flOutliner">						<outline text="add additional HTML rendering for outliner support in browser if flOutliner=yes, do not if flOutliner parameter is absent from request."/>						</outline>					</outline>				<outline text="Specific to OPML rendering">					<outline text="linkAttribute">						<outline text="name of the attribute designating a link attachments to outline nodes."/>						<outline text="activeRenderer tries this parameter first, then 'url', then 'xmlUrl'."/>						</outline>					<outline text="opmlCall">						<outline text="name of the Javascript function called to render OPML links transclusion."/>						<outline text="defaults to 'transclude'."/>						</outline>					<outline text="rssCall">						<outline text="name of the Javascript function called to render RSS links transclusion."/>						<outline text="defaults to 'transclude'."/>						</outline>					<outline text="imgCall">						<outline text="name of the Javascript function called to render picture files (GIF, JPG or PNG) transclusion."/>						<outline text="defaults to 'imgLoad'."/>						</outline>					<outline text="mmCall">						<outline text="name of the Javascript function called to render multimedia files (QT and SWF) transclusion."/>						<outline text="defaults to 'mmLoad'."/>						</outline>					<outline text="htmlCall">						<outline text="name of the Javascript function called to render HTML links."/>						<outline text="defaults to 'pageLoad'."/>						</outline>					<outline text="targetFrame">						<outline text="name of the destination frame of HTML links."/>						<outline text="defaults to same frame as link of origine."/>						</outline>					<outline text="flDisplayHTMLWedge">						<outline text="render link type attributes linking to HTML content as a 'page' wedge if flDisplayHTMLWedge=yes, as regular HTML links if flDisplayHTMLWedge parameter is absent from request."/>						</outline>					<outline text="flDisplayDirectives">						<outline text="render nodes starting with '#' (Frontier directives) if flDisplayDirectives=yes, do not if flDisplayDirectives is absent from request			"/>						</outline>					</outline>				<outline text="Specific to RSS rendering">					<outline text="itemCnt">						<outline text="number of RSS items to render, starting from top, default is 0 for all."/>						</outline>					<outline text="expandedCnt">						<outline text="number of item nodes to render as expanded, starting from top, default is 0 for none."/>						</outline>					<outline text="titleWordCnt">						<outline text="maximum number of words per title nodes, default is 0 for all."/>						</outline>					<outline text="flIncludeChannelTitle">						<outline text="include the RSS channel's title if flIncludeChannelTitle=yes, do not if absent from request."/>						</outline>					<outline text="flCollapseChannelTitle">						<outline text="render RSS Channel title as collapsed if flCollapseChannelTitle=yes, as expanded if absent from request."/>						</outline>					<outline text="flCreateHeader">						<outline text="creates a header node out of each RSS item description's first sentence if flCreateHeader=yes, do not create a header node if absent from request."/>						</outline>					<outline text="flFilterImages">						<outline text="replaces img HTML tags with '[image]', linking to the image file in a different window, if flFilterImages=yes, no image filtering if absent from request."/>						</outline>					<outline text="flFilterQuotes">						<outline text="replaces blockquote HTML tags with divs of class rssQuote if flFilterQuotes=yes, no blockquotes filtering if absent from request."/>						</outline>					<outline text="flRenderContentTag">						<outline text="uses content:encoded tag of RSS 1.0 and RSS 2.0 to render each item's body node if flRenderContentTag=yes, uses description tag instead if absent from request."/>						</outline>					<outline text="flTitleLink">						<outline text="Defaults to false."/>						<outline text="When true, a link is inserted around the last word of each item's title if a link is provided with the item."/>						</outline>					</outline>				<outline text="Specific to HTML (default) output">					<outline text="template">						<outline text="Specifies the url of an HTML template file to replace the default rendering template.">							<outline text="Here is a &lt;a href=&quot;http://www.activerenderer.com/gems/standardTemplate.html&quot; target=&quot;_blank&quot;&gt;link&lt;/a&gt; to the default rendering template." type="link" url="http://www.activerenderer.com/gems/standardTemplate.html"/>							<outline text="The template is a regular HTML page, where the source's rendered content is marked up as &lt;b&gt;##body##&lt;/b&gt;.">								<outline text="The aR web service merely replaces the ##body## tag with the proper HTML code for the rendered outline."/>								</outline>							<outline text="The template's header must include links to aR's stylesheet and javascript code. Check out the Implementation notes at the end of this document."/>							</outline>						<outline text="Example">							<outline text="Assuming you have a 'myTemplate.html' template file available in the 'gems' folder of your site."/>							<outline text="The template parameter would be specified as: &amp;template=http://my.site.com/gems/myTemplate.html."/>							</outline>						</outline>					</outline>				</outline>			</outline>		<outline text="XML-RPC transmits XML formatted function calls and returned values through HTTP POST requests.">			<outline text="XML-RPC is great for calling rendering services from other programming languages, provided these languages support XML-RPC natively or through a library.">				<outline text="Here are a few XML-RPC links.">					<outline text="Java">						<outline text="Apache XML-RPC" type="link" url="http://ws.apache.org/xmlrpc/"/>						<outline text="Marquee XML-RPC" type="link" url="http://xmlrpc.sourceforge.net/"/>						</outline>					<outline text="Javascript">						<outline text="XML-RPC Message Builder" type="link" url="http://scottandrew.com/xml-rpc/"/>						<outline text="vcXMLRPC Library" type="link" url="http://www.vcdn.org/Public/XMLRPC/"/>						<outline text="Mozilla" type="link" url="http://www.mozilla.org/projects/xmlrpc/"/>						</outline>					<outline text="Perl">						<outline text="RPC::XML" type="link" url="http://www.blackperl.com/RPC%3A%3AXML/"/>						<outline text="SOAP::Lite" type="link" url="http://www.soaplite.com/"/>						<outline text="Frontier::RPC" type="link" url="http://bitsko.slc.ut.us/~ken/xml-rpc/"/>						</outline>					<outline text="PHP">						<outline text="xmlrpc-epi-php" type="link" url="http://xmlrpc-epi.sourceforge.net/main.php?t=php_about"/>						<outline text="xmlrpc library" type="link" url="http://keithdevens.com/software/xmlrpc/"/>						</outline>					<outline text="Python">						<outline text="xmlrpclib" type="link" url="http://www.pythonware.com/products/xmlrpc/"/>						<outline text="py-xmlrpc" type="link" url="http://sourceforge.net/projects/py-xmlrpc/"/>						</outline>					<outline text="Usertalk" type="link" url="http://radio.userland.com/webServicesTutorial"/>					<outline text="Other resources" type="link" url="http://www.xmlrpc.com/discuss/reader$1568.opml"/>					</outline>				</outline>			<outline text="The activeRenderer XML-RPC server answers at http::\//rpc.activerenderer.com/, on port 80."/>			<outline text="You can call 2 rendering functions. Both functions return a string, including the HTML rendering of the string you've passed as first parameter, but not including the full HTML header/body structure.">				<outline text="activeRenderer.opmlRenderer">					<outline text="Parameters (in sequence):"/>					<outline text="opml">						<outline text="string, mandatory."/>						<outline text="the OPML formatted text you want to render as dynamic HTML."/>						</outline>					<outline text="uniqId">						<outline text="string, empty by default."/>						<outline text="optional prefix for all outline node divs id generation."/>						</outline>					<outline text="cssClassName">						<outline text="string, defaults to &quot;active&quot;."/>						<outline text="CSS class name stem for rendered node divs."/>						</outline>					<outline text="cssClassLevel">						<outline text="integer, defaults to 0."/>						<outline text="starting depth for all generated outline nodes."/>						</outline>					<outline text="link">						<outline text="string, defaults to &quot;url&quot;"/>						<outline text="name of the attribute designating a link attachments to outline nodes."/>						<outline text="activeRenderer tries this parameter first, then 'url', then 'xmlUrl'."/>						</outline>					<outline text="opmlCall">						<outline text="string, defaults to &quot;transclude&quot;"/>						<outline text="name of the Javascript function called to render OPML links transclusion."/>						</outline>					<outline text="imgCall">						<outline text="string, defaults to &quot;imgLoad&quot;"/>						<outline text="name of the Javascript function called to render picture files (GIF, JPG or PNG) transclusion."/>						</outline>					<outline text="rssCall">						<outline text="string, defaults to &quot;transclude&quot;"/>						<outline text="name of the Javascript function called to render RSS links transclusion."/>						</outline>					<outline text="mmCall">						<outline text="string, defaults to &quot;mmLoad&quot;"/>						<outline text="name of the Javascript function called to render multimedia files (QT and SWF) transclusion."/>						</outline>					<outline text="htmlCall">						<outline text="string, defaults to &quot;pageLoad&quot;"/>						<outline text="name of the Javascript function called to render simple HTML links."/>						</outline>					<outline text="targetFrame">						<outline text="string, empty by defaults, links are opened in the same frame/window as source."/>						<outline text="name of the destination frame for rendered HTML links."/>						</outline>					<outline text="flDisplayHTMLWedge">						<outline text=" boolean, false by default."/>						<outline text="when true, render link type attributes linking to HTML content as 'page' node wedges."/>						<outline text="when false, render them as regular HTML links."/>						</outline>					<outline text="flOutliner">						<outline text="boolean, false by default."/>						<outline text="when true, adds additional HTML rendering for outliner-type functions support in the browser.">							<outline text="this is only useful if you are trying to create a full web based outliner :-)"/>							</outline>						</outline>					<outline text="flDisplayDirectives">						<outline text="boolean, false by default"/>						<outline text="when true, render outline nodes starting with # (Frontier directives)."/>						<outline text="when false, skip nodes with Frontier directives."/>						</outline>					<outline text="flRoll">						<outline text="boolean, false by default"/>						<outline text="when true, modify HTML rendering to better fit blogrolls (deprecated)."/>						</outline>					</outline>				<outline text="activeRenderer.rssRenderer">					<outline text="Parameters (in sequence):"/>					<outline text="rss">						<outline text="string, mandatory."/>						<outline text="the RSS formatted text you want to render as dynamic HTML."/>						</outline>					<outline text="uniqId">						<outline text="string, empty by default."/>						<outline text="optional prefix for all outline node divs id generation."/>						</outline>					<outline text="cssClassName">						<outline text="string, defaults to &quot;active&quot;."/>						<outline text="CSS class name stem for rendered node divs."/>						</outline>					<outline text="cssClassLevel">						<outline text="integer, defaults to 0."/>						<outline text="starting depth for all generated outline nodes."/>						</outline>					<outline text="flIncludeChannelTitle">						<outline text="boolean, false by default."/>						<outline text="when true, include the RSS channel's title as first node."/>						</outline>					<outline text="flCollapseChannelTitle">						<outline text="boolean, false by default."/>						<outline text="when true and flIncludeChannelTitle is true, render the RSS Channel title node as collapsed."/>						</outline>					<outline text="itemCnt">						<outline text="integer, defaults to 0, render all items."/>						<outline text="number of RSS items to render, starting from top."/>						</outline>					<outline text="expandedCnt">						<outline text="integer, defaults to 0 for none."/>						<outline text="number of item nodes to render as expanded, starting from top."/>						</outline>					<outline text="titleWordCnt">						<outline text="integer, defaults to 0 for all words."/>						<outline text="maximum number of words per title nodes."/>						</outline>					<outline text="flCreateHeader">						<outline text="boolean, false by default."/>						<outline text="when true, creates a header node out of each RSS item description's first sentence."/>						<outline text="when false, do not create header nodes."/>						</outline>					<outline text="flOutliner">						<outline text="boolean, false by default."/>						<outline text="when true, adds additional HTML rendering for outliner-type functions support in the browser.">							<outline text="this is only useful if you are trying to create a full web based outliner :-)"/>							</outline>						</outline>					<outline text="opmlCall">						<outline text="string, defaults to &quot;transclude&quot;"/>						<outline text="name of the Javascript function called to render OPML links transclusion."/>						</outline>					<outline text="imgCall">						<outline text="string, defaults to &quot;imgLoad&quot;"/>						<outline text="name of the Javascript function called to render picture files (GIF, JPG or PNG) transclusion."/>						</outline>					<outline text="rssCall">						<outline text="string, defaults to &quot;transclude&quot;"/>						<outline text="name of the Javascript function called to render RSS links transclusion."/>						</outline>					<outline text="mmCall">						<outline text="string, defaults to &quot;mmLoad&quot;"/>						<outline text="name of the Javascript function called to render multimedia files (QT and SWF) transclusion."/>						</outline>					<outline text="htmlCall">						<outline text="string, defaults to &quot;pageLoad&quot;"/>						<outline text="name of the Javascript function called to render simple HTML links."/>						</outline>					<outline text="flDisplayHTMLWedge">						<outline text=" boolean, false by default."/>						<outline text="when true, render link type attributes linking to HTML content as 'page' node wedges."/>						<outline text="when false, render them as regular HTML links."/>						</outline>					<outline text="flRoll">						<outline text="boolean, false by default"/>						<outline text="when true, modify HTML rendering to better fit blogrolls (deprecated)."/>						</outline>					<outline text="targetFrame">						<outline text="string, empty by defaults, links are opened in the same frame/window as source."/>						<outline text="name of the destination frame for rendered HTML links."/>						</outline>					<outline text="flFilterImages">						<outline text="boolean, false by default."/>						<outline text="when true, replaces img HTML tags with '[image]', linking to the image file in a different window."/>						</outline>					<outline text="flFilterQuotes">						<outline text="boolean, false by default."/>						<outline text="when true, replaces blockquote HTML tags with divs of class rssQuote."/>						</outline>					<outline text="flRenderContentTag">						<outline text="boolean, false by default."/>						<outline text="when true, uses the content:encoded tag of RSS 1.0 and RSS 2.0 to render each item's body node."/>						<outline text="when false, uses the description tag."/>						</outline>					<outline text="flTitleLink">						<outline text="Defaults to false."/>						<outline text="When true, a link is inserted around the last word of each item's title if a link is provided with the item."/>						</outline>					</outline>				</outline>			</outline>		<outline text="Implementation notes">			<outline text="The dynamic HTML code generated by activeRenderer relies on 2 external resources:">				<outline text="A Javascript program: activerenderer.js" type="link" url="http://www.activerenderer.com/activeRenderer/activerenderer.js"/>				<outline text="A CSS stylesheet: activerenderer.css" type="link" url="http://www.activerenderer.com/activeRenderer/activerenderer.css"/>				</outline>			<outline text="When generating HTML pages from your application, remember to include links to those 2 files in your page header, linking either to the files on the activerenderer.com site, or - best - to your &lt;a href=&quot;http://www.activerenderer.com/gems/resources.zip&quot;&gt;own versions&lt;/a&gt; stored on your server.">				<outline text="&amp;#060;link rel=\&quot;stylesheet&quot; type=&quot;text/css&quot; href=&quot;http://your.server.domain/some_path/activerenderer.css&quot;&amp;#062;"/>				<outline text="&amp;#060;script type=\&quot;text/javascript&quot; src=&quot;http://your.server.domain/some_path/activerenderer.js&quot;&amp;#062;&amp;#060;/script&amp;#062;"/>				</outline>			</outline>		<outline text="Examples">			<outline text="Radio Userland">				<outline text="Entering the following code in Radio's quickscript editor will render your subscriptions list by calling the activeRenderer RPC server. No need to instal activeRenderer :-)">					<outline text="url = \&quot;http://127.0.0.1:5335/gems/mySubscriptions.opml&quot;;"/>					<outline text="opml = tcp.httpReadUrl ( url );"/>					<outline text="params = {opml};"/>					<outline text="test = \&quot;&quot;;"/>					<outline text="test = xml.rpc (\&quot;rpc.activerenderer.com&quot;, 80, &quot;activeRenderer.opmlRenderer&quot;, @params);"/>					<outline text="wp.newTextObject (test, @temp.test);"/>					<outline text="edit (@temp.test);"/>					</outline>				<outline text="If you have activeRenderer installed, you can use a local call instead:">					<outline text="test = xml.rpc (&quot;127.0.0.1&quot;, 5335, &quot;activeRenderer.opmlRenderer&quot;, @params);"/>					</outline>				</outline>			<outline text="Please send me code samples using other languages, I'll include them in this section."/>			</outline>		</body>	</opml>