You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@roller.apache.org by sn...@apache.org on 2006/09/18 21:22:19 UTC
svn commit: r447512 - in /incubator/roller/trunk/docs: installguide/
installguide/generated/ templateguide/ templateguide/generated/
templateguide/generated/html/ userguide/ userguide/generated/
userguide/generated/html/
Author: snoopdave
Date: Mon Sep 18 12:22:17 2006
New Revision: 447512
URL: http://svn.apache.org/viewvc?view=rev&rev=447512
Log:
Regenerated PDFs and HTML using Open Office 2.0.3
Added:
incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_1e560987.gif (with props)
incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_2d61cb4e.gif (with props)
incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_3e97bead.gif (with props)
incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_59438386.gif (with props)
incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_6d79f29e.gif (with props)
incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_731c768.gif (with props)
incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_745e10ce.gif (with props)
incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m202e3c46.gif (with props)
incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m2b0639f5.gif (with props)
incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m4b8ab955.gif (with props)
incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m5695ffaf.gif (with props)
incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m637f673c.gif (with props)
Modified:
incubator/roller/trunk/docs/installguide/generated/roller-install-guide.pdf
incubator/roller/trunk/docs/installguide/roller-install-guide.odt
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
incubator/roller/trunk/docs/userguide/generated/html/roller-user-guide.html
incubator/roller/trunk/docs/userguide/generated/roller-user-guide.pdf
incubator/roller/trunk/docs/userguide/roller-user-guide.odt
Modified: incubator/roller/trunk/docs/installguide/generated/roller-install-guide.pdf
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/installguide/generated/roller-install-guide.pdf?view=diff&rev=447512&r1=447511&r2=447512
==============================================================================
Binary files - no diff available.
Modified: incubator/roller/trunk/docs/installguide/roller-install-guide.odt
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/installguide/roller-install-guide.odt?view=diff&rev=447512&r1=447511&r2=447512
==============================================================================
Binary files - no diff available.
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=447512&r1=447511&r2=447512
==============================================================================
--- incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide.html (original)
+++ incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide.html Mon Sep 18 12:22:17 2006
@@ -3,11 +3,11 @@
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
<TITLE></TITLE>
- <META NAME="GENERATOR" CONTENT="StarOffice 8 (Solaris x86)">
+ <META NAME="GENERATOR" CONTENT="OpenOffice.org 2.0 (Solaris x86)">
<META NAME="AUTHOR" CONTENT="Dave Johnson">
<META NAME="CREATED" CONTENT="20051209;11500200">
<META NAME="CHANGEDBY" CONTENT="Dave Johnson">
- <META NAME="CHANGED" CONTENT="20060822;15271100">
+ <META NAME="CHANGED" CONTENT="20060918;15194300">
<META NAME="SDFOOTNOTE" CONTENT=";;;;P">
<META NAME="SDENDNOTE" CONTENT="ARABIC">
<STYLE>
@@ -19,6 +19,12 @@
P.ctl { font-weight: medium }
H1.cjk { font-family: "Andale Sans UI" }
H1.ctl { font-family: "Lucidasans" }
+ H2.western { font-family: "Thorndale", serif }
+ H2.cjk { font-family: "Andale Sans UI" }
+ H2.ctl { font-family: "Lucidasans" }
+ H3.western { font-family: "Thorndale", serif }
+ H3.cjk { font-family: "Andale Sans UI" }
+ H3.ctl { font-family: "Lucidasans" }
TD P { margin-bottom: 0in }
TD P.western { font-family: "Times New Roman" }
TH P { margin-bottom: 0in }
@@ -54,9 +60,6 @@
<BR>
</P>
<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in; background: transparent">
- <FONT COLOR="#ff0000"><FONT SIZE=7 STYLE="font-size: 40pt"><B>DRAFT
- #20060822</B></FONT></FONT></P>
- <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in; background: transparent">
<BR>
</P>
<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in; background: transparent">
@@ -139,6 +142,12 @@
<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
<BR>
</P>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
+ <BR>
+ </P>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
+ <BR>
+ </P>
<P CLASS="western" ALIGN=LEFT><FONT FACE="Courier New"><FONT SIZE=1 STYLE="font-size: 8pt"><I>Licensed
to the Apache Software Foundation (ASF) under one or more
contributor license agreements. The ASF licenses this file to You
@@ -288,7 +297,7 @@
can edit to customize the content, layout and appearance of your
weblog.
</P>
- <H2>2.1 - Page templates</H2>
+ <H2 CLASS="western">2.1 - Page templates</H2>
<P CLASS="western">When you create a new Roller weblog you must
pick a theme to define the new weblog's appearance and layout. A
theme is just a small set of templates, where each template
@@ -312,7 +321,7 @@
page templates. In the example above, we see only the $model
object, but here are others. You'll learn more about models in
Section 4 and Section 5 provides a complete reference.</P>
- <H2>2.2 - The Velocity template language</H2>
+ <H2 CLASS="western">2.2 - The Velocity template language</H2>
<P CLASS="western">The simple template language that we use inside
Roller page templates is called Velocity. It's designed to be
simple and easy for even non-programmers, but it's also a simple
@@ -395,7 +404,7 @@
the CSS style code used by the weblog.</P>
<P CLASS="western">First, let's look at a simple Weblog template.
</P>
- <H2>3.1 - The Weblog template</H2>
+ <H2 CLASS="western">3.1 - The Weblog template</H2>
<P CLASS="western">Below is a simple Weblog page that displays all
of the data that weblog typically contains including recent entries
with paging to past entries, category link, feed links, a calendar
@@ -610,7 +619,7 @@
Note in point #9 that the display of the weblog entries is
controlled by another template, the _day template. So next let's
take a look at that _day template.</P>
- <H2>3.2 - The _day template</H2>
+ <H2 CLASS="western">3.2 - The _day template</H2>
<P CLASS="western">A theme's _day template is responsible for
displaying one day's worth of weblog entries. Here's a typical _day
template, one that corresponds to the above Weblog template.</P>
@@ -720,7 +729,7 @@
<P CLASS="western">Now you've seen the required templates and
you've seen most of the commonly used macros in action, let's
discuss the mechanics of customizing your theme.</P>
- <H2>3.3 - Customizing your theme</H2>
+ <H2 CLASS="western">3.3 - Customizing your theme</H2>
<P CLASS="western">When you start a Roller weblog and you pick a
theme, your weblog uses a <I>shared</I> copy of that theme. The
page templates that define your theme are shared by all of the
@@ -757,7 +766,7 @@
just use the <B>Preferences->Theme</B> page to switch back to a
shared theme – or pick another one to customize. Now let's
discuss editing and creating templates.</P>
- <H2>3.4 - Editing and creating page templates</H2>
+ <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->Templates</B> page, shown below,
@@ -837,12 +846,12 @@
</UL>
<P CLASS="western">Let's discuss how to access data via models and
data objects.</P>
- <H2>4.1 - Accessing data via models and objects</H2>
+ <H2 CLASS="western">4.1 - Accessing data via models and objects</H2>
<P CLASS="western">Models and data objects are objects and there
are two ways to access data from objects. One way is to access an
objects properties. Another is to call the object's methods. Let's
talk about these two techniques.</P>
- <H3>4.1.1 - Accessing object properties</H3>
+ <H3 CLASS="western">4.1.1 - Accessing object properties</H3>
<P CLASS="western">To access an objects properties, you use a
simple dot-notation. For example, if you want to display the Roller
version number property of the <B>$config</B> model object, you do
@@ -863,7 +872,7 @@
like so:</P>
<P STYLE="margin-bottom: 0in; background: transparent"><FONT FACE="Courier New"><FONT SIZE=2> <p><B>$model.weblog.name</B></a></FONT></FONT></P>
<P STYLE="margin-bottom: 0in; background: transparent"><FONT FACE="Courier New"><FONT SIZE=2> <p><B>$model.weblog.description</B></a></FONT></FONT></P>
- <H3>4.1.2 - Calling object methods</H3>
+ <H3 CLASS="western">4.1.2 - Calling object methods</H3>
<P CLASS="western">Another way to access an object's data is to
call an objects's methods. Methods are different from properties
because they require parameters. You use the same simple
@@ -877,7 +886,7 @@
<P CLASS="western">Argument one is the name of the theme and
argument two is the name of a file that exists in the theme's
directory. Note that a comma is used to separate the arguments.</P>
- <H2>4.2 - Calling macros</H2>
+ <H2 CLASS="western">4.2 - Calling macros</H2>
<P CLASS="western">In page templates, you get data from objects and
you use template code to display that data as HTML. To help you
along, Roller includes some macros which can be used to generate
@@ -898,7 +907,7 @@
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>4.3 - A word about pagers</H2>
+ <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 – that is, we want a Next link to go to the next
@@ -998,10 +1007,10 @@
</UL>
<P CLASS="western">For each model, we'll cover properties and
methods.</P>
- <H2>5.1 - $config</H2>
+ <H2 CLASS="western">5.1 - $config</H2>
<P CLASS="western">The $config model provides access to the Roller
configuration data that you'll need in your weblog.</P>
- <H3>5.1.1 - $config Properties</H3>
+ <H3 CLASS="western">5.1.1 - $config Properties</H3>
<TABLE WIDTH=720 BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
<COL WIDTH=186>
<COL WIDTH=57>
@@ -1165,7 +1174,7 @@
</TR>
</TBODY>
</TABLE>
- <H3>5.1.2 - $config Methods</H3>
+ <H3 CLASS="western">5.1.2 - $config Methods</H3>
<P CLASS="western">The <B>$config</B> model also provides a set of
methods for accessing properties by name. Generally, you should be
able to get the configuration data you need from the properties
@@ -1182,7 +1191,7 @@
propertyName)</B><BR>Returns the named runtime property as an
integer.</P>
</UL>
- <H2>5.2 - $model</H2>
+ <H2 CLASS="western">5.2 - $model</H2>
<P CLASS="western">The <B>$model </B>object provides you with
access to all of the data objects that make up your weblog. You can
get a pager object to access your weblog entries, the weblog entry
@@ -1194,13 +1203,13 @@
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_23f6e71e.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_41cae8f2.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_54c83831.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m52909c75.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m5a7105a.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m1fb04575.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m5542aee0.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m3506fd0f.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_m316a6705.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m415f93a1.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_70922ad5.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_2eeff179.gif" ALIGN=LEFT><BR><BR>
+ <P CLASS="frame-contents-western"><IMG SRC="roller-template-guide_html_1e560987.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m202e3c46.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m5695ffaf.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_59438386.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m637f673c.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m2b0639f5.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_745e10ce.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_mf2d7980.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_2d61cb4e.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_731c768.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_m4b8ab955.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_6d79f29e.gif" ALIGN=LEFT><IMG SRC="roller-template-guide_html_3e97bead.gif" ALIGN=LEFT><BR><BR>
</P>
</SPAN><BR CLEAR=LEFT><BR><BR>
</P>
<P CLASS="western">Now let's the details of the $model object,
starting with properties.</P>
- <H3>5.2.1 - $model Properties</H3>
+ <H3 CLASS="western">5.2.1 - $model Properties</H3>
<TABLE WIDTH=719 BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
<COL WIDTH=181>
<COL WIDTH=116>
@@ -1331,7 +1340,7 @@
</TR>
</TBODY>
</TABLE>
- <H3>5.2.2 - $model Search Properties</H3>
+ <H3 CLASS="western">5.2.2 - $model Search Properties</H3>
<P CLASS="western">If the URL indicates a search, then the pager
returned by <B>$model.weblogEntriesPager</B> will return entries
from the search and some additional properties will be available on
@@ -1420,7 +1429,7 @@
</TR>
</TBODY>
</TABLE>
- <H3>5.2.3 - $model methods</H3>
+ <H3 CLASS="western">5.2.3 - $model methods</H3>
<P CLASS="western">The <B>$model</B> object also provides a couple
of methods:</P>
<UL>
@@ -1433,7 +1442,7 @@
</UL>
<P CLASS="western"><BR><BR>
</P>
- <H2 STYLE="page-break-before: always">5.3 - $url</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">5.3 - $url</H2>
<P CLASS="western">To ensure that your URLs are formed correctly,
you should use the <B>$url</B> model to form all URLs that point to
the Roller site or to your weblog. Every possible type of Roller
@@ -1833,7 +1842,7 @@
</P>
<P CLASS="western"><BR><BR>
</P>
- <H2 STYLE="page-break-before: always">5.4 - $utils</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">5.4 - $utils</H2>
<P CLASS="western">The <B>$utils </B>object provides all of the
string manipulation methods you'll ever need for your weblog,
including methods for formatting dates, escapeing HTML, encoding
@@ -1927,7 +1936,7 @@
<LI><P CLASS="western"><B>Weblog Category</B>: A category within a
weblog, categories in Roller are hierarchical</P>
</UL>
- <H2>6.1 - Bookmark</H2>
+ <H2 CLASS="western">6.1 - Bookmark</H2>
<P CLASS="western"><BR><BR>
</P>
<TABLE WIDTH=721 BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
@@ -2025,7 +2034,7 @@
<P CLASS="western" STYLE="margin-bottom: 0in; background: transparent; font-weight: medium">
<BR>
</P>
- <H2>6.2 - BookmarkFolder</H2>
+ <H2 CLASS="western">6.2 - BookmarkFolder</H2>
<TABLE WIDTH=721 BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
<COL WIDTH=149>
<COL WIDTH=167>
@@ -2146,7 +2155,7 @@
</TR>
</TBODY>
</TABLE>
- <H2>6.3 - Comment</H2>
+ <H2 CLASS="western">6.3 - Comment</H2>
<TABLE WIDTH=721 BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
<COL WIDTH=157>
<COL WIDTH=93>
@@ -2310,7 +2319,7 @@
</TR>
</TBODY>
</TABLE>
- <H2>6.4 - PageTemplate</H2>
+ <H2 CLASS="western">6.4 - PageTemplate</H2>
<TABLE WIDTH=721 BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
<COL WIDTH=157>
<COL WIDTH=92>
@@ -2416,7 +2425,7 @@
</TR>
</TBODY>
</TABLE>
- <H2>6.5 - Referrer</H2>
+ <H2 CLASS="western">6.5 - Referrer</H2>
<TABLE WIDTH=721 BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
<COL WIDTH=164>
<COL WIDTH=85>
@@ -2568,7 +2577,7 @@
</TR>
</TBODY>
</TABLE>
- <H2>6.6 - User</H2>
+ <H2 CLASS="western">6.6 - User</H2>
<TABLE WIDTH=721 BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
<COL WIDTH=188>
<COL WIDTH=172>
@@ -2662,7 +2671,7 @@
</TR>
</TBODY>
</TABLE>
- <H2>6.7 - Weblog</H2>
+ <H2 CLASS="western">6.7 - Weblog</H2>
<TABLE WIDTH=721 BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
<COL WIDTH=190>
<COL WIDTH=172>
@@ -2971,7 +2980,7 @@
link.</P>
</UL>
</UL>
- <H2>6.8 - WeblogCategory</H2>
+ <H2 CLASS="western">6.8 - WeblogCategory</H2>
<TABLE WIDTH=721 BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
<COL WIDTH=195>
<COL WIDTH=168>
@@ -3091,7 +3100,7 @@
</TR>
</TBODY>
</TABLE>
- <H2>6.9 - WeblogEntry</H2>
+ <H2 CLASS="western">6.9 - WeblogEntry</H2>
<TABLE WIDTH=719 BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0>
<COL WIDTH=193>
<COL WIDTH=167>
@@ -3375,7 +3384,7 @@
or null if no such attribute</P>
</UL>
</UL>
- <H2>6.10 - WeblogEntryAttribute</H2>
+ <H2 CLASS="western">6.10 - WeblogEntryAttribute</H2>
<P CLASS="western">Weblog entry attributes are name/value pairs
that can be assigned to weblog entries. Currently, they're only
used to add podcasts to blog entries.</P>
@@ -3439,7 +3448,7 @@
</TR>
</TBODY>
</TABLE>
- <H3></H3>
+ <H3 CLASS="western"></H3>
<P CLASS="western"><BR><BR>
</P>
<H1 CLASS="western" STYLE="page-break-before: always">7 - Macro
@@ -3447,14 +3456,14 @@
<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>
- <H2>7.1 - Entry macros</H2>
+ <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>
</UL>
- <H2>7.2 - Comment macros</H2>
+ <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
@@ -3463,7 +3472,7 @@
<LI><P CLASS="western"><B>#showWeblogEntryCommentForm($entry)</B><BR>Display
a comment form for adding a comment to the specified entry.</P>
</UL>
- <H2>7.3 - List macros</H2>
+ <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>
@@ -3477,7 +3486,7 @@
specified category object. If $expanding and $subcats are set to
true, then display the categories as an expandable tree view.</P>
</UL>
- <H2>7.4 - Menu macros</H2>
+ <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>
@@ -3485,7 +3494,7 @@
an authoring menu for the current weblog. If $vertical is true,
then display a menu suitable for use in a narrow sidebar.</P>
</UL>
- <H2>7.5 - Search macros</H2>
+ <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,
@@ -3496,7 +3505,7 @@
<LI><P CLASS="western"><B>#showNextPrevSearchControl($pager)</B><BR>Show
special pager designed for paging through search results.</P>
</UL>
- <H2>7.6 - Misc. macros</H2>
+ <H2 CLASS="western">7.6 - Misc. macros</H2>
<UL>
<LI><P CLASS="western"><B>#showWeblogEntryCalendar($weblog
$category)</B><BR>Show weblog entry calendar, optionally
@@ -3524,13 +3533,13 @@
the <B>$site </B>for accessing site-wide data,and the <B>$planet
</B>model for accessing Planet Roller data. Let's start with the
$site model.</P>
- <H2>8.1 - $site</H2>
+ <H2 CLASS="western">8.1 - $site</H2>
<P CLASS="western">The <B>$site </B>model provides access to
site-wide data: aggregations of webog entries from all weblogs,
comments from all weblogs, lists of users, lists of weblogs, etc.
-- in short, everything you need to build an interesting community
front page for Roller.</P>
- <H3>8.1.1 - $site Objects</H3>
+ <H3 CLASS="western">8.1.1 - $site Objects</H3>
<P CLASS="western">For some SiteModel methods (e.g. hot-blogs, most
commented, etc.) return a special type of object use to expressing
a count with a short name, a long name and an internationalized
@@ -3605,7 +3614,7 @@
</TR>
</TBODY>
</TABLE>
- <H3>8.1.2 - $site Methods</H3>
+ <H3 CLASS="western">8.1.2 - $site Methods</H3>
<UL>
<LI><P CLASS="western"><B>Pager getWeblogEntriesPager(int
sinceDays, int max)</B><BR>Get pager that returns WeblogEntry
@@ -3669,12 +3678,12 @@
WeblogEntries in the form of StatCount objects, but only those
updated in last sinceDays number of days.</P>
</UL>
- <H2>8.2 - $planet</H2>
+ <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 “external”), any custom
group aggregation, a feed and ranked subscriptions.</P>
- <H3>8.2.1 - $planet Objects</H3>
+ <H3 CLASS="western">8.2.1 - $planet Objects</H3>
<P CLASS="western">The $planet model returns two types of objects
that we haven't seen before: the PlanetSubscription object, which
represents a feed subscription, and PlanetEntry, which represents
@@ -3959,7 +3968,7 @@
</TABLE>
<P CLASS="western"><BR><BR>
</P>
- <H3>8.2.2 - $planet Methods</H3>
+ <H3 CLASS="western">8.2.2 - $planet Methods</H3>
<UL>
<LI><P CLASS="western"><B>Pager getAggregationPager(int sinceDays,
int max)</B><BR>Get pager that returns PlanetEntry objects from
Added: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_1e560987.gif
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_1e560987.gif?view=auto&rev=447512
==============================================================================
Binary file - no diff available.
Propchange: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_1e560987.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_2d61cb4e.gif
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_2d61cb4e.gif?view=auto&rev=447512
==============================================================================
Binary file - no diff available.
Propchange: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_2d61cb4e.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_3e97bead.gif
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_3e97bead.gif?view=auto&rev=447512
==============================================================================
Binary file - no diff available.
Propchange: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_3e97bead.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_59438386.gif
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_59438386.gif?view=auto&rev=447512
==============================================================================
Binary file - no diff available.
Propchange: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_59438386.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_6d79f29e.gif
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_6d79f29e.gif?view=auto&rev=447512
==============================================================================
Binary file - no diff available.
Propchange: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_6d79f29e.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_731c768.gif
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_731c768.gif?view=auto&rev=447512
==============================================================================
Binary file - no diff available.
Propchange: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_731c768.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_745e10ce.gif
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_745e10ce.gif?view=auto&rev=447512
==============================================================================
Binary file - no diff available.
Propchange: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_745e10ce.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m202e3c46.gif
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m202e3c46.gif?view=auto&rev=447512
==============================================================================
Binary file - no diff available.
Propchange: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m202e3c46.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m2b0639f5.gif
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m2b0639f5.gif?view=auto&rev=447512
==============================================================================
Binary file - no diff available.
Propchange: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m2b0639f5.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m4b8ab955.gif
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m4b8ab955.gif?view=auto&rev=447512
==============================================================================
Binary file - no diff available.
Propchange: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m4b8ab955.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m5695ffaf.gif
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m5695ffaf.gif?view=auto&rev=447512
==============================================================================
Binary file - no diff available.
Propchange: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m5695ffaf.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
Added: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m637f673c.gif
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m637f673c.gif?view=auto&rev=447512
==============================================================================
Binary file - no diff available.
Propchange: incubator/roller/trunk/docs/templateguide/generated/html/roller-template-guide_html_m637f673c.gif
------------------------------------------------------------------------------
svn:mime-type = application/octet-stream
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=447512&r1=447511&r2=447512
==============================================================================
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=447512&r1=447511&r2=447512
==============================================================================
Binary files - no diff available.
Modified: incubator/roller/trunk/docs/userguide/generated/html/roller-user-guide.html
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/userguide/generated/html/roller-user-guide.html?view=diff&rev=447512&r1=447511&r2=447512
==============================================================================
--- incubator/roller/trunk/docs/userguide/generated/html/roller-user-guide.html (original)
+++ incubator/roller/trunk/docs/userguide/generated/html/roller-user-guide.html Mon Sep 18 12:22:17 2006
@@ -3,11 +3,11 @@
<HEAD>
<META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=iso-8859-1">
<TITLE></TITLE>
- <META NAME="GENERATOR" CONTENT="StarOffice 8 (Solaris x86)">
+ <META NAME="GENERATOR" CONTENT="OpenOffice.org 2.0 (Solaris x86)">
<META NAME="AUTHOR" CONTENT="Dave Johnson">
<META NAME="CREATED" CONTENT="20051209;11500200">
<META NAME="CHANGEDBY" CONTENT="Dave Johnson">
- <META NAME="CHANGED" CONTENT="20060825;12065200">
+ <META NAME="CHANGED" CONTENT="20060918;15073100">
<META NAME="SDFOOTNOTE" CONTENT=";;;;P">
<META NAME="SDENDNOTE" CONTENT="ARABIC">
<STYLE>
@@ -17,8 +17,16 @@
P.western { font-family: "Times New Roman" }
H1.cjk { font-family: "Andale Sans UI" }
H1.ctl { font-family: "Lucidasans" }
+ H2.western { font-family: "Thorndale", serif }
+ H2.cjk { font-family: "Andale Sans UI" }
+ H2.ctl { font-family: "Lucidasans" }
+ H3.western { font-family: "Thorndale", serif }
+ H3.cjk { font-family: "Andale Sans UI" }
+ H3.ctl { font-family: "Lucidasans" }
+ PRE { font-family: "Cumberland", monospace }
DD.western { font-family: "Times New Roman" }
DT.western { font-family: "Times New Roman" }
+ TT { font-family: "Cumberland", monospace }
-->
</STYLE>
</HEAD>
@@ -37,8 +45,8 @@
</P>
<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=7 STYLE="font-size: 40pt"><B>User
Guide</B></FONT></P>
- <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT COLOR="#ff0000"><FONT SIZE=7 STYLE="font-size: 40pt"><B>DRAFT
- #20060825</B></FONT></FONT></P>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ </P>
<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
<P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=7 STYLE="font-size: 32pt"><B>Apache
@@ -359,7 +367,8 @@
- Getting started with an existing Roller installation</A> where we
discuss how to register for an ordinary Roller user account.
</P>
- <H2>2.1 - Getting started with a new Roller installation</H2>
+ <H2 CLASS="western">2.1 - Getting started with a new Roller
+ installation</H2>
<P CLASS="western">If you've just installed a new Roller server,
make sure that you create the first user yourself. Roller grants
global admin permission to the very first user that is created.
@@ -394,7 +403,7 @@
you're done click the <B>Create Weblog</B> button.
</P>
</OL>
- <H2><A NAME="2.2.Getting%20started%20with%20an%20existing%20Roller%20installation|outline"></A>
+ <H2 CLASS="western"><A NAME="2.2.Getting%20started%20with%20an%20existing%20Roller%20installation|outline"></A>
2.2 - Getting started with an existing Roller installation</H2>
<P CLASS="western">To get started on an existing Roller
installation, first you need to create a user account. Once you've
@@ -443,7 +452,7 @@
you're done click the <B>Create Weblog</B> button.
</P>
</OL>
- <H2>2.3 - Accepting an invitation to join a weblog</H2>
+ <H2 CLASS="western">2.3 - Accepting an invitation to join a weblog</H2>
<P CLASS="western">Roller supports group blogging. That means that
more than one user can edit and manage a single weblog. If somebody
invites you to join their weblog, an invitation message will appear
@@ -461,7 +470,7 @@
you'll be a member of the weblog and the weblog will appear on your
Main Menu page as one of your weblogs.
</P>
- <H2>2.4 - Getting around in Roller</H2>
+ <H2 CLASS="western">2.4 - Getting around in Roller</H2>
<P CLASS="western">When you log into Roller, Roller sends you to
the Roller <I>editor interface</I> -- a set of web pages for
editing and managing your weblog and (if you have global admin
@@ -562,7 +571,8 @@
a new user, creating a new weblog and finding your way around let's
start blogging.
</P>
- <H2>2.5 Changing the Language of the editor interface</H2>
+ <H2 CLASS="western">2.5 Changing the Language of the editor
+ interface</H2>
<P CLASS="western">The Roller editor interface uses the locale
(language and country) User Profile setting to select the text to
display in the editor navbar and in each editor page. You can
@@ -597,8 +607,8 @@
profile and perform administrative duties (if you have global admin
permissions).
</P>
- <H2 STYLE="page-break-before: always">3.1 - Creating and editing a
- weblog entries</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">3.1 - Creating
+ and editing a weblog entries</H2>
<P CLASS="western">To create a new weblog entry, go to your
weblog's <B>New Entry</B> page, enter a title in the Title field,
enter the your post in the Content text area, choose a category
@@ -742,15 +752,15 @@
the edit weblog page, but it will be pretty close. </FONT>
</P>
</UL>
- <H2>3.2 - Finding and editing weblog entries</H2>
+ <H2 CLASS="western">3.2 - Finding and editing weblog entries</H2>
<P CLASS="western">All of your blog entries are saved in a
database. Once your blog entries scroll off the front page or off
the recent entries list of the <B>Create & Edit:New Entry</B>
page, they are still available to your readers on your weblog
pages. They're available to you too.
</P>
- <H3>3.2.1 - <B>Finding old entries with the Create & Edit:New
- Entry page</B>
+ <H3 CLASS="western">3.2.1 - <B>Finding old entries with the Create
+ & Edit:New Entry page</B>
</H3>
<P CLASS="western">If you go to the <B>Create & Edit:New Entry</B>
page, you'll see on the right a list of recent Pending Entries,
@@ -785,8 +795,8 @@
</P>
</SPAN><BR CLEAR=LEFT><BR><BR>
</P>
- <H3>3.2.2 - <B>Finding old entries with the Create &
- Edit:Entries page</B>
+ <H3 CLASS="western">3.2.2 - <B>Finding old entries with the Create
+ & Edit:Entries page</B>
</H3>
<P CLASS="western" STYLE="font-weight: medium">You can use the
Create & Edit:Entries to find and edit your old posts. That
@@ -798,8 +808,9 @@
specific time period. You can edit any of the entries in the Weblog
Entries list by simply clicking on its title.
</P>
- <H3>3.2.3 - <B>Finding old entries using the pages of your weblog</B>
- </H3>
+ <H3 CLASS="western">3.2.3 - <B>Finding old entries using the pages
+ of your weblog</B>
+ </H3>
<P CLASS="western">You can also use the pages of your weblog to
navigate into the past and find old blog entries. If you do this
when you are logged in, then you'll see an <B>Edit</B> link on each
@@ -823,8 +834,8 @@
can navigate into the past by using URLs.
</P>
</UL>
- <H3>3.2.4 - <B>Finding old entries with Roller's built-in search
- engine</B>
+ <H3 CLASS="western">3.2.4 - <B>Finding old entries with Roller's
+ built-in search engine</B>
</H3>
<P CLASS="western">Roller also has a built in search engine, which
you can use to search for entries in the entire site, or in just
@@ -833,7 +844,8 @@
</P>
<P CLASS="western"><BR><BR>
</P>
- <H2 STYLE="page-break-before: always">3.3 - Weblog categories</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">3.3 - Weblog
+ categories</H2>
<P CLASS="western">Roller's weblog categories feature allows you to
organize your weblog posts by category. For example, you might
setup a category called "Family" for your family related
@@ -847,7 +859,7 @@
old post. Currently, Roller only allows you to assign each weblog
post to one category.
</P>
- <H3>3.3.1 - <B>The Weblog Category Chooser</B>
+ <H3 CLASS="western">3.3.1 - <B>The Weblog Category Chooser</B>
</H3>
<P CLASS="western">When a user views your site, they can choose
which category to view. All of the stock Roller weblog templates
@@ -855,7 +867,7 @@
close to the top of the page so that your readers can pick which
category to display or "All" for all categories of posts.
</P>
- <H3>3.3.2 - <B>RSS Feed for Each Category</B>
+ <H3 CLASS="western">3.3.2 - <B>RSS Feed for Each Category</B>
</H3>
<P CLASS="western">Your weblog's main RSS newsfeed includes all
categories, but users can choose to subscribe to specific
@@ -863,16 +875,17 @@
list of your RSS feeds, one for all categories and one for each
separate category.
</P>
- <H3>3.3.3 - <B>Adding, Renaming, and Removing Weblog Categories</B>
- </H3>
+ <H3 CLASS="western">3.3.3 - <B>Adding, Renaming, and Removing
+ Weblog Categories</B>
+ </H3>
<P CLASS="western">You can change the names of your categories, add
new categories, and delete categories using the <B>Create &
Edit:Categories</B> page of the Roller Editor UI.
</P>
<P CLASS="western"><BR><BR>
</P>
- <H2 STYLE="page-break-before: always">3.4 - Using a blog client
- with Roller</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">3.4 - Using a
+ blog client with Roller</H2>
<P CLASS="western">A blog client allows you to post to Roller
remotely, from your desktop or from some other web site. For
example, desktop applications such as Ecto and MarsEdit can post to
@@ -931,7 +944,8 @@
</P>
<P CLASS="western"><BR><BR>
</P>
- <H2 STYLE="page-break-before: always">3.5 - Podcasting with Roller</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">3.5 - Podcasting
+ with Roller</H2>
<P CLASS="western">Roller now includes support for <I>podcasting</I>,
a way to distribute files through your weblog's newsfeed.
Typically, folks use Podcasting to distribute audio files, but the
@@ -940,7 +954,8 @@
downloads the audio files that are referenced in your newsfeed and
copies them to an music player, such as an MP3 player.
</P>
- <H3>3.5.1 - <B>How to create a podcast feed with Roller</B>
+ <H3 CLASS="western">3.5.1 - <B>How to create a podcast feed with
+ Roller</B>
</H3>
<P CLASS="western">In Roller a Podcast is like an attachment to a
weblog entry. We call it mediacasting in the Roller UI because it
@@ -1029,7 +1044,7 @@
page of your weblog. Note that turning off comments, disables both
comments and trackbacks.
</P>
- <H2>4.1 - Comment notification via email</H2>
+ <H2 CLASS="western">4.1 - Comment notification via email</H2>
<P CLASS="western">If you're going to leave comments turn on then
take the time to read them, to respond where appropriate and, when
you receive spam or other forms of offensive comments, delete them
@@ -1044,7 +1059,7 @@
below, where you may choose to approve, mark as spam or even delete
the new comment.
</P>
- <H2>4.2 - Comment management and moderation</H2>
+ <H2 CLASS="western">4.2 - Comment management and moderation</H2>
<P CLASS="western" STYLE="font-style: normal; font-weight: medium">If
you'd like to preview and approve comments before they are
displayed on your weblog, then you'll want to turn on <I>comment
@@ -1139,7 +1154,7 @@
trackback will be marked as un-approved and pending. You'll have to
visit the comment management page to approve that trackback before
it is displayed as a comment on your weblog.</SPAN></P>
- <H2>4.3 - <B>Preventing weblog spam</B>
+ <H2 CLASS="western">4.3 - <B>Preventing weblog spam</B>
</H2>
<P CLASS="western">There are three forms of comment spam that can
affect your weblog:</P>
@@ -1165,7 +1180,7 @@
verification (described in the previous section) to manage spam.
That's not all. Roller also includes a blacklisting feature, which
can be used to fight all three forms of spam.</P>
- <H3>4.3.1 - Three levels of blacklisting</H3>
+ <H3 CLASS="western">4.3.1 - Three levels of blacklisting</H3>
<P CLASS="western"><SPAN STYLE="font-weight: medium">Roller uses a
<I>blacklist</I>, a lists of words which are used to check incoming
comments, trackbacks and referrers for spam. The blacklist includes
@@ -1196,7 +1211,8 @@
and trackbacks are checked against all three levels of blacklist.
Incoming referrers, however, are only checked against the levels 2
and 3 blacklist.</P>
- <H3>4.3.2 - How to add words and expressions to the blacklist</H3>
+ <H3 CLASS="western">4.3.2 - How to add words and expressions to the
+ blacklist</H3>
<P CLASS="western" STYLE="font-weight: medium">If you have a spam
problem on your weblog and you'd like to add words to the
blacklist, it's probably better for you to ask your administrator
@@ -1220,7 +1236,8 @@
</UL>
<P CLASS="western"><BR><BR>
</P>
- <H2 STYLE="page-break-before: always">4.4 - Sending trackbacks</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">4.4 - Sending
+ trackbacks</H2>
<P CLASS="western">If you are writing about something you read on
another weblog, you want to let the author and readers of that
weblog know that you are doing so, and that other weblog is
@@ -1263,11 +1280,11 @@
</SPAN><BR CLEAR=LEFT><BR><BR>
</P>
<UL>
- <LI><P CLASS="western">You should now see your trackback listed
- among the comments on Otto's blog entry.
+ <LI VALUE=1><P CLASS="western">You should now see your trackback
+ listed among the comments on Otto's blog entry.
</P>
</UL>
- <H2>4.5 - Referrer rankings</H2>
+ <H2 CLASS="western">4.5 - Referrer rankings</H2>
<P CLASS="western">The <B>Weblog:Referrer</B> referrer rankings
page shows the hits that are coming in from other websites and
weblogs that have links to your weblog and to specific entries in
@@ -1301,7 +1318,8 @@
</P>
<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
</P>
- <H2 STYLE="page-break-before: always">5.1 - Weblog settings</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">5.1 - Weblog
+ settings</H2>
<P CLASS="western">The <B>Preferences:Settings</B> page allows you
to set the configuration parameters for your weblog. The page is
large, so we've split it into two screen-shots. Here's the first
@@ -1362,12 +1380,13 @@
<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
</P>
<UL>
- <LI><P CLASS="western"><FONT SIZE=2><B>Weblog is active: </B><SPAN STYLE="font-weight: medium">un-check
- this box to indicate that your weblog is no longer active and
- should not appear in hot-blog and other weblog listing on the
- site. You might want to do this if you take a very long vacation
- or if you have decided to stop updating your weblog for some
- other reason. </SPAN></FONT>
+ <LI VALUE=1><P CLASS="western"><FONT SIZE=2><B>Weblog is active:
+ </B><SPAN STYLE="font-weight: medium">un-check this box to
+ indicate that your weblog is no longer active and should not
+ appear in hot-blog and other weblog listing on the site. You
+ might want to do this if you take a very long vacation or if you
+ have decided to stop updating your weblog for some other reason.
+ </SPAN></FONT>
</P>
<LI><P CLASS="western"><FONT SIZE=2><B>Number of entries to
display on weblog</B>: Enter the maximum number of entries to be
@@ -1418,10 +1437,10 @@
Choose the default amount of time to allow comments for new blog
entries. This setting may also be overridden using the Comment
Settings section of the New Entry page.</SPAN></FONT></P>
- <LI><P CLASS="western"><SPAN STYLE="font-weight: medium"><FONT SIZE=2><B>Apply
- comment defaults to all existing entries? </B>- If you check this
- box, when you click the Save button the comment defaults you have
- set will be applied to all existing comments.</FONT></SPAN></P>
+ <LI><P CLASS="western"><FONT SIZE=2><B>Apply comment defaults to
+ all existing entries? </B><SPAN STYLE="font-weight: medium">- If
+ you check this box, when you click the Save button the comment
+ defaults you have set will be applied to all existing comments.</SPAN></FONT></P>
</UL>
<P CLASS="western" STYLE="font-weight: medium"><BR><BR>
</P>
@@ -1471,7 +1490,7 @@
</P>
</SPAN><BR CLEAR=LEFT><BR><BR>
</P>
- <H2>5.2 - Weblog themes</H2>
+ <H2 CLASS="western">5.2 - Weblog themes</H2>
<P CLASS="western">A weblog theme is a set of templates,
style-sheets and image that determine how your weblog will be
displayed. A theme can define both the layout and color-scheme of
@@ -1495,7 +1514,7 @@
<B>Preferences:Theme</B> page will destroy the custom changes
you've made.
</P>
- <H2>5.3 - Uploading Files</H2>
+ <H2 CLASS="western">5.3 - Uploading Files</H2>
<P CLASS="western">Roller includes a file-upload feature that
allows you to upload images and other files for use in your weblog.
</P>
@@ -1524,7 +1543,8 @@
form to include an <TT>alt</TT> attribute that describes the image
(for those who cannot see the image).
</P>
- <H2 STYLE="page-break-before: always">5.4 - Setting up a group blog</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">5.4 - Setting
+ up a group blog</H2>
<P CLASS="western">To create a group blog, create a new weblog or
log into an existing weblog that you'd like members to contribute
to. Creating a weblog for group blogging is the same a creating a
@@ -1629,7 +1649,7 @@
that is, a list of your favorite weblogs and web sites that is
displayed in the sidebar of your weblog.
</P>
- <H2>6.1 - Adding new links to your blogroll</H2>
+ <H2 CLASS="western">6.1 - Adding new links to your blogroll</H2>
<P CLASS="western"><SPAN STYLE="font-weight: medium">Individual
blogroll items are known as <I>bookmarks</I>. </SPAN>Use the <B>Create
& Edit:Bookmarks</B> page to add, edit and delete bookmarks and
@@ -1660,7 +1680,7 @@
</UL>
<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
</P>
- <H2><B>6.2 - Adding new links to your blogroll</B></H2>
+ <H2 CLASS="western"><B>6.2 - Adding new links to your blogroll</B></H2>
<P CLASS="western" STYLE="margin-bottom: 0in">The Add/Edit bookmark
form, shown below, allows you to enter information about one
bookmark.</P>
@@ -1685,8 +1705,8 @@
<LI><P CLASS="western" STYLE="margin-bottom: 0in">Display
weight: Higher numbered bookmarks displayed bolder/larger</P>
</UL>
- <H2 STYLE="page-break-before: always">6.3 - Adding new bookmark
- folders</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">6.3 - Adding
+ new bookmark folders</H2>
<P CLASS="western">If you'd like to display a separate list of
links somewhere on your weblog, or you'd like to store links in
Roller for some other reason, you can use the Add folder form,
@@ -1732,8 +1752,8 @@
...</PRE><P CLASS="western" STYLE="margin-bottom: 0in">
<BR>
</P>
- <H2 STYLE="page-break-before: always">6.4 - Bookmark import and
- export via OPML</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">6.4 - Bookmark
+ import and export via OPML</H2>
<P CLASS="western">Roller makes it easy to import bookmarks and
build your blogroll by importing bookmarks in OPML format. XBEL
might be a better bookmarks format, but OPML is more popular in the
@@ -1781,7 +1801,7 @@
<P CLASS="western">Roller supports conventional XML-RPC weblog
update ping mechanism used by many sites for such notifications.
</P>
- <H2>7.1 - Registering with an Aggregator</H2>
+ <H2 CLASS="western">7.1 - Registering with an Aggregator</H2>
<P CLASS="western">Generally speaking, aggregation sites first
require you to register your weblog with their site. During this
registration process you normally provide both the HTTP URL and the
@@ -1795,7 +1815,7 @@
an aggregator, you can set up your weblog to deliver pings to that
site.
</P>
- <H2>7.2 - Ping Targets, Common and Custom</H2>
+ <H2 CLASS="western">7.2 - Ping Targets, Common and Custom</H2>
<P CLASS="western">You can set up the Roller server to ping sites
of your choice automatically whenever you post published updates to
your weblog.
@@ -1820,7 +1840,7 @@
wish to ping in one of the common ping targets, you can configure
your own custom ping target.
</DT></UL>
- <H2>7.3 - Setting up Automated Pings</H2>
+ <H2 CLASS="western">7.3 - Setting up Automated Pings</H2>
<P CLASS="western">Once a ping target (either a common ping target
or a custom ping target) has been configured for the site that you
wish to ping, you can use the <B>Weblog:Pings</B> page (shown
@@ -1865,7 +1885,7 @@
</P>
<P CLASS="western"><BR><BR>
</P>
- <H2>7.4 - Sending a Manual Ping</H2>
+ <H2 CLASS="western">7.4 - Sending a Manual Ping</H2>
<P CLASS="western">You can also send a manual ping to a ping target
using the <B>Send Ping Now</B> link listed for the target on the
<B>Weblog:Pings</B> page. When you send a manual ping the ping is
@@ -1883,7 +1903,7 @@
rarely, or if you are feeling a bit impatient, and you don't want
to wait for the next queue processing interval.
</P>
- <H2>7.5 - Creating and Editing Custom Ping Targets</H2>
+ <H2 CLASS="western">7.5 - Creating and Editing Custom Ping Targets</H2>
<P CLASS="western">You should find that most popular ping targets
are listed among the common ping targets and you can ping these
without needing to create a new custom one. If you don't find a
@@ -1960,8 +1980,8 @@
an error indication telling you what was wrong with your entry</P>
<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
</P>
- <H2 STYLE="page-break-before: always">7.6 - More on Registering
- with an Aggregator</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">7.6 - More on
+ Registering with an Aggregator</H2>
<P CLASS="western">When you register with an aggregator, you will
usually need to provide two pieces of information as part of the
registration, your blog's base (HTML) url and your RSS feed (XML)
@@ -2009,7 +2029,7 @@
via the <B>Global Admin->Configuration </B>page and how to
configure Roller's custom ping facility via the <B>Global
Admin->Ping Targets</B> page.</P>
- <H2>8.1 - Managing users</H2>
+ <H2 CLASS="western">8.1 - Managing users</H2>
<P CLASS="western">The <B>Global Admin->User Admin</B> page,
shown below, allows you to find users, edit users and create new
users.
@@ -2067,7 +2087,8 @@
<P CLASS="western" STYLE="margin-bottom: 0in"><B>There's one
important limitation: currently there is currently no way to
delete a user.</B></P>
- <H2 STYLE="page-break-before: always">8.2 - Configuring Roller</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">8.2 - Configuring
+ Roller</H2>
<P CLASS="western">The <B>Global Admin->Configuration</B> page
allows you to set Roller's runtime configuration properties. It
is a big page, so we will discuss each section separately below.
@@ -2120,9 +2141,9 @@
</SPAN><BR CLEAR=LEFT><BR><BR>
</P>
<UL>
- <LI><P CLASS="western"><B>Allow New Users</B>: Set this to
- enable the <I>register as new user</I> link on the main page. If
- you turnoff user creation, you'll only be able to create new
+ <LI VALUE=1><P CLASS="western"><B>Allow New Users</B>: Set this
+ to enable the <I>register as new user</I> link on the main page.
+ If you turnoff user creation, you'll only be able to create new
users via the <B>Global Admin->User Admin</B> page.</P>
</UL>
<UL>
@@ -2171,7 +2192,7 @@
<P CLASS="western" STYLE="margin-bottom: 0.08in"><BR><BR>
</P>
<UL>
- <LI><P CLASS="western" STYLE="margin-bottom: 0.08in"><B>Default
+ <LI VALUE=1><P CLASS="western" STYLE="margin-bottom: 0.08in"><B>Default
number of entries</B>: default number of entries to appear in
each newsfeed (RSS and Atom).</P>
<LI><P CLASS="western" STYLE="margin-bottom: 0.08in"><B>Maximum
@@ -2192,7 +2213,7 @@
<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
</P>
<UL>
- <LI><P CLASS="western" STYLE="margin-bottom: 0.08in"><B>Enable
+ <LI VALUE=1><P CLASS="western" STYLE="margin-bottom: 0.08in"><B>Enable
File Uploads</B>: Are users allowed to upload files?
</P>
<LI><P CLASS="western" STYLE="margin-bottom: 0.08in"><B>Allowed
@@ -2219,7 +2240,8 @@
<P CLASS="western">This section, intended for Roller
administrators, describes how Roller weblog update ping feature
works and how to configure and administer it.</P>
- <H2>9.1 - Creating and editing common ping targets</H2>
+ <H2 CLASS="western">9.1 - Creating and editing common ping
+ targets</H2>
<P CLASS="western">Common ping targets are ping targets that are
shared by all users. You can create and edit common ping targets
using the <B>Global Admin->Ping Targets</B> page.
@@ -2240,7 +2262,8 @@
<P CLASS="western">Administrators should make sure to test new
common ping targets after creating them.
</P>
- <H2>9.2 - How Roller Processes Weblog Update Pings</H2>
+ <H2 CLASS="western">9.2 - How Roller Processes Weblog Update
+ Pings</H2>
<P CLASS="western">Roller processes weblog update pings in the
background. When a user updates his or her weblog, Roller
automatically queues any required automated pings on a queue.
@@ -2267,7 +2290,8 @@
weblog <B>Preferences->Pings</B> page, as well as a failure
policy to deactivate persistently failing ping targets).
</P>
- <H2>9.3 - Configuration Properties Controlling Ping Processing</H2>
+ <H2 CLASS="western">9.3 - Configuration Properties Controlling
+ Ping Processing</H2>
<P CLASS="western">These properties control processing of the
ping queue. They are configured in the <TT><FONT FACE="Courier New">roller.properties</FONT></TT><FONT FACE="Courier New">
</FONT>file.
@@ -2304,7 +2328,7 @@
requeued and will instead be dropped from the queue. The default
value is 3. We think this value is fine for most sites. </FONT>
</DD></DL>
- <H2>
+ <H2 CLASS="western">
9.4 - Suspending all ping processing</H2>
<P CLASS="western">Administrators can suspend all ping processing
at runtime by checking the <B>Suspend ping processing?</B>
@@ -2325,7 +2349,7 @@
will never be queued and hence never sent, but pings queued
before the suspension are sent once the suspension is lifted.
</P>
- <H2>9.5 - Controlling and disabling ping usage</H2>
+ <H2 CLASS="western">9.5 - Controlling and disabling ping usage</H2>
<P CLASS="western">Since use of a ping target causes an outbound
network connection to the ping site, some administrators may not
want to allow users to create their own custom ping targets. It
@@ -2373,7 +2397,7 @@
safely disable ping queue processing (by setting the processing
interval to zero) in this situation.
</P>
- <H2>9.6 - Initialization of common ping targets</H2>
+ <H2 CLASS="western">9.6 - Initialization of common ping targets</H2>
<P CLASS="western">The initial set of common ping targets is
determined by the following configuration property.
</P>
@@ -2408,7 +2432,7 @@
create.</P>
<P CLASS="western">This section describes how to setup, configure
and run the Planet Roller aggregator.</P>
- <H2>10.1 - Setting up the Planet aggregator</H2>
+ <H2 CLASS="western">10.1 - Setting up the Planet aggregator</H2>
<P CLASS="western">Before you can configure and use the Planet
aggregator, you must set it up. Here are the steps:</P>
<P CLASS="western"><BR><BR>
@@ -2471,7 +2495,7 @@
it from cron or Windows Task Scheduler too. And again, UNIX users
can use <FONT SIZE=2 STYLE="font-size: 10pt"><FONT FACE="Courier New">rollertask.sh</FONT></FONT>
to do this.</P>
- <H2 STYLE="page-break-before: always"><A NAME="section-AdministrationGuide_120-ConfiguringPlanetRoller"></A>
+ <H2 CLASS="western" STYLE="page-break-before: always"><A NAME="section-AdministrationGuide_120-ConfiguringPlanetRoller"></A>
10.2 - Configuring Planet Roller</H2>
<P CLASS="western">If you've got Planet enabled, when you login
as a global admin you'll see a Planet Administration link on the
@@ -2528,7 +2552,7 @@
</UL>
<P CLASS="western"><BR><BR>
</P>
- <H2 STYLE="page-break-before: always"><A NAME="section-AdministrationGuide_120-AddingExternalSubscriptionsToPlanetRoller"></A>
+ <H2 CLASS="western" STYLE="page-break-before: always"><A NAME="section-AdministrationGuide_120-AddingExternalSubscriptionsToPlanetRoller"></A>
10.3 - Adding external weblogs to Planet Roller</H2>
<P CLASS="western">Planet Roller allows you to create multiple
aggregation groups each containing a different set of feeds, but
@@ -2575,8 +2599,8 @@
</P>
<P CLASS="western"><BR><BR>
</P>
- <H2 STYLE="page-break-before: always">10.4 - Adding custom groups
- to Planet Roller</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">10.4 - Adding
+ custom groups to Planet Roller</H2>
<P CLASS="western">You can also add custom aggregation groups and
Planet Roller will provide an RSS newsfeed for each group you
add. For example, if you add groups with the handles <I>music</I>
@@ -2614,8 +2638,8 @@
</P>
<P CLASS="western"><BR><BR>
</P>
- <H2 STYLE="page-break-before: always">10.5 - Using Planet Roller
- data in your weblog pages</H2>
+ <H2 CLASS="western" STYLE="page-break-before: always">10.5 - Using
+ Planet Roller data in your weblog pages</H2>
<P CLASS="western"><FONT FACE="Times New Roman">You can display
aggregations from Planet Roller in the page of your Roller
weblogs, but before you do you'll need to do some configuration
Modified: incubator/roller/trunk/docs/userguide/generated/roller-user-guide.pdf
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/userguide/generated/roller-user-guide.pdf?view=diff&rev=447512&r1=447511&r2=447512
==============================================================================
Binary files - no diff available.
Modified: incubator/roller/trunk/docs/userguide/roller-user-guide.odt
URL: http://svn.apache.org/viewvc/incubator/roller/trunk/docs/userguide/roller-user-guide.odt?view=diff&rev=447512&r1=447511&r2=447512
==============================================================================
Binary files - no diff available.