roller-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From snoopd...@apache.org
Subject svn commit: r489133 - in /incubator/roller/trunk/docs/templateguide: generated/html/roller-template-guide.html generated/roller-template-guide.pdf roller-template-guide.odt
Date Wed, 20 Dec 2006 16:22:41 GMT
Author: snoopdave
Date: Wed Dec 20 08:22:40 2006
New Revision: 489133

URL: http://svn.apache.org/viewvc?view=rev&rev=489133
Log:
Updated template guide to document generated HTML and CSS classes used

Modified:
    incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide.html
    incubator/roller/trunk/docs/templateguide/generated/roller-template-guide.pdf
    incubator/roller/trunk/docs/templateguide/roller-template-guide.odt

Modified: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide.html
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide.html?view=diff&rev=489133&r1=489132&r2=489133
==============================================================================
--- incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide.html (original)
+++ incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide.html Wed Dec 20 08:22:40 2006
@@ -1,13 +1,12 @@
 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
 <HTML>
 <HEAD>
-	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
+	<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
 	<TITLE></TITLE>
-	<META NAME="GENERATOR" CONTENT="OpenOffice.org 2.0  (Solaris x86)">
+	<META NAME="GENERATOR" CONTENT="NeoOffice 2.0 Aqua Beta 3  (Unix)">
 	<META NAME="AUTHOR" CONTENT="Dave Johnson">
 	<META NAME="CREATED" CONTENT="20051209;11500200">
-	<META NAME="CHANGEDBY" CONTENT="Dave Johnson">
-	<META NAME="CHANGED" CONTENT="20061216;10014500">
+	<META NAME="CHANGED" CONTENT="20061220;11100100">
 	<META NAME="SDFOOTNOTE" CONTENT=";;;;P">
 	<META NAME="SDENDNOTE" CONTENT="ARABIC">
 	<STYLE>
@@ -32,6 +31,12 @@
 		P.frame-contents-western { font-family: "Times New Roman"; font-weight: medium }
 		P.frame-contents-cjk { font-weight: medium }
 		P.frame-contents-ctl { font-weight: medium }
+		P.roller-macro-title-western { background: #cccccc; border-top: 1px solid #000000; border-bottom: none; border-left: none; border-right: none; padding-top: 0.04in; padding-bottom: 0in; padding-left: 0in; padding-right: 0in; font-family: "Times New Roman"; font-weight: medium }
+		P.roller-macro-title-cjk { background: #cccccc; border-top: 1px solid #000000; border-bottom: none; border-left: none; border-right: none; padding-top: 0.04in; padding-bottom: 0in; padding-left: 0in; padding-right: 0in; font-weight: medium }
+		P.roller-macro-title-ctl { background: #cccccc; border-top: 1px solid #000000; border-bottom: none; border-left: none; border-right: none; padding-top: 0.04in; padding-bottom: 0in; padding-left: 0in; padding-right: 0in; font-weight: medium }
+		P.roller-macro-synopsys-western { margin-left: 0.5in; font-family: "Times New Roman"; font-weight: medium }
+		P.roller-macro-synopsys-cjk { margin-left: 0.5in; font-weight: medium }
+		P.roller-macro-synopsys-ctl { margin-left: 0.5in; font-weight: medium }
 	-->
 	</STYLE>
 </HEAD>
@@ -751,7 +756,7 @@
 		<P CLASS="western"><BR><BR>
 		</P>
 		<OL>
-			<LI><P CLASS="western"><IMG SRC="roller-template-guide_html_5dc2a3fd.png" NAME="graphics1" ALIGN=LEFT WIDTH=582 HEIGHT=340 BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><B>Go
+			<LI><P CLASS="western"><IMG SRC="roller-template-guide_html_m4016f15a.png" NAME="graphics1" ALIGN=LEFT WIDTH=582 HEIGHT=340 BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><B>Go
 			to the Preferences-&gt;Theme page.</B><BR>Login to Roller and go
 			to your weblog's <B>Preferences-&gt;Themes</B> page. Shown below.<BR></FONT><BR><BR>
 			</P>
@@ -762,25 +767,25 @@
 			to pick the theme that you'd like to use as your starting point.
 			Once you've picked your theme, click the Save button to save it as
 			your current theme.</FONT></P>
-			<LI><P CLASS="western"><IMG SRC="roller-template-guide_html_2de01e50.png" NAME="graphics2" ALIGN=LEFT WIDTH=370 HEIGHT=94 BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><B>Click
+			<LI><P CLASS="western"><IMG SRC="roller-template-guide_html_m71a47e4a.png" NAME="graphics2" ALIGN=LEFT WIDTH=370 HEIGHT=94 BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><B>Click
 			the Customize button.</B><BR>Click the Customize button to
 			customize your theme. When you do this, copies of the themes page
 			templates will be copied into your weblog so you can edit them.</FONT></P>
 			<LI><P CLASS="western"><FONT SIZE=2><B>Customize your theme by
 			editing and creating page templates.</B><BR>Go to the
 			Preferences-&gt;Templates page, edit your page templates and add
-			new ones as needed &ndash; as described in the next section.</FONT></P>
+			new ones as needed – as described in the next section.</FONT></P>
 		</OL>
 		<P CLASS="western">And if you get tired of your customized theme,
 		just use the <B>Preferences-&gt;Theme</B> page to switch back to a
-		shared theme &ndash; or pick another one to customize. Now let's
+		shared theme – or pick another one to customize. Now let's
 		discuss editing and creating templates.</P>
 		<H2 CLASS="western">3.4 - Editing and creating page templates</H2>
 		<P CLASS="western">Once you've got the page templates copied into
 		your weblog, you can do just about anything you want to your theme.
 		You can use the <B>Preferences-&gt;Templates</B> page, shown below,
 		to create a new page, delete a page or choose a page to edit.</P>
-		<P CLASS="western"><IMG SRC="roller-template-guide_html_m7503a72a.png" NAME="graphics3" ALIGN=LEFT WIDTH=634 HEIGHT=352 BORDER=0><BR CLEAR=LEFT><BR><BR>
+		<P CLASS="western"><IMG SRC="roller-template-guide_html_3be4c6e2.png" NAME="graphics3" ALIGN=LEFT WIDTH=634 HEIGHT=352 BORDER=0><BR CLEAR=LEFT><BR><BR>
 		</P>
 		<P CLASS="western">Now might be a good time to describe the <I>page
 		template properties</I> since you can see them in the table above.
@@ -797,9 +802,9 @@
 			yourself as to the purpose of the page.</P>
 			<LI><P CLASS="western"><B>Link</B>: Each page template has a link
 			property, which is used to form the URL for the page. For example,
-			if the page's name is &ldquo;simple&rdquo; then the page will be
-			available at the URL &ldquo;/page/simple&rdquo; within the weblog.
-						</P>
+			if the page's name is “simple” then the page will be available
+			at the URL “/page/simple” within the weblog. 
+			</P>
 			<LI><P CLASS="western"><B>Navbar</B>: This is a flag that
 			indicates whether the page is to be shown in the weblog navigation
 			bar that is produced by the <FONT FACE="Courier New">#showPageMenu()</FONT>
@@ -816,7 +821,7 @@
 		below).</P>
 		<P CLASS="western"><BR><BR>
 		</P>
-		<P CLASS="western"><IMG SRC="roller-template-guide_html_m68e6eb1e.png" NAME="graphics4" ALIGN=LEFT WIDTH=633 HEIGHT=437 BORDER=0><BR CLEAR=LEFT><BR><BR>
+		<P CLASS="western"><IMG SRC="roller-template-guide_html_m48cd7d3.png" NAME="graphics4" ALIGN=LEFT WIDTH=633 HEIGHT=437 BORDER=0><BR CLEAR=LEFT><BR><BR>
 		</P>
 		<P CLASS="western">But the rules for <I>required pages</I> are
 		different. The weblog pages named Weblog, _day and _css are
@@ -888,8 +893,8 @@
 		dot-notation, but you must end the expression with a list of
 		parameters in parentheses. For example, if you'd like to display an
 		image from within your theme, you can use the $url model like so:</P>
-		<P STYLE="margin-bottom: 0in; background: transparent"><FONT FACE="Courier New"><FONT SIZE=2>	&lt;img='<B>$url.themeResource(&ldquo;basic&rdquo;,
-		&ldquo;background.gif&rdquo;)</B>'&gt;&lt;/a&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent"><FONT FACE="Courier New"><FONT SIZE=2>	&lt;img='<B>$url.themeResource(“basic”,
+		“background.gif”)</B>'&gt;&lt;/a&gt;</FONT></FONT></P>
 		<P STYLE="margin-bottom: 0in; background: transparent"><BR>
 		</P>
 		<P CLASS="western">Argument one is the name of the theme and
@@ -912,14 +917,13 @@
 		<P STYLE="margin-bottom: 0in; background: transparent"><BR>
 		</P>
 		<P CLASS="western">Argument one is the weblog for the calendar and
-		argument two is the category, where &ldquo;nil&rdquo; indicates
-		that no category is specified. Note that the arguments for a macro
-		are separated by a space and NOT a comma as was the case for
-		methods.</P>
+		argument two is the category, where “nil” indicates that no
+		category is specified. Note that the arguments for a macro are
+		separated by a space and NOT a comma as was the case for methods.</P>
 		<H2 CLASS="western">4.3 - A word about pagers</H2>
 		<P CLASS="western">There are many cases in a weblog when we want to
 		display a large collection of values and we want that collection to
-		be page-able &ndash; that is, we want a Next link to go to the next
+		be page-able – that is, we want a Next link to go to the next
 		page of results and possibly a Previous link to go to the previous
 		page. So in Roller, we've introduced the concept of a <SPAN STYLE="font-style: normal">pager</SPAN>.
 		A <I>pager</I> is a special type of object that makes it easy to
@@ -931,26 +935,26 @@
 		what a pager looks like:</P>
 		<UL>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.homeLink 		&ndash; URL of the first page of
+			<FONT SIZE=2>$pager.homeLink 		– URL of the first page of
 			results</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.homeName 		&ndash; Name to be displayed for
-			that URL</FONT></P>
+			<FONT SIZE=2>$pager.homeName 		– Name to be displayed for that
+			URL</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.nextLink 			&ndash; URL of the next page of
+			<FONT SIZE=2>$pager.nextLink 			– URL of the next page of
 			results</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.nextName 		&ndash; Name to be displayed for
-			that URL</FONT></P>
+			<FONT SIZE=2>$pager.nextName 		– Name to be displayed for that
+			URL</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.prevLink 			&ndash; URL of the previous page
-			of results</FONT></P>
+			<FONT SIZE=2>$pager.prevLink 			– URL of the previous page of
+			results</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.prevName 		&ndash; Name to be displayed for
-			that URL</FONT></P>
+			<FONT SIZE=2>$pager.prevName 		– Name to be displayed for that
+			URL</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.items 			&ndash; Collection of data objects;
-			the current page of results</FONT></P>
+			<FONT SIZE=2>$pager.items 			– Collection of data objects; the
+			current page of results</FONT></P>
 		</UL>
 		<P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium"><A NAME="DDE_LINK6"></A>
 		<BR>
@@ -964,38 +968,38 @@
 		to the next months entries.</P>
 		<UL>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.homeLink 		&ndash; URL of the first page of
+			<FONT SIZE=2>$pager.homeLink 		– URL of the first page of
 			results</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.homeName 		&ndash; Name to be displayed for
-			that URL</FONT></P>
+			<FONT SIZE=2>$pager.homeName 		– Name to be displayed for that
+			URL</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.nextLink 			&ndash; URL of the next page of
+			<FONT SIZE=2>$pager.nextLink 			– URL of the next page of
 			results</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.nextName 		&ndash; Name to be displayed for
-			that URL</FONT></P>
+			<FONT SIZE=2>$pager.nextName 		– Name to be displayed for that
+			URL</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.prevLink 			&ndash; URL of the previous page
-			of results</FONT></P>
+			<FONT SIZE=2>$pager.prevLink 			– URL of the previous page of
+			results</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.prevName 		&ndash; Name to be displayed for
-			that URL</FONT></P>
+			<FONT SIZE=2>$pager.prevName 		– Name to be displayed for that
+			URL</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.nextCollectionLink 	&ndash; URL of next
-			collection in sequence</FONT></P>
+			<FONT SIZE=2>$pager.nextCollectionLink 	– URL of next collection
+			in sequence</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.nextCollectionName 	&ndash; Name to be
-			displayed for that URL</FONT></P>
+			<FONT SIZE=2>$pager.nextCollectionName 	– Name to be displayed
+			for that URL</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.prevCollectionLink 	&ndash; URL of previous
+			<FONT SIZE=2>$pager.prevCollectionLink 	– URL of previous
 			collection in sequence</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.prevCollectionName 	&ndash; Name to be
-			displayed for that URL</FONT></P>
+			<FONT SIZE=2>$pager.prevCollectionName 	– Name to be displayed
+			for that URL</FONT></P>
 			<LI><P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
-			<FONT SIZE=2>$pager.items 			&ndash; Collection of data objects;
-			the current page of results</FONT></P>
+			<FONT SIZE=2>$pager.items 			– Collection of data objects; the
+			current page of results</FONT></P>
 		</UL>
 		<P CLASS="western"><BR><BR>
 		</P>
@@ -1005,13 +1009,13 @@
 		<P CLASS="western">This section covers the standard model objects
 		available in all page templates:</P>
 		<UL>
-			<LI><P CLASS="western"><FONT SIZE=2>$config &ndash; provides
-			access to the Roller site configuration parameters</FONT></P>
-			<LI><P CLASS="western"><FONT SIZE=2>$model &ndash; provides access
-			to data for one specific weblog</FONT></P>
-			<LI><P CLASS="western"><FONT SIZE=2>$url &ndash; for creating
-			Roller URLs and URLs within one specific weblog</FONT></P>
-			<LI><P CLASS="western"><FONT SIZE=2>$utils &ndash; utility methods
+			<LI><P CLASS="western"><FONT SIZE=2>$config – provides access to
+			the Roller site configuration parameters</FONT></P>
+			<LI><P CLASS="western"><FONT SIZE=2>$model – provides access to
+			data for one specific weblog</FONT></P>
+			<LI><P CLASS="western"><FONT SIZE=2>$url – for creating Roller
+			URLs and URLs within one specific weblog</FONT></P>
+			<LI><P CLASS="western"><FONT SIZE=2>$utils – utility methods
 			needed within page templates</FONT></P>
 		</UL>
 		<P CLASS="western">For each model, we'll cover properties and
@@ -1212,7 +1216,7 @@
 		get from those. See Section 6 for a complete reference to the data
 		objects and their properties.</P>
 		<P CLASS="western"><SPAN ID="Frame1" DIR="LTR" STYLE="float: left; width: 7.06in; height: 3.96in; border: none; padding: 0in; background: #ffffff">
-			<P CLASS="frame-contents-western"><IMG SRC="roller-template-guide_html_m7ef36857.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_25f9ab6e.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m4dbd3550.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_4cf7f533.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m4f60519c.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m75262f7.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m667c4c30.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_4b949c80.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m610b5f75.gif" ALIGN=LEFT><IMG SRC="roller-
 template-guide_html_m452b7d95.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m3add420.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_6d3d7e5b.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_4b83d79d.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_7b24c4cc.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_a408ed3.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m7027fa92.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m8246857.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m4f869ae1.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_dac7346.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_34787221.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m7881d7c5.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_4729f1a5.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m40391650.gif" ALIGN=LEFT><BR><BR>
+			<P CLASS="frame-contents-western"><IMG SRC="roller-template-guide_html_m511689ba.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_1eba02e4.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m46b36671.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_30c3e854.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m46b36671.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_3b1590ae.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m46b36671.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mc6db489.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m46b36671.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m5549e0bf.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m46b36671.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_1b9c380d.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m46b36671.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m309473a9.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m2be1d0df.gif" ALIGN=LEFT><IMG SRC="ro
 ller-template-guide_html_m3107805d.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_245ede7d.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_13d4503d.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mef06a86.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m24b6c41b.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m621ff2d2.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m71b0dc19.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m25e81f83.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m5306fce6.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m4359b92f.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m1f390da8.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_797b2131.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_6a9c40d8.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_46d84e54.gif" ALIGN=LEFT><BR><BR>
 			</P>
 		</SPAN><BR CLEAR=LEFT><BR><BR>
 		</P>
@@ -3059,7 +3063,7 @@
 				getRecentWeblogEntries(String cat, int max)</B><BR>Get most
 				recent WeblogEntries in the weblog up to the number max. You can
 				specify a category name if you'd liike only entries from one
-				category (or &ldquo;nil&rdquo; for all categories). 
+				category (or “nil” for all categories). 
 				</P>
 				<LI><P CLASS="western" STYLE="font-weight: medium"><B>List
 				getRecentComments(int max)</B><BR>Get most recent Comments in the
@@ -3587,78 +3591,704 @@
 		<H1 CLASS="western" STYLE="page-break-before: always">7 - Macro
 		Reference</H1>
 		<P CLASS="western">This section lists the macros that are available
-		for use in Roller page templates and a brief description of how
-		each works.</P>
+		for use in Roller page templates, a brief description of how each
+		works and where appropriate an outline of the generated HTML, which
+		highlights the CSS classes defined.</P>
 		<H2 CLASS="western">7.1 - Entry macros</H2>
-		<UL>
-			<LI><P CLASS="western"><B>#showWeblogEntriesPager($pager)</B><BR>Displays
-			the weblog entries contained in the specified $pager object.</P>
-			<LI><P CLASS="western"><B>#showNextPrevEntriesControl($pager)</B><BR>Display
-			the next/prev links of the specified $pager object.</P>
-			<LI><P CLASS="western"><B>#showEntryTags($entry)</B><BR>Display
-			tags associated with one weblog entry as list of links to tag
-			specific views of weblog.</P>
-		</UL>
+		<P CLASS="roller-macro-title-western"><B>#showWeblogEntriesPager($pager)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$pager: </B><SPAN STYLE="font-weight: medium">Pager
+		object returned by a getWeblogEntriesPager() method</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Displays the weblog
+		entries contained in the specified $pager object by calling your
+		weblog's _day template for each day's worth of entries.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P CLASS="western" STYLE="font-weight: medium">Depends entirely on
+		contents of your weblog's _day template.</P>
+		<P CLASS="western" STYLE="font-weight: medium"><BR><BR>
+		</P>
+		<P CLASS="roller-macro-title-western"><B>#showNextPrevEntriesControl($pager)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$pager: </B><SPAN STYLE="font-weight: medium">Pager
+		object returned by a getWeblogEntriesPager() method</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Display the next/prev
+		links of the specified $pager object.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P CLASS="western" STYLE="font-weight: medium">Assuming you the
+		page has prev and next links, the HTML will look something like the
+		below. As you can see, no CSS classes are defined.</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&amp;laquo;
+		</FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;a
+		href=&quot;...&quot;&gt; ...prev... &lt;/a&gt; |  </FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;a
+		href=&quot;...&quot;&gt; ...home...&lt;/a&gt; |</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;a
+		href=&quot;...&quot;&gt; ...next... &lt;/a&gt; </FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&amp;raquo;</FONT></FONT></P>
+		<P CLASS="western"><BR><BR>
+		</P>
+		<P CLASS="roller-macro-title-western"><B>#showEntryTags($entry)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$entry: </B><SPAN STYLE="font-weight: medium">WeblogEntry
+		object</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Display tags associated
+		with one weblog entry as list of links to tag specific views of
+		weblog.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P CLASS="western"><SPAN STYLE="font-weight: medium">No CSS classes
+		are used, only a series of links like so:</SPAN></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;a
+		href=&quot;...&quot; rel=&quot;tag&quot;&gt; ...tag name... &lt;/a&gt;
+		</FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;a
+		href=&quot;...&quot; rel=&quot;tag&quot;&gt; ...tag name... &lt;/a&gt;
+		</FONT></FONT>
+		</P>
 		<H2 CLASS="western">7.2 - Comment macros</H2>
-		<UL>
-			<LI><P CLASS="western"><B>#showWeblogEntryComments($entry)</B><BR>Display
-			the comments associated with the specified entry, not including
-			those entries that are not approved for posting or that are marked
-			as spam.</P>
-			<LI><P CLASS="western"><B>#showWeblogEntryCommentForm($entry)</B><BR>Display
-			a comment form for adding a comment to the specified entry.</P>
-		</UL>
+		<P CLASS="roller-macro-title-western"><B>#showWeblogEntryComments($entry)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$entry: </B><SPAN STYLE="font-weight: medium">WeblogEntry
+		object</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Display the comments
+		associated with the specified entry, not including those entries
+		that are not approved for posting or that are marked as spam. 
+		</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P CLASS="western" STYLE="font-weight: medium">Here's the skeleton
+		with CSS classes highlighted:</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;div
+		class=&quot;<B>comments</B>&quot; id=&quot;comments&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;div
+		class=&quot;<B>comments-head</B>&quot;&gt; &lt;!-- Comments title
+		--&gt; &lt;/div&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;div
+		class=&quot;<B>comment even</B>&quot; id=&quot;&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>	<I>&lt;!-- even like above
+		or odd as below --&gt;</I></FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;div
+		class=&quot;<B>comment odd</B>&quot; id=&quot;&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>...comment content...</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;p
+		class=&quot;<B>comment-details</B>&quot;&gt; </FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>...comment details...</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;a href=&quot;link to
+		comment&quot; class=&quot;<B>entrypermalink</B>&quot; &gt;#&lt;/a&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/p&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/div&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;/div&gt;</FONT></FONT></P>
+		<P CLASS="western"><BR><BR>
+		</P>
+		<P CLASS="roller-macro-title-western"><B>#showWeblogEntryCommentForm($entry)</B></P>
+		<P CLASS="western"><B>Arguments: </B>
+		</P>
+		<P CLASS="western"><B>	$entry: </B><SPAN STYLE="font-weight: medium">WeblogEntry
+		object</SPAN></P>
+		<P CLASS="western"><B>Synopsis</B>: 
+		</P>
+		<P CLASS="western">	Display a comment form for adding a comment to
+		the specified entry.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P CLASS="western">If comments are no longer allowed for the weblog
+		entry in question, then only a status message is generated:</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;span
+		class=&quot;status&quot;&gt; ...comments closed message... &lt;/span&gt;</FONT></FONT></P>
+		<P CLASS="western"><BR><BR>
+		</P>
+		<P CLASS="western">Otherwise we display the comment form. Here's
+		the skeleton with CSS classes highlighted:</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;div
+		class=&quot;<B>comments-form</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;div
+		class=&quot;<B>comments-head</B>&quot;&gt; ...comment form title...
+		&lt;/div&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;span
+		class=&quot;<B>error</B>&quot;&gt; ...error message... &lt;/span&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;span
+		class=&quot;<B>status</B>&quot;&gt; ...status message... &lt;/span&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;form
+		method=&quot;post&quot; name=&quot;commentForm&quot; ...&gt;    </FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;ul&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;label class=&quot;<B>desc</B>&quot;&gt;
+		...text field... &lt;/label&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;input type=&quot;text&quot;
+		name=&quot;name&quot; class=&quot;<B>text</B> large&quot; ... /&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;input type=&quot;checkbox&quot;
+		class=&quot;<B>checkbox</B>&quot; .../&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;label class=&quot;<B>choice</B>&quot;&gt;
+		...checkbox field... &lt;/label&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;label class=&quot;<B>desc</B>&quot;&gt;
+		... &lt;/label&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;textarea
+		name=&quot;content&quot; class=&quot;<B>textarea</B> large&quot;
+		cols=&quot;&quot; rows=&quot;&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		      <FONT FACE="Courier New"><FONT SIZE=2>&lt;!-- Comment content
+		--&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;/textarea&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;li class=&quot;<B>info</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;span
+		class=&quot;<B>comments-syntax-indicator</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		       <FONT FACE="Courier New"><FONT SIZE=2>&lt;span
+		class=&quot;<B>disabled</B>&quot;&gt; Disabled &lt;/span&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		       <FONT FACE="Courier New"><FONT SIZE=2>&lt;!-- disabled as
+		above or enabled as below --&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		       <FONT FACE="Courier New"><FONT SIZE=2>&lt;span
+		class=&quot;<B>enabled</B>&quot;&gt; Enabled &lt;/span&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;/span&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;li class=&quot;<B>info</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		  <FONT FACE="Courier New"><FONT SIZE=2>&lt;div
+		id=&quot;commentAuthenticator&quot;&gt;&lt;/div&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		  <FONT FACE="Courier New"><FONT SIZE=2>&lt;input type=&quot;button&quot;
+		class=&quot;<B>button</B>&quot; ... /&gt; &lt;!-- preview button
+		--&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		  <FONT FACE="Courier New"><FONT SIZE=2>&lt;input type=&quot;submit&quot;
+		class=&quot;<B>button</B>&quot; ... /&gt; &lt;!-- preview button
+		--&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/ul&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;/form&gt;</FONT></FONT></P>
 		<H2 CLASS="western">7.3 - List macros</H2>
-		<UL>
-			<LI><P CLASS="western"><B>#showWeblogEntryLinksList($entries)</B><BR>Display
-			a simple list of entries, with a title and link for each.</P>
-			<LI><P CLASS="western"><B>#showBookmarkLinksList($folderObj
-			$expanding $subfolders)</B><BR>Displays all bookmarks in a
-			specified bookmark folder object.  If $expanding and $subfolders
-			are set to true, then display the bookmarks as an expandable tree
-			view.</P>
-			<LI><P CLASS="western"><B>#showWeblogCategoryLinksList($categoryObj
-			$expanding $subcats)</B><BR>Displays all categories under a
-			specified category object. If $expanding and $subcats are set to
-			true, then display the categories as an expandable tree view.</P>
-		</UL>
+		<P CLASS="roller-macro-title-western"><B>#showWeblogEntryLinksList($entries)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$entries: </B><SPAN STYLE="font-weight: medium">List
+		of WeblogEntry objects to be displayed in a list inks</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Display a simple list of
+		entries, with a title and link for each.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P CLASS="western" STYLE="font-weight: medium">We use a simple HTML
+		list with a the CSS classes highlighted below:</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">   <FONT FACE="Courier New"><FONT SIZE=2>&lt;ul
+		class=&quot;<B>rEntriesList</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       <FONT FACE="Courier New"><FONT SIZE=2>&lt;li
+		class=&quot;<B>recentposts</B>&quot;&gt;&lt;a href=&quot;...&quot;&gt;
+		...title... &lt;/a&gt;&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">   <FONT FACE="Courier New"><FONT SIZE=2>&lt;/ul&gt;</FONT></FONT></P>
+		<P CLASS="western"><BR><BR>
+		</P>
+		<P CLASS="roller-macro-title-western"><B>#showBookmarkLinksList($folderObj
+		$expanding $subfolders)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$folderObj: </B><SPAN STYLE="font-weight: medium">Folder
+		object from which bookmarks are to be shown</SPAN><B><BR>	$expanding:
+		</B><SPAN STYLE="font-weight: medium">Set to true to show a
+		JavaScript-expandable tree of folders and bookmarks</SPAN><B><BR>	$subfolders:
+		</B><SPAN STYLE="font-weight: medium">Set to true to recusively
+		show Folder object contents</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Displays all bookmarks in
+		a specified bookmark folder object.  If $expanding and $subfolders
+		are set to true, then display the bookmarks as an expandable tree
+		view.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P CLASS="western" STYLE="font-weight: medium">We generate a simple
+		nested list with different CSS classes for the <FONT FACE="Courier, sans-serif">&lt;ul&gt;</FONT>
+		list and <FONT FACE="Courier, sans-serif">&lt;li&gt; </FONT>list
+		item elements. The bookmark CSS class is prepended with the
+		priority number of the bookmark.</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">   <FONT FACE="Courier New"><FONT SIZE=2>&lt;ul
+		class=&quot;<B>rFolder</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;li
+		class=&quot;<B>rFolderItem</B>&quot;&gt; </FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">          
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;a href=&quot;...&quot;
+		class=&quot;<B>rBookmark10</B>&quot; /&gt;...bookmark name... &lt;/a&gt;
+		</FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;li
+		class=&quot;<B>rFolderItem</B>&quot;&gt; </FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">          
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;a href=&quot;...&quot;
+		class=&quot;<B>rBookmark5</B>&quot; /&gt;...bookmark name... &lt;/a&gt;
+		</FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;li
+		class=&quot;<B>rFolderItem</B>&quot;&gt; ...sub-folder name...
+		&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;ul
+		class=&quot;<B>rFolder</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;li class=&quot;<B>rFolderItem</B>&quot;&gt;
+		... &lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/ul&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">   <FONT FACE="Courier New"><FONT SIZE=2>&lt;/ul&gt;</FONT></FONT></P>
+		<P CLASS="western"><BR><BR>
+		</P>
+		<P CLASS="western">Expanding folders are a little more complex.
+		Roller uses a combination of hidden <FONT FACE="Courier, sans-serif">&lt;div&gt;</FONT>
+		elements and JavaScript to create a simple expandable tree like so:</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">   <FONT FACE="Courier New"><FONT SIZE=2>&lt;ul
+		class=&quot;<B>rFolder</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;li
+		class=&quot;<B>rFolderItem</B>&quot;&gt; </FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">          
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;a href=&quot;...&quot;
+		class=&quot;<B>rBookmark10</B>&quot; /&gt;...bookmark name... &lt;/a&gt;
+		</FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;div
+		class=&quot;<B>rFolder</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;li class=&quot;<B>rFolderItem</B>&quot;&gt;&lt;a
+		href=&quot;...&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;span id=&quot;...&quot;&gt;
+		+ &lt;/span&gt;&lt;/a&gt; ...sub-folder name...&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;ul id=&quot;...&quot;
+		class=&quot;<B>rFolder</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		       <FONT FACE="Courier New"><FONT SIZE=2>&lt;a href=&quot;...&quot;
+		class=&quot;<B>rBookmark6</B>&quot; /&gt;...bookmark name... &lt;/a&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;/ul&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/div&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">   <FONT FACE="Courier New"><FONT SIZE=2>&lt;/ul&gt;</FONT></FONT></P>
+		<P CLASS="western"><BR><BR>
+		</P>
+		<P CLASS="roller-macro-title-western"><B>#showWeblogCategoryLinksList($categoryObj
+		$expanding $subcats)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$categoryObj: </B><SPAN STYLE="font-weight: medium">Category
+		object containing category objects to be displayed</SPAN><B><BR>	$expanding:
+		</B><SPAN STYLE="font-weight: medium">Set to true to show a
+		JavaScript-expandable tree of folders and bookmarks</SPAN><B><BR>	$subcats:
+		 </B><SPAN STYLE="font-weight: medium">Set to true to recusively
+		show sub-Category object contents</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Displays all categories
+		under a specified category object. If $expanding and $subcats are
+		set to true, then display the categories as an expandable tree
+		view.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;ul
+		class=&quot;<B>rCategory</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       <FONT FACE="Courier New"><FONT SIZE=2>&lt;li&gt;
+		...unselected category name... &lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       <FONT FACE="Courier New"><FONT SIZE=2>&lt;li
+		class=&quot;<B>selected</B>&quot;&gt; ...selected category name...
+		&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;/ul&gt;</FONT></FONT></P>
+		<P CLASS="western"><BR><BR>
+		</P>
+		<P CLASS="western">Or for expanding folders</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;ul
+		class=&quot;<B>rCategory</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;div
+		class=&quot;<B>rCategory</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;li&gt;&lt;a href=&quot;...&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;a href=&quot;...&quot;&gt;&lt;span
+		id=&quot;...&quot;&gt; + &lt;/span&gt;&lt;/a&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;a href=&quot;...&quot;&gt;
+		...category name... &lt;/a&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;ul id=&quot;...&quot;
+		class=&quot;<B>rCategory</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;li
+		class=&quot;<B>selected</B>&quot;&gt;categoryObject.name&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;!-- or --&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;li&gt;&lt;a
+		href=&quot;...&quot;&gt; ...category name...&lt;/a&gt;&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/ul&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/div&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;/ul&gt;</FONT></FONT></P>
 		<H2 CLASS="western">7.4 - Menu macros</H2>
-		<UL>
-			<LI><P CLASS="western"><B>#showPageMenu($weblog)</B><BR>Display a
-			page navigation menu that lists all pages in the weblog.</P>
-			<LI><P CLASS="western"><B>#showAuthorMenu($vertical)</B><BR>Display
-			an authoring menu for the current weblog. If $vertical is true,
-			then display a menu suitable for use in a narrow sidebar.</P>
-		</UL>
+		<P CLASS="roller-macro-title-western"><B>#showPageMenu($weblog)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$weblog: </B><SPAN STYLE="font-weight: medium">Show
+		page menu for this weblog</SPAN><B>	</B></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Display a page navigation
+		menu that lists all pages in the weblog.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P CLASS="western" STYLE="font-weight: medium">The page menu is
+		displayed as a simple HTML list with separate CSS styles for list
+		and list-tems.</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;ul
+		class=&quot;<B>rNavigationBar</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;li
+		class=&quot;<B>rNavItem</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;a href=&quot;...&quot;&gt;
+		...name... &lt;/a&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;/ul&gt;</FONT></FONT></P>
+		<P CLASS="western"><BR><BR>
+		</P>
+		<P CLASS="roller-macro-title-western"><B>#showAuthorMenu($vertical)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$vertical: </B><SPAN STYLE="font-weight: medium">True
+		to display vertical menu, false to display horizontal</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Display an authoring menu
+		for the current weblog. If $vertical is true, then display a menu
+		suitable for use in a narrow sidebar.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P CLASS="western">For a vertical menu, we use a simple HTML list:</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;ul
+		class=&quot;<B>rMenu</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;li&gt;&lt;a href=&quot;...&quot;&gt;
+		...menu item name... &lt;/a&gt;&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;/ul&gt;</FONT></FONT></P>
+		<P CLASS="western"><BR><BR>
+		</P>
+		<P CLASS="western">For a horizontal menu, we simply emit a series
+		of pipe-separated links:</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;a
+		href=&quot;...&quot;&gt; ...menu item name... &lt;/a&gt;
+		&amp;nbsp;|&amp;nbsp;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;a
+		href=&quot;...&quot;&gt; ...menu item name... &lt;/a&gt;
+		&amp;nbsp;|&amp;nbsp;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;a
+		href=&quot;...&quot;&gt; ...menu item name... &lt;/a&gt;</FONT></FONT></P>
 		<H2 CLASS="western">7.5 - Search macros</H2>
-		<UL>
-			<LI><P CLASS="western"><B>#showWeblogSearchForm($weblog
-			$withCats)</B><BR>Show a search form for searching the weblog and,
-			if $withCats is true show a category chooser.</P>
-			<LI><P CLASS="western"><B>#showWeblogSearchAgainForm($weblog)</B><BR>Show
-			search again form, suitable for display at the start of a page of
-			search results.</P>
-			<LI><P CLASS="western"><B>#showNextPrevSearchControl($pager)</B><BR>Show
-			special pager designed for paging through search results.</P>
-		</UL>
+		<P CLASS="roller-macro-title-western"><B>#showWeblogSearchForm($weblog
+		$withCats)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$weblog: </B><SPAN STYLE="font-weight: medium">show
+		search form for this Weblog object</SPAN><B><BR>	$withCats: </B><SPAN STYLE="font-weight: medium">set
+		to true to display a category combo-box</SPAN></P>
+		<P CLASS="western">Show a search form for searching the weblog and,
+		if $withCats is true show a category chooser.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;form
+		id=&quot;<B>searchForm</B>&quot; style=&quot;margin: 0; padding: 0&quot;
+		...&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>...form markup...</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;/form&gt;</FONT></FONT></P>
+		<P CLASS="western"><BR><BR>
+		</P>
+		<P CLASS="roller-macro-title-western"><B>#showWeblogSearchAgainForm($weblog)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$weblog: </B><SPAN STYLE="font-weight: medium">show
+		search-again form for this Weblog object</SPAN><B>	</B></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Show search again form,
+		suitable for display at the start of a page of search results.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;div
+		id=&quot;<B>searchAgain</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;form&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>...form markup...</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/form&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;/div&gt;</FONT></FONT></P>
+		<P CLASS="western"><BR><BR>
+		</P>
+		<P CLASS="roller-macro-title-western"><B>#showNextPrevSearchControl($pager)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$pager: </B><SPAN STYLE="font-weight: medium">Pager
+		returned by getWeblogEntriesPager() in the context of a search page</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Show special pager
+		designed for paging through search results.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;h3&gt;
+		...search summary... &lt;/h3&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&amp;laquo;
+		</FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;a
+		href=&quot;...&quot;&gt; ...prev... &lt;/a&gt; | </FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;a
+		href=&quot;...&quot;&gt; ...home... &lt;/a&gt; | </FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;a
+		href=&quot;...&quot;&gt; ...next... &lt;/a&gt; </FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&amp;raquo;</FONT></FONT></P>
+		<P CLASS="western"><BR><BR>
+		</P>
 		<H2 CLASS="western">7.6 - Misc. macros</H2>
-		<UL>
-			<LI><P CLASS="western"><B>#showWeblogEntryCalendar($weblog
-			$category)</B><BR>Show weblog entry calendar, optionally
-			restricted by category name (&ldquo;nil&rdquo; for no category)</P>
-			<LI><P CLASS="western"><B>#includeTemplate($weblog
-			$pageName)</B><BR>Parse and include a page template into the
-			current page tempate.</P>
-			<LI><P CLASS="western"><B>#showAutodiscoveryLinks($weblog)</B><BR>Show
-			the RSS, Atom and RSD auto-discovery links suitable for use within
-			an HTML &lt;head&gt; element.</P>
-			<LI><P CLASS="western"><B>#showTrackbackAutodiscovery($entry)</B><BR>Show
-			trackback autodiscovery code for a specified weblog entry,
-			suitable for use within a day template.</P>
-		</UL>
-		<P CLASS="western">And that's it for the Roller macros. Now let's
-		move on to some additional models for use in site-wide weblogs.</P>
-		<H2 CLASS="western">7.7 - Displaying a Tag Cloud</H2>
+		<P CLASS="roller-macro-title-western"><B>#showWeblogEntryCalendar($weblog
+		$category)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$weblog: </B><SPAN STYLE="font-weight: medium">Weblog
+		object</SPAN><B><BR>	$category: </B><SPAN STYLE="font-weight: medium">Category
+		restriction (or 'nil' for no restriction)</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Show weblog entry
+		calendar, optionally restricted by category name (“nil” for no
+		category)</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P CLASS="western" STYLE="font-weight: medium">A weblog entry
+		calendar is displayed as a table with different CSS classes for
+		&lt;td&gt;, &lt;th&gt;, &lt;div&gt; and links elements within, as
+		illustrated below.</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;table
+		class=&quot;<B>hCalendarTable</B>&quot; ...&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;tr&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;td colspan=&quot;7&quot;
+		class=&quot;<B>hCalendarMonthYearRow</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;a href=&quot;...&quot;
+		class=&quot;<B>hCalendarNavBar</B>&quot;&gt;&amp;laquo; ...prev
+		month...&lt;/a&gt; | </FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;a href=&quot;...&quot;
+		class=&quot;<B>hCalendarNavBar</B>&quot;&gt;&amp;raquo; ...next
+		month...&lt;/a&gt; </FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/td&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/tr&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;tr&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;th
+		class=&quot;<B>hCalendarDayNameRow</B>&quot;
+		align=&quot;center&quot;&gt;Sun&lt;/th&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>...days of week...</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;th
+		class=&quot;<B>hCalendarDayNameRow</B>&quot;
+		align=&quot;center&quot;&gt;Sat&lt;/th&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/tr&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;tr&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;td
+		class=&quot;<B>hCalendarDayNotInMonth</B>&quot;&gt;&amp;nbsp;&lt;/td&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>...days of week...</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;td class=&quot;<B>hCalendarDay</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		  <FONT FACE="Courier New"><FONT SIZE=2>&lt;div
+		class=&quot;<B>hCalendarDayTitle</B>&quot;&gt;1&lt;/div&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/td&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;td
+		class=&quot;<B>hCalendarDayLinked</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;div
+		class=&quot;<B>hCalendarDayTitle</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		       <FONT FACE="Courier New"><FONT SIZE=2>&lt;a href=&quot;...&quot;&gt;2&lt;/a&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;/div&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/td&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/tr&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;tr
+		class=&quot;<B>hCalendarNextPrev</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;td colspan=&quot;7&quot;
+		align=&quot;center&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">            
+		   <FONT FACE="Courier New"><FONT SIZE=2>&lt;a href=&quot;...&quot;
+		class=&quot;<B>hCalendarNavBar</B>&quot;&gt;Today&lt;/a&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/td&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/tr&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;/table&gt;</FONT></FONT></P>
+		<P CLASS="western"><BR><BR>
+		</P>
+		<P CLASS="roller-macro-title-western"><B>#includeTemplate($weblog
+		$pageName)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$weblog: </B><SPAN STYLE="font-weight: medium">Weblog
+		object from which page is to be included</SPAN><B><BR>	$pageName:
+		</B><SPAN STYLE="font-weight: medium">Name of page to be included</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Parse and include a page
+		template into current page.</P>
+		<P CLASS="western"><BR><BR>
+		</P>
+		<P CLASS="roller-macro-title-western"><B>#showAutodiscoveryLinks($weblog)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$weblog: </B><SPAN STYLE="font-weight: medium">Weblog
+		object</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Show the RSS, Atom and RSD
+		auto-discovery links suitable for use within an HTML &lt;head&gt;
+		element.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P CLASS="western" STYLE="font-weight: medium">No style-able markup
+		is produced.</P>
+		<P CLASS="western"><BR><BR>
+		</P>
+		<P CLASS="roller-macro-title-western"><B>#showTrackbackAutodiscovery($entry)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$entry:</B><SPAN STYLE="font-weight: medium">
+		WeblogEntry object</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Show trackback
+		autodiscovery code for a specified weblog entry, suitable for use
+		within a day template.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P CLASS="western" STYLE="font-weight: medium">No style-able markup
+		is produced.</P>
+		<P CLASS="western" STYLE="font-weight: medium"><BR><BR>
+		</P>
+		<P CLASS="roller-macro-title-western"><B>#showAtomFeedsList($weblog)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$weblog: </B><SPAN STYLE="font-weight: medium">Weblog
+		object</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="western" STYLE="font-weight: medium">Displays a list of
+		links to a weblog's Atom newsfeeds. One for entries and one for
+		entries in each category that is defined in your weblog.</P>
+		<P CLASS="western" STYLE="font-weight: medium"><B>Generated HTML
+		and CSS classes used</B></P>
+		<P CLASS="western" STYLE="font-weight: medium">The feed list is
+		displayed as a simple HTML list with separate styles for list and
+		list-items.</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;ul
+		class=&quot;<B>rFeeds</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       <FONT FACE="Courier New"><FONT SIZE=2>&lt;li&gt;
+		&lt;a href=&quot;...&quot;&gt; ...feed name...&lt;/a&gt; &lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;/ul&gt;</FONT></FONT></P>
+		<P CLASS="western" STYLE="font-weight: medium"><BR><BR>
+		</P>
+		<P CLASS="western" STYLE="font-weight: medium"><BR><BR>
+		</P>
+		<P CLASS="roller-macro-title-western"><B>#showRSSFeedsList($weblog)</B></P>
+		<P CLASS="western"><B>	$weblog: </B><SPAN STYLE="font-weight: medium">Weblog
+		object</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="western" STYLE="font-weight: medium">Displays a list of
+		links to a weblog's RSS newsfeeds. One for entries and one for
+		entries in each category that is defined in your weblog.</P>
+		<P CLASS="western" STYLE="font-weight: medium"><B>Generated HTML
+		and CSS classes used</B></P>
+		<P CLASS="western" STYLE="font-weight: medium">The feed list is
+		displayed as a simple HTML list with separate styles for list and
+		list-items.</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;ul
+		class=&quot;<B>rFeeds</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;li&gt;&lt;a href=&quot;...&quot;&gt;
+		...feed name... &lt;/a&gt;&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;/ul&gt;</FONT></FONT></P>
+		<P CLASS="western" STYLE="font-weight: medium"><BR><BR>
+		</P>
+		<P CLASS="roller-macro-title-western"><B>#showReferrersList($refs
+		$max $maxWidth)</B></P>
+		<P CLASS="western"><B>Arguments:</B></P>
+		<P CLASS="western"><B>	$refs: </B><SPAN STYLE="font-weight: medium">List
+		of Referrer objects to be displayed</SPAN><B><BR>	$max: </B><SPAN STYLE="font-weight: medium">Maximum
+		number of objects to be displayed</SPAN><B><BR>	$maxWidth: </B><SPAN STYLE="font-weight: medium">Max
+		character width of text displayed</SPAN></P>
+		<P CLASS="western"><B>Synopsis:</B></P>
+		<P CLASS="roller-macro-synopsys-western">Display a list of today's
+		referrers as a simple HTML list. Note that many sites turn off
+		referrers due to spam problems and on such sites, this macro will
+		display nothing.</P>
+		<P CLASS="western"><B>Generated HTML and CSS classes used</B></P>
+		<P CLASS="western" STYLE="font-weight: medium">The referrer list is
+		displayed as a simple HTML list with separate styles for list and
+		list-items.</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;ul
+		class=&quot;<B>rReferersList</B>&quot;&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">        <FONT FACE="Courier New"><FONT SIZE=2>&lt;li
+		class=&quot;<B>rReferersListItem</B>&quot;&gt; </FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">           
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;a href=&quot;...&quot;&gt;
+		...referrer link... &lt;/a&gt; </FONT></FONT>
+		</P>
+		<P STYLE="margin-bottom: 0in; background: transparent">       
+		<FONT FACE="Courier New"><FONT SIZE=2>&lt;/li&gt;</FONT></FONT></P>
+		<P STYLE="margin-bottom: 0in; background: transparent">    <FONT FACE="Courier New"><FONT SIZE=2>&lt;/ul&gt;</FONT></FONT></P>
+		<P CLASS="western" STYLE="font-weight: medium"><BR><BR>
+		</P>
+		<P CLASS="western">And that's it for the Roller macros. Before we
+		move on to additional models, let's cover something you might want
+		to do, but that doesn't yet have a macro – creating a tag cloud.</P>
+		<H2 CLASS="western" STYLE="page-break-before: always">7.7 - Displaying
+		a Tag Cloud</H2>
 		<P CLASS="western">We don't yet include a Tag Cloud macro in Roller
 		because it's so easy to create one yourself. Here's what you do to
 		display a tag cloud for your weblog. First, if you have not already
@@ -3937,8 +4567,8 @@
 		<H2 CLASS="western">8.2 - $planet</H2>
 		<P CLASS="western">The <B>$planet</B> model makes Planet Roller
 		data available to weblog pages. It allows you to display the main
-		aggregation (i.e. the one named &ldquo;external&rdquo;), any custom
-		group aggregation, a feed and ranked subscriptions.</P>
+		aggregation (i.e. the one named “external”), any custom group
+		aggregation, a feed and ranked subscriptions.</P>
 		<H3 CLASS="western">8.2.1 - Configuring the planet model</H3>
 		<P CLASS="western">The PlanetModel is not enabled by default in
 		Roller, so before you can use it in your weblogs you'll need to

Modified: incubator/roller/trunk/docs/templateguide/generated/roller-template-guide.pdf
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/generated/roller-template-guide.pdf?view=diff&rev=489133&r1=489132&r2=489133
==============================================================================
Binary files - no diff available.

Modified: incubator/roller/trunk/docs/templateguide/roller-template-guide.odt
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/roller-template-guide.odt?view=diff&rev=489133&r1=489132&r2=489133
==============================================================================
Binary files - no diff available.



Mime
View raw message