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/08/17 04:28:50 UTC
svn commit: r432119 [4/5] - in /incubator/roller/branches/roller_3.0/docs:
tempateguide/ tempateguide/generated/ tempateguide/generated/html/
userguide/ userguide/generated/ userguide/generated/html/
Modified: incubator/roller/branches/roller_3.0/docs/userguide/generated/html/roller-user-guide.html
URL: http://svn.apache.org/viewvc/incubator/roller/branches/roller_3.0/docs/userguide/generated/html/roller-user-guide.html?rev=432119&r1=432118&r2=432119&view=diff
==============================================================================
--- incubator/roller/branches/roller_3.0/docs/userguide/generated/html/roller-user-guide.html (original)
+++ incubator/roller/branches/roller_3.0/docs/userguide/generated/html/roller-user-guide.html Wed Aug 16 19:28:49 2006
@@ -7,110 +7,107 @@
<META NAME="AUTHOR" CONTENT="Dave Johnson">
<META NAME="CREATED" CONTENT="20051209;11500200">
<META NAME="CHANGEDBY" CONTENT="Dave Johnson">
- <META NAME="CHANGED" CONTENT="20060512;18113300">
+ <META NAME="CHANGED" CONTENT="20060816;22231700">
<META NAME="SDFOOTNOTE" CONTENT=";;;;P">
<META NAME="SDENDNOTE" CONTENT="ARABIC">
<STYLE>
<!--
- @page { size: 8.5in 11in; margin: 0.79in }
+ @page { size: 8.5in 11in; margin: 0.5in }
P { margin-bottom: 0.08in }
+ P.western { font-family: "Times New Roman" }
H1.cjk { font-family: "Andale Sans UI" }
H1.ctl { font-family: "Lucidasans" }
- TD P { margin-bottom: 0in }
+ DD.western { font-family: "Times New Roman" }
+ DT.western { font-family: "Times New Roman" }
-->
</STYLE>
</HEAD>
<BODY LANG="en-US" DIR="LTR">
-<P STYLE="margin-bottom: 0in"><BR>
+<P CLASS="western" STYLE="margin-bottom: 0in"><BR>
</P>
<DIV ID="wrapper" DIR="LTR">
<DIV ID="banner" DIR="LTR">
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=7 STYLE="font-size: 40pt"><B>User
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=7 STYLE="font-size: 40pt"><B>User
Guide</B></FONT></P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=7 STYLE="font-size: 32pt"><B>Apache
- Roller</B></FONT></P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=5 STYLE="font-size: 20pt"><B>Version
- 2.3-incubating</B></FONT></P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
- </P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
- </P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
- </P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT COLOR="#ff0000"><FONT SIZE=7 STYLE="font-size: 40pt"><B>DRAFT
+ #20060816</B></FONT></FONT></P>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
- </P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=7 STYLE="font-size: 32pt"><B>Apache
+ Roller</B></FONT></P>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><FONT SIZE=5 STYLE="font-size: 20pt"><B>Version
+ 3.0 (incubating)</B></FONT></P>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" ALIGN=CENTER STYLE="margin-bottom: 0in"><BR>
</P>
- <P ALIGN=LEFT><FONT FACE="Courier New"><FONT SIZE=1 STYLE="font-size: 8pt"><I>Licensed
+ <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
under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at</I></FONT></FONT></P>
- <P ALIGN=LEFT> <FONT FACE="Courier New"><FONT SIZE=1 STYLE="font-size: 8pt"><I>http://www.apache.org/licenses/LICENSE-2.0</I></FONT></FONT></P>
- <P ALIGN=LEFT><FONT FACE="Courier New"><FONT SIZE=1 STYLE="font-size: 8pt"><I>Unless
+ <P CLASS="western" ALIGN=LEFT>
+ <FONT FACE="Courier New"><FONT SIZE=1 STYLE="font-size: 8pt"><I>http://www.apache.org/licenses/LICENSE-2.0</I></FONT></FONT></P>
+ <P CLASS="western" ALIGN=LEFT><FONT FACE="Courier New"><FONT SIZE=1 STYLE="font-size: 8pt"><I>Unless
required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS"
BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
@@ -120,7 +117,7 @@
file in the top level directory of this distribution.</I></FONT></FONT></P>
</DIV>
<DIV ID="centercontent" DIR="LTR">
- <P STYLE="page-break-before: always"><BR><BR>
+ <P CLASS="western" STYLE="page-break-before: always"><BR><BR>
</P>
<DIV ID="Table of Contents1" DIR="LTR">
<DIV ID="Table of Contents2_Head" DIR="LTR">
@@ -140,6 +137,8 @@
Accepting an invitation to join a weblog 6</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>2.4 -
Getting around in Roller 6</P>
+ <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>2.5
+ Changing the Language of the editor interface 8</P>
<P STYLE="margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>3
- Creating and editing your weblog 9</B></FONT></P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>3.1 -
@@ -149,119 +148,107 @@
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">3.2.1 - Finding
old entries with the Create & Edit:New Entry page 12</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">3.2.2 - Finding
- old entries with the Create & Edit:Edit Entries page 13</P>
+ old entries with the Create & Edit:Entries page 13</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">3.2.3 - Finding
old entries using the pages of your weblog 13</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">3.2.4 - Finding
- old entries with Roller's built-in search engine 13</P>
+ old entries with Roller's built-in search engine 14</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>3.3 -
- Weblog categories 14</P>
+ Weblog categories 15</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">3.3.1 - The
- Weblog Category Chooser 14</P>
+ Weblog Category Chooser 15</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">3.3.2 - RSS
- Feed for Each Category 14</P>
+ Feed for Each Category 15</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">3.3.3 - Adding,
- Renaming, and Removing Weblog Categories 14</P>
+ Renaming, and Removing Weblog Categories 15</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>3.4 -
- Podcasting with Roller 15</P>
+ Podcasting with Roller 16</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">3.4.1 - How to
- create a podcast feed with Roller 15</P>
+ create a podcast feed with Roller 16</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>3.5 -
- Referrer rankings 17</P>
+ Referrer rankings 18</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>3.6 -
- Comment notification via email 17</P>
+ Comment notification via email 18</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>3.7 -
- Comment management and moderation 17</P>
+ Comment management and moderation 18</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>3.8 -
Preventing weblog spam 19</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">3.8.1 - Three
- levels of blacklisting 19</P>
+ levels of blacklisting 20</P>
<P STYLE="margin-left: 0.39in; margin-bottom: 0in">3.8.2 - How to
- add words and expressions to the blacklist 19</P>
+ add words and expressions to the blacklist 20</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>3.9 -
Sending trackbacks 20</P>
<P STYLE="margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>4
- - Managing your weblog settings 21</B></FONT></P>
+ - Managing your weblog settings 22</B></FONT></P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>4.1 -
- Weblog settings 22</P>
+ Weblog settings 23</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>4.2 -
- Weblog themes 25</P>
+ Weblog themes 26</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>4.3 -
Uploading Files 26</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>4.4 -
- Setting up a group blog 27</P>
+ Setting up a group blog 28</P>
<P STYLE="margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>5
- - Customizing your weblog's theme 29</B></FONT></P>
+ - Managing your weblog's blogroll 30</B></FONT></P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>5.1 -
- Weblog and day templates 31</P>
+ Adding new links to your blogroll 30</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>5.2 -
- Define standard headers and footers with a decorator 33</P>
+ Adding new links to your blogroll 31</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>5.3 -
- Roller Macros and Variables 34</P>
+ Adding new bookmark folders 32</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>5.4 -
- Creating and packaging your own Roller theme 35</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>5.5 -
- Overriding Roller Macros 36</P>
+ Bookmark import and export via OPML 33</P>
<P STYLE="margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>6
- - Managing your weblog's blogroll 37</B></FONT></P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>6.1 -
- Adding new links to your blogroll 37</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>6.2 -
- Adding new links to your blogroll 38</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>6.3 -
- Adding new bookmark folders 39</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>6.4 -
- Bookmark import and export via OPML 40</P>
+ - Using a blog client with Roller 34</B></FONT></P>
<P STYLE="margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>7
- - Using a blog client with Roller 41</B></FONT></P>
+ - Using weblog pings 35</B></FONT></P>
+ <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>7.1 -
+ Registering with an Aggregator 35</P>
+ <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>7.2 -
+ Ping Targets, Common and Custom 35</P>
+ <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>7.3 -
+ Setting up Automated Pings 35</P>
+ <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>7.4 -
+ Sending a Manual Ping 36</P>
+ <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>7.5 -
+ Creating and Editing Custom Ping Targets 37</P>
+ <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>7.6 -
+ More on Registering with an Aggregator 39</P>
<P STYLE="margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>8
- - Using weblog pings 42</B></FONT></P>
+ - Roller administration 40</B></FONT></P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>8.1 -
- Registering with an Aggregator 42</P>
+ Managing users 40</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>8.2 -
- Ping Targets, Common and Custom 42</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>8.3 -
- Setting up Automated Pings 42</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>8.4 -
- Sending a Manual Ping 44</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>8.5 -
- Creating and Editing Custom Ping Targets 44</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>8.6 -
- More on Registering with an Aggregator 46</P>
+ Configuring Roller 42</P>
<P STYLE="margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>9
- - Roller administration 47</B></FONT></P>
+ - Weblog update ping administration 45</B></FONT></P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>9.1 -
- Managing users 47</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>9.2 -
- Configuring Roller 49</P>
+ Creating and editing common ping targets 45</P>
+ <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>9.2 - How
+ Roller Processes Weblog Update Pings 45</P>
+ <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>9.3 -
+ Configuration Properties Controlling Ping Processing 46</P>
+ <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>9.4 -
+ Suspending all ping processing 46</P>
+ <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>9.5 -
+ Controlling and disabling ping usage 46</P>
+ <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>9.6 -
+ Initialization of common ping targets 47</P>
<P STYLE="margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>10
- - Weblog update ping administration 52</B></FONT></P>
+ - Planet Roller administration 48</B></FONT></P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>10.1 -
- Creating and editing common ping targets 52</P>
+ Setting up the Planet aggregator 48</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>10.2 -
- How Roller Processes Weblog Update Pings 52</P>
+ Configuring Planet Roller 49</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>10.3 -
- Configuration Properties Controlling Ping Processing 53</P>
+ Adding external weblogs to Planet Roller 50</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>10.4 -
- Suspending all ping processing 53</P>
+ Adding custom groups to Planet Roller 51</P>
<P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>10.5 -
- Controlling and disabling ping usage 53</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>10.6 -
- Initialization of common ping targets 54</P>
- <P STYLE="margin-bottom: 0in"><FONT SIZE=4 STYLE="font-size: 16pt"><B>11
- - Planet Roller administration 55</B></FONT></P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>11.1 -
- Setting up the Planet aggregator 55</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>11.2 -
- Configuring Planet Roller 56</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>11.3 -
- Adding external subscriptions to Planet Roller 57</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>11.4 -
- The Planet Roller main page 58</P>
- <P STYLE="margin-left: 0.2in; margin-bottom: 0in"></SPAN>11.5 -
- Adding custom groups to Planet 59</P>
+ Using Planet Roller data in your weblog pages 52</P>
</DIV>
- <P><BR><BR>
+ <P CLASS="western"><BR><BR>
</P>
<DIV ID="Illustration Index1" DIR="LTR">
<DIV ID="Illustration Index1_Head" DIR="LTR">
@@ -281,503 +268,519 @@
navbar 8</P>
<P STYLE="margin-bottom: 0in">Illustration 6: Main menu 9</P>
<P STYLE="margin-bottom: 0in">Illustration 7: Weblog editor 10</P>
- <P STYLE="margin-bottom: 0in">Illustration 8: Edit entries page 12</P>
- <P STYLE="margin-bottom: 0in">Illustration 9: Podcast URL field 16</P>
+ <P STYLE="margin-bottom: 0in">Illustration 8: Edit entries page 13</P>
+ <P STYLE="margin-bottom: 0in">Illustration 9: Podcast URL field 17</P>
<P STYLE="margin-bottom: 0in">Illustration 10Comment (and
- trackback) management page 18</P>
+ trackback) management page 19</P>
<P STYLE="margin-bottom: 0in">Illustration 11: Send trackback
- control 20</P>
+ control 21</P>
<P STYLE="margin-bottom: 0in">Illustration 12: Result of sending
- trackback 20</P>
+ trackback 21</P>
<P STYLE="margin-bottom: 0in">Illustration 13: Weblog preferences
- menu 21</P>
+ menu 23</P>
<P STYLE="margin-bottom: 0in">Illustration 14: Weblog settings
- page part 1 22</P>
+ page part 1 24</P>
<P STYLE="margin-bottom: 0in">Illustration 15: Weblog settings
- page part 2 24</P>
+ page part 2 26</P>
<P STYLE="margin-bottom: 0in">Illustration 16: Theme selection
- page 25</P>
- <P STYLE="margin-bottom: 0in">Illustration 17: Weblog permissions
page 27</P>
- <P STYLE="margin-bottom: 0in">Illustration 18: Weblog templates
+ <P STYLE="margin-bottom: 0in">Illustration 17: Weblog permissions
page 29</P>
- <P STYLE="margin-bottom: 0in">Illustration 19: Edit template
- page 30</P>
- <P STYLE="margin-bottom: 0in">Illustration 20: Theme directory
- structure 35</P>
- <P STYLE="margin-bottom: 0in">Illustration 21: Bookmarks
- management page 37</P>
- <P STYLE="margin-bottom: 0in">Illustration 22: Add and edit
- bookmark form 38</P>
- <P STYLE="margin-bottom: 0in">Illustration 23: Add folder form 39</P>
- <P STYLE="margin-bottom: 0in">Illustration 24: Automatic ping
- configuration page 43</P>
- <P STYLE="margin-bottom: 0in">Illustration 25: Custom ping targets
- page 45</P>
- <P STYLE="margin-bottom: 0in">Illustration 26: Edit ping target
- form 45</P>
- <P STYLE="margin-bottom: 0in">Illustration 27: User admin page 47</P>
- <P STYLE="margin-bottom: 0in">Illustration 28: User admin form 48</P>
- <P STYLE="margin-bottom: 0in">Illustration 29: Config page: site
- settings 49</P>
- <P STYLE="margin-bottom: 0in">Illustration 30: Config page: user
- settings 49</P>
- <P STYLE="margin-bottom: 0in">Illustration 31: Config page: file
- upload settings 50</P>
- <P STYLE="margin-bottom: 0in">Illustration 32: Config page:
- newsfeed settings 50</P>
- <P STYLE="margin-bottom: 0in">Illustration 33: Common weblog ping
- targets 51</P>
- <P STYLE="margin-bottom: 0in">Illustration 34: Planet config
- page 55</P>
- <P STYLE="margin-bottom: 0in">Illustration 35: Planet
- subscriptions page 56</P>
- <P STYLE="margin-bottom: 0in">Illustration 36: Planet front
- page 57</P>
+ <P STYLE="margin-bottom: 0in">Illustration 18: Bookmarks
+ management page 31</P>
+ <P STYLE="margin-bottom: 0in">Illustration 19: Add and edit
+ bookmark form 32</P>
+ <P STYLE="margin-bottom: 0in">Illustration 20: Add folder form 33</P>
+ <P STYLE="margin-bottom: 0in">Illustration 21: Automatic ping
+ configuration page 37</P>
+ <P STYLE="margin-bottom: 0in">Illustration 22: Custom ping targets
+ page 39</P>
+ <P STYLE="margin-bottom: 0in">Illustration 23: Edit ping target
+ form 39</P>
+ <P STYLE="margin-bottom: 0in">Illustration 24: User admin page 41</P>
+ <P STYLE="margin-bottom: 0in">Illustration 25: User admin form 42</P>
+ <P STYLE="margin-bottom: 0in">Illustration 26: Config page: site
+ settings 43</P>
+ <P STYLE="margin-bottom: 0in">Illustration 27: Config page: user
+ settings 43</P>
+ <P STYLE="margin-bottom: 0in">Illustration 28: Config: comments 44</P>
+ <P STYLE="margin-bottom: 0in">Illustration 29: Config page: file
+ upload settings 45</P>
+ <P STYLE="margin-bottom: 0in">Illustration 30: Config page:
+ newsfeed settings 45</P>
+ <P STYLE="margin-bottom: 0in">Illustration 31: Common weblog ping
+ targets 46</P>
+ <P STYLE="margin-bottom: 0in">Illustration 32: Planet config
+ page 50</P>
+ <P STYLE="margin-bottom: 0in">Illustration 33: Planet
+ subscriptions page 51</P>
+ <P STYLE="margin-bottom: 0in">Illustration 34: Planet front
+ page 52</P>
+ <P STYLE="margin-bottom: 0in">Illustration 35: Planet custom
+ groups page 53</P>
</DIV>
- <P STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" STYLE="margin-bottom: 0in"><BR>
</P>
- <P STYLE="margin-bottom: 0in"><BR>
+ <P CLASS="western" STYLE="margin-bottom: 0in"><BR>
</P>
<H1 CLASS="western" STYLE="page-break-before: always">1 - Introduction</H1>
- <P>This user guide describes how to use Roller, a web application
- that can support a single user weblog, thousands of weblogs and/or
- group weblogs. You'll learn how to register as a new user, create
- weblogs, edit and post weblog entries and manage your weblog.
- You'll also learn how to customize your weblog's <I>blogroll</I>, a
- list of links to your favorite web sites,and how to change the
+ <P CLASS="western">This user guide describes how to use Roller, a
+ web application that can support a single user weblog, thousands of
+ weblogs and/or group weblogs. You'll learn how to register as a new
+ user, create weblogs, edit and post weblog entries and manage your
+ weblog. You'll also learn how to customize your weblog's <I>blogroll</I>,
+ a list of links to your favorite web sites,and how to change the
look-and-feel or <I>theme</I> of your weblog.</P>
- <P>A word about terminology is necessary because the word weblog is
- both a noun and a verb. In this guide we use the words weblog and
- weblog entry as follows:
+ <P CLASS="western">A word about terminology is necessary because
+ the word weblog is both a noun and a verb. In this guide we use the
+ words weblog and weblog entry as follows:
</P>
<UL>
- <LI><P STYLE="margin-bottom: 0in"><I>Weblog</I>: a weblog or blog
- is an online journal written by one or more authors. In Roller a
- weblog consists of weblog entries, weblog categories, favorite
- bookmarks and settings that define the appearance and behavior of
- the weblog.
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in"><I>Weblog</I>: a
+ weblog or blog is an online journal written by one or more
+ authors. In Roller a weblog consists of weblog entries, weblog
+ categories, favorite bookmarks and settings that define the
+ appearance and behavior of the weblog.
</P>
- <LI><P><I>Weblog entry</I>: a weblog entry is an individual entry
- within a weblog with a title, date and text.
+ <LI><P CLASS="western"><I>Weblog entry</I>: a weblog entry is an
+ individual entry within a weblog with a title, date and text.
</P>
</UL>
<H1 CLASS="western">2 - Getting started with Roller</H1>
- <P>We'll start by explaining how to get started with a fresh Roller
- server, one that was just created and has no users at all. If you
- are using an existing Roller server, which has already been setup
- by somebody else, then you can skip to section <A HREF="#2.2.Getting%20started%20with%20an%20existing%20Roller%20installation%7Coutline">2.2
+ <P CLASS="western">We'll start by explaining how to get started
+ with a fresh Roller server, one that was just created and has no
+ users at all. If you are using an existing Roller server, which has
+ already been setup by somebody else, then you can skip to section
+ <A HREF="#2.2.Getting%20started%20with%20an%20existing%20Roller%20installation%7Coutline">2.2
- 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>
- <P>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. Later, you can
- use that admin user to grant global admin permission to other
- users. Here's how to create your first user:
+ <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.
+ Later, you can use that admin user to grant global admin permission
+ to other users. Here's how to create your first user:
</P>
- <P><B>How to create the first user and weblog on a fresh Roller
- site:</B>
+ <P CLASS="western"><B>How to create the first user and weblog on a
+ fresh Roller site:</B>
</P>
<OL>
- <LI><P STYLE="margin-bottom: 0in">Start Roller and navigate to the
- main page (e.g. <A HREF="http://localhost:8080/roller%29.">http://localhost:8080/roller).
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in">Start Roller and
+ navigate to the main page (e.g. <A HREF="http://localhost:8080/roller%29.">http://localhost:8080/roller).
</A>
</P>
- <LI><P STYLE="margin-bottom: 0in">Click the <B>Register</B> link
- in the top right corner of the page.
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in">Click the
+ <B>Register</B> link in the top right corner of the page.
</P>
- <LI><P STYLE="margin-bottom: 0in">Fill out the information for
- your new user, perhaps using the username 'admin' since the first
- user is the admin user. Once you've filled out the form. click the
- <B>Register User</B> button.
- </P>
- <LI><P STYLE="margin-bottom: 0in">On the Welcome to Roller page,
- choose the <B>Click here</B> link to login as your new user.
- You'll be taken to the Roller Main Menu page.
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in">Fill out the
+ information for your new user, perhaps using the username 'admin'
+ since the first user is the admin user. Once you've filled out the
+ form. click the <B>Register User</B> button.
+ </P>
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in">On the Welcome
+ to Roller page, choose the <B>Click here</B> link to login as your
+ new user. You'll be taken to the Roller Main Menu page.
+ </P>
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in">On the Main Menu
+ page, click the <B>create a weblog</B> link to create a new
+ weblog.
</P>
- <LI><P STYLE="margin-bottom: 0in">On the Main Menu page, click the
- <B>create a weblog</B> link to create a new weblog.
- </P>
- <LI><P>Fill out the Create Weblog page and when you're done click
- the <B>Create Weblog</B> button.
+ <LI><P CLASS="western">Fill out the Create Weblog page and when
+ 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>
2.2 - Getting started with an existing Roller installation</H2>
- <P>To get started on an existing Roller installation, first you
- need to create a user account. Once you've done that, you can
- create one or more weblogs for your user.
- </P>
- <P><B>How to create a user account</B>
- </P>
- <P>Some Roller sites require you to use a separate system to create
- a Roller account. For example, at Sun we require blogs.sun.com
- bloggers to register using an internal system called BAM.
+ <P CLASS="western">To get started on an existing Roller
+ installation, first you need to create a user account. Once you've
+ done that, you can create one or more weblogs for your user.
+ </P>
+ <P CLASS="western"><B>How to create a user account</B>
+ </P>
+ <P CLASS="western">Some Roller sites require you to use a separate
+ system to create a Roller account. For example, at Sun we require
+ blogs.sun.com bloggers to register using an internal system called
+ BAM.
</P>
- <P>With a stock Roller installation, here's how you register a new
- user:
+ <P CLASS="western">With a stock Roller installation, here's how you
+ register a new user:
</P>
<OL>
- <LI><P STYLE="margin-bottom: 0in">Use your web browser to go to
- the main page of the Roller installation
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in">Use your web
+ browser to go to the main page of the Roller installation
</P>
- <LI><P STYLE="margin-bottom: 0in">Click the <B>Register</B> link
- in the top right corner of the page
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in">Click the
+ <B>Register</B> link in the top right corner of the page
</P>
- <LI><P STYLE="margin-bottom: 0in">Fill out the information for
- your new user. Once you've filled out the form. click the <B>Register
- User</B> button.
- </P>
- <LI><P>On the Welcome to Roller page, choose the <B>Click here</B>
- link to login as your new user. You'll be taken to the Roller Main
- Menu page.
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in">Fill out the
+ information for your new user. Once you've filled out the form.
+ click the <B>Register User</B> button.
+ </P>
+ <LI><P CLASS="western">On the Welcome to Roller page, choose the
+ <B>Click here</B> link to login as your new user. You'll be taken
+ to the Roller Main Menu page.
</P>
</OL>
- <P><B>How to create a weblog for your user</B>
+ <P CLASS="western"><B>How to create a weblog for your user</B>
</P>
- <P>Here's how you create a new Roller weblog for your user:
+ <P CLASS="western">Here's how you create a new Roller weblog for
+ your user:
</P>
<OL>
- <LI><P STYLE="margin-bottom: 0in">Login to Roller by clicking the
- <B>Login</B> or the <B>Main Menu</B> link
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in">Login to Roller
+ by clicking the <B>Login</B> or the <B>Main Menu</B> link
</P>
- <LI><P STYLE="margin-bottom: 0in">On the Main Menu page, click the
- <B>create a weblog</B> link to create a new weblog.
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in">On the Main Menu
+ page, click the <B>create a weblog</B> link to create a new
+ weblog.
</P>
- <LI><P>Fill out the Create Weblog page and when you're done click
- the <B>Create Weblog</B> button.
+ <LI><P CLASS="western">Fill out the Create Weblog page and when
+ you're done click the <B>Create Weblog</B> button.
</P>
</OL>
<H2>2.3 - Accepting an invitation to join a weblog</H2>
- <P>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 at the top
- of the Main Menu page. Depending on how Roller is configured, you
- may also get an email message that informs you of the invitation.
- To accept an invitation, login to Roller go to the Main Menu page
- and you'll see something like this.</P>
- <P><SPAN ID="Frame1" DIR="LTR" STYLE="float: left; width: 5.61in; height: 1.84in; border: none; padding: 0in; background: #ffffff">
+ <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
+ at the top of the Main Menu page. Depending on how Roller is
+ configured, you may also get an email message that informs you of
+ the invitation. To accept an invitation, login to Roller go to the
+ Main Menu page and you'll see something like this.</P>
+ <P CLASS="western"><SPAN ID="Frame1" DIR="LTR" STYLE="float: left; width: 5.61in; height: 1.84in; border: none; padding: 0in; background: #ffffff">
<P STYLE="margin-top: 0.08in"><IMG SRC="roller-user-guide_html_5c796a10.png" NAME="graphics1" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
1: Main Menu with invitation to join a group blog</I></FONT></P>
</SPAN><BR CLEAR=LEFT>
</P>
- <P>That's an invitation to join the weblog with the handle
- 'adminblog'. To accept click the accept button. Once you do, you'll
- be a member of the weblog and the weblog will appear on your Main
- Menu page as one of your weblogs.
+ <P CLASS="western">That's an invitation to join the weblog with the
+ handle 'adminblog'. To accept click the accept button. Once you do,
+ 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>
- <P>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 privileges) the Roller
- installation itself.
- </P>
- <P><B>Find your way around the editor interface</B>
- </P>
- <P>No matter where you go in the Roller <I>editor interface</I>,
- you'll always see a <I>status bar</I> across the top of the page
- with convenient links to the Roller front page and main menu.
+ <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
+ privileges) the Roller installation itself.
+ </P>
+ <P CLASS="western"><B>Find your way around the editor interface</B>
+ </P>
+ <P CLASS="western">No matter where you go in the Roller <I>editor
+ interface</I>, you'll always see a <I>status bar</I> across the top
+ of the page with convenient links to the Roller front page and main
+ menu.
</P>
- <P><SPAN ID="Frame2" DIR="LTR" STYLE="float: left; width: 6.78in; height: 0.43in; border: none; padding: 0in; background: #ffffff">
+ <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"><IMG SRC="roller-user-guide_html_5e921c9f.png" NAME="graphics3" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
2: Status bar, no weblog</I></FONT></P>
</SPAN><BR CLEAR=LEFT>
</P>
- <P><BR><BR>
+ <P CLASS="western"><BR><BR>
</P>
- <P>That's what the status bar looks like when you are logged in
- (assuming your username is 'admin'), but you haven't chosen a
- specific weblog in which to work. What's going on here?
+ <P CLASS="western">That's what the status bar looks like when you
+ are logged in (assuming your username is 'admin'), but you haven't
+ chosen a specific weblog in which to work. What's going on here?
</P>
<UL>
- <LI><P STYLE="margin-bottom: 0in">The text on the left indicates
- that you are logged in as user admin.
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in">The text on the
+ left indicates that you are logged in as user admin.
</P>
- <LI><P STYLE="margin-bottom: 0in">On the right, the words <B>Front
- Page</B> link to the front page of the Roller site. Your site's
- administrator may have changed the words Front Page to something
- else, but the link should still take you to the site's front page.
- </P>
- <LI><P>Also on the right, the words <B>Main Menu</B> link to the
- main menu of Roller, where you can manage your weblog(s), create
- new weblogs and accept invitations to join other user's weblogs.
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in">On the right,
+ the words <B>Front Page</B> link to the front page of the Roller
+ site. Your site's administrator may have changed the words Front
+ Page to something else, but the link should still take you to the
+ site's front page.
+ </P>
+ <LI><P CLASS="western">Also on the right, the words <B>Main Menu</B>
+ link to the main menu of Roller, where you can manage your
+ weblog(s), create new weblogs and accept invitations to join other
+ user's weblogs.
</P>
</UL>
- <P>If you are logged into Roller and you are editing one specific
- weblog, the status bar will include a link to that weblog. For
- example, the bar below indicates that user 'admin' is logged-in and
- editing weblog called 'adminblog.'
+ <P CLASS="western">If you are logged into Roller and you are
+ editing one specific weblog, the status bar will include a link to
+ that weblog. For example, the bar below indicates that user 'admin'
+ is logged-in and editing weblog called 'adminblog.'
</P>
- <P><SPAN ID="Frame3" DIR="LTR" STYLE="float: left; width: 6.78in; height: 0.44in; border: none; padding: 0in; background: #ffffff">
+ <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"><IMG SRC="roller-user-guide_html_406a562a.png" NAME="graphics4" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
3: Status bar within weblog</I></FONT></P>
</SPAN><BR CLEAR=LEFT>
</P>
- <P><BR><BR>
+ <P CLASS="western"><BR><BR>
</P>
- <P><B>Going from your weblog back to the editor interface</B>
+ <P CLASS="western"><B>Going from your weblog back to the editor
+ interface</B>
</P>
- <P>When you're on your weblog page and you need a way to get back
- to the Roller editor interface, look for the <I>weblog navbar</I>.
- All of Roller's built-in themes include the navbar. It looks
- slightly different in each theme, but it always includes the same
- set of links.
+ <P CLASS="western">When you're on your weblog page and you need a
+ way to get back to the Roller editor interface, look for the <I>weblog
+ navbar</I>. All of Roller's built-in themes include the navbar. It
+ looks slightly different in each theme, but it always includes the
+ same set of links.
</P>
- <P>
+ <P CLASS="western">
</P>
- <P><SPAN ID="Frame4" DIR="LTR" STYLE="float: left; width: 2.16in; height: 1.47in; border: none; padding: 0in; background: #ffffff">
+ <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"><IMG SRC="roller-user-guide_html_3fb97cd5.png" NAME="graphics5" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
4: Weblog navigation bar</I></FONT></P>
</SPAN><BR CLEAR=LEFT><BR><BR>
</P>
- <P>That's what weblog navbar looks like this when you are <I>not</I>
- logged in (note that the exact appearance varies in each theme).
- The words <B>Front Page</B> link to the front page of the Roller
- installation and as with the front page link in the banner-status
- bar, the words may be different on your site. Next are links to the
- public pages of the weblog, and this particular weblog includes
- pages called <B>Weblog</B> and <B>About</B>. Finally, there is a
- link to <B>Login</B>.
+ <P CLASS="western">That's what weblog navbar looks like this when
+ you are <I>not</I> logged in (note that the exact appearance varies
+ in each theme). The words <B>Front Page</B> link to the front page
+ of the Roller installation and as with the front page link in the
+ banner-status bar, the words may be different on your site. Next
+ are links to the public pages of the weblog, and this particular
+ weblog includes pages called <B>Weblog</B> and <B>About</B>.
+ Finally, there is a link to <B>Login</B>.
</P>
- <P>
+ <P CLASS="western">
</P>
- <P><BR><BR>
+ <P CLASS="western"><BR><BR>
</P>
- <P><SPAN ID="Frame5" DIR="LTR" STYLE="float: left; width: 2.4in; height: 3.5in; border: none; padding: 0in; background: #ffffff">
+ <P CLASS="western"><SPAN ID="Frame5" DIR="LTR" STYLE="float: left; width: 2.4in; height: 3.5in; border: none; padding: 0in; background: #ffffff">
<P STYLE="margin-top: 0.08in"><IMG SRC="roller-user-guide_html_6e5d8126.png" NAME="graphics6" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
5: Weblog editor navbar</I></FONT></P>
</SPAN><BR CLEAR=LEFT><BR><BR>
</P>
- <P>That's what weblog navbar looks like this when you are <I>are</I>
- logged in. After the familiar Front Page link and the page links
- there's a link to the weblog's New Entry page, the weblog's
- Settings page and a <B>Logout</B> link.
- </P>
- <P>After the logout link is the <I>editor navbar</I>, which
- includes shortcuts to all of the editor pages for this particular
- weblog. It is also included on all of the built-in Roller themes,
- but is a separate component from the plain old weblog navbar.
- </P>
- <P>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 CLASS="western">That's what weblog navbar looks like this when
+ you are <I>are</I> logged in. After the familiar Front Page link
+ and the page links there's a link to the weblog's New Entry page,
+ the weblog's Settings page and a <B>Logout</B> link.
+ </P>
+ <P CLASS="western">After the logout link is the <I>editor navbar</I>,
+ which includes shortcuts to all of the editor pages for this
+ particular weblog. It is also included on all of the built-in
+ Roller themes, but is a separate component from the plain old
+ weblog navbar.
+ </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>
<H2>2.5 Changing the Language of the editor interface</H2>
- <P>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 select your
- preferred locale when registering or, if you have already
- registered, on the Your Profile page. If a translation for your
- preferred language is available on your Roller installation, the
- editor interface will use this language for all the editor pages.
- If you have selected your preferred language and the pages are
- still displayed in English (or the default language of your Roller
- installation?) there may not be a translation available for your
- language. (If you or the person(s) responsible for your Roller
- installation would like to translate Roller to an additional
+ <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
+ select your preferred locale when registering or, if you have
+ already registered, on the Your Profile page. If a translation for
+ your preferred language is available on your Roller installation,
+ the editor interface will use this language for all the editor
+ pages. If you have selected your preferred language and the pages
+ are still displayed in English (or the default language of your
+ Roller installation?) there may not be a translation available for
+ your language. (If you or the person(s) responsible for your
+ Roller installation would like to translate Roller to an additional
language, please visit the Roller project website...)
(Translations are currently available for...)</P>
<H1 CLASS="western" STYLE="page-break-before: always">3 - Creating
and editing your weblog</H1>
- <P>First, you login 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. 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 CLASS="western">First, you login 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. 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><SPAN ID="Frame6" DIR="LTR" STYLE="float: left; width: 6.33in; height: 4.34in; border: none; padding: 0in; background: #ffffff">
+ <P CLASS="western"><SPAN ID="Frame6" DIR="LTR" STYLE="float: left; width: 6.33in; height: 4.34in; border: none; padding: 0in; background: #ffffff">
<P STYLE="margin-top: 0.08in"><IMG SRC="roller-user-guide_html_m37111dbc.png" NAME="graphics7" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
6: Main menu</I></FONT></P>
</SPAN><BR CLEAR=LEFT><BR><BR>
</P>
- <P>The main menu page lists all of your weblogs and for each, shows
- you links to its New Entry, Edit Entries and Settings pages. You
- can also create a new weblog, edit your user profile and perform
- administrative duties (if you have global admin permissions).
+ <P CLASS="western">The main menu page lists all of your weblogs and
+ for each, shows you links to its New Entry, Edit Entries and
+ Settings pages. You can also create a new weblog, edit your user
+ 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>
- <P>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 from the Category combo, and
- hit the <B>Post to Weblog</B> button. As soon as you do that, your
- weblog entry is posted to your weblog for the world to see. Here is
- the relevant part of the New Entry page.
+ <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
+ from the Category combo, and hit the <B>Post to Weblog</B> button.
+ As soon as you do that, your weblog entry is posted to your weblog
+ for the world to see. Here is the relevant part of the New Entry
+ page.
</P>
- <P>
+ <P CLASS="western">
</P>
- <P><SPAN ID="Frame7" DIR="LTR" STYLE="float: left; width: 6.71in; height: 7.54in; border: none; padding: 0in; background: #ffffff">
+ <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"><FONT SIZE=2><I>Illustration 7:
Weblog editor</I></FONT></P>
<P STYLE="margin-top: 0.08in"><IMG SRC="roller-user-guide_html_27fdfebe.png" NAME="graphics8" ALIGN=LEFT WIDTH=613 HEIGHT=686 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
</SPAN><BR CLEAR=LEFT><BR><BR>
</P>
- <P>The above screenshow shows the RTE weblog entry editor
- (editor-rte.jsp), a rich text editor that creates the HTML for you.
- If you prefer to edit the HTML yourself, you can switch to the
- plain text editor (editor-text.jsp). Use the Preferences:Settings
- page to pick the weblog editor page you'd like to use.</P>
- <P>Let's cover the fields on the page:
+ <P CLASS="western">The above screenshow shows the RTE weblog entry
+ editor (editor-rte.jsp), a rich text editor that creates the HTML
+ for you. If you prefer to edit the HTML yourself, you can switch to
+ the plain text editor (editor-text.jsp). Use the
+ Preferences:Settings page to pick the weblog editor page you'd like
+ to use.</P>
+ <P CLASS="western">Let's cover the fields on the page:
</P>
<UL>
- <LI><P><B>Title</B>: this is the title for your post, it is
- required.</P>
+ <LI><P CLASS="western"><B>Title</B>: this is the title for your
+ post, it is required.</P>
</UL>
<UL>
- <LI><P><B>Category</B>: You must pick a category for your entry.
- You can change the list of categories available in your weblog by
- using the <B>Create & Edit:Categories</B> page.
- </P>
+ <LI><P CLASS="western"><B>Category</B>: You must pick a category
+ for your entry. You can change the list of categories available in
+ your weblog by using the <B>Create & Edit:Categories</B> page.
+ </P>
</UL>
<UL>
- <LI><P><B>Pub Time</B>: You don't need to set this unless you want
- to post at a specific time in the past or in the future. The best
- thing to do is to leave it blank. Roller will set it for you when
- you click the Post to Weblog button to publish your new weblog
- entry.</P>
+ <LI><P CLASS="western"><B>Pub Time</B>: You don't need to set this
+ unless you want to post at a specific time in the past or in the
+ future. The best thing to do is to leave it blank. Roller will set
+ it for you when you click the Post to Weblog button to publish
+ your new weblog entry.</P>
</UL>
<UL>
- <LI><P><B>Status</B>: This field displays the status of your
- weblog entry. The possible values are Not saved, Draft and
- Published.
+ <LI><P CLASS="western"><B>Status</B>: This field displays the
+ status of your weblog entry. The possible values are Not saved,
+ Draft and Published.
</P>
</UL>
<UL>
- <LI><P><B>Summary (optional)</B>: For long posts, you might want
- to enter a sentence or two as summary in addition to the content.
- If you do, your short summary will appear on the front page of
- your weblog and the content will appear on the single-entry view.
- Your summary will also be included in your newsfeed in an
- <FONT FACE="Courier New"><atom:summary></FONT> element.</P>
- <LI><P><B>Content</B>: This is where you put the body of your
- weblog entry.</P>
+ <LI><P CLASS="western"><B>Summary (optional)</B>: For long posts,
+ you might want to enter a sentence or two as summary in addition
+ to the content. If you do, your short summary will appear on the
+ front page of your weblog and the content will appear on the
+ single-entry view. Your summary will also be included in your
+ newsfeed in an <FONT FACE="Courier New"><atom:summary></FONT>
+ element.</P>
+ <LI><P CLASS="western"><B>Content</B>: This is where you put the
+ body of your weblog entry.</P>
</UL>
- <P><BR><BR>
+ <P CLASS="western"><BR><BR>
</P>
- <P>Below the weblog entry fields are the Other Settings
+ <P CLASS="western">Below the weblog entry fields are the Other
+ Settings
</P>
<UL>
- <LI><P><B>Comment Settings</B>: Click on the little plus-sign plus
- (+) to expand the Comment Settings control, where you can
- enable/disable comments on your blog entry.
+ <LI><P CLASS="western"><B>Comment Settings</B>: Click on the
+ little plus-sign plus (+) to expand the Comment Settings control,
+ where you can enable/disable comments on your blog entry.
</P>
</UL>
<UL>
- <LI><P><B>Plugins to Apply</B>: This control allows you to pick
- which plugins are to be applied to this entry. For example, if you
- want ;-) smilies in your text to be replaced with smiley-face
- images, choose the emoticons plugin. You can set which plugins are
- to be applied by default on your weblog's <B>Preferences:Settings</B>
- page. Note that your Roller site administator controls the list of
- available plugins. Here's the current list of plugins included in
- Roller:
+ <LI><P CLASS="western"><B>Plugins to Apply</B>: This control
+ allows you to pick which plugins are to be applied to this entry.
+ For example, if you want ;-) smilies in your text to be replaced
+ with smiley-face images, choose the emoticons plugin. You can set
+ which plugins are to be applied by default on your weblog's
+ <B>Preferences:Settings</B> page. Note that your Roller site
+ administator controls the list of available plugins. Here's the
+ current list of plugins included in Roller:
</P>
</UL>
<UL>
<UL>
- <LI><P STYLE="margin-bottom: 0in">Convert Line Breaks</P>
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in">Convert Line
+ Breaks</P>
</UL>
</UL>
<UL>
<UL>
- <LI><P>Topic Tags</P>
- <LI><P>Textile Formatter</P>
- <LI><P>Acronyms</P>
- <LI><P>Bookmark Linker</P>
- <LI><P>Email Scrambler</P>
- <LI><P>Emoticons</P>
- <LI><P>Read More Summary – <I>deprecated: use a summary
- instead</I></P>
+ <LI><P CLASS="western">Topic Tags</P>
+ <LI><P CLASS="western">Textile Formatter</P>
+ <LI><P CLASS="western">Acronyms</P>
+ <LI><P CLASS="western">Bookmark Linker</P>
+ <LI><P CLASS="western">Email Scrambler</P>
+ <LI><P CLASS="western">Emoticons</P>
+ <LI><P CLASS="western">Read More Summary – <I>deprecated:
+ use a summary instead</I></P>
</UL>
</UL>
<UL>
- <LI><P><B>Misc settings</B>: Here you can control misc. settings
- like text right-to-left and, if you're an administaror, you can
- "pin" an entry to the top of the front-page of the site.
- </P>
+ <LI><P CLASS="western"><B>Misc settings</B>: Here you can control
+ misc. settings like text right-to-left and, if you're an
+ administaror, you can "pin" an entry to the top of the
+ front-page of the site.
+ </P>
</UL>
<UL>
- <LI><P><B>MediaCast settings</B>: This control allows you to
- specify the URL of a file to be included in your blog entry as an
- RSS enclosure, also known as a <I>podcast</I>. See the next
- section for more information on podcasting with Roller.
+ <LI><P CLASS="western"><B>MediaCast settings</B>: This control
+ allows you to specify the URL of a file to be included in your
+ blog entry as an RSS enclosure, also known as a <I>podcast</I>.
+ See the next section for more information on podcasting with
+ Roller.
</P>
</UL>
- <P>Below that is a row of buttons.
+ <P CLASS="western">Below that is a row of buttons.
</P>
<UL>
- <LI><P><B>Post To Weblog</B>: Don't click this button until
- ABSOLUTELY SURE you're ready to publish your weblog entry for the
- entire world to see.
+ <LI><P CLASS="western"><B>Post To Weblog</B>: Don't click this
+ button until ABSOLUTELY SURE you're ready to publish your weblog
+ entry for the entire world to see.
</P>
</UL>
<UL>
- <LI><P><B>Submit for Review</B>: If you only have limited blogger
- rights in the weblog, you won' t see the Post to Weblog button
- because limited bloggers are not allowed to publish directly.
- Instead, you'll see a Submit for Review button. Click this button
- when you are ready for the authors of the blog you are working in
- to review your work and either publish or save it as a draft and
- ask you to revise it.
+ <LI><P CLASS="western"><B>Submit for Review</B>: If you only have
+ limited blogger rights in the weblog, you won' t see the Post to
+ Weblog button because limited bloggers are not allowed to publish
+ directly. Instead, you'll see a Submit for Review button. Click
+ this button when you are ready for the authors of the blog you are
+ working in to review your work and either publish or save it as a
+ draft and ask you to revise it.
</P>
</UL>
<UL>
- <LI><P><B>Save as Draft</B>: Click this button to save your post
- as a draft entry for editing later.
+ <LI><P CLASS="western"><B>Save as Draft</B>: Click this button to
+ save your post as a draft entry for editing later.
</P>
</UL>
<UL>
- <LI><P><B>Preview</B>: Click this button to see what your post
- will look like when displayed in a browser. Not that preview is
- not exactly like what you'll see because you weblog may have
- different font and style settings than the edit weblog page, but
- it will be pretty close.
+ <LI><P CLASS="western"><B>Preview</B>: Click this button to see
+ what your post will look like when displayed in a browser. Not
+ that preview is not exactly like what you'll see because you
+ weblog may have different font and style settings than the edit
+ weblog page, but it will be pretty close.
</P>
</UL>
<UL>
- <LI><P><B>Spell Check</B>: Click this button to spell check your
- post. Be forewarned that Roller's spell checker is far from
- perfect. It catches HTML tags as spelling errors and its user
- interface is clunky. We're investigating alternatives.</P>
+ <LI><P CLASS="western"><B>Spell Check</B>: Click this button to
+ spell check your post. Be forewarned that Roller's spell checker
+ is far from perfect. It catches HTML tags as spelling errors and
+ its user interface is clunky. We're investigating alternatives.</P>
</UL>
<H2>3.2 - Finding and editing weblog entries</H2>
- <P>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 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>
- <P>If you go to the <B>Create & Edit:New Entry</B> page, you'll
- see on the right a list of recent Pending Entries, Draft Entries,
- and Recent Entries. You can edit any of these by simply clicking on
- title.
+ <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,
+ Draft Entries, and Recent Entries. You can edit any of these by
+ simply clicking on title.
</P>
<UL>
- <LI><P STYLE="margin-bottom: 0in"><I>Pending Entries</I> are
- entries created by limited bloggers who are not allowed to publish
- directly to the web. If you have author or admin permission in the
- blog you can edit and publish these entries.
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in"><I>Pending
+ Entries</I> are entries created by limited bloggers who are not
+ allowed to publish directly to the web. If you have author or
+ admin permission in the blog you can edit and publish these
+ entries.
</P>
- <LI><P STYLE="margin-bottom: 0in"><I>Draft Entries</I> are entries
- that are not yet visible on the web becuase you, or somebody else
- in your weblog is not yet done editing them. You can edit any
- draft entries in your weblog.
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in"><I>Draft Entries</I>
+ are entries that are not yet visible on the web becuase you, or
+ somebody else in your weblog is not yet done editing them. You can
+ edit any draft entries in your weblog.
</P>
- <LI><P><I>Recent Entries</I> are entries that have been published
- to the web. If you have author or admin permission in the blog you
- can edit and re-publish these entries.
+ <LI><P CLASS="western"><I>Recent Entries</I> are entries that have
+ been published to the web. If you have author or admin permission
+ in the blog you can edit and re-publish these entries.
</P>
</UL>
- <P><BR><BR>
+ <P CLASS="western"><BR><BR>
</P>
- <P><SPAN ID="Frame28" DIR="LTR" STYLE="float: left; width: 6.85in; height: 5.23in; border: none; padding: 0in; background: #ffffff">
+ <P CLASS="western"><SPAN ID="Frame28" DIR="LTR" STYLE="float: left; width: 6.85in; height: 5.23in; border: none; padding: 0in; background: #ffffff">
<P STYLE="margin-top: 0.08in"><IMG SRC="roller-user-guide_html_m199b047d.png" NAME="graphics11" ALIGN=LEFT WIDTH=658 HEIGHT=485 BORDER=0><BR CLEAR=LEFT><BR><BR>
</P>
<P STYLE="margin-top: 0.08in"><FONT SIZE=2><I>Illustration 8: Edit
@@ -789,129 +792,132 @@
<H3>3.2.2 - <B>Finding old entries with the Create &
Edit:Entries page</B>
</H3>
- <P STYLE="font-weight: medium">You can use the Create &
- Edit:Entries to find and edit your old posts. That includes posts
- that have scrolled-off the bottom of the Pending, Draft and Recent
- Entries lists we discussed above. When you first arrive on the page
- it will show you most recent entries, as shown in the screenshot
- below. If you want to find an old post you can use the start and
- end date calendars to look for posts in a specific time period. You
- can edit any of the entries in the Weblog Entries list by simply
- clicking on its title.
+ <P CLASS="western" STYLE="font-weight: medium">You can use the
+ Create & Edit:Entries to find and edit your old posts. That
+ includes posts that have scrolled-off the bottom of the Pending,
+ Draft and Recent Entries lists we discussed above. When you first
+ arrive on the page it will show you most recent entries, as shown
+ in the screenshot below. If you want to find an old post you can
+ use the start and end date calendars to look for posts in a
+ 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>
- <P>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 weblog entry, which
- will load that entry into the weblog editor (i.e. the New Entry
- page).
- </P>
- <P>There are several ways to do this:
- </P>
- <UL>
- <LI><P STYLE="margin-bottom: 0in"><B>Using the calendar</B>: most
- weblog themes include a calendar, which you can use to navigate
- back and forwards in time.
- </P>
- <LI><P STYLE="margin-bottom: 0in"><B>Using the next/prev links</B>:
- most weblog themes include next/previous links, which allow you to
- navigate back and forwards in time.
- </P>
- <LI><P><B>Using URLs</B>: you can also use URL's to navigate back
- in time. Roller URLs take the form /page/username and
- /page/username/date where date is formatted YYYYMMDD. So, you can
- navigate into the past by using URLs.
+ <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
+ weblog entry, which will load that entry into the weblog editor
+ (i.e. the New Entry page).
+ </P>
+ <P CLASS="western">There are several ways to do this:
+ </P>
+ <UL>
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in"><B>Using the
+ calendar</B>: most weblog themes include a calendar, which you can
+ use to navigate back and forwards in time.
+ </P>
+ <LI><P CLASS="western" STYLE="margin-bottom: 0in"><B>Using the
+ next/prev links</B>: most weblog themes include next/previous
+ links, which allow you to navigate back and forwards in time.
+ </P>
+ <LI><P CLASS="western"><B>Using URLs</B>: you can also use URL's
+ to navigate back in time. Roller URLs take the form /page/username
+ and /page/username/date where date is formatted YYYYMMDD. So, you
+ 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>
- <P>Roller also has a built in search engine, which you can use to
- search for entries in the entire site, or in just your blog. If
- you're logged in, when you find one of your old entries, it will
- have an <B>Edit</B> link.
+ <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
+ your blog. If you're logged in, when you find one of your old
+ entries, it will have an <B>Edit</B> link.
</P>
<H2 STYLE="page-break-before: always">3.3 - Weblog categories</H2>
- <P>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 posts, a category
- called "Music" for your music posts, and a category
- called "Misc" for everything else.
- </P>
- <P>When you write a new weblog post you must decide which category
- to place it in. On the <B>Create & Edit:New Entry</B> page,
- there is a combo-box that allows you to pick a category for your
- post or to change the category when you edit an old post.
- Currently, Roller only allows you to assign each weblog post to one
- category.
+ <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
+ posts, a category called "Music" for your music posts,
+ and a category called "Misc" for everything else.
+ </P>
+ <P CLASS="western">When you write a new weblog post you must decide
+ which category to place it in. On the <B>Create & Edit:New
+ Entry</B> page, there is a combo-box that allows you to pick a
+ category for your post or to change the category when you edit an
+ 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>
- <P>When a user views your site, they can choose which category to
- view. All of the stock Roller weblog templates include the Weblog
- Category Chooser (displayed by the <FONT FACE="Courier New">#showWeblogCategoryChooser()</FONT>
- macro) 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>
+ <P CLASS="western">When a user views your site, they can choose
+ which category to view. All of the stock Roller weblog templates
+ include the Weblog Category Chooser (displayed by the
+ <FONT FACE="Courier New">#showWeblogCategoryChooser()</FONT> macro)
+ 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>
- <P>Your weblog's main RSS newsfeed includes all categories, but
- users can choose to subscribe to specific categories. All of the
- stock Roller weblog templates display a list of your RSS feeds
- (displayed by the <FONT FACE="Courier New">#showRSSLinks()</FONT>
+ <P CLASS="western">Your weblog's main RSS newsfeed includes all
+ categories, but users can choose to subscribe to specific
+ categories. All of the stock Roller weblog templates display a list
+ of your RSS feeds (displayed by the <FONT FACE="Courier New">#showRSSLinks()</FONT>
macro), one for all categories and one for each separate category.
</P>
<H3>3.3.3 - <B>Adding, Renaming, and Removing Weblog Categories</B>
</H3>
- <P>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 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>
<H2 STYLE="page-break-before: always">3.4 - Podcasting with Roller</H2>
- <P>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 technique can be
- used to distribute any type of file. Specialized Podcast client
- software (such as <A HREF="http://ipodderx.com/">iPodderX</A><IMG SRC="http://www.rollerweblogger.org/wiki/images/out.png" NAME="graphics10" ALIGN=BOTTOM WIDTH=6 HEIGHT=6 BORDER=0>)
+ <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
+ technique can be used to distribute any type of file. Specialized
+ Podcast client software (such as <A HREF="http://ipodderx.com/">iPodderX</A><IMG SRC="http://www.rollerweblogger.org/wiki/images/out.png" NAME="graphics10" ALIGN=BOTTOM WIDTH=6 HEIGHT=6 BORDER=0>)
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.4.1 - <B>How to create a podcast feed with Roller</B>
</H3>
- <P>In Roller a Podcast is like an attachment to a weblog entry. We
- call it mediacasting in the Roller UI because it can be any type of
- file and is not necessarily destined for play on an Apple iPod.
- Here are the steps involved in Podcasting with Roller:
+ <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
+ can be any type of file and is not necessarily destined for play on
+ an Apple iPod. Here are the steps involved in Podcasting with
+ Roller:
</P>
<UL>
- <LI><P>Record an interesting Podcast (that's the hard part, by the
- way)
+ <LI><P CLASS="western">Record an interesting Podcast (that's the
+ hard part, by the way)
</P>
</UL>
<UL>
- <LI><P>Save your Podcast in MP3 format (or whatever you prefer).
+ <LI><P CLASS="western">Save your Podcast in MP3 format (or
+ whatever you prefer).
</P>
</UL>
<UL>
- <LI><P>Upload your Podcast to a web server somewhere and take note
- of your Podcast's URL. If you have the space for it and your
- Roller admin allows MP3 files, you can use file-upload capability
- to upload it to your Roller website. Chose the <B>Create &
- Edit: File Uploads</B> menu item to get to Roller's file-upload
- page. For example, if Nina of example.com were to upload a file to
- Roller, then the URL would look something like this:
+ <LI><P CLASS="western">Upload your Podcast to a web server
+ somewhere and take note of your Podcast's URL. If you have the
+ space for it and your Roller admin allows MP3 files, you can use
+ file-upload capability to upload it to your Roller website. Chose
+ the <B>Create & Edit: File Uploads</B> menu item to get to
+ Roller's file-upload page. For example, if Nina of example.com
+ were to upload a file to Roller, then the URL would look something
+ like this:
</P>
</UL>
<PRE STYLE="margin-bottom: 0.2in"> <FONT FACE="Courier New">http://example.com/roller/resources/nina/mycast.mp3</FONT></PRE>
<UL>
- <LI><P>Create a new Roller Weblog entry via <B>Create &
- Edit:New Entry</B> describing 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. Using Nina as an example again, she
- would add the following HTML to her blog entry to provide a link
- to her Podcast:
+ <LI><P CLASS="western">Create a new Roller Weblog entry via <B>Create
+ & Edit:New Entry</B> describing 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. Using Nina as an example
+ again, she would add the following HTML to her blog entry to
+ provide a link to her Podcast:
</P>
</UL>
<PRE> Hey now! I just created my first Podcast you can download it
@@ -919,58 +925,61 @@
<FONT FACE="Courier New"> <a href="http://example.com/roller/resources/nina/mycast.mp3">mycast.mp3</a></FONT></PRE>
<UL>
- <LI><P>And the most important step: in the lower-half of the Edit
- Weblog page, you'll see an expandable control labelled <I>+MediaCast
- Settings</I>. Click on that to expand the MediaCast control and
- paste into the URL field the URL of your Podcast.
+ <LI><P CLASS="western">And the most important step: in the
+ lower-half of the Edit Weblog page, you'll see an expandable
+ control labelled <I>+MediaCast Settings</I>. Click on that to
+ expand the MediaCast control and paste into the URL field the URL
+ of your Podcast.
</P>
</UL>
<UL>
- <LI><P>Once your blog post is ready, save it as a draft or publish
- it. Once you've done that you'll see that the MediaCast Settings
- control has 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:
- </P>
+ <LI><P CLASS="western">Once your blog post is ready, save it as a
+ draft or publish it. Once you've done that you'll see that the
+ MediaCast Settings control has 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:
+ </P>
</UL>
- <P>
+ <P CLASS="western">
</P>
- <P><SPAN ID="Frame8" DIR="LTR" STYLE="float: left; width: 6.37in; height: 1.37in; border: none; padding: 0in; background: #ffffff">
+ <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"><IMG SRC="roller-user-guide_html_33edbb94.png" NAME="graphics9" ALIGN=LEFT WIDTH=100% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
9: Podcast URL field</I></FONT></P>
</SPAN><BR CLEAR=LEFT><BR><BR>
</P>
- <P><BR><BR>
+ <P CLASS="western"><BR><BR>
</P>
<UL>
- <LI><P>Roller will add the Podcast to your RSS newsfeed as an
- <TT><enclosure></TT>. You can check this by looking at your
- RSS newsfeed. Go to your weblog and click the orange XML icon, or
- just enter your newsfeed URL into your browser. After you download
- your newsfeed file, open it with your favorite text editor and in
- the most recent entry you'll see an RSS enclosure. For example,
- Nina would see the following enclosure in her newsfeed:
+ <LI><P CLASS="western">Roller will add the Podcast to your RSS
+ newsfeed as an <TT><enclosure></TT>. You can check this by
+ looking at your RSS newsfeed. Go to your weblog and click the
+ orange XML icon, or just enter your newsfeed URL into your
+ browser. After you download your newsfeed file, open it with your
+ favorite text editor and in the most recent entry you'll see an
+ RSS enclosure. For example, Nina would see the following enclosure
+ in her newsfeed:
</P>
</UL>
<PRE><FONT FACE="Courier New"> <enclosure url="http://example.com/roller/resources/nina/mycast.mp3" </FONT>
-<FONT FACE="Courier New"> type="audio/x-mpeg" length="3409127" /></FONT></PRE><P>
+<FONT FACE="Courier New"> type="audio/x-mpeg" length="3409127" /></FONT></PRE><P CLASS="western">
That's all there is to podcasting with Roller.</P>
- <P><BR><BR>
+ <P CLASS="western"><BR><BR>
</P>
- <P><BR><BR>
+ <P CLASS="western"><BR><BR>
</P>
- <P><BR><BR>
+ <P CLASS="western"><BR><BR>
</P>
<H2 STYLE="page-break-before: always">3.5 - Referrer rankings</H2>
- <P>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 your weblog. By looking
- at your referrer logs, you can get an idea of who is reading and
- commenting on your weblog.
+ <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
+ your weblog. By looking at your referrer logs, you can get an idea
+ of who is reading and commenting on your weblog.
</P>
- <P>Working with comments and trackbacks</P>
- <P>Roller supports weblog comments and <I>trackbacks</I><SPAN STYLE="font-style: normal">,
+ <P CLASS="western">Working with comments and trackbacks</P>
+ <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 <B>Preferences:Settings</B>
@@ -978,65 +987,68 @@
comments and trackbacks.
</P>
<H2>3.6 - Comment notification via email</H2>
- <P>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 <B>Preferences:Settings</B> page.
- </P>
- <P>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 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 <B>Preferences:Settings</B> 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>3.7 - Comment management and moderation</H2>
- <P 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 moderation</I> via
- <B>Preferences:Settings</B>. 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 <B>Create & Edit:Comments</B> 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 STYLE="font-style: normal"><B>The comment management page</B></P>
- <P><SPAN STYLE="font-weight: medium"><SPAN STYLE="font-style: normal">The
+ <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
+ moderation</I> via <B>Preferences:Settings</B>. 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 <B>Create & Edit:Comments</B> 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="font-style: normal"><B>The comment
+ management page</B></P>
+ <P CLASS="western"><SPAN STYLE="font-weight: medium"><SPAN STYLE="font-style: normal">The
comment management page, shown in illustration 10, allows you to
manage comments for your weblog. If you arrive on the page from the
link in a comment notification email, then you'll see only the
comments for the one entry that was commented upon. If you arrive
via the menu, you'll see all recent comments in reverse
chronological order.</SPAN></SPAN></P>
- <P STYLE="font-style: normal; font-weight: medium">Comments that
- are suspected to be spam are shown with a light red background,
- with the spam check-box checked. Comments that are new and pending
- your review are shown with a light yellow background.
- </P>
- <P STYLE="margin-left: -0.01in; font-weight: medium"><I>How to
- moderate comments</I></P>
- <UL>
- <LI><P STYLE="font-style: normal; font-weight: medium">Review each
- new comment and decide if it is to be approved for display, marked
- as spam and hidden or deleted entirely.
+ <P CLASS="western" STYLE="font-style: normal; font-weight: medium">Comments
+ that are suspected to be spam are shown with a light red
+ background, with the spam check-box checked. Comments that are new
+ and pending your review are shown with a light yellow background.
+ </P>
+ <P CLASS="western" STYLE="margin-left: -0.01in; font-weight: medium">
+ <I>How to moderate comments</I></P>
+ <UL>
+ <LI><P CLASS="western" STYLE="font-style: normal; font-weight: medium">
+ <FONT SIZE=2>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><SPAN STYLE="font-weight: medium"><SPAN STYLE="font-style: normal">Only
+ <LI><P CLASS="western"><FONT SIZE=2><SPAN STYLE="font-weight: medium"><SPAN STYLE="font-style: 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.
+ they are. </FONT>
</P>
- <LI><P>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.</P>
- </UL>
- <P STYLE="margin-left: -0.01in; font-weight: medium"><I>How to
- search weblog comments</I></P>
- <P STYLE="margin-left: -0.01in"><SPAN STYLE="font-weight: medium">You
+ <LI><P CLASS="western"><FONT SIZE=2>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>
+ <P CLASS="western" STYLE="margin-left: -0.01in; font-weight: medium">
+ <I>How to search weblog comments</I></P>
+ <P CLASS="western" STYLE="margin-left: -0.01in"><SPAN STYLE="font-weight: medium">You
can also use the comment management page to search for comments
across all entries in your weblog by keyword, status and date. Use
the Filter comments area of the page to set the fields you want to
@@ -1044,36 +1056,37 @@
can be displayed on one page, then a next page link will be
displayed at the top of the list of comments so that you can
navigate into the past<SPAN STYLE="font-style: normal">.</SPAN></SPAN></P>
- <P STYLE="font-style: normal; font-weight: medium"><BR><BR>
+ <P CLASS="western" STYLE="font-style: normal; font-weight: medium"><BR><BR>
</P>
- <P><SPAN ID="Frame10" DIR="LTR" STYLE="float: left; width: 6.93in; height: 4.24in; border: none; padding: 0in; background: #ffffff">
+ <P CLASS="western"><SPAN ID="Frame10" DIR="LTR" STYLE="float: left; width: 6.93in; height: 4.24in; border: none; padding: 0in; background: #ffffff">
<P STYLE="margin-top: 0.08in"><IMG SRC="roller-user-guide_html_276ad74f.png" NAME="graphics15" ALIGN=LEFT WIDTH=98% BORDER=0><BR CLEAR=LEFT><FONT SIZE=2><I>Illustration
10Comment (and trackback) management page</I></FONT></P>
</SPAN><BR CLEAR=LEFT><BR><BR>
</P>
- <P><B>Global comment management</B></P>
- <P STYLE="font-weight: medium">If your user has global
- adminstration privileges, then you can manage comments across the
- entire Roller site, including every weblog. To do this, go to the
- <B>Server Adminstation:Comments</B> page and you'll see a page that
- is almost identical to the weblog-specific comment management page.
- </P>
- <P STYLE="font-weight: medium"><I>Limitations of global comment
- management</I></P>
- <P STYLE="font-weight: medium">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><B>A word about receiving trackbacks</B></P>
- <P STYLE="font-weight: medium">Incoming trackbacks are treated
- differently, depending on how your Roller site is setup. Your site
- adminstrator may choose to disable incoming trackbacks entirely. In
- that case, anybody who tries to send a comment to your weblog via
- trackback will receive and error messae and no comment will be
- added.</P>
- <P STYLE="margin-bottom: 0in"><SPAN STYLE="font-weight: medium">Your
+ <P CLASS="western"><B>Global comment management</B></P>
+ <P CLASS="western" STYLE="font-weight: medium">If your user has
+ global adminstration privileges, then you can manage comments
+ across the entire Roller site, including every weblog. To do this,
+ go to the <B>Server Adminstation: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-weight: medium"><I>Limitations of
+ global comment management</I></P>
+ <P CLASS="western" STYLE="font-weight: medium">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"><B>A word about receiving trackbacks</B></P>
+ <P CLASS="western" STYLE="font-weight: medium">Incoming trackbacks
+ are treated differently, depending on how your Roller site is
+ setup. Your site adminstrator may choose to disable incoming
+ trackbacks entirely. In that case, anybody who tries to send a
+ comment to your weblog via trackback will receive and error messae
+ and no comment will be added.</P>
+ <P CLASS="western" STYLE="margin-bottom: 0in"><SPAN STYLE="font-weight: medium">Your
site administrator may choose to enable a spam prevention measure
known as <I>trackback verification. </I>If that's the case, then
each incoming trackback will be verified. If the weblog that sent
@@ -1083,1159 +1096,561 @@
it is displayed as a comment on your weblog.</SPAN></P>
<H2>3.8 - <B>Preventing weblog spam</B>
</H2>
- <P>There are three forms of comment spam that can affect your
- weblog:</P>
+ <P CLASS="western">There are three forms of comment spam that can
+ affect your weblog:</P>
<UL>
<UL>
- <LI><P><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">
[... 3217 lines stripped ...]