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 2011/05/17 02:43:04 UTC
svn commit: r1103964 [4/5] - in /roller/trunk/weblogger-docs: templateguide/
templateguide/generated/ templateguide/generated/html/ userguide/
userguide/generated/ userguide/generated/html/
Modified: roller/trunk/weblogger-docs/userguide/generated/html/roller-user-guide.html
URL: http://svn.apache.org/viewvc/roller/trunk/weblogger-docs/userguide/generated/html/roller-user-guide.html?rev=1103964&r1=1103963&r2=1103964&view=diff
==============================================================================
--- roller/trunk/weblogger-docs/userguide/generated/html/roller-user-guide.html (original)
+++ roller/trunk/weblogger-docs/userguide/generated/html/roller-user-guide.html Tue May 17 00:43:04 2011
@@ -1,3035 +1,213 @@
-<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">
-<HTML>
-<HEAD>
- <META HTTP-EQUIV="CONTENT-TYPE" CONTENT="text/html; charset=utf-8">
- <TITLE></TITLE>
- <META NAME="GENERATOR" CONTENT="OpenOffice.org 3.1 (Unix)">
- <META NAME="AUTHOR" CONTENT="Dave Johnson">
- <META NAME="CREATED" CONTENT="20070705;10044400">
- <META NAME="CHANGED" CONTENT="20091023;22353900">
- <META NAME="Info 1" CONTENT="">
- <META NAME="Info 2" CONTENT="">
- <META NAME="Info 3" CONTENT="">
- <META NAME="Info 4" CONTENT="">
- <STYLE TYPE="text/css">
- <!--
- @page { margin: 0.5in }
- P { margin-bottom: 0.06in; widows: 2; orphans: 2 }
- P.western { font-family: "Times New Roman", serif }
- H1 { margin-bottom: 0.08in; border-top: none; border-bottom: 2.50pt solid #000000; border-left: none; border-right: none; padding: 0in; widows: 2; orphans: 2; page-break-before: always }
- H1.western { font-family: "Helvetica", sans-serif; font-size: 22pt; font-style: italic }
- H1.cjk { font-family: "Mincho"; font-size: 16pt }
- H1.ctl { font-family: "Lucidasans"; font-size: 16pt }
- H2 { margin-bottom: 0.08in; widows: 2; orphans: 2 }
- H2.western { font-family: "Helvetica", sans-serif; font-style: italic }
- H2.cjk { font-family: "Mincho"; font-size: 14pt; font-style: italic }
- H2.ctl { font-family: "Lucidasans"; font-size: 14pt; font-style: italic }
- H3 { margin-bottom: 0.08in; widows: 2; orphans: 2 }
- H3.western { font-family: "Helvetica", sans-serif; font-size: 16pt }
- H3.cjk { font-family: "Mincho" }
- H3.ctl { font-family: "Lucidasans" }
- TD P { margin-bottom: 0in; widows: 2; orphans: 2 }
- TD P.western { font-family: "Times New Roman", serif }
- TH P { margin-bottom: 0in; border-top: none; border-bottom: 2.50pt solid #000000; border-left: none; border-right: none; padding: 0in; widows: 2; orphans: 2 }
- TH P.western { font-family: "Helvetica", sans-serif; font-style: oblique }
- TH P.cjk { font-style: italic }
- TH P.ctl { font-style: italic }
- PRE { font-family: "Cumberland", monospace; widows: 2; orphans: 2 }
- DD { widows: 2; orphans: 2 }
- DD.western { font-family: "Times New Roman", serif }
- DT { widows: 2; orphans: 2 }
- DT.western { font-family: "Times New Roman", serif }
- A:visited { so-language: en-US }
- TT { font-family: "Cumberland", monospace }
- -->
- </STYLE>
-</HEAD>
-<BODY LANG="en-US" DIR="LTR">
-<P CLASS="western" ALIGN=RIGHT STYLE="margin-bottom: 0in; background: transparent">
-<IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_490f4977.png" NAME="graphics1" ALIGN=BOTTOM WIDTH=252 HEIGHT=102 BORDER=0></P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=RIGHT STYLE="margin-bottom: 0in; background: transparent">
- <FONT FACE="Helvetica, sans-serif"><FONT SIZE=7><B>User Guide</B></FONT></FONT></P>
-<P CLASS="western" ALIGN=RIGHT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<FONT FACE="Helvetica, sans-serif"><FONT SIZE=4 STYLE="font-size: 16pt"><B>Apache
-Roller Weblogger </B></FONT></FONT>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<FONT FACE="Helvetica, sans-serif"><FONT SIZE=4 STYLE="font-size: 16pt"><B>Version
-5.0</B></FONT></FONT></P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<SDFIELD TYPE=DOCINFO SUBTYPE=CHANGE FORMAT=DATE SDNUM="1033;1033;MMMM YYYY">October 2009</SDFIELD></P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" STYLE="page-break-before: always"><FONT FACE="Helvetica, sans-serif"><FONT SIZE=6 STYLE="font-size: 22pt"><B>Table
-of Contents</B></FONT></FONT></P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<DIV ID="Table of Contents1" DIR="LTR">
- <DIV ID="Table of Contents1_Head" DIR="LTR">
- <P STYLE="margin-top: 0.17in; margin-bottom: 0.08in; page-break-after: avoid">
- <FONT FACE="Helvetica, sans-serif"><FONT SIZE=4 STYLE="font-size: 16pt"><B>Table
- of Contents</B></FONT></FONT></P>
- </DIV>
- <P STYLE="margin-bottom: 0in; page-break-before: auto"> <FONT SIZE=3><B>1
- Overview 4</B></FONT></P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 1.1 Copyright and
- trademark information 4</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 1.2 Feedback 4</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 1.3
- Acknowledgments 4</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 1.4 Modifications
- and Updates 4</P>
- <P STYLE="margin-bottom: 0in; page-break-before: auto"> <FONT SIZE=3><B>2
- Introduction 5</B></FONT></P>
- <P STYLE="margin-bottom: 0in; page-break-before: auto"> <FONT SIZE=3><B>3
- Getting started with Roller 6</B></FONT></P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 3.1 Getting
- started with a new Roller installation 6</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 3.2 Creating a
- new user and weblog 7</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 3.3 Getting
- around in Roller 9</P>
- <P STYLE="margin-bottom: 0in; page-break-before: auto"> <FONT SIZE=3><B>4
- Creating and editing your weblog 10</B></FONT></P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 4.1 Creating and
- editing a weblog entry 11</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 4.1.1 Weblog
- editor fields 12</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 4.1.2 Weblog
- editor buttons 12</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 4.1.3 Weblog
- editor plugin settings 13</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 4.1.4 Weblog
- editor advanced settings 13</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 4.2 Finding and
- editing weblog entries 14</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 4.3 Managing
- categories 15</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 4.4 Managing your
- weblog's blogroll 16</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 4.5 Uploading
- images and other files to your weblog 17</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 4.5.1 How to
- upload files 18</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 4.5.2 How to
- edit and update files 20</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 4.5.3 How to use
- Media File Directories 21</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 4.5.4 How to
- delete Media Files 21</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 4.5.5 How to
- delete Media File Directories 21</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 4.5.6 How to
- post images to your weblog 21</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 4.5.7 How to
- post a podcast to your weblog 21</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 4.6 Podcasting
- with Roller 22</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 4.6.1 How to
- create a podcast feed with Roller 22</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 4.7 Using a
- weblog client with Roller 23</P>
- <P STYLE="margin-bottom: 0in; page-break-before: auto"> <FONT SIZE=3><B>5
- Working with comments and trackbacks 24</B></FONT></P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 5.1 Comment
- notification via email 24</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 5.2 Comment
- management 24</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 5.3 Comment
- moderation 25</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 5.4 Global
- comment management 25</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 5.5 Preventing
- weblog spam 26</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 5.6 Sending
- trackbacks 27</P>
- <P STYLE="margin-bottom: 0in; page-break-before: auto"> <FONT SIZE=3><B>6
- Choosing your weblog theme 28</B></FONT></P>
- <P STYLE="margin-bottom: 0in; page-break-before: auto"> <FONT SIZE=3><B>7
- Managing your weblog preferences 29</B></FONT></P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 7.1 Weblog
- settings 29</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 7.1.1 General
- settings 29</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 7.1.2
- Internationalization Settings 30</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 7.1.3 Comments
- and default comment settings 30</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 7.1.4 Weblog
- client API 31</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 7.1.5 Formatting
- 31</P>
- <P STYLE="margin-left: 0.39in; margin-bottom: 0in"> 7.1.6 Spam
- prevention 32</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 7.2 Weblog
- members: managing a group blog 33</P>
- <P STYLE="margin-bottom: 0in; page-break-before: auto"> <FONT SIZE=3><B>8
- Using weblog pings 35</B></FONT></P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 8.1 Registering
- with an Aggregator 35</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 8.2 Ping Targets,
- Common and Custom 35</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 8.3 Setting up
- Automated Pings 35</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 8.4 Sending a
- Manual Ping 37</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 8.5 Creating and
- Editing Custom Ping Targets 37</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 8.6 More on
- Registering with an Aggregator 39</P>
- <P STYLE="margin-bottom: 0in; page-break-before: auto"> <FONT SIZE=3><B>9
- Roller administration 40</B></FONT></P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 9.1 Managing
- users 40</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 9.2 Configuring
- Roller 42</P>
- <P STYLE="margin-bottom: 0in; page-break-before: auto"> <FONT SIZE=3><B>10
- Weblog update ping administration 45</B></FONT></P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 10.1 Creating and
- editing common ping targets 45</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 10.2 How Roller
- Processes Weblog Update Pings 45</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 10.3
- Configuration Properties Controlling Ping Processing 46</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 10.4 Suspending
- all ping processing 46</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 10.5 Controlling
- and disabling ping usage 46</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 10.6
- Initialization of common ping targets 47</P>
- <P STYLE="margin-bottom: 0in; page-break-before: auto"> <FONT SIZE=3><B>11
- Weblog Export 48</B></FONT></P>
- <P STYLE="margin-bottom: 0in; page-break-before: auto"> <FONT SIZE=3><B>12
- Planet Roller administration 49</B></FONT></P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 12.1 Configuring
- Planet Roller 49</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 12.2 Adding
- external weblogs to Planet Roller 51</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"> 12.3 Adding
- custom groups to Planet Roller 52</P>
- <P STYLE="margin-bottom: 0in; page-break-before: auto"> <FONT SIZE=3><B>13
- Apache Software License, Version 2.0 53</B></FONT></P>
-</DIV>
-<P CLASS="western"><BR><BR>
-</P>
-<H1 CLASS="western" STYLE="page-break-before: always"> 1 Overview</H1>
-<P CLASS="western">This document is a user guide to the Apache Roller
-Weblogger, the Java-based and open source weblog server that is
-produced by the Apache Roller project of the Apache Software
-Foundation.
-</P>
-<P CLASS="western">There are separate guides available on other
-topics; an Template Guide for those who wish to customize the layout
-and design of their weblog pages and an Installation Guide for those
-installing the Roller software on a web server.</P>
-<H2 CLASS="western"> 1.1 Copyright and trademark information</H2>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-The contents of this document are subject to the terms of the Apache
-Software License.</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-All trademarks within this document belong to legitimate owners.</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<H2 CLASS="western"> 1.2 Feedback</H2>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-Please direct any comments or suggestions about this document to:
-dev@roller.apache.org</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<H2 CLASS="western"> 1.3 Acknowledgments</H2>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-The general format of this document was based on the documentation
-template used by OpenOffice.org.</P>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<H2 CLASS="western"> 1.4 Modifications and Updates</H2>
-<DIV ALIGN=RIGHT>
- <TABLE WIDTH=861 BORDER=1 BORDERCOLOR="#000000" CELLPADDING=4 CELLSPACING=0 RULES=COLS STYLE="page-break-inside: avoid">
- <COL WIDTH=189>
- <COL WIDTH=655>
- <TBODY>
- <TR VALIGN=TOP>
- <TH WIDTH=189>
- <P CLASS="western" ALIGN=LEFT>Date</P>
- </TH>
- <TH WIDTH=655>
- <P CLASS="western" ALIGN=LEFT>Description of Change</P>
- </TH>
- </TR>
- <TR VALIGN=TOP>
- <TD WIDTH=189 SDVAL="39305" SDNUM="1033;0;MM/DD/YY">
- <P CLASS="western" ALIGN=LEFT>08/11/07</P>
- </TD>
- <TD WIDTH=655>
- <P CLASS="western" ALIGN=LEFT>Rewrites and updates for Roller
- 4.0, Dave Johnson</P>
- </TD>
- </TR>
- </TBODY>
- <TBODY>
- <TR VALIGN=TOP>
- <TD WIDTH=189 SDVAL="39268" SDNUM="1033;0;MM/DD/YY">
- <P CLASS="western" ALIGN=LEFT>07/05/07</P>
- </TD>
- <TD WIDTH=655>
- <P CLASS="western" ALIGN=LEFT>New format/layout, Dave Johnson</P>
- </TD>
- </TR>
- </TBODY>
- <TBODY>
- <TR VALIGN=TOP>
- <TD WIDTH=189 SDVAL="39294" SDNUM="1033;0;MM/DD/YY">
- <P CLASS="western" ALIGN=LEFT>07/31/07</P>
- </TD>
- <TD WIDTH=655>
- <P CLASS="western" ALIGN=LEFT>Roller 4.0 updates from Linda
- Skrocki</P>
- </TD>
- </TR>
- </TBODY>
- <TBODY>
- <TR VALIGN=TOP>
- <TD WIDTH=189 SDVAL="39805" SDNUM="1033;0;MM/DD/YY">
- <P CLASS="western" ALIGN=LEFT>12/23/08</P>
- </TD>
- <TD WIDTH=655>
- <P CLASS="western" ALIGN=LEFT>Notes on how email addresses are
- used</P>
- </TD>
- </TR>
- </TBODY>
- </TABLE>
-</DIV>
-<P CLASS="western" ALIGN=LEFT STYLE="margin-bottom: 0in; background: transparent">
-<BR>
-</P>
-<H1 CLASS="western" STYLE="page-break-before: always"> 2 Introduction</H1>
-<P CLASS="western">This user guide describes how to use the Apache
-Roller Weblogger or Roller for short, a web application that can
-support a single user weblog, thousands of weblogs and/or group
-weblogs.
-</P>
-<P CLASS="western">You'll learn how to register as a new user. You'll
-learn how to create one or more weblogs for yourself or a group of
-your friends. You'll learn how to create, edit and post weblog
-entries. We will also cover more advanced topics such as adjusting
-your weblog's settings, how to customize your blogroller, how to
-manage weblog pings and more.</P>
-<P CLASS="western">First, let's get some terminology out of the way
-because there's a lot of jargon in weblogging. Here's a list of some
-of the terms we use in this manual without a whole lot of background.</P>
-<UL>
- <LI><P CLASS="western"><SPAN STYLE="background: transparent"><B>Weblog</B>:
- A set of web pages and RSS/Atom feeds that display weblog entries
- written by one or more authors, uploaded images, bookmarks and
- comments posted by visitors. Weblog entries are displayed on the
- main page of the weblog and in the weblog's feeds in reverse
- chronological order.</SPAN></P>
- <LI><P CLASS="western"><SPAN STYLE="background: transparent"><B>Weblog
- entry</B>. A single weblog entry with a title, publication
- timestamp, summary, content and some settings <SPAN STYLE="font-weight: normal">that
- indicate if and when comments are allowed.</SPAN></SPAN></P>
- <LI><P CLASS="western" STYLE="font-weight: normal"><SPAN STYLE="background: transparent"><B>Comment</B>.
- A comment posted by a visitor to a weblog and regarding one specific
- weblog post. A comment has an email address, a publication timestamp
- and some content.</SPAN></P>
- <LI><P CLASS="western" STYLE="font-weight: normal"><SPAN STYLE="background: transparent"><B>Trackback</B>.
- A comment posted by a remote weblog regarding one specific weblog
- post. Trackbacks are stored as comments by Roller. </SPAN>
- </P>
- <LI><P CLASS="western" STYLE="font-weight: normal"><SPAN STYLE="background: transparent"><B>Templates</B>.
- Each Roller weblog is defined by a set of HTML and CSS templates
- that provide the layout and styles for the weblog. Normally
- templates are authored using Velocity template language, but other
- languages are possible via plugins (i.e. Groovy Server Pages, JRuby,
- etc.)</SPAN></P>
- <LI><P CLASS="western" STYLE="font-weight: normal"><SPAN STYLE="background: transparent"><B>Feed</B>.
- A feed is an XML representation of the most recent entries, comments
- or other data. Folks can subscribe to your feed to be alerted of new
- weblog entries and comments posted. Roller supports both RSS and
- Atom formats for feeds.</SPAN></P>
- <LI><P CLASS="western" STYLE="font-weight: normal"><SPAN STYLE="background: transparent"><B>Feed
- reader</B>. Software that makes it easy to subscribe to and read
- feeds, e.g. Google Reader, Net News Wire, Feed Demon, etc.</SPAN></P>
- <LI><P CLASS="western" STYLE="font-weight: normal"><SPAN STYLE="background: transparent"><B>Blog
- client</B>. Software that makes it easy to post to your weblog, e.g.
- Ecto and Mars Edit.</SPAN></P>
-</UL>
-<P CLASS="western" STYLE="font-weight: normal"><BR><BR>
-</P>
-<P CLASS="western" STYLE="font-weight: normal"><SPAN STYLE="background: transparent">With
-that out of the way, let's get started blogging with Roller. </SPAN>
-</P>
-<P CLASS="western"><BR><BR>
-</P>
-<H1 CLASS="western"> 3 Getting started with Roller</H1>
-<P CLASS="western">Getting started with Roller means different things
-to different people. If you are using an existing Roller server, then
-getting started means registering a new user and creating or joining
-a weblog. If that's the case for you, skip ahead to section 3.2. If
-you just finished setting up your own Roller installation on your own
-web server, then getting started means a little bit more. You've got
-a little post installation work to do.</P>
-<H2 CLASS="western"> 3.1 Getting started with a new Roller
-installation</H2>
-<P CLASS="western">Once you've got Roller up and running you will see
-a screen like the one below, which explains exactly what you've got
-to do to get started with Roller. First, create a new user so you can
-login. Second, login and create a weblog for yourself or one to
-server as the front page of the site or both. Third, designate which
-weblog is the front page weblog.
-</P>
-<P CLASS="western"><SPAN ID="Frame32" DIR="LTR" STYLE="float: left; width: 5.86in; height: 4.03in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><FONT SIZE=2><I>Illustration
- 1: Welcome to Roller</I></FONT></P>
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_mdec3cbf.png" NAME="graphics30" ALIGN=LEFT WIDTH=674 HEIGHT=486 BORDER=0><BR CLEAR=LEFT><BR><BR>
- </P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western"><B>Creating the first user. </B>Your first step is
-to create a new user. Remember, the first user you create will be
-given administrative privileges. You might want to use the username
-"admin" or something similar. Later, you can login as the
-admin user when you need to change site-wide settings. If you wish,
-you can grant other users admin privileges so they can help out with
-admin duties. Let's take a look at the user registration page. You
-can see the new user registration form in the next section.</P>
-<P CLASS="western"><B>Create the first weblog(s). </B>Next you should
-create at least one weblog. See section 3.2 below for some more
-information the create weblog page. If you are running a personal
-blog site, then you might want your weblog to serve as the front page
-of your site. In that case, create a weblog, use a normal weblog
-theme (i.e. not the Roller Homepage theme) and assign your weblog as
-the front page weblog of the site.</P>
-<P CLASS="western">If you are running a community weblog site with
-multiple weblogs, then you will probably want to create a weblog to
-serve as the front page of the site. Create a new weblog, name it
-"main" or "community" or something suitable
-because its name will appear in URLs. And we recommend that you use
-the Roller Homepage theme because it is specially designed to serve
-as a weblog community front page, aggregating all of the site's
-weblogs together but having no content of its own.</P>
-<P CLASS="western"><B>Designate a front page weblog. </B>Once you've
-created a front page weblog, whether it be a personal weblog or a
-community aggregator, you need to tell Roller. So, select your front
-page weblog and, if you are running a community site then set the
-<I>Enable aggregated site-wide frontpage</I> checkbox before you
-click Save.</P>
-<P CLASS="western">If you've read this far, you've probably created
-your own user and weblog and if so you can skip the next section.</P>
-<H2 CLASS="western"> 3.2 Creating a new user and weblog
-</H2>
-<P CLASS="western">To create a new user use the Register link, which
-can be found in the top right of the Roller login page. That link
-will take you to the New User Registration page shown below.</P>
-<P CLASS="western"><SPAN ID="Frame19" DIR="LTR" STYLE="float: left; width: 6.49in; height: 3.34in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><FONT SIZE=2><I>Illustration
- 2: New User Registration page</I></FONT></P>
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m6539e1c1.png" NAME="graphics31" ALIGN=LEFT WIDTH=747 HEIGHT=663 BORDER=0><BR CLEAR=LEFT><BR><BR>
- </P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western">The New User Registration form is pretty
-self-explanatory, but keep in mind that your username cannot be
-changed; it is your unique identifier in the system. But that's OK
-because your screen name is the name that will be displayed on your
-weblog and in your feeds and you <I>can</I> change it later if you
-wish.</P>
-<P CLASS="western" STYLE="font-weight: normal"><B>Picking your
-language and timezone. </B>You can set your language of choice and
-timezone too, but these values don't do much in Roller. The locale
-and timezone of your weblog are really what matter. The values you
-set here will be used as your defaults when you create your weblog.</P>
-<P CLASS="western"><SPAN STYLE="background: transparent"><B>Creating
-a weblog . </B>Once you've created a user, then log in and you'll see
-the Roller Main Menu page and a greeting that reads:</SPAN></P>
-<P CLASS="western"><I> You've got a user account, but no weblog.
-Would you lik<SPAN STYLE="font-weight: normal">e to </SPAN><FONT COLOR="#0000ff"><U><SPAN STYLE="font-weight: normal">create
-one</SPAN></U></FONT><SPAN STYLE="font-weight: normal">?</SPAN></I></P>
-<P CLASS="western"><SPAN ID="Frame5" DIR="LTR" STYLE="float: left; width: 6.88in; height: 5.72in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m2e6ae159.png" NAME="graphics37" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 3: Create Weblog page</I></FONT></P>
-</SPAN><BR CLEAR=LEFT>Follow that link to create your first weblog.
-You'll see the form below.
-</P>
-<P CLASS="western"><BR><BR>
-</P>
-<P CLASS="western">The form is designed to be self-explanatory. Note
-that you can change everything later, except for the weblog handle,
-which is the unique identifier for your weblog.
-</P>
-<P CLASS="western">Now that you've got a user and a weblog, let's
-discuss how to get around in the Roller interface.</P>
-<P CLASS="western" STYLE="page-break-before: always"><BR><BR>
-</P>
-<H2 CLASS="western"> 3.3 Getting around in Roller</H2>
-<P CLASS="western">Once you've logged into Roller's editor pages you
-should be able to find your way around using Roller's tabbed menu. To
-provide a little extra assistance, Roller displays a status bar at
-the top of each editor page.</P>
-<P CLASS="western">For example, the status bar below indicates that
-you are logged in as user 'admin' and you are not editing a weblog.
-You can go directly to the front page of the site by clicking the
-first link on the right (it might not be labelled Front Page on your
-site), to the main menu with the second link and you can log out
-entirely by using the Logout.</P>
-<P CLASS="western"><SPAN ID="Frame2" DIR="LTR" STYLE="float: left; width: 6.78in; height: 0.43in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_49cf29d3.png" NAME="graphics12" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 4: Status bar, no weblog</I></FONT></P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western">For example, the status bar below indicates that
-you are logged in as user 'admin' and you are editing a weblog with
-the handle 'adminblog'.</P>
-<P CLASS="western"><SPAN ID="Frame3" DIR="LTR" STYLE="float: left; width: 6.78in; height: 0.44in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m5de7cd4f.png" NAME="graphics4" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 5: Status bar within weblog</I></FONT></P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western"><BR><BR>
-</P>
-<P CLASS="western">If you are not logged into Roller then you can
-either access the login link directly or use a Login link from one of
-the weblogs on the site. The login link is of this form:</P>
-<P CLASS="western" STYLE="font-weight: normal"> <FONT COLOR="#0000ff"><U>http://hostname/roller-ui/login-redirect.rol</U></FONT></P>
-<P CLASS="western">Or this form if Roller is installed under its own
-context:</P>
-<P CLASS="western"><FONT COLOR="#0000ff"> <U>http://hostname/roller/roller-ui/login-redirect.rol</U></FONT></P>
-<P CLASS="western">You probably won't need to cut-and-paste that link
-because most weblogs display an author menu like so:</P>
-<P CLASS="western">
-</P>
-<P CLASS="western"><SPAN ID="Frame4" DIR="LTR" STYLE="float: left; width: 2.16in; height: 1.47in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_15f7407e.png" NAME="graphics5" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 6: Weblog navigation bar</I></FONT></P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western">Now that we've covered the basics of registering a
-new user, creating a new weblog and finding your way around let's
-start blogging.
-</P>
-<H1 CLASS="western" STYLE="page-break-before: always"> 4 Creating and
-editing your weblog</H1>
-<P CLASS="western">First, you log in to Roller. What happens next
-depends on the number of weblogs that you have. If you have one
-weblog, you'll be taken directly to the <B>New Entry</B> page for
-that weblog.
-</P>
-<P CLASS="western">If you have more than one weblog or none at all,
-then you'll be taken to the <B>Main Menu</B> page, shown below, so
-you can pick which weblog to edit and/or create new weblogs.
-</P>
-<P CLASS="western"><SPAN ID="Frame6" DIR="LTR" STYLE="float: left; width: 7.23in; height: 4.17in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m7b2a25db.png" NAME="graphics6" ALIGN=LEFT WIDTH=805 HEIGHT=422 BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 7: Main menu</I></FONT></P>
-</SPAN><BR CLEAR=LEFT>The main menu page lists all of your weblogs
-and for each, shows you links to its New Entry, Entries, Comments,
-Theme and Settings pages. You can also create a new weblog, edit your
-user profile.
-</P>
-<P CLASS="western">If you are logged in as a Global Administrator,
-you will also see a Server Admin link in the actions side-bar. And if
-you have Roller's Planet aggregator enabled, then you will also see a
-Planet Admin link there as well.</P>
-<H2 CLASS="western" STYLE="page-break-before: always"> 4.1 Creating
-and editing a weblog entry</H2>
-<P CLASS="western">Use the <B>Create & Edit -> New Entry</B>
-page (also known as the Weblog editor page) to create, edit and
-publish weblog entries. Using this page, shown below in illustration
-7, you can set entry title, category, content and summary. You can
-also set some advanced settings by expanding the <I>Plugins To Apply</I>
-and <I>Advanced Settings</I> controls at the bottom of the page.
-Let's review those fields, buttons and settings.</P>
-<P CLASS="western"><SPAN ID="Frame7" DIR="LTR" STYLE="float: left; width: 6.71in; height: 7.54in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><FONT SIZE=2><I>Illustration
- 8: Weblog editor</I></FONT></P>
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m323d553.png" NAME="graphics8" ALIGN=LEFT WIDTH=651 HEIGHT=886 BORDER=0><BR CLEAR=LEFT><BR><BR>
- </P>
-</SPAN><BR CLEAR=LEFT>
-</P>
-<H3 CLASS="western"> 4.1.1 Weblog editor fields</H3>
-<P CLASS="western">Let's discuss each of the fields on the New Entry
-page, so you know how to use them.</P>
-<UL>
- <LI><P CLASS="western"><B>Title</B> â Each weblog entry must have
- a title. Be careful when you pick your title, it will be used in the
- link to your weblog entry. For best results, <I>do</I> use titles
- that are short and to-the-point. <I>Don't </I>include any HTML in
- your titles, just plain text â if you want your titles to be bold,
- then customize your templates instead of embedding HTML in your
- titles.</P>
- <LI><P CLASS="western"><B>Status</B> â This read-only field tells
- you about the current state of the weblog entry that you are
- editing. There are three possible status settings:</P>
-</UL>
-<UL>
- <LI><P CLASS="western"><I>Not Saved</I> â the entry has never been
- saved</P>
- <LI><P CLASS="western"><I>Draft</I> â the entry is saved as a
- draft and is not yet visible to your weblog's readers</P>
- <LI><P CLASS="western"><I>Published</I> â the entry has been
- published and is visible to your weblog's readers</P>
- <LI><P CLASS="western"><B>Permalink</B> â this read-only field is
- the permalink link to your weblog entry. It is set the first time
- that you save an entry, based on the title at the time you save â
- and it cannot be changed later.</P>
- <LI><P CLASS="western"><B>Category</B> â You can pick one category
- for your weblog entry. Categories are for folks who want to
- organized the entries in their weblog into a small-set of fixed and
- possible hierarchical categories, defined by the weblog admin
- (that's probably you). You can add and remove categories via the
- Categories page.</P>
- <LI><P CLASS="western"><B>Tags</B> â (optional) In addition to
- assigning each of your weblog entries to a category you can also tag
- them. You can assign a list of tags to each entry. You can use any
- tag name you want. Separate your tags with spaces. Currently, the
- only way to do multi-word tags is to use an underbar, for example to
- tag something with "apache roller" you would use the tag
- apache_roller. As you type, Roller may suggest tags that you've used
- before.</P>
- <LI><P CLASS="western"><B>Content</B> â This is the main body of
- your weblog entry, in HTML format. We try to make that easy by
- providing two ways to edit the content. Via the Settings page, you
- can pick either of these:</P>
- <LI><P CLASS="western"><B>Rich Text Editor (Xinha) </B>â a
- rich-text editor that's designed to make editing HTML as easy as
- using MS Word or Open Office.</P>
- <LI><P CLASS="western"><B>Text Editor </B>â a plain-text editor
- that you can use to edit the raw HTML markup of your weblog entries.
- Don't use this unless you know HTML.</P>
- <LI><P CLASS="western"><B>Summary</B> â (optional) If you wish,
- you can enter a short summary of your weblog post. If you do so,
- then the short summary will be displayed on the main page of your
- weblog and your readers will have to click a Read More link to get
- to the full-content. Some bloggers like to do this when they have
- very long post and they don't want that long post to dominate the
- main page of their weblog.</P>
-</UL>
-<H3 CLASS="western"> 4.1.2 Weblog editor buttons</H3>
-<P CLASS="western">Here's a guide to the buttons that appear on the
-Weblog editor page.</P>
-<UL>
- <LI><P CLASS="western"><B>Post to weblog</B> â Using this button
- will publish your weblog entry and make it visible to the world.
- Make sure you're happy with your post before you publish because
- once something is published on the web, and grabbed by the blog
- aggregators and search engines, <I>there's really no way to
- un-publish</I> it.
- </P>
- <LI><P CLASS="western"><B>Submit for review </B>â if you're just a
- limited blogger, you won't see the Post to weblog button because you
- cannot post to the web. Instead, you'll see a Submit for review
- button which you can use to send your entry to the author/admin of
- the blog that you are working in. If they like the post, they can
- publish it â or they can return it to you for further edits.</P>
- <LI><P CLASS="western"><B>Save as draft </B>â this will save your
- weblog post for later editing, but will <I>not</I> publish it to the
- web. When you're working on a new weblog entry, use Save as draft
- often so you won't lose your post in the event of internet
- connection loss or session time-out.</P>
- <LI><P CLASS="western"><B>Delete entry </B>â use this to delete
- the current weblog entry, you'll be asked to confirm.</P>
- <LI><P CLASS="western"><B>Full preview</B> â You won't see this
- button until you've saved your entry as a draft. It allows you to
- view, in a separate window, a preview of your entry, displayed using
- the layout and style of your blog.
- </P>
-</UL>
-<H3 CLASS="western"> 4.1.3 Weblog editor plugin settings</H3>
-<P CLASS="western">If you expand the <I>Plugins to Apply</I> control,
-you'll see a set of check-boxes, one for each Weblog Entry Plugin
-that is available. Check the ones that you'd like to apply to your
-current weblog entry. If you have a favorite plugin, one that you
-want to use on every entry, then you can set it as a default on your
-weblog's Settings page.</P>
-<H3 CLASS="western"> 4.1.4 <IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_34fae829.png" NAME="graphics25" ALIGN=LEFT WIDTH=690 HEIGHT=125 BORDER=0><BR CLEAR=LEFT>Weblog
-editor advanced settings</H3>
-<P CLASS="western">If you expand the <I>Advanced Settings</I>
-control, you'll see what's below.</P>
-<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m4a8a2aa0.png" NAME="graphics26" ALIGN=LEFT WIDTH=690 HEIGHT=212 BORDER=0><BR CLEAR=LEFT>All
-of these are optional settings.</P>
-<UL>
- <LI><P CLASS="western"><B>Pub Time</B> â if you'd like to set the
- publication time of your weblog entry to a specific time, possibly
- one in the future, you can do so here.
- </P>
- <LI><P CLASS="western"><B>Allow comments for </B>â this setting
- allows you to turn comments on/off for your weblog entry and to
- limit the number of days that comments are allowed.</P>
- <LI><P CLASS="western"><B>Text reads left-to-right </B>â this
- settings allows you to set the reads left-to-right flag for a weblog
- entry. Currently, none of the stock Roller templates respect this
- setting.</P>
- <LI><P CLASS="western"><B>Pinned to main</B><SPAN STYLE="font-weight: normal">
- â only Global Administrators will see this setting. It's a way to
- indicate that a post is a </SPAN><I><SPAN STYLE="font-weight: normal">special
- announcement </SPAN></I><SPAN STYLE="font-weight: normal">that
- should be pinned to the top of the front-page of a weblog site. The
- front-page theme respects this setting).</SPAN></P>
- <LI><P CLASS="western" STYLE="font-weight: normal"><B>Enclosure URL</B>:
- if you'd like to include a audio, video or image file as a p<I>odcast</I>
- in your weblog's RSS feed, then enter the URL of that file here.</P>
-</UL>
-<P CLASS="western"><BR><BR>
-</P>
-<H2 CLASS="western" STYLE="page-break-before: always"> 4.2 Finding
-and editing weblog entries</H2>
-<P CLASS="western">All of your weblog entries are saved in a
-database. Once your entries scroll off the front page or off the
-recent entries list of the weblog editor page, they are still
-available via next and previous links displayed on your weblog and
-via the weblog calendar that is included in most weblog themes.</P>
-<P CLASS="western">You can also access your entries via the Edit
-Entries page, which allows you to search entries via keyword,
-category, tags, date and status.</P>
-<P CLASS="western"><SPAN ID="Frame28" DIR="LTR" STYLE="float: left; width: 6.61in; height: 4.85in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_86e10f.png" NAME="graphics7" ALIGN=LEFT WIDTH=708 HEIGHT=520 BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 9: Edit entries page</I></FONT></P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western" STYLE="page-break-before: always"><BR><BR>
-</P>
-<H2 CLASS="western"> 4.3 Managing categories</H2>
-<P CLASS="western">Each weblog can define its own unique list of
-categories to be used for categorizing weblog entries, using the
-Categories page shown below. When you or another author of your
-weblog creates a new entry you <I>must</I> choose one of the
-categories you have defined.
-</P>
-<P CLASS="western"><SPAN ID="Frame36" DIR="LTR" STYLE="float: left; width: 5.78in; height: 4.43in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_66ea625.png" NAME="graphics10" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 10: Categories page </I></FONT>
- </P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western">You can use the Categories page to add new
-categories and to edit your existing ones. You can change category
-names if you wish. And you can also delete categories and if a
-category is in use you will be asked to re-categorize the entries in
-that category.
-</P>
-<P CLASS="western">You can also define a hierarchy of categories and
-move categories around in that hierarchy, but support for
-hierarchical categories is somewhat limited in most Roller themes.
-Unless you are prepared to do some customization via template
-editing, you probably don't want to use hierarchical categories.</P>
-<H2 CLASS="western" STYLE="page-break-before: always"> 4.4 Managing
-your weblog's blogroll</H2>
-<P CLASS="western">Roller makes it easy to maintain a <I>blogroll</I>,
-that is, a list of your favorite weblogs and web sites that is
-displayed in the sidebar of your weblog. <SPAN STYLE="font-weight: normal">Individual
-blogroll items are known as </SPAN><I><SPAN STYLE="font-weight: normal">bookmarks</SPAN></I><SPAN STYLE="font-weight: normal">.
-</SPAN>Use the <B>Create & Edit:Bookmarks</B> page to add, edit
-and delete bookmarks and bookmark folders in your blogroll.
-</P>
-<P CLASS="western"><SPAN ID="Frame20" DIR="LTR" STYLE="float: left; width: 5.73in; height: 5.07in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m5de8b252.png" NAME="graphics33" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 11: Bookmarks management page</I></FONT></P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western"><BR><BR>
-</P>
-<H2 CLASS="western" STYLE="page-break-before: always"> 4.5 Uploading
-images and other files to your weblog
-</H2>
-<P CLASS="western">If you'd like to upload images or other files for
-use in your weblog, go to your weblog's <B>Create & Edit ->
-Media Files</B> page. From there you can upload files, browse and
-search files. You can also manage your files, organize them into
-directories and post them to your weblog.</P>
-<P CLASS="western"><BR><BR>
-</P>
-<P CLASS="western"><SPAN ID="Frame18" DIR="LTR" STYLE="float: left; width: 7.5in; height: 3.86in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><FONT SIZE=2><I>Illustration
- 12: Media File View page</I></FONT></P>
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m3b545805.png" NAME="graphics27" ALIGN=LEFT WIDTH=863 HEIGHT=516 BORDER=0><BR CLEAR=LEFT><BR><BR>
- </P>
-</SPAN><BR CLEAR=LEFT>You can see the Media File View page above.
-Below we'll discuss all of the things you can do with Media Files via
-the Media Filew View page and the new Media File browser that we've
-added to the Weblog Editor.
-</P>
-<P CLASS="western" STYLE="page-break-before: always"><BR><BR>
-</P>
-<H3 CLASS="western"> 4.5.1 How to upload files</H3>
-<P CLASS="western">To upload files you follow the <B>Add Media File</B>
-link in the top right of the page. You will see the Media File Add
-page, which is pictured below.</P>
-<P CLASS="western"><BR><BR>
-</P>
-<P CLASS="western"><SPAN ID="Frame12" DIR="LTR" STYLE="float: left; width: 7.5in; height: 5.66in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m15afd31c.png" NAME="graphics29" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 13: Add Media Files page</I></FONT></P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western">You can upload up to five files at a time and you
-can enter information about the images including title, description,
-copyright statement and tags. You can pick which directory should
-receive the uploaded images.</P>
-<P CLASS="western">You can also decide whether or not you want your
-images to be included in the Gallery, which means that they will be
-made available in the Media File Feed for your blog.
-</P>
-<P CLASS="western"><BR><BR>
-</P>
-<P CLASS="western" STYLE="page-break-before: always">After your file
-upload completes, Roller will show you the <B>Upload Complete</B>
-page (below) with the files that you uploaded and will offer to
-include them in a new weblog post for you. You can choose any or all
-of the images, or you can skip this step and return to the Media File
-View.</P>
-<P CLASS="western"><BR><BR>
-</P>
-<P CLASS="western"><SPAN ID="Frame13" DIR="LTR" STYLE="float: left; width: 7.5in; height: 6.2in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_545814de.png" NAME="graphics32" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 14: Upload Complete page</I></FONT></P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western"><BR><BR>
-</P>
-<P CLASS="western" STYLE="page-break-before: always"><BR><BR>
-</P>
-<H3 CLASS="western"> 4.5.2 How to edit and update files</H3>
-<P CLASS="western">From the Media File View page, you can edit any
-Media File simply by clicking on it. When you click you will be shown
-the Media File Edit page (below). From this page, you can edit the
-same information that you entered when you uploaded the file.
-</P>
-<P CLASS="western">You can also upload a new version of the file. The
-file will maintain the same URL as before the update, so no worries
-about broken links. If the file is an image, a new thumbnail will be
-generated for you and image size information will be updated.</P>
-<P CLASS="western"><BR><BR>
-</P>
-<P CLASS="western"><SPAN ID="Frame14" DIR="LTR" STYLE="float: left; width: 5.83in; height: 5.41in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_2c20c49e.png" NAME="graphics44" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 15: Media File Edit page</I></FONT></P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western" STYLE="page-break-before: always"><BR><BR>
-</P>
-<H3 CLASS="western"> 4.5.3 How to use Media File Directories</H3>
-<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m529f15f0.png" NAME="graphics47" ALIGN=LEFT WIDTH=361 HEIGHT=283 BORDER=0>You
-can use directories to organize your Media Files. You can move files
-around and not worry about breaking any links because directory and
-file names are not part of URLs.</P>
-<P CLASS="western">To create a new directory, enter a new directory
-name in the new directory control, and click the create button.
-</P>
-<P CLASS="western">To navigate into a directory in the Media File
-View page, simply click on the directory.
-</P>
-<H3 CLASS="western"> 4.5.4 How to delete Media Files</H3>
-<P CLASS="western">To delete Media Files, go to the <B>Media File
-View</B> page, select the checkboxes of the files you wish to delete
-and then click the Delete button. You will have to confirm the delete
-before it executes.</P>
-<H3 CLASS="western"> 4.5.5 How to delete Media File Directories</H3>
-<P CLASS="western">Toe delete Media File Directories you must first
-empty them out. You can only delete directories that are empty.</P>
-<H3 CLASS="western"> 4.5.6 How to post images to your weblog</H3>
-<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m52be4c7a.png" NAME="graphics48" ALIGN=LEFT WIDTH=505 HEIGHT=271 BORDER=0>We
-explained above how to post images during the upload process. You can
-also post images to your weblog directly from the Media File View
-page.
-</P>
-<P CLASS="western">Look for the little green plus sign and click it
-to see the Create Weblog Post menu.</P>
-<P CLASS="western">When you click <B>Post in Weblog</B>, Roller will
-create a new weblog and include your Media File. If it's an image,
-Roller will also include the image thumbnail.
-</P>
-<P CLASS="western"><BR><BR>
-</P>
-<P CLASS="western"><BR><BR>
-</P>
-<H3 CLASS="western"> 4.5.7 How to post a podcast to your weblog</H3>
-<P CLASS="western">Look for the little green plus sign and click it
-to see the Create Weblog Post menu.</P>
-<P CLASS="western">When you click <B>Post in Weblog as Podcast</B>,
-Roller will create a new weblog and include your Media File in the
-post content and as an enclosure. As an enclosure, your file will be
-referenced in your weblog's RSS/Atom feed so that podcast readers can
-fetch it.</P>
-<H2 CLASS="western" STYLE="page-break-before: always"> 4.6 Podcasting
-with Roller</H2>
-<P CLASS="western">Roller 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 technique can
-be used to distribute any type of file. Specialized podcast client
-software downloads the audio files that are referenced in your
-newsfeed and copies them to an music player, such as an MP3 player.
-</P>
-<P CLASS="western"><I>This section assumes that you want to upload
-your podcasts to some other server, one with lots of space and
-bandwidth, and not to Roller. If you want to upload your podcasts to
-Roller, then see <B>Section 4.5.7</B> for an explanation of posting a
-Media File to your weblog as a podcast.</I></P>
-<H3 CLASS="western"> 4.6.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. Here are the steps involved in Podcasting with Roller:
-</P>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3>Record an interesting Podcast
- (that's the hard part, by the way) and save your Podcast in MP3
- format or whatever format you prefer. </FONT>
- </P>
-</UL>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3>Upload your Podcast to a web
- server somewhere and take note of your Podcast's URL. For example,
- if you were to upload a file to Roller, then the URL might look
- something like this: </FONT>
- </P>
-</UL>
-<P CLASS="western"><I><FONT SIZE=3> </FONT><FONT COLOR="#0000ff"><FONT FACE="Times New Roman, serif"><U>http://hostname/roller/yourname/resource/mycast.mp3</U></FONT></FONT></I></P>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3>Create a new Roller weblog entry
- announcing your new Podcast. You might want to provide a link to it
- so that those without a Podcast client can click to download it
- directly. For example:</FONT></P>
-</UL>
-<P CLASS="western"><FONT FACE="Times New Roman, serif"><I> Hey now!
-I just created my first Podcast you can download it here:<BR> <a
-href="http://hostname/roller/yourname/resource/mycast.mp3">mycast.mp3</a></I></FONT></P>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3>And the most important step: in
- the lower-half of the weblog editor page, you'll see an expandable
- control labelled <I>Advanced Settings</I>. Click on that to expand
- the control and paste in the URL of your podcast. </FONT>
- </P>
-</UL>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3>Once your blog post is ready,
- save it as a draft or publish it. Once you've done that you'll see
- that the Advanced Settings control has picked up the content-type
- and file-size of your podcast. If not, then Roller could not access
- your podcast due to network problems or perhaps a bad URL. Make sure
- the URL is correct and save again. If your podcast is OK, you'll see
- something like this: </FONT>
- </P>
-</UL>
-<P CLASS="western"><SPAN ID="Frame8" DIR="LTR" STYLE="float: left; width: 6.37in; height: 1.37in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m36b65532.png" NAME="graphics9" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 16: Podcast URL field</I></FONT></P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3>Roller will add the podcast to
- your RSS newsfeed as an </FONT><TT><FONT SIZE=3><enclosure></FONT></TT><FONT SIZE=3>.
- You can check this by looking at your RSS newsfeed and any podcast
- software that is subscribed to your feed will pick it up
- automatically. </FONT>
- </P>
-</UL>
-<PRE><FONT FACE="Courier New"><FONT SIZE=3> <enclosure url="http://example.com/roller/nina/resource/mycast.mp3" </FONT></FONT>
-<FONT FACE="Courier New"><FONT SIZE=3> type="audio/x-mpeg" length="3409127" /></FONT></FONT>
-</PRE><H2 CLASS="western" STYLE="page-break-before: always">
- 4.7 Using a weblog client with Roller</H2>
-<P CLASS="western">Using a nice weblog client like Ecto or MarsEdit
-can make it easier for you to post to your Roller weblog. You can
-also post to your weblog remotely from services like Flickr.com and
-del.icio.us. This is possible because Roller supports a standard
-publishing protocols such as the MetaWeblog API and the Atom
-Publishing Protocol. Here's how to set up a weblog client to post to
-Roller.</P>
-<P CLASS="western"><BR><BR>
-</P>
-<P CLASS="western"><B>Configuring a weblog client for use with Roller</B></P>
-<P CLASS="western">First, make sure to enable weblog client API
-support in your weblog via your weblog's Weblog Settings page.
-</P>
-<P CLASS="western"><SPAN ID="Frame39" DIR="LTR" STYLE="float: left; width: 3.97in; height: 0.94in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_62264ef1.png" NAME="graphics11" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 17: Weblog Settings page: Weblog Client API</I></FONT></P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western">Next, start your blogging client, find the
-preferences or account setup dialog. You'll need to set the following
-parameters:</P>
-<UL>
- <LI><P CLASS="western"><B>Username</B>: your Roller username</P>
- <LI><P CLASS="western"><B>Password</B>: your Roller password</P>
- <LI><P CLASS="western"><B>BlogID</B>: the handle of your Roller
- weblog</P>
- <LI><P CLASS="western"><B>URL</B>: the URL of Roller's web services
- end-point</P>
-</UL>
-<P CLASS="western" STYLE="font-weight: normal">Note that you may not
-need to enter your BlogID because some blog clients will login to
-Roller and then present you with a list of the weblogs that are
-available to your user.
-</P>
-<P CLASS="western" STYLE="font-weight: normal"><BR><BR>
-</P>
-<P CLASS="western"><B>A blogs.sun.com example</B>. For example, if
-you have an account on blogs.sun.com, your username is fred and your
-blog's handle is fredsblog (i.e. your weblog's URL is
-<I>http://blogs.sun.com/fredsblog</I>), then your parameters would
-be:</P>
-<UL>
- <LI><P CLASS="western"><B>Username</B>: fred</P>
- <LI><P CLASS="western"><B>Password</B>: (your password)</P>
- <LI><P CLASS="western"><B>BlogID</B>: fredsblog</P>
- <LI><P CLASS="western"><A NAME="DDE_LINK1"></A><B>URL</B>:
- http://blogs.sun.com/roller-services/xmlrpc
- </P>
-</UL>
-<P CLASS="western">You may not need to enter your BlogID because some
-blog clients will login to Roller and then present you with a list of
-the weblogs that are available to your user.
-</P>
-<P CLASS="western"><BR><BR>
-</P>
-<P CLASS="western"><B>A jroller.com example</B>. If you have an
-account on jroller.com, your username is fred and your blog's handle
-is fredsblog (i.e. your weblog's URL is
-<I>http://jroller.com/fredsblog</I>), then your parameters would be:</P>
-<UL>
- <LI><P CLASS="western"><B>Username</B>: fred</P>
- <LI><P CLASS="western"><B>Password</B>: (your password)</P>
- <LI><P CLASS="western"><B>BlogID</B>: fredsblog</P>
- <LI><P CLASS="western" STYLE="margin-bottom: 0.2in"> <FONT FACE="Courier New"><FONT SIZE=3><B>URL</B>:
- http://jroller.com/roller-services/xmlrpc </FONT></FONT>
- </P>
-</UL>
-<H1 CLASS="western"> 5 Working with comments and trackbacks</H1>
-<P CLASS="western">Roller supports weblog comments and <I>trackbacks</I><SPAN STYLE="font-style: normal">,
-which provide a way for other bloggers to add comments to your blog
-remotely.</SPAN> By default comments and trackbacks are enabled, but
-you can turn them off on your weblog's Weblog Settings page of your
-weblog. Note that turning off comments will disable both comments and
-trackbacks.
-</P>
-<H2 CLASS="western"> 5.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
-from your weblog. You can't respond to comments if you don't know
-when you get one, so make sure you enable email notification of
-comments. You can do that on the Weblog Settings page.
-</P>
-<P CLASS="western">If you've got email turned on then you'll receive
-an email every time you get a new comment and the email will include
-the text of the comment, a link to the entry that was commented upon
-and a link to the comment management page, shown below, where you may
-choose to approve, mark as spam or even delete the new comment.
-</P>
-<H2 CLASS="western"> 5.2 Comment management</H2>
-<P CLASS="western">You can use the Comments page to manage your
-weblog comments. You can mark comments as spam or delete them
-entirely. You can search comments by keyword, date and status. If
-you've got comment moderation turned on, you will use the Comments
-page to approve new comments.
-</P>
-<P CLASS="western"><SPAN ID="Frame40" DIR="LTR" STYLE="float: left; width: 6.18in; height: 4.09in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_33514f37.png" NAME="graphics42" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 18: Comments page</I></FONT></P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western"><BR><BR>
-</P>
-<P CLASS="western" STYLE="page-break-before: always"><B>A word about
-status</B></P>
-<P CLASS="western">You can't edit comments, but you can mark them as
-spam or dis-approve them. Someday, Roller may provide some spam
-filtering based on data collected from comments marked as spam but
-currently, marking as spam and dis-approving of a comment do the same
-thing -- they prevent the comment from being displayed on your
-weblog.
-</P>
-<P CLASS="western"><B>How to get to the Comments page</B></P>
-<P CLASS="western">There are a couple of ways to get to the Comments
-page. You can use Roller's tabbed menu to go there and manage comment
-across your entire weblog. If you've got email notification of new
-comments turned on, the you might arrive at the Comments page via a
-link sent to you in your email.</P>
-<P CLASS="western">You can also manage comments for just one weblog.
-When you are editing a weblog entry with comments you'll see a link
-in the top-right corner of the weblog editor page like the one below,
-which you can use to access the entry's comments.</P>
-<H2 CLASS="western"> 5.3 Comment moderation</H2>
-<P CLASS="western" STYLE="font-style: normal; font-weight: normal">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 moderation</I>
-via Weblog Settings page. When comment moderation is enabled, then
-each new comment will be marked as pending and unapproved and will
-not appear on your weblog. To check for new comments, go to the
-Comments page to check for and either approve or delete new comments.
-If you've got comment notification enabled, make sure you also enable
-comment notification so you'll know when new comments arrive. To
-moderate comments, use the comment management page, described below.</P>
-<P CLASS="western" STYLE="margin-left: -0.01in; font-style: normal"><FONT SIZE=3><B>How
-to moderate comments</B></FONT></P>
-<UL>
- <LI><P CLASS="western" STYLE="font-style: normal; font-weight: normal">
- <FONT SIZE=3>Review each new comment and decide if it is to be
- approved for display, marked as spam and hidden or deleted entirely.
- </FONT>
- </P>
- <LI><P CLASS="western"><FONT SIZE=3><SPAN STYLE="font-style: normal"><SPAN STYLE="font-weight: normal">Only
- comments that are marked as approved and are not spam will be
- displayed on your weblog. So set (or unset) the corresponding
- chec</SPAN></SPAN>kboxes for each comment, or leave them the way
- they are. </FONT>
- </P>
- <LI><P CLASS="western"><FONT SIZE=3>When you are done. Click the
- save changes button at the bottom of the page. You'll see that
- comments that were pending are no longer pending and those that you
- marked for delete will be gone.</FONT></P>
-</UL>
-<H2 CLASS="western"> 5.4 Global comment management</H2>
-<P CLASS="western" STYLE="font-weight: normal">If your user has
-global administration privileges, then you can manage comments across
-the entire Roller site, including every weblog. To do this, go to the
-<B>Server Administration:Comments</B> page and you'll see a page that
-is almost identical to the weblog-specific comment management page.
-</P>
-<P CLASS="western" STYLE="font-style: normal"><B>Limitations of
-global comment management</B></P>
-<P CLASS="western" STYLE="font-weight: normal">You can use this page
-to mark as spam or delete any comment in the system, however you
-cannot change the approval status of comments through this interface.
-Approving comments for display is the duty and responsibility of the
-individual webloggers, so comment approval is only available in the
-context of a weblog.</P>
-<P CLASS="western" STYLE="font-weight: normal; page-break-before: always">
-<BR><BR>
-</P>
-<H2 CLASS="western"><A NAME="5.5.Preventing weblog spam |outline"></A>
- 5.5 <B>Preventing weblog spam</B>
-</H2>
-<P CLASS="western">There are three forms of comment spam that can
-affect your weblog:</P>
-<UL>
- <UL>
- <LI><P CLASS="western"><FONT SIZE=3><I>Comment spam</I>: spam that
- arrives via the comment form on your weblog. Sometimes spam
- comments are added by a human and sometimes by a computer program
- known as a <I>spambot.</I><SPAN STYLE="font-style: normal"> </SPAN></FONT>
- </P>
- <LI><P CLASS="western"><FONT SIZE=3><I>Trackback spam</I>: spam
- that arrives via trackbacks sent by a spambot.</FONT></P>
- <LI><P CLASS="western"><FONT SIZE=3><I>Referrer spam</I>: spam that
- arrives in web requests and appears on the Referrers page of your
- Roller blog or on your blog (but only if your blog theme uses the
- <FONT FACE="Courier, sans-serif">#showReferrers()</FONT> macro).</FONT></P>
- </UL>
-</UL>
-<P CLASS="western">Fortunately, there are counter-measures for each
-type of spam. Here are Roller's built in spam prevention measures:</P>
-<UL>
- <LI><P CLASS="western"><I>Pluggable comment authentication</I>. By
- default, Roller asks each commenter a simple math question to ensure
- that they are a person and not a spam robot. Your site administrator
- can turn this off or replace it with another form of authentication.</P>
- <LI><P CLASS="western"><I>Pluggable comment validation</I>. Roller
- includes five comment validators below. Your site administrator can
- adjust the settings for these validators and can enable/disable them
- as needed by overriding Roller's configuration properties (see the
- Installation Guide for more information).</P>
- <UL>
- <LI><P CLASS="western">Excess links validator will mark comments
- with more than three links as spam (default: on)</P>
- <LI><P CLASS="western">Excess size validator marks any comment with
- more than 1000 characters as spam (default: on)</P>
- <LI><P CLASS="western">Blacklist validator marks comments
- containing any of your site's designated bad words as spam
- (default: on)</P>
- <LI><P CLASS="western">Trackback verification validator will check
- incoming trackbacks to ensure that they link to you.</P>
- <LI><P CLASS="western">Akismet validator allows you to use the
- Akismet.com spam prevention service.
- </P>
- </UL>
- <LI><P CLASS="western"><I>Comment throttling</I>. If your site is
- being abused by a spam robot your site administrator can set up
- throttling, which will watch for abusers and ban IP addresses that
- are posting too many comments too quickly.</P>
-</UL>
-<P CLASS="western"><B>But nothing beats comment moderation</B></P>
-<P CLASS="western">Even if you've got all of those measures enabled
-you should still enable email notification of comments so that you
-are constantly aware of new comments on your weblog. None of the
-measures are 100% effective. If you are really concerned about
-displaying offensive content on your weblog even for a short time,
-then enable comment moderation on your weblog.</P>
-<OL START=2>
- <OL>
- <OL>
- <P CLASS="western"><B>Three levels of blacklisting</B></P>
- </OL>
- </OL>
-</OL>
-<P CLASS="western"><SPAN STYLE="font-weight: normal">Roller uses a
-</SPAN><I><SPAN STYLE="font-weight: normal">blacklist</SPAN></I><SPAN STYLE="font-weight: normal">,
-a lists of words which are used to check incoming comments,
-trackbacks and referrers for spam. The blacklist includes several
-thousand words and regular expressions which which are used to check
-incoming comments and trackbacks. If the name, URL or content of a
-comment or trackback includes one of the blacklist words or matches
-one of the expressions then that comment or trackback is marked as
-spam and is not displayed on your weblog, unless you use the comment
-management page to unmark it.</SPAN></P>
-<P CLASS="western" STYLE="font-weight: normal">Actually, there are
-three levels of blacklist:</P>
-<UL>
- <UL>
- <LI><P CLASS="western" STYLE="font-weight: normal"><FONT SIZE=3>Level
- 1 blacklist: This is the built-in blacklist, the one that comes
- with Roller. This can only be changed by somebody with root access
- to the Roller server itself.</FONT></P>
- <LI><P CLASS="western" STYLE="font-weight: normal"><FONT SIZE=3>Level
- 2 blacklist: This is the site wide blacklist, which can only be
- edited by a global administrator via the Server Admin page.</FONT></P>
- <LI><P CLASS="western" STYLE="font-weight: normal"><FONT SIZE=3>Level
- 3 blacklist: Weblog specific blacklist, which you control in the
- Weblog Settings page of your weblog.</FONT></P>
- </UL>
-</UL>
-<P CLASS="western" STYLE="font-weight: normal">Incoming comments and
-trackbacks are checked against all three levels of blacklist.
-Incoming referrers, however, are only checked against the levels 2
-and 3 blacklist.</P>
-<OL START=2>
- <OL>
- <OL START=0>
- <P CLASS="western"><B>How to add words and expressions to the
- blacklist</B></P>
- </OL>
- </OL>
-</OL>
-<P CLASS="western" STYLE="font-weight: normal">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 to add the
-words to the level 2 blacklist for you. That way, every blogger on
-the site will benefit from the addition. If you must do it yourself,
-here's how you do it:</P>
-<UL>
- <UL>
- <LI><P CLASS="western" STYLE="font-weight: normal"><FONT SIZE=3>Go
- to the Weblog Settings page and scroll down to the blacklist fields</FONT></P>
- <LI><P CLASS="western" STYLE="font-weight: normal"><FONT SIZE=3>Enter
- your spam words, one per line</FONT></P>
- <LI><P CLASS="western"><FONT SIZE=3><SPAN STYLE="font-weight: normal">Lines
- that begin with a left parenthesis will be treated as regular
- expressions (see the Java API documentation for
- </SPAN></FONT><FONT FACE="Courier New"><FONT SIZE=3><SPAN STYLE="font-weight: normal">javax.util.regex.Pattern</SPAN></FONT></FONT><FONT SIZE=3><SPAN STYLE="font-weight: normal">
- for a guide to regular expressions). Don't try to use a regular
- expression unless you really know what you're doing.</SPAN></FONT></P>
- </UL>
-</UL>
-<H2 CLASS="western"> 5.6 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 trackback
-enabled, then you should send that weblog a trackback ping. Here's a
-story that illustrates how trackback works:
-</P>
-<UL>
- <LI><P CLASS="western">You read an interesting blog entry on Otto's
- blog. You notice that Otto's blog entry has a trackback URL, so
- instead of leaving a comment on Otto's blog you decide to comment by
- writing a blog entry in your own blog. You copy that trackback URL
- (using ALT-C, or right-click-copy, or whatever) cause you'll need it
- later.
- </P>
-</UL>
-<UL>
- <LI><P CLASS="western">You go to your blog and write a new blog
- entry in response to Otto's entry. Click the Post to Weblog button
- to publish your new entry. After you publish, scroll down on the New
- Entry page until you see the following text field and button: <BR>
- </P>
-</UL>
-<P CLASS="western"><SPAN ID="Frame11" DIR="LTR" STYLE="float: left; width: 6.79in; height: 1.33in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m401d41af.png" NAME="graphics13" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 19: Send trackback control</I></FONT></P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<UL>
- <LI><P CLASS="western">Enter the trackback URL from Otto's blog
- entry into the text field and click the Send Trackback button.
- Roller will respond by printing the response received from Otto's
- blog server. If the trackback was successful, you should see
- something like this:
- </P>
- <LI VALUE=1><P CLASS="western">You should now see your trackback
- listed among the comments on Otto's blog entry.
- </P>
-</UL>
-<P CLASS="western"><BR><BR>
-</P>
-<H1 CLASS="western"> 6 Choosing your weblog theme
-</H1>
-<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 your weblog. You can
-pick from one of a number of predefined themes. Some themes will
-allow you to control design by using a stylesheet. Other themes
-require you to edit the templates that define the theme if you want
-to customize them.</P>
-<P CLASS="western"><SPAN ID="Frame10" DIR="LTR" STYLE="float: left; width: 6.9in; height: 1.35in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_3194c44e.png" NAME="graphics22" ALIGN=LEFT WIDTH=98% BORDER=0><BR CLEAR=LEFT><BR><BR>
- </P>
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><FONT SIZE=2><I>Illustration
- 20: Design menu</I></FONT></P>
-</SPAN><BR CLEAR=LEFT>You can access Roller's theme and template
-features for your weblog via the Design menu, shown below:
-</P>
-<P CLASS="western">The Theme menu leads you to the theme chooser
-page, shown below. Using this page you can pick from one or more
-different themes for your weblog. If none of the themes are appealing
-to you, then speak to your site administrator about obtaining or
-developing some additional themes. The Roller Support project is one
-place where you can obtain additional themes
-(<FONT COLOR="#0000ff"><U>http://roller.dev.java.net</U></FONT>, <I>not</I>
-an Apache site).</P>
-<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_6e6b01a8.png" NAME="graphics19" ALIGN=LEFT WIDTH=509 HEIGHT=574 BORDER=0><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western"><BR><BR>
-</P>
-<P CLASS="western">For more information on customizing Roller themes
-refer to the Template Guide.
-</P>
-<H1 CLASS="western"> 7 Managing your weblog preferences</H1>
-<P CLASS="western">As a Roller user, you are free to customize the
-settings of your weblog as you wish. When you establish your Roller
-user account, you can choose one of the dozen or so stock themes for
-your website. Later, you can use the theme switcher to switch to a
-different theme. Or, if you know something about HTML and CSS you can
-customize the look-and-feel and layout of your weblog yourself by
-modifying the page templates that make up your site and by adding new
-pages. Best of all, you can do all of this through the web-based
-Roller Editor UI.
-</P>
-<H2 CLASS="western"> 7.1 Weblog settings</H2>
-<P CLASS="western"><FONT SIZE=3>The <B>Preferences:Settings</B> page
-allows you to set the configuration parameters for your weblog. </FONT>
-</P>
-<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_mede79f.png" NAME="graphics3" ALIGN=LEFT WIDTH=756 HEIGHT=100 BORDER=0><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western" STYLE="font-weight: normal"><BR><BR>
-</P>
-<P CLASS="western" STYLE="font-weight: normal"><FONT SIZE=3>Here is
-an explanation of each of the settings on the weblog
-<B>Preferences:Settings</B> page: </FONT>
-</P>
-<H3 CLASS="western"> 7.1.1 <B>General settings</B>
-</H3>
-<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m3f04a47a.png" NAME="graphics15" ALIGN=LEFT WIDTH=669 HEIGHT=332 BORDER=0><BR CLEAR=LEFT><BR><BR>
-</P>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3><B>Title</B></FONT><FONT SIZE=3>
- - The title of your weblog may include HTML, but the HTML will be
- stripped out in your RSS feed. You can access your title in a page
- template with the expression </FONT><TT><FONT SIZE=3>#showWebsiteTitle()</FONT></TT><FONT SIZE=3>
- </FONT>
- </P>
-</UL>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3><B><SPAN STYLE="background: transparent">Tagline</SPAN></B></FONT><FONT SIZE=3><SPAN STYLE="background: transparent">
- â Short description or sub title of your weblog. May include HTML,
- but the HTML will be stripped out in your RSS feed. You can access
- your tagline in a page template with the expression
- </SPAN></FONT><TT><FONT SIZE=3><SPAN STYLE="background: transparent">#showWebsiteDescription()</SPAN></FONT></TT><FONT SIZE=3><SPAN STYLE="background: transparent">.
- </SPAN></FONT>
- </P>
- <LI><P CLASS="western"><FONT SIZE=3><SPAN STYLE="background: transparent"><B>Icon</B>
- - The image file name (ex: thumbnail.jpg) or image url (ex:
- http://yoursite/thumbnail.com) that shows on some of the default
- themes. You'll need to upload the image via the <B>Create &
- Edit:File Uploads</B><SPAN STYLE="font-weight: normal"> tab first. </SPAN></SPAN></FONT>
- </P>
- <LI><P CLASS="western"><FONT SIZE=3><B><SPAN STYLE="background: transparent">About
- your blog</SPAN></B><SPAN STYLE="font-weight: normal"><SPAN STYLE="background: transparent">
- â A more detailed description of the blog or blog author(s) that
- shows on some of the default themes.</SPAN></SPAN></FONT></P>
-</UL>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3><B>Email address of weblog
- owner</B>: Enter the email address that you would like people to use
- to contact the person in charge of your blog; usually that's you. To
- thwart spammers, your email address will be obfuscated when
- displayed on your blog. Please enter a valid address, otherwise
- Roller's email features will not work.</FONT></P>
-</UL>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3><B>Weblog editor page to be used</B>
- - Choose a weblog editor page, some are rich-text editors: </FONT>
- </P>
-</UL>
-<UL>
- <UL>
- <LI><P CLASS="western" STYLE="margin-bottom: 0in"><FONT SIZE=3>editor-text.jsp:
- Simple text editor, you must enter HTML</FONT></P>
- <LI><P CLASS="western" STYLE="margin-bottom: 0in"><FONT SIZE=3>editor-rte.jsp:
- Rich text editor (works in Firefox and IE but not Safari)</FONT></P>
- </UL>
-</UL>
-<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
-</P>
-<UL>
- <LI VALUE=1><P CLASS="western"><FONT SIZE=3><B>Weblog is active:
- </B><SPAN STYLE="font-weight: normal">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=3><B>Number of entries to display
- on weblog</B>: Enter the maximum number of entries to be displayed
- on your weblog.</FONT></P>
-</UL>
-<H3 CLASS="western"> 7.1.2 Internationalization Settings</H3>
-<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m49fe23de.png" NAME="graphics16" ALIGN=LEFT WIDTH=669 HEIGHT=171 BORDER=0><BR CLEAR=LEFT><BR><BR>
-</P>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3><B>I publish my weblog in
- multiple languages</B><SPAN STYLE="font-weight: normal">: check this
- box if you blog in multiple languages and would like to specify a
- language locale for each of your weblog entries.</SPAN></FONT></P>
- <LI><P CLASS="western"><FONT SIZE=3><B>Show my weblog entries from
- all languages on my home page</B><SPAN STYLE="font-weight: normal">:
- check this box if you'd like your weblog's main page to show your
- posts in all languages. If you don't check it, then readers will
- only see weblog entries from your default locale.</SPAN></FONT></P>
- <LI><P CLASS="western"><FONT SIZE=3><B>Locale</B><SPAN STYLE="font-weight: normal">
- set the default locale for your weblog.</SPAN></FONT></P>
- <LI><P CLASS="western"><FONT SIZE=3><B>Timezone: </B><SPAN STYLE="font-weight: normal">the
- timezone to be used in your weblog.</SPAN></FONT></P>
-</UL>
-<H3 CLASS="western"> 7.1.3 <B>Comments</B> and default comment
-settings</H3>
-<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m8971d05.png" NAME="graphics17" ALIGN=LEFT WIDTH=633 HEIGHT=225 BORDER=0><BR CLEAR=LEFT><BR><BR>
-</P>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3><B>Allow comments for your
- weblog?</B> â Check this box to allow visitors to leave comments
- on your weblog. </FONT>
- </P>
- <LI><P CLASS="western"><FONT SIZE=3><B>Moderate comments</B> â
- Check this box to enable comment moderation (i.e. you must approve
- each comment before it is displayed).</FONT></P>
- <LI><P CLASS="western"><FONT SIZE=3><B>Email comments</B> â Check
- this box to receive an email notification of each new comments. </FONT>
- </P>
- <LI><P CLASS="western"><FONT SIZE=3><B>Default from e-mail address
- for comments</B></FONT><FONT SIZE=3> â This will be used as the
- from address in comment emails sent by Roller.</FONT></P>
-</UL>
-<P CLASS="western"><BR><BR>
-</P>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3><B>By default, allow comments
- for new entries</B> â Check this box to enable comments on your
- weblog. You can also control comments on each individual weblog
- entry.</FONT></P>
- <LI><P CLASS="western"><FONT SIZE=3><B>Default time to allow
- comments for new entries </B><SPAN STYLE="font-weight: normal">â
- 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"><FONT SIZE=3><B>Apply comment defaults to all
- existing entries? </B><SPAN STYLE="font-weight: normal">- 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>
-<H3 CLASS="western"> 7.1.4 <B>Weblog client API</B>
-</H3>
-<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_3f9b9a7d.png" NAME="graphics34" ALIGN=LEFT WIDTH=656 HEIGHT=124 BORDER=0><BR CLEAR=LEFT><BR><BR>
-</P>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3><B>Enable Blogger API for your
- weblog</B> - Set to true to enable weblogging via the MetaWeblog
- API. This will allow you to use handy blogging clients like Ecto to
- post to your weblog. </FONT>
- </P>
-</UL>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3><B>Category for posts received
- via Blogger API</B> - Choose the category for incoming posts made
- via the Blogger API. This only applies if you blogging client does
- not support categories. </FONT>
- </P>
-</UL>
-<H3 CLASS="western"> 7.1.5 <B>Formatting</B>
-</H3>
-<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_3e7fa921.png" NAME="graphics43" ALIGN=LEFT WIDTH=640 HEIGHT=131 BORDER=0><BR CLEAR=LEFT><BR><BR>
-</P>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3><B>Default entry formatters:
- </B><SPAN STYLE="font-weight: normal">this is the list of plug-ins
- to be enabled by default on a new weblog entry. </SPAN></FONT>
- </P>
-</UL>
-<H3 CLASS="western"> 7.1.6 <B>Spam prevention</B>
-</H3>
-<P CLASS="western"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_m38e76eb8.png" NAME="graphics35" ALIGN=LEFT WIDTH=651 HEIGHT=193 BORDER=0><BR CLEAR=LEFT><BR><BR>
-</P>
-<UL>
- <LI><P CLASS="western"><FONT SIZE=3><B>Ignore incoming referrer URLs
- that contain any of these (comma-separated) words - </B><SPAN STYLE="font-weight: normal">you
- can use this to filter out what referrers are accepted. Somewhat
- useful if you start getting hit by referrer spam, but not a complete
- solution to the referrer spam problem. See section [</SPAN><A HREF="#5.5.Preventing weblog spam |outline"><SPAN STYLE="font-weight: normal">5.5]
- </SPAN></A><SPAN STYLE="font-weight: normal">for more information on
- spam prevention.</SPAN></FONT></P>
-</UL>
-<P CLASS="western"><BR><BR>
-</P>
-<P CLASS="western"><BR><BR>
-</P>
-<H2 CLASS="western" STYLE="page-break-before: always"> 7.2 Weblog
-members: managing 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
-personal weblog (see section <A HREF="http://www.rollerweblogger.org/wiki/Wiki.jsp?page=UserGuide_2.x#ref-UserGuide_2.x-3">[3]</A>
-for instructions). Navigate to the <B>Members</B> menu item in the
-<B>Preferences</B> tab. The <B>Preferences:Members</B> page enables
-weblog admins to invite members to a group blog and manage the group
-blog user access.
-</P>
-<P CLASS="western"><SPAN ID="Frame16" DIR="LTR" STYLE="float: left; width: 6.67in; height: 4.19in; border: none; padding: 0in; background: #ffffff">
- <P STYLE="margin-top: 0.08in; margin-bottom: 0.08in"><IMG SRC="file:///Users/dave/Source/roller_trunk/apps/weblogger/docs/userguide/generated/html/roller-user-guide_html_796ebdaa.png" NAME="graphics21" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
- 21: Weblog permissions page</I></FONT></P>
-</SPAN><BR CLEAR=LEFT><BR><BR>
-</P>
-<P CLASS="western">You can use the <B>Invite new member</B> link to
-invite any Roller user to join your weblog, but before you do you
-should understand the three different permission levels allowed for
-members of a weblog. They are:
-</P>
-<UL>
- <LI><P CLASS="western"><B>Admin</B>: an admin can create/edit weblog
- entries and publish them to the web. They can also manage the weblog
- by changing the theme, editing the page templates that define the
- look of the blog, and managing the users of the blog. Roller will
- grant you admin rights in any weblog you create. Admin users can see
- both the Create & Edit tab and the Preferences tab of Roller.
- </P>
- <LI><P CLASS="western"><B>Author</B>: author permission allows users
- to create entries, edit entries and upload files. But authors cannot
- change weblog settings, modify the theme or manage users. Authors
- can see the weblog Create & Edit tab, but not the weblog
- Preferences tab.
- </P>
-</UL>
-<UL>
- <LI><P CLASS="western"><B>Limited</B>: limited bloggers can create
- and edit blog entries and save them as drafts, but cannot publish
- them to the web.
- </P>
-</UL>
-<P CLASS="western">Select <B>Invite new member</B> from the right
-navigation to invite Admins, Authors, and Limited authors to join the
-group blog. You'll need to know the users individual blog username to
-find them in the list of users. You may scroll through the list, but
-it's best to begin typing their username to locate them. Set the
-users Permissions by selecting Admin, Author, or Limited. Click on
-<B>Send Invitation</B>. If Roller is not configured to talk to the
-mail server, you may get the following messages:
-</P>
-<PRE>User successfully invited.
-ERROR: Notification email(s) not sent, due to Roller configuration <BR>or mail server problem.</PRE><P CLASS="western">
-As long as the first message is present, the invite is successful.
-The next time the user logs into the blog site, they will see the
-message show in the screenshot below asking them to accept or decline
-your invitation.</P>
-<P CLASS="western">Once a user is a member of your blog, you can
[... 1605 lines stripped ...]