<?xml version="1.0" encoding="ISO-8859-1"?><!-- OPML generated by Radio UserLand v8.0.8 on Thu, 22 Jan 2004 18:47:25 GMT -->
<opml version="1.1">	<head>		<title>aRTutorial4.opml</title>		<dateCreated>Thu, 01 Aug 2002 03:55:30 GMT</dateCreated>		<dateModified>Thu, 22 Jan 2004 18:47:24 GMT</dateModified>		<ownerName>Marc Barrot</ownerName>		<ownerEmail>info@prec-it.com</ownerEmail>		<expansionState></expansionState>		<vertScrollState>1</vertScrollState>		<windowTop>77</windowTop>		<windowLeft>276</windowLeft>		<windowBottom>503</windowBottom>		<windowRight>870</windowRight>		</head>	<body>		<outline text="#title &quot;Publishing active blogRolls&quot;"/>		<outline text="#opmlStory &quot;http://www.activerenderer.com/opml/tutor/aRTutorial4.opml&quot;"/>		<outline text="&lt;b&gt;activeRenderer tutorial&lt;/b&gt; - part 4"/>		<outline text="activeRolls are just like regular blogrolls, with a twist: active outline wedges to uncover underlying levels of information. They are great for preserving screen real-estate."/>		<outline text="Step 1: Create a blogRoll outline.">			<outline text="According to &lt;a href=&quot;http://radio.outliners.com/stories/storyReader$85&quot;&gt;Jake Savin's definition&lt;/a&gt;, blogrolls are a collection of links on the home page of a weblog that point to sites that are somehow related to yours.">				<outline text="They serve several purposes, they direct readers to the sites that are important to you, and serve as a set of bookmarks for you."/>				<outline text="They also help build page rank in search engines for sites you wish to bestow page rank on."/>				</outline>			<outline text="So first use Radio's outliner to create an OPML document with your links.">				<outline text="Here is a &lt;a href=&quot;http://radio.weblogs.com/0104487/images/my/outlineRoll.gif&quot; target=&quot;_new&quot;&gt;screenshot&lt;/a&gt; of the original version. (expand the wedge on the left to see a current version in this page)." type="link" url="http://radio.weblogs.com/0104487/gems/opml/blogroll.opml"/>				<outline text="And here is a &lt;a href=&quot;http://radio.weblogs.com/0104487/images/my/rollShot.gif&quot; target=&quot;_new&quot;&gt;screenshot&lt;/a&gt; of the same outline in the right sidebar of &lt;b&gt;s&amp;nbsp;l&amp;nbsp;a&amp;nbsp;m&lt;/b&gt;'s home page." type="link" url="http://radio.weblogs.com/0104487/"/>				</outline>			<outline text="Usually, blogrolls are organized into sections, the title of each section is a summit node, and all related links are indented underneath it."/>			<outline text="Links are actually nodes bearing a &lt;i&gt;link&lt;/i&gt; XML tag attribute.">				<outline text="In Radio's outliner, you can define a link attribute by selecting a node in the outline, then the 'Outline / Add Link...' menu option, then typing or pasting a URL (a Web address) for the link."/>				</outline>			<outline text="You can save your blogroll outline under any file name ending with '.opml'.">				<outline text="There's nothing preventing you from creating several blogrolls, with different file names."/>				<outline text="If you create a file named &lt;i&gt;blogroll.opml&lt;/i&gt; and save it in the &lt;i&gt;gems&lt;/i&gt; sub-folder of your &lt;i&gt;www&lt;/i&gt; folder, you will conform to UserLand's recommendations.">					<outline text="Your blogroll will be automatically scanned if you're using UserLand's &lt;a href=&quot;http://radio.userland.com/radioMacrosHeadLinks&quot; target=&quot;_blank&quot;&gt;headLinks&lt;/a&gt; macro."/>					</outline>				<outline text="But there's nothing preventing you from saving it to any folder which content is upstreamed to the public site without any rendering, such as the &lt;i&gt;opml&lt;/i&gt; folder created by aR under &lt;i&gt;www&lt;/i&gt;."/>				</outline>			</outline>		<outline text="Step 2: Insert an activeRoll macro call in your main template.">			<outline text="Open the &lt;i&gt;#homeTemplate.txt&lt;/i&gt; file located in Radio's &lt;i&gt;www&lt;/i&gt; folder with a text editor."/>			<outline text="Find a good place to insert the activeRoll macro.">				<outline text="A good place is usually within the left or the right sidebar of your template."/>				</outline>			<outline text="Insert a line like the one in the screenshot attached to this node, substituting the pathname for your own blogroll file." type="link" url="http://www.activerenderer.com/images/tutor/activeRollShot1.gif"/>			<outline text="On a Windows system, the local URL would look more like this :">				<outline text="file:\///C/Program%20Files/Radio%20UserLand/www/gems/blogroll.opml"/>				</outline>			<outline text="You may also use a &lt;i&gt;local&lt;/i&gt; URL:">				<outline text="http:\//127.0.0.1:5335/gems/blogroll.opml"/>				</outline>			<outline text="Or like this if you were referencing a file on your public site, it could look like this :">				<outline text="http:\//radio.weblogs.com/0104487/gems/blogroll.opml"/>				</outline>			<outline text="You can and should substitute another string for the blogroll's title, title:\&quot;activeRoll&quot; is just an example.">				<outline text="If you do not provide a title argument, your blogRoll will still be rendered, but without a title."/>				</outline>			<outline text="Important: if you are not currently publishing your weblog's home page with any of aR's 2 outline styles.">				<outline text="And have never done so at some point in the past."/>				<outline text="Then, there's a good chance that your &lt;i&gt;#homeTemplate.txt&lt;/i&gt; file is missing links to aR's Javascript code and CSS stylesheet in its header."/>				<outline text="So, insert an &lt;i&gt;activeRendererHeader&lt;/i&gt; macro call in the HEAD section of the template - check the attached screenshot." type="link" url="http://www.activerenderer.com/images/tutor/headHtml.gif"/>				</outline>			</outline>		<outline text="Step 3: Re-publish your home page and check the result.">			<outline text="Use the Radio / Publish / Weblog Home Page menu in Radio."/>			<outline text="Then check your &lt;a href=&quot;http://127.0.0.1:5335/system/pages/eventsLog&quot; target = &quot;_new&quot;&gt;Event Log&lt;/a&gt; after a minute or so, and click on the &lt;i&gt;index.html&lt;/i&gt; link in the latest Upstream event, it should be listed as one of the most recent events."/>			</outline>		<outline text="Step 4: Customize your blogRoll's style.">			<outline text="All elements of the roll are defined by CSS classes in the &lt;i&gt;activerenderer.css&lt;/i&gt; stylesheet.">				<outline text="You will find &lt;i&gt;activerenderer.css&lt;/i&gt; in the &lt;i&gt;activeRenderer&lt;/i&gt; sub-folder of &lt;i&gt;www&lt;/i&gt;."/>				<outline text="To learn more about CSS stylesheets, try the &lt;a href=&quot;http://safari.oreilly.com/JVXSL.asp?x=1&amp;mode=section&amp;sortKey=rank&amp;sortOrder=desc&amp;view=book&amp;xmlid=1-56592-622-6&amp;open=true&amp;g=&amp;catid=itbooks.inet.webauth&amp;s=1&amp;b=1&amp;f=1&amp;t=1&amp;c=1&amp;u=1&amp;r=&amp;o=1&amp;page=0&quot; target&quot;_blank&quot;&gt;O'Reilly Salmon book&lt;/a&gt;, and the &lt;a href=&quot;http://www.w3.org/Style/CSS/&quot; target=&quot;_blank&quot;&gt;W3C specification&lt;/a&gt;."/>				</outline>			<outline text="&lt;i&gt;rollTitle&lt;/i&gt; defines the style for your blogroll's title element."/>			<outline text="&lt;i&gt;roll&lt;/i&gt; defines the style for the 'box' - an HTML div - in which the blogroll is encased."/>			<outline text="&lt;i&gt;roll1&lt;/i&gt; to &lt;i&gt;roll4&lt;/i&gt; define the style for each indentation level in the blogroll's outline.">				<outline text="Feel free to add more levels if you need them."/>				</outline>			<outline text="&lt;i&gt;rollHelp&lt;/i&gt; defines the style for the 'how this works' link."/>			<outline text="If you customize the activerenderer.css stylesheet, do update the version number (currently 1.0.4) at the top of the file to a greater value.">				<outline text="This way, your customized version will not be automatically superseded the next time I update the default CSS stylesheet in activeRenderer." type="link" url="http://www.activerenderer.com/images/tutor/cssShot1.gif"/>				</outline>			<outline text="You may also override those classes by inserting new definitions for them in the header section of your template file, inside a STYLE tag." type="link" url="http://www.activerenderer.com/images/tutor/embeddedCSS.gif"/>			</outline>		<outline text="Step 5: Use activeRoll's optional parameters.">			<outline text="In the previous step, you've learned that the default style for your blogroll is defined by CSS classes with names all starting with &lt;i&gt;roll&lt;/i&gt;."/>			<outline text="You can specify another name when calling activeRoll from a template.">				<outline text="In the attached example, the title - Navigation - will have a style of &lt;i&gt;navLinksTitle&lt;/i&gt;, the blogroll's box will be defined in &lt;i&gt;navLinks&lt;/i&gt;, indentation levels will start at &lt;i&gt;navLinks1&lt;/i&gt;." type="link" url="http://www.activerenderer.com/images/tutor/activeRollShot2.gif"/>				<outline text="This way, you may have several activeRolls with different styles on the same page."/>				</outline>			<outline text="If you are &lt;a href=&quot;http://www.rklau.com/tins/&quot; target=&quot;_blank&quot;&gt;Rick Klau&lt;/a&gt;, and inserting your blogroll in an HTML iframe tag, you can specify a target:\&quot;_parent&quot; optional parameter to have all links point to your main frame.">				<outline text="This should work even if your name is not Rick Klau.">					<outline text="Specially since Rick has now moved his weblogs to Movable Type :-)"/>					<outline text="You don't even have to be a lawyer, though it may help..."/>					</outline>				<outline text="You can also use target:\&quot;someWindowName&quot; to have all links open in the same distinct window.">					<outline text="By default, all links in your blogroll open in a new window."/>					</outline>				</outline>			</outline>		<outline text="So, by now you should be convinced that activeRolls are both neat and simple to add to your weblog. But wait, wouldn't it be even cooler if you could publish your browser bookmarks, even your Yahoo bookmarks directly into an activeRoll ? Check out &lt;a href=&quot;http://www.activerenderer.com/outlines/tutor/aRTutorial5.html&quot;&gt;part 5&lt;/a&gt; then."/>		</body>	</opml>