<?xml version="1.0" encoding="ISO-8859-1"?><!-- OPML generated by Radio UserLand v8.0.8 on Mon, 26 Jan 2004 02:19:39 GMT -->
<opml version="1.1">	<head>		<title>aRTutorial7.opml</title>		<dateCreated>Sat, 15 Feb 2003 00:37:31 GMT</dateCreated>		<dateModified>Mon, 26 Jan 2004 02:19:38 GMT</dateModified>		<ownerName>Marc Barrot</ownerName>		<ownerEmail>info@prec-it.com</ownerEmail>		<expansionState></expansionState>		<vertScrollState>1</vertScrollState>		<windowTop>48</windowTop>		<windowLeft>49</windowLeft>		<windowBottom>522</windowBottom>		<windowRight>698</windowRight>		</head>	<body>		<outline text="#title &quot;Leverage Outline Transclusion&quot;"/>		<outline text="#opmlStory &quot;http://www.activerenderer.com/opml/tutor/aRTutorial7.opml&quot;"/>		<outline text="&lt;b&gt;activeRenderer tutorial&lt;/b&gt; - part 7"/>		<outline text="What are we talking about ?">			<outline text="Transclusion is hardly a new concept, Ted Nelson came up with the idea and christened it transclusion in the early sixties: instead of copying an existing information and pasting it into some new content (the way Xerox then Apple popularized later), better to create a link through a universal network to the unique original so that it appears inside its new context.">				<outline text="A visionary idea, specially since the Internet wasn't even in prototype stage. It never gained critical mass though, despite Ted's best efforts."/>				</outline>			<outline text="Almost 40 years later, Dave Winer and the Userland team raised the ante when pioneering outline transclusion within Radio's built-in outliner. Dave refers to outline transclusion as 'inclusion'."/>			<outline text="In &lt;a href=&quot;http://radio.weblogs.com/0104487/2002/10/10.html&quot; target=&quot;_blank&quot;&gt;October 2002&lt;/a&gt;, after some experimenting and a little help from my friends, I achieved the same transclusion effect inside a web browser, gradually expanding it to most Web popular multimedia formats.">				<outline text="Browser based transclusion replaces the now classic Web hypertext link, which substitutes the linked material to the current window's content (or opens it in a new window), with a more sophisticated inclusion of the linked material inside the current web page, preserving the viewing context."/>				</outline>			</outline>		<outline text="&lt;b&gt;Step 1&lt;/b&gt;: A picture is worth a thousand words.">			<outline text="Click the camera icon which replaces the 'standard' wedge at the left of this paragraph." type="link" url="http://www.activerenderer.com/images/tutor/gisele.jpg"/>			<outline text="How cool is that ? Now try resizing your browser window, reload/refresh this page and try again.">				<outline text="Got the picture ?"/>				</outline>			<outline text="The transclusion property lets you create a sort of 'attachment' to an outline node (or paragraph).">				<outline text="But unlike an email attachment, the attached content is not part of the document: the outline only carries a &lt;i&gt;link&lt;/i&gt; to the attached content."/>				</outline>			<outline text="Any 'linked' picture, in JPG, GIF or PNG format, is loaded over the Web, resized according to the current width of the paragraph it is attached, and inserted in the outline as a child node of the current one.">				<outline text="Thereafter, you can collapse and expand the parent paragraph to hide or reveal the picture."/>				</outline>			</outline>		<outline text="&lt;b&gt;Step 2&lt;/b&gt;: But it's not only about pictures...">			<outline text="Click the 'film reel' icon on this node." type="link" url="http://www.activerenderer.com/images/tutor/device.swf"/>			<outline text="Macromedia Flash animations (SWF files) are rendered like pictures. So are Apple Quicktime movies (MOV files).">				<outline text="I have plans to support Microsoft AVI, Real RPG and generic MPEG movie formats in a not too distant future."/>				</outline>			<outline text="As with the picture example in Step 1, the first child node of Step 2 only carries a 'link' to the attached multimedia content."/>			</outline>		<outline text="&lt;b&gt;Step 3&lt;/b&gt;: And it's even worse than it appears :-)">			<outline text="Now click on the 'up arrow' icon that serves as this node's wedge." type="link" url="http://www.activerenderer.com/opml/tutor/aRTutorial7.opml"/>			<outline text="How weird! This outline expands into itself, it literarily has no end :-)">				<outline text="If you are reading this under MacOS with Microsoft Internet Explorer 5.2 or Apple Safari, then the included outline opens in a different window in your browser. There is a bug in the current MSIE that prevents the inclusion Javascript code to work, and Safari does not seem to be standards compliant enough yet.">					<outline text="I received reliable information that the bug was indeed corrected in the MSIE 6.0 source tree. The only problem being that Microsoft will never release any MacOS 6.0 version :-)"/>					<outline text="I need to check newer, MacOS 10.3 only versions  - mine is only 1.0.1 (v85.6) - to see if there has been recent progress with Safari."/>					</outline>				</outline>			<outline text="Of course, it's far more interesting to include &lt;i&gt;other&lt;/i&gt; OPML outlines. This way, they can be expanded inside the current page, preserving the context around the linking node."/>			<outline text="There's more: click the 'up arrow' wedge at the left of this paragraph. " type="link" url="http://www.activerenderer.com/rss.xml"/>			<outline text="activeRenderer can display RSS news feeds as outlines, allowing their insertion in regular outlines."/>			<outline text="Outline inclusion also allows the creation of distributed directories, as you can see by clicking on this paragraph's wedge." type="link" url="http://www.activerenderer.com/opml/aR/opmlDirectories.opml"/>			<outline text="If the linked content is simple HTML, as opposed to OPML/RSS/GIF/JPG/PNG/SWF/MOV, the link is rendered as a small 'page' icon in the wedge, and it opens in a new window when clicked." type="link" url="http://scripting.com/"/>			</outline>		<outline text="&lt;b&gt;Step 4&lt;/b&gt;: Creating included content with Radio's outliner.">			<outline text="First: what is needed to create outline inclusions ?">				<outline text="It certainly helps if you have an &lt;a href=&quot;http://radio.outliners.com/&quot; target=&quot;_blank&quot;&gt;outliner&lt;/a&gt; available :-)">					<outline text="If you're a Radio Userland blogger, then you're in business." type="link" url="http://www.activerenderer.com/opml/tutor/aRTutorial1.opml"/>					</outline>				<outline text="You also need the complete URL (or Web address) of the content you want to include in your outline.">					<outline text="For instance, the URL of this document is: &lt;i&gt;http:\//www.activerenderer.com/opml/tutor/aRTutorial7.opml&lt;/i&gt;."/>					<outline text="This is an outline I saved on my local machine, in the &lt;i&gt;www:opml:tutor&lt;/i&gt; folder (I'm using a MacOS X Powerbook laptop).">						<outline text="All files saved under the opml folder are upstreamed to your weblog's public site without any rendering."/>						</outline>					<outline text="The URL for the Gisele Bundchen picture in step one is: &lt;i&gt;http:\//www.activerenderer.com/images/tutor/gisele.jpg&lt;/i&gt;"/>					<outline text="This is a JPEG image file I saved in the &lt;i&gt;www:images:tutor&lt;/i&gt; folder in my laptop.">						<outline text="All image files saved under the &lt;i&gt;images&lt;/i&gt; folder are also upstreamed to the public site."/>						<outline text="I could have used the orginal URL for the image just as well: &lt;i&gt;http:\//www.keg.com/bgs/runway/jens/Gisele-gibue015.jpg&lt;/i&gt;">							<outline text="But this server seems to be under a lot of pressure these days :-)"/>							</outline>						</outline>					</outline>				</outline>			<outline text="Start by creating a new outline as described in &lt;a href=&quot;http://www.activerenderer.com/outlines/tutor/aRTutorial1.html&quot; target=&quot;_blank&quot;&gt;Tutorial 1&lt;/a&gt; - or load an existing outline into the outliner." type="link" url="http://www.activerenderer.com/opml/tutor/aRTutorial1.opml"/>			<outline text="Then select the node where you want the included content to appear."/>			<outline text="This node will become the parent node of the included content. With the current version of activeRenderer, it should not have children nodes."/>			<outline text="To add the link to the included content, select the &lt;i&gt;Outline / Add Link&lt;/i&gt; menu option (cmd-K under MacOS, ctrl-K under Windows)" type="link" url="http://www.activerenderer.com/images/tutor/outlinerShot1.png"/>			<outline text="In the small window that pops up, type in, or paste in the URL to the document you want to attach." type="link" url="http://www.activerenderer.com/images/tutor/outlinerShot2.png"/>			<outline text="Click Ok, you will notice that the node's wedge in the outliner has changed to an up-arrow." type="link" url="http://www.activerenderer.com/images/tutor/outlinerShot3.png"/>			<outline text="Now save your outline and check the rendered version as described in step 5 of &lt;a href=&quot;http://www.activerenderer.com/outlines/tutor/aRTutorial1.html&quot; target=&quot;_new&quot;&gt;Tutorial 1&lt;/a&gt;." type="link" url="http://www.activerenderer.com/opml/tutor/aRTutorial1.opml"/>			</outline>		<outline text="&lt;b&gt;Step 5&lt;/b&gt;: OPML links nuts and bolts.">			<outline text="In the OPML format file your outline is stored in, there is one &lt;i&gt;outline&lt;/i&gt; tag per outline node.">				<outline text="The textual content of the node is coded in the aptly named &lt;i&gt;text&lt;/i&gt; attribute of the tag."/>				</outline>			<outline text="Inclusion links are coded as &lt;i&gt;type&lt;/i&gt; and &lt;i&gt;url&lt;/i&gt; or &lt;i&gt;xmlUrl&lt;/i&gt; attributes of the &lt;i&gt;outline&lt;/i&gt; tag." type="link" url="http://www.activerenderer.com/images/tutor/outlinerShot4.png"/>			<outline text="The OPML specification is extremely loose, to the dismay of most XML literati.">				<outline text="Dave Winer, who invented the format, recommends that when specifying a link to some RSS content, usually in a subscriptions directory, one uses type=\&amp;quot;rss&amp;quot; with xmlUrl=&amp;quot;some_url&amp;quot;, and type=&amp;quot;link&amp;quot; with url=&amp;quot;some_url&amp;quot; in all other cases."/>				<outline text="I think it makes sense to extend the type attribute values to describe all the formats possibly linked to an outline node, while standardizing in the url attribute (over xmlUrl) for specifying the link's destination.">					<outline text="But this is part of a discussion on the future of OPML, which has no place in this document :-)"/>					</outline>				</outline>			</outline>		<outline text="Outline transclusion, or inclusion, is a way of creating richer online documents, preserving both the integrity of the reference original and the context in which it is viewed. Another of activeRenderer's tricks lets you add RSS content inside your published pages: check out &lt;a href=&quot;http://www.activerenderer.com/outlines/tutor/aRTutorial8.html&quot;&gt;part 8&lt;/a&gt;."/>		</body>	</opml>