roller-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From snoopd...@apache.org
Subject svn commit: r327589 [6/72] - in /incubator/roller/branches/roller_1.x: ./ contrib/ contrib/lib/ contrib/plugins/ contrib/plugins/src/ contrib/plugins/src/org/ contrib/plugins/src/org/roller/ contrib/plugins/src/org/roller/presentation/ contrib/plugins/...
Date Fri, 21 Oct 2005 21:46:28 GMT
Propchange: incubator/roller/branches/roller_1.x/docs/userguide/old/grep2_.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: incubator/roller/branches/roller_1.x/docs/userguide/old/grey2.gif
URL: http://svn.apache.org/viewcvs/incubator/roller/branches/roller_1.x/docs/userguide/old/grey2.gif?rev=327589&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/roller/branches/roller_1.x/docs/userguide/old/grey2.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: incubator/roller/branches/roller_1.x/docs/userguide/old/pacifica.gif
URL: http://svn.apache.org/viewcvs/incubator/roller/branches/roller_1.x/docs/userguide/old/pacifica.gif?rev=327589&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/roller/branches/roller_1.x/docs/userguide/old/pacifica.gif
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: incubator/roller/branches/roller_1.x/docs/userguide/old/pacifica_.jpg
URL: http://svn.apache.org/viewcvs/incubator/roller/branches/roller_1.x/docs/userguide/old/pacifica_.jpg?rev=327589&view=auto
==============================================================================
Binary file - no diff available.

Propchange: incubator/roller/branches/roller_1.x/docs/userguide/old/pacifica_.jpg
------------------------------------------------------------------------------
    svn:mime-type = application/octet-stream

Added: incubator/roller/branches/roller_1.x/docs/userguide/old/roller-ug-0.9.5.html
URL: http://svn.apache.org/viewcvs/incubator/roller/branches/roller_1.x/docs/userguide/old/roller-ug-0.9.5.html?rev=327589&view=auto
==============================================================================
--- incubator/roller/branches/roller_1.x/docs/userguide/old/roller-ug-0.9.5.html (added)
+++ incubator/roller/branches/roller_1.x/docs/userguide/old/roller-ug-0.9.5.html Fri Oct 21 14:27:36 2005
@@ -0,0 +1,883 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2//EN">
+<html>
+<head>
+                                    
+  <meta name="Generator" content="Workbench 6.0">
+                                    
+  <meta http-equiv="CONTENT-TYPE"
+ content="text/html; charset=windows-1252">
+  <title>Roller User Guide</title>
+                                                                  
+  <meta name="AUTHOR" content="David Johnson">
+                                    
+  <meta name="CREATED" content="20020227;22544700">
+                                    
+  <meta name="CHANGEDBY" content="David Johnson">
+                                    
+  <meta name="CHANGED" content="20020403;23400900">
+                                    
+  <style>








+@page { margin-left: 1.25in; margin-right: 1.25in; margin-top: 1in; margin-bottom: 1in }








+








+P








+{








+    margin-bottom : 0.08in;








+}








+








+P.western








+{








+    font-family : "Thorndale", serif;








+}








+








+H1








+{








+    margin-bottom : 0.08in;








+}








+








+H1.western








+{








+    font-family : "Albany", sans-serif;








+    font-size : 16pt;








+}








+








+H1.cjk








+{








+    font-family : "HG Mincho Light J";








+    font-size : 16pt;








+    font-weight : bold;








+}








+








+H1.ctl








+{








+    font-family : "Arial Unicode MS";








+    font-size : 16pt;








+    font-weight : bold;








+}








+








+  </style>
+</head>
+<body lang="en-US">
+               
+<h1 class="western">The Roller Weblogger</h1>
+               
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4">Version 0.9.5 User's Guide</font></font></p>
+               
+<p class="western"><i><font size="2">Copyright <font
+ face="Times New Roman, serif">©</font>     2002 David M Johnson</font></i></p>
+               
+<p class="western"><font size="2"><i>Updated: August 28, 2002<br>
+</i></font></p>
+<p class="western"><font face="Albany, sans-serif" color="#ff0000"><font
+ size="4">( new or previously undocumented features are shown in red )<br>
+<br>
+</font></font></p>
+               
+<ul>
+           <li>                                                    
+    <p style="margin-bottom: 0in;"><a href="#introduction"><b>Introduction</b></a></p>
+           </li>
+           <li style="margin-bottom: 0in;">                              
+                    
+    <div><a href="#getting_started"><b>Getting started</b></a></div>
+                                                          
+    <ul>
+               <li style="margin-bottom: 0in;">Sign up for a new account</li>
+               <li style="margin-bottom: 0in;">Your initial website</li>
+                                                          
+    </ul>
+           </li>
+           <li style="margin-bottom: 0in;">                              
+                    
+    <div><a href="#editing_your_weblog"><b>Editing your weblog</b></a></div>
+                                                          
+    <ul>
+               <li style="margin-bottom: 0in;">Adding a new           entry</li>
+               <li style="margin-bottom: 0in;">Editing an old           entry</li>
+           <li style="margin-bottom: 0in;">Posting using a Blogger API client<br>
+           </li>
+                                                          
+    </ul>
+           </li>
+           <li style="margin-bottom: 0in;">                              
+                    
+    <div><a href="#editing_bookmarks"><b>Editing your bookmark collection</b></a></div>
+                                                          
+    <ul>
+               <li style="margin-bottom: 0in;">Adding new           bookmark
+  folders</li>
+               <li style="margin-bottom: 0in;">Adding bookmarks          to
+ folders</li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">Importing Bookmarks
+in OPML format</font><br>
+      </li>
+                                                          
+    </ul>
+           </li>
+           <li style="margin-bottom: 0in;">                              
+                    
+    <div><a href="#editing_newsfeeds"><b>Editing your newsfeed collection</b></a></div>
+                                                          
+    <ul>
+               <li style="margin-bottom: 0in;">Adding and           deleting
+  newsfeeds</li>
+                                                          
+    </ul>
+           </li>
+           <li style="margin-bottom: 0in;">                              
+                    
+    <div><a href="#customizing_your_pages"><b>Customizing your pages</b></a></div>
+                                                          
+    <ul>
+               <li style="margin-bottom: 0in;">Creating and           editing
+  pages</li>
+               <li style="margin-bottom: 0in;">Your initial           pages:
+  Weblog,  _DayTemplate and _css</li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">Uploading files
+to Roller</font></li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">Exporting your
+website data</font></li>
+                                                                
+    </ul>
+           </li>
+           <li style="margin-bottom: 0in;">                              
+                    
+    <div><a href="#macros_for_page"><b>Macros for use on Pages</b></a></div>
+                                                          
+    <ul>
+               <li style="margin-bottom: 0in;">$macros.showWeblogCategoryChooser(
+             boolean )</li>
+               <li style="margin-bottom: 0in;">$macros.showWeblogEntries()</li>
+               <li style="margin-bottom: 0in;">$macros.showWeblogCalendar()</li>
+               <li style="margin-bottom: 0in;">$macros.includePage(      
+   string ) </li>
+               <li style="margin-bottom: 0in;">$macros.showBookmarks(    
+     string, boolean )</li>
+      <li style="margin-bottom: 0in;">$macros.showEditorNavBar( boolean )</li>
+      <li style="margin-bottom: 0in;">$macros.showNavBar( boolean )<br>
+      </li>
+               <li style="margin-bottom: 0in;">$macros.showNewsfeeds( string
+)</li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">$macros.showAllNewsfeeds()<br>
+        </font></li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">$macros.showResourcePath()</font><br>
+      </li>
+               <li style="margin-bottom: 0in;">$macros.showRSSBadge()</li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">$macros.showThemePath(
+string )</font></li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">$macros.showThemeImage(
+string, string )</font></li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">$macros.showThemeImagePath(
+string, string )</font></li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">$macros.showThemeScript(
+string, string )</font></li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">$macros.showThemeScriptPath(
+string, string )</font></li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">$macros.showThemeStyle(
+string, string, boolean )</font></li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">$macros.showThemeStyleImport(
+string, string )</font></li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">$macros.showThemeStylePath(
+string, string )</font></li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">$macros.showVersion()</font></li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">$macros.showWebsiteTitle()</font></li>
+      <li style="margin-bottom: 0in;"><font color="#ff0000">$macros.showWebsiteDescription()</font></li>
+         
+    </ul>
+                     
+    <ul>
+                                                          
+    </ul>
+           </li>
+           <li style="margin-bottom: 0in;">                              
+                    
+    <div><a href="#macros_for_day"><b>Macros for use on your DayTemplate
+page</b></a></div>
+                                                          
+    <ul>
+               <li style="margin-bottom: 0in;">$macros.showPermalink()</li>
+               <li style="margin-bottom: 0in;">$macros.showEntryDate()</li>
+               <li style="margin-bottom: 0in;">$entries</li>
+               <li style="margin-bottom: 0in;">$entry.title</li>
+               <li style="margin-bottom: 0in;">$entry.text</li>
+               <li style="margin-bottom: 0in;">$entry.updateTime</li>
+               <li style="margin-bottom: 0in;">$entry.pubTime</li>
+                                                          
+    </ul>
+           </li>
+               
+</ul>
+               
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><a name="introduction"></a></font></font><font
+ face="Albany, sans-serif"><font size="4">Introduction</font></font></p>
+               
+<p style="margin-bottom: 0in;">Roller is a Weblogger.      Roller makes it
+   easy for you to maintain a weblog, even if you are have     little or no
+  knowledge of HTML.  All you have to do is go to a web site     that is
+running   the Roller software, sign up for an account and bam you     have
+a weblog.    You can start posting right away.  You will need to know a 
+   little about   HTML if you want to kick it up a notch by customizing the
+    layout of your  Weblog and adding new pages to your Weblog website. More
+on     that later.</p>
+               
+<p style="margin-bottom: 0in;">Please note that Roller     is currently beta
+quality code – not necessarily ready for prime time –     there are probably
+a number    of design flaws and an even larger number of     bugs.  As always
+with software   of all sorts, and especially pre-release     software such
+as this, use at  your own risk.</p>
+               
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><a name="getting_started"></a>Getting
+Started</font></font></p>
+               
+<ul>
+           <li>                                                    
+    <p style="margin-bottom: 0in;"><b>Signing up for a new account</b></p>
+           </li>
+               
+</ul>
+               
+<p class="western">To sign-up for a Roller account, go the the main Roller
+       page and click on the link that reads “register as a new user.”  
+Enter your login name, your real name, your desired password, your e-mail
+     address, and pick one of the predefined Weblog themes provided by Roller.
+ There is a basic theme, which is a very good starting point for those who
+wish to build their own themes.  And, there are three themes adapted from
+themes on <a href="http://www.blogskins.com">blogskins.com</a>: these are
+shown below.  <font color="#ff0000">There is also a new XHTML/CSS based theme
+called x2 that was contributed by Matt Raible.</font><br>
+ </p>
+ 
+<table cellpadding="10" cellspacing="2" border="0" width="100%">
+   <tbody>
+     <tr>
+       <td valign="top">                            
+      <div align="center"><a href="grey2.gif">grey2<br>
+       <br>
+       </a></div>
+                            
+      <div align="center"><a href="grey2.gif"><img src="grep2_.jpg"
+ alt="" width="300" height="300">       </a><br>
+       </div>
+       </td>
+       <td valign="top">                            
+      <div align="center"><a href="pacifica.gif">pacifica<br>
+       </a></div>
+       <a href="pacifica.gif"><br>
+       </a>                            
+      <div align="center"><a href="pacifica.gif"><img
+ src="pacifica_.jpg" alt="" width="300" height="300">       </a><br>
+       </div>
+       </td>
+     </tr>
+     <tr>
+       <td valign="top">                            
+      <div align="center"><a href="currency.gif">currency<br>
+       </a></div>
+       <a href="currency.gif"><br>
+       </a>                            
+      <div align="center"><a href="currency.gif"><img
+ src="currency_.jpg" alt="" width="300" height="300">       </a><br>
+       </div>
+       </td>
+       <td valign="top" align="center"><a
+ href="file:///C:/allfiles/src_cvs/roller_main/roller/docs/userguide/weblog.gif">basic<br>
+       <br>
+       </a><a href="weblog.gif"><img src="weblog_.jpg" alt=""
+ width="300" height="276">      </a>      <br>
+       <br>
+       </td>
+     </tr>
+            
+  </tbody> 
+</table>
+               
+<p class="western">After your account is created you will be returned to the
+    main Roller page.  You will see that your name has been added to the
+list     of Roller users displayed on the main page. If you click on your
+name in     this list, you will be taken <span style="">to your     Weblog
+page.  </span></p>
+               
+<ul>
+           <li>                                                    
+    <p style="margin-bottom: 0in;"><b>Your initial website</b></p>
+           </li>
+               
+</ul>
+               
+<p class="western">Your initial website will include just one webpage that
+   is     visible to your readers and that is named “Weblog.” This page  
+ will include a navigation bar, a weblog category chooser, a weblog     calendar,
+  some links and a weblog area where your posts will appear.  The     screenshot
+  below shows what your page will look like if you chose the     Roller basic
+  theme:  </p>
+               
+<p class="western" align="center"><i><font size="2">Figure 1: your initial
+   Weblog page, assuming you chose the basic theme</font></i></p>
+               
+<p class="western" align="center">  <a href="weblog.gif"><img
+ src="weblog_.jpg" alt="" width="300" height="276">      </a><br
+ clear="left">
+           </p>
+               
+<ul>
+           <li>                                                    
+    <p class="western"><b>Logging in</b> </p>
+           </li>
+               
+</ul>
+               
+<p class="western">From your Weblog page or from the main Roller page, click
+       the Login link.  Enter your username and password, click submit, and
+   you     will be taken to your Weblob page again.  But this time, you will
+   see some     new Links on the page: Weblog:Edit, Weblog:Categories, Weblog:Flush-Cache,
+Bookmarks, Newsfeeds, and Website. These links lead you to pages for  editing
+     your Weblog, categories, bookmarks (AKA links), newsfeeds, and  the
+actual      pages that make up your website.  First, lets talk about how
+to edit your     Weblog.</p>
+               
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><a name="editing_your_weblog"></a></font></font><font
+ face="Albany, sans-serif"><font size="4">Editing your Weblog</font></font></p>
+               
+<ul>
+           <li>                                                    
+    <p style="margin-bottom: 0in;"><b>Adding a new entry</b></p>
+           </li>
+               
+</ul>
+               
+<p style="margin-bottom: 0in;"><span style="">Editing     your Weblog means
+   adding new Weblog entries to be enjoyed by your readers     and editing
+ older  Weblog entries to correct mistakes, clarify points, or to     censor
+ those  </span>drunken ramblings you entered last night.</p>
+               
+<p style="margin-bottom: 0in;">To add a new Weblog     entry you simply go
+   to the Edit-Weblog page, enter an optional title, enter     the Weblog
+entry,   choose a Weblog category. and hit the Submit button.  As     soon
+as you  do that, your Weblog entry is posted to your Weblog for the     world
+to see.  <br>
+ </p>
+ 
+<p style="margin-bottom: 0in;">Generally, you will not need to use the Flush
+Cache link on the Weblog:Edit page, unless you are using SQL to muck about
+in the Roller database and you want to force the cache to reset itself.  Normally,
+as you edit weblog entries, bookmarks, and other things Roller should automatically
+reset it's cache as needed.<br>
+   </p>
+                  
+<p style="margin-bottom: 0in;" align="center"><font size="2"><i>Figure   
+2: the Edit-Weblog page<br>
+      <br>
+      </i></font></p>
+           
+<div align="center">   </div>
+           
+<div align="center"><a href="edit-weblog.gif"><img
+ src="edit-weblog_.jpg" alt="" width="300" height="421">      </a> <br
+ clear="left">
+      </div>
+               
+<ul>
+           <li>                                                    
+    <p style="margin-bottom: 0in;"><b>Editing an old entry</b></p>
+           </li>
+               
+</ul>
+               
+<p style="margin-bottom: 0in;">You can edit or remove     an old Weblog entry
+   by clicking on the Edit or Remove links in the Recent     Weblog Entries
+  part of the page.  If the Weblog entry that you want to edit     is not
+so  recent and is not shown in the Recent Weblog Entries list, then     you
+can  use the Weblog Entry Archive calendar to find that old entry.<br>
+     </p>
+         
+<ul>
+       <li style="margin-bottom: 0in;"><b>Posting using a Blogger API client</b><br>
+          </li>
+         
+</ul>
+                
+<p style="margin-bottom: 0in;">You can use any Blogger API client to post
+  and edit Roller weblog entries.  Before you can do this, you must go to
+the Roller Website:Settings menu and check the box that reads <i>Enable Blogger
+ API for your weblog</i>.  You should also pick a category for posts made
+through the Blogger API.  <font color="#ff0000">Be aware that one shortcoming
+of Blogger API based blogging clients titles. The Blogger API does not support
+weblog entry titles.</font>   </p>
+     
+<p style="margin-bottom: 0in;">Once you have enabled Blogger API support
+for your weblog, you can use any Blogger API client to post and edit your
+Roller weblog. For example, you could use the <a
+ href="http://wbloggar.com">w:bloggar</a>client.  Below is a screenshot of
+the w:bloggar client.  As you can see, you need to configure w:bloggar by
+entering your host name, port number, and the path /roller/xmlrpc into the
+w:bloggar Account Connection dialog-box.  You also need to enter your Roller
+username and password in to the w:bloggar login dialog.<br>
+   </p>
+     
+<p style="margin-bottom: 0in;" align="center"><a href="bloggar.jpg"><img
+ alt="" src="bloggar_.jpg" width="300" height="289" border="0">   </a><br>
+</p>
+<p style="margin-bottom: 0in;" align="left"><br>
+<br>
+     </p>
+               
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><a name="editing_bookmarks"></a></font></font><font
+ face="Albany, sans-serif"><font size="4">Editing your bookmark collection</font></font></p>
+               
+<ul>
+           <li>                                                    
+    <p style="margin-bottom: 0in;"><b>Adding new bookmark         folders</b></p>
+           </li>
+               
+</ul>
+                  
+<p style="margin-bottom: 0in;">You probably already     have a web bookmark
+   collection stored in your web browser, so why do you     need to enter
+bookmarks   into Roller.  Well, most Weblog authors like to     include links
+to their   favorite websites and to their favorite Weblogs     right on their
+Weblog   page.  Roller's bookmark feature makes it easy for     you to do
+this too.</p>
+               
+<p style="margin-bottom: 0in;">Bookmarks are organized     in to named folders.
+    You can define any number of folders and each of     these folders can
+ hold  any number of bookmarks.  There is only one level of     folders, so
+ you cannot have a folder that contains other folders.  </p>
+               
+<p style="margin-bottom: 0in;">Your initial website     contains two bookmark
+   folders: one named “Blogrolling” that     contains Weblogging related links
+   and one named “News” that     contains links to well known news sources.
+   If you look at Figure 1 again,     you can see that these two folder are
+  displayed on the left side of the     Weblog page.  You can use Roller's
+ bookmark management features to rename     these folders if you wish, or
+you can delete them add add folders of your     own choosing.</p>
+               
+<p style="margin-bottom: 0in;" align="center"><font size="2"><i>Figure   
+3: the Edit-Bookmark Folders page<br>
+      <br>
+      </i></font></p>
+           
+<div align="center">   </div>
+           
+<div align="center"><a href="edit-bookmark.gif"><img
+ src="edit-bookmark_.jpg" alt="" width="300" height="355">      </a><br
+ clear="left">
+      </div>
+               
+<ul>
+           <li>                                                    
+    <p style="margin-bottom: 0in;">Adding bookmarks to         folders</p>
+           </li>
+               
+</ul>
+                  
+<p style="margin-bottom: 0in;">Once you have defined     one or more bookmark
+   folders, you can start adding bookmarks to those     folders.  From the
+ Edit-Bookmark  Folders page, click the Edit link for the     Folder you wish
+ to edit.  You  will be taken to the Edit-Bookmark Folder     page for that
+ folder.  From  there you can edit the name of the folder and     you can
+add and remove bookmarks in that folder.</p>
+                  
+<p style="margin-bottom: 0in;" align="center"><font size="2"><i>Figure   
+4: the Edit-Bookmark Folder page</i></font></p>
+           
+<div align="center">     </div>
+           
+<p style="margin-bottom: 0in;" align="center"><a href="edit-folder.gif"><img
+ src="edit-folder_.jpg" alt="" width="300" height="355">      </a><br>
+           </p>
+               
+<ul>
+           <li>                                                    
+    <p style="margin-bottom: 0in;"><b>Editing a bookmark</b></p>
+           </li>
+               
+</ul>
+                  
+<p style="margin-bottom: 0in;">After you use the     Edit-Bookmark Folder
+   to add a bookmark, you can edit the Bookmark itself.      To edit a bookmark,
+   click on the Edit link in the Edit-Bookmark Folder     page.  That will
+ take  you to the Edit-Bookmark page and from there you can     change the
+ name,  description and display priority of the bookmark you have     chosen
+ to edit.   You can also move the bookmark to another folder by     changing
+ the Bookmark  Folder combo-box.</p>
+                  
+<p style="margin-bottom: 0in;" align="center"><font size="2"><i>Figure   
+5: the Edit-Bookmark page<br>
+      <br>
+      </i></font></p>
+           
+<div align="center">   </div>
+           
+<div align="center"><a href="edit-bookmark.gif"><img
+ src="edit-bookmark_.jpg" alt="" width="300" height="355">      </a><br
+ clear="left">
+      </div>
+           
+<p style="margin-bottom: 0in;">     <br>
+</p>
+<ul>
+  <li style="margin-bottom: 0in;"><b><font color="#ff0000">Importing Bookmarks
+in OPML format</font></b></li>
+</ul>
+<font color="#ff0000">Roller makes it easy to import bookmarks and build
+your blogroll by importing bookmarks in OPML format.  XBEL might be a better
+bookmarks format, but OPML is more popular in the world of weblogs.  To import
+bookmarks via OPML, follow these steps:</font><br>
+<ol>
+  <li><font color="#ff0000">download bookmarks in OPML format from a site
+such as Scripting.COM and save them as a file on your hard disk.</font></li>
+  <li><font color="#ff0000">Login to Roller and choose the Bookmarks:Import
+menu option.</font></li>
+  <li><font color="#ff0000">Use the file-upload capability to upload the
+OPML file into Roller.  The bookmarks will be imported into a folder called
+"unfiled".  You can use Roller to organize the bookmarks as you wish.</font>
+ </li>
+</ol>
+           
+<p style="margin-bottom: 0in;"><br>
+           </p>
+               
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><a name="editing_newsfeeds"></a></font></font><font
+ face="Albany, sans-serif"><font size="4">Editing your newsfeed collection</font></font></p>
+               
+<ul>
+           <li>                                                    
+    <p style="margin-bottom: 0in;"><b>Adding and deleting         newsfeeds</b></p>
+           </li>
+               
+</ul>
+                  
+<p style="margin-bottom: 0in;">A newsfeed is a list of     news stories and
+   a short desciption of each story that is automically     retrieved from
+ some  remote website.  Newsfeeds are delivered in a format     known as Really
+  Simple Syndication or Rich Site Summary or just RSS.  </p>
+                  
+<p style="margin-bottom: 0in;">Roller allows you to     include newsfeeds
+   on your Weblog page or on a separate page that you create     as part of
+  your Weblog's website.  Your initial website will include three     newsfeeds,
+   but none of these newsfeeds are displayed on your Weblog page.      You
+ can  use one of the macros that we will discuss later to display your  
+  newsfeeds.</p>
+                  
+<p style="margin-bottom: 0in;">Before you include a     newsfeed on your website,
+you should probaby make sure that doing so is OK     with the provider of
+the newsfeed.  Some providers might frown upon this     and by frown I mean
+that they might sick a pack of rabid lawyers on your     ass.  Anyhow, use
+your own judgement here – I am not a lawyer and I     am not responsible for
+any of your current or future legal troubles.</p>
+                  
+<p style="margin-bottom: 0in;">To add a newsfeed you     need a URL to the
+   providers RSS feed.  This URL usually ends with the     letters “.xml”.
+  Enter the name that you would like to use for     the newsfeed, enter the
+  URL and hit enter to add the newsfeed.</p>
+               
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><a
+ name="customizing_your_pages"></a></font></font><font
+ face="Albany, sans-serif"><font size="4">Customizing your pages</font></font></p>
+               
+<ul>
+           <li>                                                    
+    <p style="margin-bottom: 0in;"><b>Page templates and         macros</b></p>
+           </li>
+               
+</ul>
+                  
+<p style="margin-bottom: 0in;">Your Weblog page is     defined by a page template.
+ A template is a file with some special “macros”     that indicate where
+Roller is supposed to put your Weblog, Weblog Calendar,     and other dynamically
+created content.  A templage can be an HTML file, an     HTML fragment, a
+CSS page, or just about anything else you can enter into     Roller as text.</p>
+                  
+<p style="margin-bottom: 0in;">You initial Roller     website has three page
+   template, only one of which is visible to users.      The pages are named
+   Weblog, _DayTemplate and _css.</p>
+                  
+<ul>
+           <li>                                                    
+    <p style="margin-bottom: 0in;">The <b>Weblog</b>         page is the visible
+page, it is the HTML template that defines your         Weblog.  It is a
+mix of HTML and Roller macros that render the dynamic         parts of the
+page like the Weblog Calendar and the actual Weblog         entries.</p>
+           </li>
+           <li>                                                    
+    <p style="margin-bottom: 0in;">The <b>_DayTemplate</b>         page is
+   the HTML template that defines the entries for each day are         formatted
+   in your Weblog page.  This is essentially an HTML fragment         with
+ some  Roller macros for rendering the day's Weblog entries, title,      
+ date,  and other items.</p>
+           </li>
+           <li>                                                    
+    <p style="margin-bottom: 0in;">The <b>_css</b>         page is a CSS style-sheet
+information that is included (using a macro)         on your Weblog page.</p>
+           </li>
+               
+</ul>
+                  
+<p style="margin-bottom: 0in;">You can define as many     pages as you would
+   like.  You must specify which page is to be your Default     Page, that
+ is,  the page that your readers first see when they visit your     website.
+  You  must also specify which page is your Weblog day template.</p>
+                  
+<p style="margin-bottom: 0in;">Note that any page     whose name begins with
+   the underbar “_” character will not be     visible to your readers.  That
+   is why the _DayTemplate and _css pages start     with underbars, they are
+   used internally and are not meant for public     consumption.  </p>
+                  
+<p style="margin-bottom: 0in;" align="center"><font size="2"><i>Figure   
+6: the Edit-Website page</i></font></p>
+           
+<div align="center">     </div>
+           
+<p style="margin-bottom: 0in;" align="center"><a href="edit-website.gif"><img
+ src="edit-website_.jpg" alt="" width="300" height="355">      </a><br>
+      </p>
+           
+<p style="margin-bottom: 0in;">     If you click on one of     the Current
+   Pages in the Edit-Website page, you will be directed to the     Edit-Page
+   page so that you can edit that page.  You can put anything on a     page,
+   but typically you will put HTML with some Roller macros mixed in.     Next
+  you will read about the various Roller macros that are available for  
+  your use.</p>
+                  
+<p style="margin-bottom: 0in;">The screenshot below     shows the Weblog page
+being edited in the Edit-Page page.</p>
+                  
+<p style="margin-bottom: 0in;" align="center"><font size="2"><i>Figure   
+7:  the Edit-Page page</i></font></p>
+           
+<div align="center">      </div>
+           
+<p style="margin-bottom: 0in;" align="center"><a href="edit-page.gif"><img
+ src="edit-page_.jpg" alt="" width="300" height="346">      </a><br>
+      </p>
+           
+<p style="margin-bottom: 0in;">     </p>
+<font color="#ff0000"><br>
+</font><br>
+<ul>
+  <li><font color="#ff0000"><b>Uploading images to Roller</b></font></li>
+</ul>
+<font color="#ff0000">Roller now includes a file-upload feature that allows
+you to upload images and other file for use in your weblog templates.  Here
+are the steps to upload and image to Roller and to use it in a weblog template:</font>
+<ol>
+  <li><font color="#ff0000">Use the Weblog:File menu option to upload your
+image file</font></li>
+  <li><font color="#ff0000">Use the Weblog:Pages menu to edit one of your
+templates.  Place the HTML IMG tag where you want the image to appear and
+use $macros.showResourcePath() directive to build the URL for the image.
+ For example, if your image was called leo.gif you might insert an IMG tag
+like this: <b>&lt;</b></font><b><font color="#ff0000">img src="$macros.showResourcePath()/leo.gif"
+alt="one happy baby" /&gt;</font></b></li>
+</ol>
+<ul>
+  <li><b><font color="#ff0000">Exporting your website data</font></b></li>
+</ul>
+<font color="#ff0000">Your Roller administrator should be using some sort
+of database utility to back up the Roller database on a regular basis. If
+you are worried that backups are not being done and you want to store a copy
+of your Roller data on your personal computer, you can use Roller's new export
+capability to export your weblog data in Roller's XML format.  Currently,
+there is no import facility for Roller XML so in the case of data-loss you
+will need your administrator's help to recreate your user.</font><br>
+               <br>
+<p style="margin-bottom: 0in;"><font face="Albany, sans-serif"><font
+ size="4"><a name="macros_for_page"></a></font></font><font
+ face="Albany, sans-serif"><font size="4">Macros intended for use on    
+any page template</font></font></p>
+               
+<p style="margin-bottom: 0in;">Macros tell Roller     where to place the dynamic
+parts of your web pages.  Macros are actually     Velocity expressions. For
+more information on Velocity, visit the Velocity     web site and read  
+ the Velocity     User's Guide. Note <span
+ style="background: transparent none repeat scroll 50% 0%;">that I     use
+  the term macro loosely, but it does have a specific meaning in     Velocity.
+    What I call a macro is really a Velocity expression.</span></p>
+               
+<blockquote>                           
+  <p style="margin-bottom: 0in;"><b>$macros.EditorNavBar(     booean ) </b>
+   - show your website's editor navigation bar: a list of links     to each
+  of the Edit pages that you can use to edit your website.  The macro    takes
+  one boolean (true or false) argument.  If you enter true, then the    
+navbar   will be drawn vertically.  If you enter false, then the navbar will
+    be  drawn horizontally.</p>
+     
+  <p style="margin-bottom: 0in;"><b>$macros.showNavBar(     boolean ) </b>
+   - show your website's navigation bar: a list of links to each     of the
+  visible pages in your weblog.  The macro takes one boolean (true or    false)
+ argument.  If you enter true, then the navbar will be drawn     vertically.
+   If you enter false, then the navbar will be drawn horizontally.<br>
+  </p>
+     
+  <p style="margin-bottom: 0in;"><font color="#ff0000"><b>$macros.showNewsfeed(
+string )</b> - displays the newsfeed specified by name.</font></p>
+     
+  <p style="margin-bottom: 0in;"><font color="#ff0000"><b>$macros.showAllNewsfeeds()</b>
+- displays all newsfeeds that you have defined.  Warning: if you have defined
+a lot of newsfeeds this can be very slow.  </font></p>
+                                                          
+  <p style="margin-bottom: 0in;"><b>$macros.showWeblogCategoryChooser(   
+boolean )</b> - show the Weblog Category chooser: a list of links to the 
+      different categories of posts in your Weblog.  The boolean argument
+     determines if the chooser should be drawn horizontally or vertcally.</p>
+                                
+  <p style="margin-bottom: 0in;"><b>$macros.showWeblogEntries()</b>     -
+   show the most recent entries in your Weblog.</p>
+                                
+  <p style="margin-bottom: 0in;"><b>$macros.showWeblogCalendar() </b><span
+ style="">-     show your Weblog Calendar: a calendar with links to your previous
+Weblog     entries.</span></p>
+                                
+  <p style="margin-bottom: 0in;"><b>$macros.includePage(     string )</b>
+    - includes the content of another page template, specified by     name.</p>
+                                
+  <p style="margin-bottom: 0in;"><font color="#ff0000"><b>$macros.showResourcePath()</b>
+- show path to your resources directory so that you can create URLs to images
+and other files that you uploaded to Roller.<br>
+  </font><br>
+  <b>$macros.showRSSBadge()</b>     - shows    an XML icon that links to
+an RSS representation of your most recent     Weblog  entries. <br>
+  <br>
+  </p>
+  <font color="#ff0000"><b>$macros.showThemePath( string )</b> - shows base
+URL for reaching theme resources in the theme specified.<br>
+  <br>
+  </font>    <font color="#ff0000"><b>$macros.showThemeImage( string, string
+)</b> - shows image tag for specified theme and image.<br>
+  <b>arg1 </b>- theme name<br>
+  <b>arg2</b> - image name<br>
+  <br>
+  </font>    <font color="#ff0000"><b>$macros.showThemeImagePath( string,
+string )</b> - shows path to image specified by theme and name. <b><br>
+arg1 </b>- theme name<br>
+  <b>arg2 </b>- image name</font>  <br>
+  <br>
+  <font color="#ff0000"><b>$macros.showThemeScript( string, string ) </b>-
+shows Javascript tag for specified theme and script name.<br>
+  </font>  <font color="#ff0000"><b>arg1 </b>- theme name<br>
+  <b>arg2 </b>- script name<br>
+  <br>
+  </font>  <font color="#ff0000"><b>$macros.showThemeScriptPath( string,
+string )</b> - shows URL path to Javascript script in specified theme.</font><font
+ color="#ff0000"><b><br>
+arg1 </b>- theme name<br>
+  <b>arg2 </b>- script name<br>
+  <br>
+  </font>    <font color="#ff0000"><b>$macros.showThemeStyle( string, string,
+boolean )</b> - includes CSS script in page<br>
+  </font>  <font color="#ff0000"><b>arg1 </b>- </font><font
+ color="#ff0000">stylesheet </font><font color="#ff0000">name<br>
+  <b>arg2 </b>- script name<br>
+  <b>arg3</b> - true to import the CSS file instead of including it in the
+page<br>
+ <br>
+  </font>  <font color="#ff0000"><b>$macros.showThemeStyleImport( string,
+string )</b> - imports CSS in page.<br>
+  </font>  <font color="#ff0000"><b>arg1 </b>- stylesheet name<br>
+  <b>arg2 </b>- script name<br>
+  <br>
+  </font>  <font color="#ff0000"><b>$macros.showThemeStylePath( string, string
+)</b> - shows URL path to stylesheet in specified theme.<br>
+  <br>
+  </font>    <font color="#ff0000"><b>$macros.showVersion()</b> - shows  Roller
+version number<br>
+  <br>
+  </font>    <font color="#ff0000"><b>$macros.showWebsiteTitle()</b> - shows
+website title specified on Weblog:Settings page<br>
+  <br>
+  </font>    <font color="#ff0000"><b>$macros.showWebsiteDescription()</b>
+- shows website description specified on Weblog:Settings page.</font><br>
+  <br>
+      </blockquote>
+                                 
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4"><a name="macros_for_day"></a></font></font><font
+ face="Albany, sans-serif"><font size="4">Macros intended for use on your
+   day template page</font></font></p>
+               
+<p class="western">Your Day Template page determines how each day of Weblog
+       entries is formatted on the page by the <span style="">$macros.showWeblogEntries()
+       </span>macro. See the </p>
+           
+<blockquote>                           
+  <p style="margin-bottom: 0in;"><font color="#ff0000"><b>$macros.showDayPermalink()
+    </b>- shows    an icon that provides a permanent link to this day in
+your     Weblog.<br>
+  </font></p>
+  <p style="margin-bottom: 0in;">                           </p>
+  <p style="margin-bottom: 0in;"><font color="#ff0000"><b>$macros.showEntryPermalink(
+$entry )     </b>- shows    a hashmark (#) that provides a permanent link
+to this entry in your     Weblog. <br>
+  </font></p>
+                                
+  <p style="margin-bottom: 0in;"><b>$macros.showEntryDate()     </b>- shows
+   the day's date.</p>
+                                
+  <p style="margin-bottom: 0in;"><b>$entries</b> - this     Velocity expression
+   is a collection of Weblog entry objects for this day.     Each entry has
+  the following properties:</p>
+                                
+  <p style="margin-bottom: 0in;"><b>$entry.title</b> -     title of the Weblog
+   entry</p>
+                                
+  <p style="margin-bottom: 0in;"><b>$entry.text</b> -     the text of the
+   Weblog entry</p>
+                                
+  <p style="margin-bottom: 0in;"><b>$entry.updateTime</b>     - the time of
+last update for the Weblog entry</p>
+                                
+  <p style="margin-bottom: 0in;"><b>$entry.pubDate</b> -     the original
+   publish time for the Weblog entry</p>
+      </blockquote>
+                                       
+<p style="margin-top: 0.17in; page-break-after: avoid;"><font
+ face="Albany, sans-serif"><font size="4">Examples</font></font></p>
+               
+<p style="margin-bottom: 0in;">Here is the weblog page     template for the
+  basic theme, shown in figure 1 (macros are shown in blue):</p>
+           
+<blockquote>                           
+  <pre>&lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"&gt;<br>&lt;html&gt;&lt;head&gt;  <br>&lt;title&gt;<font
+ color="#3333ff">$macros.showWebsiteTitle()</font>&lt;/title&gt;     <br>&lt;style type="text/css"&gt;<font
+ color="#3333ff">$macros.includePage("_css")</font>  <br>&lt;/style&gt;<br>&lt;/head&gt;<br>&lt;body background="/roller/images/bg-greylines.gif"&gt; <br>&lt;table cellpadding="5" cellspacing="15" border="0" align="center" width="95%"&gt;   <br>   &lt;tr&gt;    <br>   &lt;td width="20%" valign="top" bgcolor="#ffffff"&gt;      <br>      <font
+ color="#3333ff">$macros.showNavBar(true)</font>&lt;br&gt; <font
+ color="#3333ff">      <br>      $macros.showEditorNavBar(true)</font>&lt;br&gt;<br>      <font
+ color="#3333ff">$macros.showBookmarks("Blogrolling",true)</font>&lt;br&gt;       <br>      <font
+ color="#3333ff">$macros.showBookmarks("News",true) </font>   <br>   &lt;/td&gt;    <br>   &lt;td width="60%" valign="top" bgcolor="#ffffff"&gt;                <br>      &lt;h2&gt;<font
+ color="#3333ff">$macros.showWebsiteTitle()</font>&lt;/h2&gt;                       <br>      <font
+ color="#3333ff">$macros.showWeblogCategoryChooser()</font>&lt;br&gt;       <br>      <font
+ color="#3333ff">$macros.showWeblogEntries()</font>    <br>   &lt;/td&gt;    <br>   &lt;td valign="top" bgcolor="#ffffff" width="20%"&gt;         <br>      <font
+ color="#3333ff">$macros.showWeblogCalendar()</font>&lt;br&gt;       <br>      <font
+ color="#3333ff">$macros.showRSSBadge()</font>    <br>   &lt;/td&gt; <br>   &lt;/tr&gt;<br>&lt;/table&gt;                  <br>&lt;/body&gt;&lt;/html&gt;<br></pre>
+      </blockquote>
+               
+<p style="margin-bottom: 0in;">Here is the Day     Template for the Weblog
+   shown in figure 1:</p>
+           
+<blockquote>                           
+  <pre>&lt;table width="95%"&gt;<br>&lt;tr&gt;<br>   &lt;td&gt;<br>   <font
+ color="#3333ff">$macros.showPermalink()<br>   $macros.showEntryDate()</font><br>   &lt;/td&gt;<br>&lt;/tr&gt;<br>&lt;/table&gt;<br><font
+ color="#3333ff">#foreach( $entry in </font><font color="#3333ff">$entries )</font><br>&lt;p&gt;<br>   &lt;b&gt;<font
+ color="#3333ff">$entry.title</font>&lt;/b&gt; <font color="#3333ff">$entry.text</font> <br>   &lt;font size="2"&gt;(<font
+ color="#3333ff">$entry.updateTime</font>/<font color="#3333ff">$entry.pubTime</font>)&lt;/font&gt;<br>&lt;/p&gt;<br><font
+ color="#3333ff">#end</font><br><br></pre>
+      </blockquote>
+           
+<pre><br></pre>
+           <br>
+     <br>
+    <br>
+   <br>
+  <br>
+ <br>
+<br>
+<br>
+<br>
+</body>
+</html>

Added: incubator/roller/branches/roller_1.x/docs/userguide/old/roller-ug-0.9.6.html
URL: http://svn.apache.org/viewcvs/incubator/roller/branches/roller_1.x/docs/userguide/old/roller-ug-0.9.6.html?rev=327589&view=auto
==============================================================================
--- incubator/roller/branches/roller_1.x/docs/userguide/old/roller-ug-0.9.6.html (added)
+++ incubator/roller/branches/roller_1.x/docs/userguide/old/roller-ug-0.9.6.html Fri Oct 21 14:27:36 2005
@@ -0,0 +1,550 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+                 
+  <meta name="generator" content="HTML Tidy, see www.w3.org">
+                
+  <meta name="Generator" content="Workbench 6.0">
+                 
+  <meta http-equiv="CONTENT-TYPE"
+ content="text/html; charset=windows-1252">
+  <title>Roller User Guide</title>
+</head>
+<body lang="en-US">
+<h1 class="western">The Roller Weblogger</h1>
+<h2>Version 0.9.6 User's Guide</h2>
+<p class="western">Copyright © 2002 David M Johnson</p>
+<p class="western">Updated: November 2, 2002<br>
+<br>
+</p>
+<ul>
+  <li>                             
+    <p><a href="#introduction">Introduction</a></p>
+  </li>
+  <li>                             
+    <div><a href="#getting_started">Getting started</a></div>
+                             
+    <ul>
+      <li style="margin-bottom: 0in;">Sign up for a new account</li>
+      <li style="margin-bottom: 0in;">Your initial website</li>
+                             
+    </ul>
+    <br>
+  </li>
+  <li>                             
+    <div><a href="#editing_your_weblog">Editing your weblog</a></div>
+                             
+    <ul>
+      <li>Adding a new entry</li>
+      <li>Publishing an entry<br>
+      </li>
+      <li>Editing an old entry</li>
+      <li>Publishing an entry<br>
+      </li>
+      <li>Posting using a Blogger API client</li>
+      <li>Flushing the cache<br>
+      </li>
+      <li>Referer rankings<br>
+      </li>
+                             
+    </ul>
+    <br>
+  </li>
+  <li>                             
+    <div><a href="#editing_bookmarks">Editing your bookmark collection</a></div>
+                             
+    <ul>
+      <li>Adding new bookmark folders</li>
+      <li>Adding bookmarks to folders</li>
+      <li>Importing Bookmarks in OPML format</li>
+                             
+    </ul>
+    <br>
+  </li>
+  <li>                             
+    <div><a href="#editing_newsfeeds">Editing your newsfeed collection</a></div>
+                             
+    <ul>
+      <li>Adding and deleting newsfeeds</li>
+                             
+    </ul>
+    <br>
+  </li>
+  <li>                             
+    <div><a href="#customizing_your_pages">Customizing your website</a></div>
+  </li>
+        
+  <ul>
+  <li>Website settings</li>
+    <li>Choosing an editor<br>
+    </li>
+  <li>Website pages</li>
+  <li>Website files</li>
+  <li>User settings</li>
+  <li>Export</li>
+  <li>Admin</li>
+        
+  </ul>
+</ul>
+<ul>
+  <li>                             
+    <div><a href="#macros_for_page">Macros for use on Pages</a></div>
+  </li>
+  <li>                             
+    <div><a href="#macros_for_day">Macros for use on your DayTemplate page</a></div>
+  </li>
+  <li>Example Weblog page and date templates<br>
+  </li>
+  
+</ul>
+  <br>
+<h2><a name="introduction"></a>Introduction</h2>
+<p>Roller is a Weblogger. Roller makes it easy for you to maintain a weblog,
+even if you are have little or no knowledge of HTML. All you have to do is
+go to a web site that is running the Roller software, sign up for an account
+and bam you have a weblog. You can start posting right away. You will need
+to know a little about HTML if you want to kick it up a notch by customizing
+the layout of your Weblog and adding new pages to your Weblog website. More
+on that later.</p>
+<p>Please note that Roller is currently beta quality code – not necessarily
+ready for prime time – there are probably a number of design flaws and an
+even larger number of bugs. As always with software of all sorts, and especially
+pre-release software such as this, use at your own risk.  If you find a flaw,
+a bug, or something that you do not like please contribute back to the Roller
+project be reporting that bug to the Roller development team's <a
+ href="http://opensource.atlassian.com/projects/roller/">JIRA
+issue tracking system</a>.</p>
+<h2><a name="getting_started"></a>Getting Started</h2>
+<h3>Signing up for a new account</h3>
+<p class="western">To sign-up for a Roller account, go the the main Roller
+page and click on the link that reads “register as a new user.” Enter your
+login name, your real name, your desired password, your e-mail address, and
+pick one of the predefined Weblog themes provided by Roller.  There is a
+basic theme, which is a very good starting point for those who wish to build
+their own themes.  And, there are three themes adapted from themes on <a
+ href="http://www.blogskins.com">blogskins.com</a>: these are shown below.
+ There is also a new XHTML/CSS based theme called x2 that was contributed
+by <a href="http://www.raibledesigns.com/">Matt Raible</a>.<br>
+</p>
+<table cellpadding="10" cellspacing="2" border="0" width="100%">
+  <tbody>
+    <tr>
+      <td valign="top">                                         
+      <div align="center"><a href="grey2.gif">grey2<br>
+      <br>
+      </a></div>
+                                         
+      <div align="center"><a href="grey2.gif"><img src="grep2_.jpg"
+ alt="" width="300" height="300"></a><br>
+      </div>
+      </td>
+      <td valign="top">                                         
+      <div align="center"><a href="pacifica.gif">pacifica<br>
+      </a></div>
+      <a href="pacifica.gif"><br>
+      </a>                                            
+      <div align="center"><a href="pacifica.gif"><img
+ src="pacifica_.jpg" alt="" width="300" height="300"></a><br>
+      </div>
+      </td>
+    </tr>
+    <tr>
+      <td valign="top">                                         
+      <div align="center"><a href="currency.gif">currency<br>
+      </a></div>
+      <a href="currency.gif"><br>
+      </a>                                            
+      <div align="center"><a href="currency.gif"><img
+ src="currency_.jpg" alt="" width="300" height="300"></a><br>
+      </div>
+      </td>
+      <td valign="top" align="center"><a
+ href="weblog.gif">
+basic<br>
+      <br>
+      </a><a href="weblog.gif"><img src="weblog_.jpg" alt="" width="300"
+ height="276"></a><br>
+      <br>
+ </td>
+    </tr>
+                 
+  </tbody>
+</table>
+<p class="western">After your account is created you will be returned to
+the main Roller page. You will see that your name has been added to the list
+of Roller users displayed on the main page. If you click on your name in
+this list, you will be taken to your Weblog page.</p>
+<h3>Your initial website</h3>
+<p class="western">Your initial website will include just one webpage that
+is visible to your readers and that is named “Weblog.” This page will include
+a navigation bar, a weblog category chooser, a weblog calendar, some links
+and a weblog area where your posts will appear. The screenshot below shows
+what your page will look like if you chose the Roller basic theme:</p>
+<p class="western" align="center">Figure 1: your initial Weblog page, assuming
+you chose the basic theme</p>
+<p class="western" align="center">  <a href="weblog.gif"><img
+ src="weblog_.jpg" alt="" width="300" height="276"></a><br clear="left">
+</p>
+<h3>Logging in</h3>
+<p class="western">From your Weblog page or from the main Roller page, click
+the Login link. Enter your username and password, click submit, and you will
+be taken to your Weblob page again. But this time, you will see some new
+Links on the page: Weblog:Edit, Weblog:Categories, Weblog:Flush-Cache, Bookmarks,
+Newsfeeds, and Website. These links lead you to pages for editing your Weblog,
+categories, bookmarks (AKA links), newsfeeds, and the actual pages that make
+up your website. First, lets talk about how to edit your Weblog.</p>
+<h2><a name="editing_your_weblog"></a>Editing your Weblog</h2>
+    
+<h3>Adding a new entry</h3>
+<p>Editing your Weblog means adding new Weblog entries to be enjoyed by your
+readers and editing older Weblog entries to correct mistakes, clarify points,
+or to censor those drunken ramblings you entered last night.</p>
+<p>To add a new Weblog entry you simply go to the Edit-Weblog page, enter
+an optional title, enter the Weblog entry, choose a Weblog category. and
+hit the Submit button. As soon as you do that, your Weblog entry is posted
+to your Weblog for the world to see.  <br>
+</p>
+<p>Generally, you will not need to use the Flush Cache link on the Weblog:Edit
+page, unless you are using SQL to muck about in the Roller database and you
+want to force the cache to reset itself.  Normally, as you edit weblog entries,
+bookmarks, and other things Roller should automatically reset it's cache
+as needed.<br>
+</p>
+<p align="center">Figure 2: the Edit-Weblog page<br>
+<br>
+</p>
+<div align="center"><a href="edit-weblog.gif"><img
+ src="edit-weblog_.jpg" alt="" width="300" height="421"></a><br
+ clear="left">
+</div>
+<h3>Publishing an entry</h3>
+The checkbox marked "Publish" controls whether or not your weblog entry is
+visible on your weblog's main page. If the box is checked, then your entry
+is visible to your readers.  If the box is not checked, then your entry is
+private.<br>
+<br>
+The text field marked "Pub Time" controls the publish time your your entry.
+ Changing the publish time may change the order of weblog entries displayed
+on your weblog.  When you enter a new publish time, you must use the format
+<span style="font-weight: bold;">dd.MM.yyyy HH:mm:ss</span>
+<h3>Editing an old entry</h3>
+You can edit or remove an old Weblog entry by clicking on the Edit or Remove
+links in the Recent Weblog Entries part of the page. If the Weblog entry that
+you want to edit is not so recent and is not shown in the Recent Weblog Entries
+list, then you can use the Weblog Entry Archive calendar to find that old
+entry.
+<h3>Posting using a Blogger API client</h3>
+<p>You can use any Blogger API client to post and edit Roller weblog entries.
+ Before you can do this, you must go to the Roller Website:Settings menu
+and check the box that reads Enable Blogger API for your weblog.  You should
+also pick a category for posts made through the Blogger API.  Be aware that
+one shortcoming of Blogger API based blogging clients titles. The Blogger
+API does not support weblog entry titles.</p>
+<p>Once you have enabled Blogger API support for your weblog, you can use
+any Blogger API client to post and edit your Roller weblog. For example,
+you could use the <a href="http://wbloggar.com">w:bloggar</a>client.  Below
+is a screenshot of the w:bloggar client.  As you can see, you need to configure
+w:bloggar by entering your host name, port number, and the path /roller/xmlrpc
+into the w:bloggar Account Connection dialog-box.  You also need to enter
+your Roller username and password in to the w:bloggar login dialog.<br>
+</p>
+<div style="text-align: center;"><a
+ href="bloggar.jpg"><img
+ alt=""
+ src="bloggar_.jpg"
+ width="300" height="289" border="0"></a><br>
+</div>
+<br>
+<h3>Flushing the cache</h3>
+The flush-cache button allows you to flush the Roller page cache.  The page
+cache is a performance feature that allows Roller to serve up pages faster
+and to minimize database access.  Normally, the cache is flushed when you
+edit a weblog entry, add a new page template, or do just about any other operation.
+ So, under normal conditions you should not need to flush the cache. <br>
+<h3>Referer rankings</h3>
+The referer 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 referer logs, you can get an idea of who is reading
+and commenting on your weblog.<br>
+<br>
+<h2><a name="editing_bookmarks"></a>Editing your bookmark collection</h2>
+<h3>Adding new book<span style="text-decoration: underline;"></span>mark
+folders</h3>
+<p>You probably already have a web bookmark collection stored in your web
+browser, so why do you need to enter bookmarks into Roller. Well, most Weblog
+authors like to include links to their favorite websites and to their favorite
+Weblogs right on their Weblog page. Roller's bookmark feature makes it easy
+for you to do this too.</p>
+<p>Bookmarks are organized in to named folders. You can define any number
+of folders and each of these folders can hold any number of bookmarks. There
+is only one level of folders, so you cannot have a folder that contains other
+folders. </p>
+<p>Your initial website contains two bookmark folders: one named “Blogrolling”
+that contains Weblogging related links and one named “News” that contains
+links to well known news sources. If you look at Figure 1 again, you can
+see that these two folder are displayed on the left side of the Weblog page.
+You can use Roller's bookmark management features to rename these folders
+if you wish, or you can delete them add add folders of your own choosing.</p>
+<p align="center">Figure 3: the Edit-Bookmark Folders page<br>
+<br>
+</p>
+<div align="center"><a href="edit-bookmark.gif"><img
+ src="edit-bookmark_.jpg" alt="" width="300" height="355"></a><br
+ clear="left">
+</div>
+<h3>Adding bookmarks to folders</h3>
+<p>Once you have defined one or more bookmark folders, you can start adding
+bookmarks to those folders. From the Edit-Bookmark Folders page, click the
+Edit link for the Folder you wish to edit. You will be taken to the Edit-Bookmark
+Folder page for that folder. From there you can edit the name of the folder
+and you can add and remove bookmarks in that folder.</p>
+<p align="center">Figure 4: the Edit-Bookmark Folder page</p>
+<p align="center"><a href="edit-folder.gif"><img src="edit-folder_.jpg"
+ alt="" width="300" height="355"></a><br>
+</p>
+<h3>Editing a bookmark</h3>
+<p>After you use the Edit-Bookmark Folder to add a bookmark, you can edit
+the Bookmark itself. To edit a bookmark, click on the Edit link in the Edit-Bookmark
+Folder page. That will take you to the Edit-Bookmark page and from there
+you can change the name, description and display priority of the bookmark
+you have chosen to edit. You can also move the bookmark to another folder
+by changing the Bookmark Folder combo-box.</p>
+<p align="center">Figure 5: the Edit-Bookmark page<br>
+<br>
+</p>
+<div align="center"><a href="edit-bookmark.gif"><img
+ src="edit-bookmark_.jpg" alt="" width="300" height="355"></a><br
+ clear="left">
+</div>
+<p><br>
+</p>
+<h3>Importing Bookmarks in OPML format</h3>
+Roller makes it easy to import bookmarks and build your blogroll by importing
+bookmarks in OPML format.  XBEL might be a better bookmarks format, but OPML
+is more popular in the world of weblogs.  To import bookmarks via OPML, follow
+these steps:<br>
+  
+<ol>
+  <li>download bookmarks in OPML format from a site such as Scripting.COM
+and save them as a file on your hard disk.</li>
+  <li>Login to Roller and choose the Bookmarks:Import menu option.</li>
+  <li>Use the file-upload capability to upload the OPML file into Roller.
+ The bookmarks will be imported into a folder called "unfiled".  You can
+use Roller to organize the bookmarks as you wish. </li>
+</ol>
+<p><br>
+</p>
+<h2><a name="editing_newsfeeds"></a>Editing your newsfeed collection</h2>
+<h3>Adding and deleting newsfeeds</h3>
+<p>A newsfeed is a list of news stories and a short desciption of each story
+that is automically retrieved from some remote website. Newsfeeds are delivered
+in a format known as Really Simple Syndication or Rich Site Summary or just
+RSS.</p>
+<p>Roller allows you to include newsfeeds on your Weblog page or on a separate
+page that you create as part of your Weblog's website. Your initial website
+will include three newsfeeds, but none of these newsfeeds are displayed on
+your Weblog page. You can use one of the macros that we will discuss later
+to display your newsfeeds.</p>
+<p>Before you include a newsfeed on your website, you should probaby make
+sure that doing so is OK with the provider of the newsfeed. Some providers
+might frown upon this and by frown I mean that they might sick a pack of
+rabid lawyers on your ass. Anyhow, use your own judgement here – I am not
+a lawyer and I am not responsible for any of your current or future legal
+troubles.</p>
+<p>To add a newsfeed you need a URL to the providers RSS feed. This URL usually
+ends with the letters “.xml”. Enter the name that you would like to use for
+the newsfeed, enter the URL and hit enter to add the newsfeed.</p>
+<h2><a name="customizing_your_pages"></a>Customizing your website</h2>
+<h3>Website settings</h3>
+The website settings form allows you to set the following properties for your
+weblog website:<br>
+<ul>
+  <li>    
+    <p><span style="font-weight: bold;">Website title</span> - The title of
+your website 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  
+  <span style="font-weight: bold;">$macros.website.title</span></p>
+  </li>
+  <li>    
+    <p><span style="font-weight: bold;">Website description</span> - The description
+of your website may include HTML, but the HTML will be stripped out in your
+RSS feed. You can access your description in a page template with the expression
+    <span style="font-weight: bold;">$macros.website.description</span></p>
+  </li>
+  <li>    
+    <p><span style="font-weight: bold;">Homepage page</span> - Choose a page
+template to be used as your websites main page.</p>
+  </li>
+  <li>    
+    <p><span style="font-weight: bold;">Day template page</span> - Choose
+a page template to be used to display weblog entries via the <span
+ style="font-weight: bold;">$macros.showWeblogEntries()</span> macro.</p>
+  </li>
+  <li>    
+    <p><span style="font-weight: bold;">Weblog editor page</span> - Choose
+either the plain old text editor (editor-text.jsp), the Ekit editor applet
+(editor-ekit.jsp), or the IE only Mitchell editor (editor-dhtml.jsp).</p>
+  </li>
+  <li>    
+    <p><span style="font-weight: bold;">Enable Blogger API </span>- Set to
+true to enable weblogging via the Blogger API.</p>
+  </li>
+  <li>    
+    <p><span style="font-weight: bold;">Category for Blogger API posts</span>
+- Choose the category for incoming posts made via the blogger API.</p>
+  </li>
+</ul>
+<h3>Website pages</h3>
+<p>Your Weblog page is defined by a page template. A template is a file with
+some special “macros” that indicate where Roller is supposed to put your
+Weblog, Weblog Calendar, and other dynamically created content. A templage
+can be an HTML file, an HTML fragment, a CSS page, or just about anything
+else you can enter into Roller as text.</p>
+<p>You initial Roller website has three page template, only one of which
+is visible to users. The pages are named Weblog, _DayTemplate and _css.</p>
+<ul>
+  <li>                             
+    <p>The Weblog page is the visible page, it is the HTML template that
+defines your Weblog. It is a mix of HTML and Roller macros that render the
+dynamic parts of the page like the Weblog Calendar and the actual Weblog
+entries.</p>
+  </li>
+  <li>                             
+    <p>The _DayTemplate page is the HTML template that defines the entries
+for each day are formatted in your Weblog page. This is essentially an HTML
+fragment with some Roller macros for rendering the day's Weblog entries,
+title, date, and other items.</p>
+  </li>
+  <li>                             
+    <p>The _css page is a CSS style-sheet information that is included (using
+a macro) on your Weblog page.</p>
+  </li>
+</ul>
+<p>You can define as many pages as you would like. You must specify which
+page is to be your Default Page, that is, the page that your readers first
+see when they visit your website. You must also specify which page is your
+Weblog day template.</p>
+<p>Note that any page whose name begins with the underbar “_” character will
+not be visible to your readers. That is why the _DayTemplate and _css pages
+start with underbars, they are used internally and are not meant for public
+consumption.</p>
+<p align="center">Figure 6: the Edit-Website page</p>
+<p align="center"><a
+ href="edit-website.gif"><img
+ src="edit-website_.jpg"
+ alt="" width="300" height="355"></a><br>
+</p>
+<p>If you click on one of the Current Pages in the Edit-Website page, you
+will be directed to the Edit-Page page so that you can edit that page. You
+can put anything on a page, but typically you will put HTML with some Roller
+macros mixed in. Next you will read about the various Roller macros that
+are available for your use.</p>
+<p>The screenshot below shows the Weblog page being edited in the Edit-Page
+page.</p>
+<p align="center">Figure 7: the Edit-Page page</p>
+<div style="text-align: center;"><a
+ href="edit-page.gif"><img
+ src="edit-page_.jpg"
+ alt="" width="300" height="346"></a><br>
+</div>
+<br>
+<h3>Website files</h3>
+Roller now includes a file-upload feature that allows you to upload images
+and other file for use in your weblog templates.  Here are the steps to upload
+and image to Roller and to use it in a weblog template:  
+<ol>
+  <li>Use the Weblog:File menu option to upload your image file</li>
+  <li>Use the Weblog:Pages menu to edit one of your templates.  Place the
+HTML IMG tag where you want the image to appear and use $macros.showResourcePath()
+directive to build the URL for the image.  For example, if your image was
+called leo.gif you might insert an IMG tag like this: &lt;img src="$macros.showResourcePath()/leo.gif"
+alt="one happy baby" /&gt;</li>
+</ol>
+<h3>User settings</h3>
+You can use the User Settings form to set your Full Name, Password, and Email
+address.
+<h3>Export</h3>
+Your Roller administrator should be using some sort of database utility to
+back up the Roller database on a regular basis. If you are worried that backups
+are not being done and you want to store a copy of your Roller data on your
+personal computer, you can use Roller's new export capability to export your
+weblog data in Roller's XML format.  Currently, there is no import facility
+for Roller XML so in the case of data-loss you will need your administrator's
+help to recreate your user.<br>
+<h3>Admin</h3>
+<h3></h3>
+The admin screen is only available to Roller administrators.  It allows an
+adminstrator to delete a user account from Roller.<br>
+<br>
+<h2><a name="macros_for_page"></a>Macros intended for use on any page template</h2>
+<p>Macros tell Roller where to place the dynamic parts of your web pages.
+Macros are actually <a href="http://jakarta.apache.org/velocity/index.html">Velocity</a> expressions. For more information on Velocity,
+visit the Velocity web site and read the Velocity <a href="http://jakarta.apache.org/velocity/user-guide.html">User's Guide</a>. Note that
+I use the term macro loosely, but it does have a specific meaning in Velocity.
+What I call a macro is really a Velocity expression.<br>
+</p>
+In a page template, you have access to an object called $macros that has many
+methods.  The macros object is actually a Java object.  To see the methods
+that are available to you via the <span style="font-weight: bold;">$macros</span>
+object, please refer to the Javadocs for:<br>
+<br>
+    <a
+ href="http://www.rollerweblogger.org/javadoc/org/roller/presentation/velocity/Macros.html">org.roller.presentation.velocity.Macros</a><br>
+<br>
+<h2><a name="macros_for_day"></a>Macros intended for use on your day template
+page</h2>
+<p class="western">Your Day Template page determines how each day of Weblog
+entries is formatted on the page by the <span style="font-weight: bold;">$macros.showWeblogEntries()</span>
+macro.  Inside your day template you have access to a <span
+ style="font-weight: bold;">$macros</span> object that has some additional
+methods.  So see the methods available to you via the $macros object in the
+day template, please refer to the Javadocs for:<br>
+</p>
+<p class="western" style="margin-left: 40px;"><a
+ href="http://www.rollerweblogger.org/javadoc/org/roller/presentation/velocity/Macros.html">org.roller.presentation.velocity.Macros</a><br>
+<a
+ href="http://www.rollerweblogger.org/javadoc/org/roller/presentation/weblog/tags/WeblogEntryMacros.html">org.roller.presentation.weblog.tags.WeblogEntryMacros</a><br>
+</p>
+<p class="western">Additionally, inside a day template you also have access
+to a collection called $entries which is made up of WeblogEntryDataEx objects.
+ For information on the methods and fields of these objects please refer to:<br>
+</p>
+<div style="margin-left: 40px;"><a
+ href="http://www.rollerweblogger.org/javadoc/org/roller/presentation/weblog/WeblogEntryDataEx.html">org.roller.presentation.weblog.WeblogEntryDataEx</a><br>
+<br>
+</div>
+<h2><a name="examples"></a>Example weblog page and day templates</h2>
+<p>Here is the weblog page template for the basic theme, shown in figure
+1 (macros are shown in blue):</p>
+<blockquote>                
+  <pre>&lt;html&gt;<br>&lt;head&gt;<br>&lt;!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"&gt;<br>&lt;title&gt;<span
+ style="color: rgb(51,51,255);">$macros.showWebsiteTitle()</span>&lt;/title&gt;    <br>&lt;style type="text/css"&gt;<span
+ style="color: rgb(51,51,255);">$macros.includePage("_css")</span><br>&lt;/style&gt;<br>&lt;/head&gt;<br>&lt;body background="/roller/images/bg-greylines.gif"&gt;<br>&lt;table cellpadding="5" cellspacing="15" border="0" align="center" width="95%"&gt;  <br>   &lt;tr&gt;   <br>   &lt;td width="20%" valign="top" bgcolor="#ffffff"&gt;     <br><span
+ style="color: rgb(51,51,255);">      $macros.showNavBar(true)</span>&lt;br&gt;   <span
+ style="color: rgb(51,51,255);">   </span><br
+ style="color: rgb(51,51,255);"><span style="color: rgb(51,51,255);">      $macros.showEditorNavBar(true)</span>&lt;br&gt;<br
+ style="color: rgb(51,51,255);"><span style="color: rgb(51,51,255);">      $macros.showBookmarks("Blogrolling",true)</span>&lt;br&gt;   <span
+ style="color: rgb(51,51,255);">   </span><br
+ style="color: rgb(51,51,255);"><span style="color: rgb(51,51,255);">      $macros.showBookmarks("News",true)</span>   <br>   &lt;/td&gt;   <br>   &lt;td width="60%" valign="top" bgcolor="#ffffff"&gt;               <br>      &lt;h2&gt;<span
+ style="color: rgb(51,51,255);">$macros.showWebsiteTitle()</span>&lt;/h2&gt;              <br>      <span
+ style="color: rgb(51,51,255);">$macros.showWeblogCategoryChooser()</span>&lt;br&gt;    <br>      <span
+ style="color: rgb(51,51,255);">$macros.showWeblogEntries()</span>   <br>   &lt;/td&gt;   <br>   &lt;td valign="top" bgcolor="#ffffff" width="20%"&gt;        <br>      <span
+ style="color: rgb(51,51,255);">$macros.showWeblogCalendar()</span>&lt;br&gt;      <br>      <span
+ style="color: rgb(51,51,255);">$macros.showRSSBadge()</span>   <br>   &lt;/td&gt;<br>   &lt;/tr&gt;<br>&lt;/table&gt;             <br>&lt;/body&gt;<br>&lt;/html&gt;<br><br></pre>
+</blockquote>
+<p>Here is the Day Template for the Weblog shown in figure 1:</p>
+<blockquote>                 
+  <pre>&lt;table width="95%"&gt;<br>&lt;tr&gt;<br>   &lt;td&gt;<br>  <span
+ style="color: rgb(51,51,255);"> $macros.showPermalink()</span><br
+ style="color: rgb(51,51,255);"><span style="color: rgb(51,51,255);">   $macros.showEntryDate()</span><br>   &lt;/td&gt;<br>&lt;/tr&gt;<br>&lt;/table&gt;<br><span
+ style="color: rgb(51,51,255);">#foreach( $entry in $entries )</span><br>&lt;p&gt;<br>   &lt;b&gt;<span
+ style="color: rgb(51,51,255);">$entry.title</span>&lt;/b&gt; <span
+ style="color: rgb(51,51,255);">$entry.text</span> <br>   &lt;font size="2"&gt;(<span
+ style="color: rgb(51,51,255);">$entry.updateTime</span>/<span
+ style="color: rgb(51,51,255);">$entry.pubTime</span>)&lt;/font&gt;<br>&lt;/p&gt;<br>#end<br></pre>
+</blockquote>
+<pre><br></pre>
+<pre><br></pre>
+<br>
+</body>
+</html>



Mime
View raw message