<?xml version="1.0" encoding="ISO-8859-1"?><!-- OPML generated by Radio UserLand v8.0.8 on Thu, 22 Jan 2004 16:54:58 GMT -->
<opml version="1.1">	<head>		<title>aRTutorial2.opml</title>		<dateCreated>Thu, 18 Jul 2002 17:54:35 GMT</dateCreated>		<dateModified>Thu, 22 Jan 2004 16:54:57 GMT</dateModified>		<ownerName>Marc Barrot</ownerName>		<ownerEmail>info@prec-it.com</ownerEmail>		<expansionState></expansionState>		<vertScrollState>1</vertScrollState>		<windowTop>135</windowTop>		<windowLeft>133</windowLeft>		<windowBottom>532</windowBottom>		<windowRight>892</windowRight>		</head>	<body>		<outline text="#title &quot;Tuning Outlines Layout&quot;"/>		<outline text="#opmlStory &quot;http://www.activerenderer.com/opml/tutor/aRTutorial2.opml&quot;"/>		<outline text="&lt;b&gt;activeRenderer tutorial&lt;/b&gt; - part 2"/>		<outline text="&lt;b&gt;Step 1&lt;/b&gt;: Specifying the outline title.">			<outline text="Check out this screenshot, taken at an early stage of the tutorial part 1 redaction (click on the 'camera' wedge)." type="link" url="http://www.activerenderer.com/images/tutor/result1Mac.gif"/>			<outline text="Now compare it with this later revision of the same page." type="link" url="http://www.activerenderer.com/images/tutor/result2Mac.gif"/>			<outline text="You can see I did some work on the title at the top of the page."/>			<outline text="What I did is include a &lt;i&gt;#title&lt;/i&gt; directive at the top of the outline : #title &quot;Publishing Simple Outlines&quot;.">				<outline text="This &lt;i&gt;#title&lt;/i&gt; directive is actually the first line of the outline, check out the &lt;a href=&quot;http://www.activerenderer.com/opml/tutor/aRTutorial1.opml&quot; target=&quot;_new&quot;&gt;opml original&lt;/a&gt;.">					<outline text="Adding a line at the very top of the outline is tricky: add it somewhere else, drag it above the first node until you see an up arrow instead of the regular triangular wedge, then drop it."/>					</outline>				<outline text="Directives all start with the pound sign (#)."/>				<outline text="Every directive is followed by an argument, which must be included in double quotes (\&quot;).">					<outline text="Since the outline is saved in an XML format (OPML), all double quotes are automatically 'entity encoded'."/>					<outline text="The \&quot; you see in the outliner appear as ampersand sign quot semicolon in the OPML file."/>					</outline>				</outline>			</outline>		<outline text="&lt;b&gt;Step 2&lt;/b&gt;: Setting each outline node's initial expansion state.">			<outline text="activeRenderer publishes your outline in the state you leave it when you save the document in Radio's outliner.">				<outline text="Any node expanded at saving time will be published expanded, revealing the underlying nodes."/>				<outline text="Any node collapsed at that time will be rendered collapsed."/>				</outline>			<outline text="So remember to review your outline's nodes state before final publication.">				<outline text="This outline was published with all top-level nodes (summits) collapsed."/>				</outline>			</outline>		<outline text="&lt;b&gt;Step 3&lt;/b&gt;: Modifying the outline's font and style.">			<outline text="Each node in your outline is rendered in HTML using a specific CSS class.">				<outline text="For additional information on CSS - Cascading Style Sheets - styling refer to:">					<outline text="The W3C official page (click on the 'page' wedge)." type="link" url="http://www.w3.org/Style/CSS/"/>					<outline text="Eric Meyer's Cascading Style Sheets: The Definitive Guide at O'Reilly." type="link" url="http://safari.oreilly.com/?x=1&amp;mode=section&amp;sortKey=title&amp;sortOrder=asc&amp;view=&amp;xmlid=1-56592-622-6&amp;open=true&amp;catid=inet.webauth&amp;s=1&amp;b=1&amp;f=1&amp;t=1&amp;c=1&amp;u=1&amp;page=0"/>					</outline>				</outline>			<outline text="The name of the class for the main outline in the published page usually starts with the &lt;i&gt;active&lt;/i&gt; text string.">				<outline text="&lt;i&gt;active&lt;/i&gt; is then followed by a number, matching the indentation level of the node."/>				<outline text="This node for instance, is rendered in HTML using an &lt;i&gt;active3&lt;/i&gt; class attribute."/>				</outline>			<outline text="All classes are specified in the &lt;i&gt;activerenderer.css&lt;/i&gt; stylesheet, located in the &lt;i&gt;activeRenderer&lt;/i&gt; subfolder of the &lt;i&gt;www&lt;/i&gt; folder."/>			<outline text="You can make all kinds of modifications to this file using a text editor.">				<outline text="If you so elect, remember to increment the version number you will find in the header of the stylesheet.">					<outline text="Use values above 99. This way,  if I update aR's default stylesheet on the master server, your customized version will not  get overwritten the next time you update your local copy."/>					</outline>				</outline>			<outline text="You may also override those class definitions by modifying the template (the #template.txt file) that applies to your outline.">				<outline text="It is actually a better way of modifying the outline's font, since it will always override any modification to the default style in activerenderer.css"/>				<outline text="Insert a STYLE type=&amp;quot;text/css&amp;quot HTML tag in the template's header, followed by your custom class definitions and a /STYLE tag.">					<outline text="Quick tip: Since styles are 'cascading', modifying the font or style of the &lt;i&gt;active1 span&lt;/i&gt; will modify the text for all the outline's nodes." type="link" url="http://www.activerenderer.com/images/tutor/styleShot.gif"/>					</outline>				<outline text="The #template.txt file that applies to your outline is either found directly in the same folder as your outline, or in the first parent folder that actually holds a template. Templates are 'cascading' too :-)"/>				</outline>			<outline text="Of course, you can always embed regular HTML tags in your outline nodes.">				<outline text="&lt;b&gt;This is displayed in bold&lt;/b&gt;, since I included it between B and /B tags."/>				<outline text="Paolo Valdemarin has a great demo page using different HTML tags in an outline." type="link" url="http://paolo.evectors.it/aRoutlines/test.html"/>				</outline>			</outline>		<outline text="&lt;b&gt;Step 4&lt;/b&gt;: Fixing the OPML mug.">			<outline text="This outline does not display an OPML espresso coffee cup on the right side any more.">				<outline text="It used to though, and your default outline probably displays an OPML coffee mug."/>				<outline text="Whatever the container, it carries a link that subscribe the reader to your Radio instant outine."/>				</outline>			<outline text="To disable the mug display altogether:">				<outline text="Open the &lt;i&gt;#prefs.txt&lt;/i&gt; file that aR placed in your &lt;i&gt;outlines&lt;/i&gt; folder with a text editor.">					<outline text="&lt;i&gt;outlines&lt;/i&gt; is a subfolder of Radio's &lt;i&gt;www&lt;/i&gt; folder, remember ?"/>					</outline>				<outline text="Remove the &lt;i&gt;#flDisplayCup&lt;/i&gt; directive and save the result, then save your outline again."/>				</outline>			<outline text="To choose the type of container:">				<outline text="Include an &lt;i&gt;#flDisplayCup&lt;/i&gt; directive at the top of your outline.">					<outline text="The second line of &lt;a href=&quot;http://www.activerenderer.com/demo/coffeeCup/&quot; target=&quot;_blank&quot;&gt;this outline&lt;/a&gt; was #flDisplayCup \&quot;cup&quot;."/>					<outline text="It takes precedence over the #flDisplayCup &quot;regular&quot; directive in the &lt;i&gt;#prefs.txt&lt;/i&gt; file."/>					</outline>				<outline text="Check the espressoCup macro documentation for a current list of containers." type="link" url="http://www.activerenderer.com/outlines/aR/aRMacros.html"/>				</outline>			</outline>		<outline text="&lt;b&gt;Step 5&lt;/b&gt;: Adding an XML button.">			<outline text="If you look at the right pane of this page, you will notice a familiar XML white on orange button, that actually links to the &lt;a href=&quot;http://www.activerenderer.com/opml/tutor/aRTutorial2.opml&quot; target=&quot;_blank&quot;&gt;OPML version&lt;/a&gt; of this document."/>			<outline text="When you save an outline in the &lt;i&gt;outlines&lt;/i&gt; folder, the original OPML version remains on your computer, and the HTML rendered version is upstreamed to the public site."/>			<outline text="But if you have checked the \&quot; Mirror the 'outlines' and 'opml' sub-folders&quot; option in the &lt;a href=&quot;http://127.0.0.1:5335/activeRenderer/preferences/&quot; target=&quot;_blank&quot;&gt;preferences&lt;/a&gt;, aR automatically creates a copy in the &lt;i&gt;opml&lt;/i&gt; folder, creating subfolders matching the &lt;i&gt;gems&lt;/i&gt; hierarchy along the way.">				<outline text="Thus, the version under &lt;i&gt;opml&lt;/i&gt; is upstreamed in its original OPML format."/>				<outline text="Whereas the copy under &lt;i&gt;outlines&lt;/i&gt; is upstreamed in HTML format."/>				<outline text="The pref being about mirroring, saving into &lt;i&gt;opml&lt;/i&gt; will create an automatic copy in &lt;i&gt;outlines&lt;/i&gt; of course."/>				</outline>			<outline text="Looking at the second line in the &lt;a href=&quot;http://www.activerenderer.com/opml/tutor/aRTutorial2.opml&quot; target=&quot;_blank&quot;&gt;original version&lt;/a&gt; of this outline, you will notice a &lt;i&gt;#opmlStory&lt;/i&gt; directive.">				<outline text="&lt;i&gt;#opmlStory&lt;/i&gt;'s argument is the URL to the original OPML version of the outline on the public site."/>				<outline text="aR's default template includes a call to the &lt;a href=&quot;http://www.activerenderer.com/outlines/aR/aRMacros.html&quot; target=&quot;_blank&quot;&gt;storyBox macro&lt;/a&gt;, that inserts an XML button and link when a &lt;i&gt;#opmlStory&lt;/i&gt; directive is included in the outline."/>				</outline>			</outline>		<outline text="All these variations are possible using aR's default outline template. The next logical step is to create your own template, with a layout that closely matches the disposition of your weblog. More on this subject in &lt;a href=&quot;http://www.activerenderer.com/outlines/tutor/aRTutorial3.html&quot;&gt;part 3&lt;/a&gt;."/>		</body>	</opml>