Update of /cvsroot/roller/roller/docs/userguide
In directory sc8-pr-cvs1:/tmp/cvs-serv30016/docs/userguide
Modified Files:
userguide.wiki
Added Files:
quickstart.wiki
Log Message:
doc backups from WIKI
--- NEW FILE: quickstart.wiki ---
!!!Getting started with Roller
This document describes how to create a new Roller account and make your first
weblog post.
!!!Sign-up for a New Account
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." You will be presented with the form
below. 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 a couple of themese adapted
from themes on [http://blogskins.com]. Take a look at the RollerThemes page to
see some screenshots.
[http://www.rollerweblogger.org/userguide/images/qs1-newuser.png]
!!!Welcome
Next you'll see the welcome page. You'll see the URL for your weblog, the URL
for your RSS feed, and a login link. After you make a note of your URLs, click
the login link to login to your weblog.
[http://www.rollerweblogger.org/userguide/images/qs2-welcome.png]
!!!Login to Roller
I'm pretty sure you know what to do here.
[http://www.rollerweblogger.org/userguide/images/qs3-login.png]
!!!Make your First Weblog Post
After you login, you will be presented with the Weblog:Edit page, shown below,
which is just one part of the Roller Editor UI. The Weblog:Edit page is shown
below. To make a weblog post enter a title in the Title field (titles are nice,
but optional), enter your post in the Content field, and pick a category
combo-box. Don't enter anything in for the Publication Time, Roller will fill
that in for you. You can use any sort of HTML markup that you want in your
post, but make sure you close all of your HTML tags.
When you are happy with your post, you can click the __Post to Weblog__ button
to post it to your weblog or the __Save as Draft__ button to save it as a
private post for later editing. Optionally, you may choose to click the __Spell
Check__ button to check and correct spelling errors in your post.
[http://www.rollerweblogger.org/userguide/images/qs4-first-post.png]
!!!How does it look
After you post your weblog entry, click the Weblog link in the Navigation Bar
at the very top of the Weblog:Edit page. You should see your weblog and the new
post that you just entered. Something like this:
[http://www.rollerweblogger.org/userguide/images/qs5-myblog.png]
Index: userguide.wiki
===================================================================
RCS file: /cvsroot/roller/roller/docs/userguide/userguide.wiki,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** userguide.wiki 18 Apr 2003 04:47:54 -0000 1.2
--- userguide.wiki 24 Apr 2003 00:50:12 -0000 1.3
***************
*** 9,60 ****
* Getting started[2]
! ** Sign up for a new account
! ** Your initial website
! * Editing your weblog[3]
** Adding a new entry
! ** Publishing an entry
! ** Editing an old entry
! ** Publishing an entry
! ** __TBD:__ ''Deleting comments and Trackbacks''
! ** __TBD:__ ''Sending a Trackback ping''
! ** Referer rankings
! ** Flushing the cache
!
! * __TBD:__ ''Using a Blogging Client''
! ** __TBD:__ ''BloggerAPI and MetaWeblogAPI''
! ** __TBD:__ ''Configuring w.bloggar''
* Customizing your website[4]
! ** Website settings
! ** Choosing an editor
! ** __TBD:__ ''Swithing your theme''
! ** Website pages
! ** Website files
! ** User settings
! ** Admin
! ** Config
! ** Export
! * Roller Macros[5]
! ** Macros for any page
! ** Macros for a day page
! ** __TBD:__ ''Using Roller macros''
! ** __TBD:__ ''Macro Reference Guide''
! ** __TBD:__ ''Adding comments to your weblog''
! ** __TBD:__ ''Adding linkbacks to your weblog''
! ** __TBD:__ ''Converting from $macros to VelociMacros''
! * Editing your bookmark collection[6]
! ** Adding new bookmark folders
! ** Adding bookmarks to folders
! ** Importing Bookmarks in OPML format
! * Editing your newsfeed collection[7]
! ** Adding and deleting newsfeeds
! * Example Page Templates[8]
- * Configuration and Administration of Roller [9]
--- 9,56 ----
* Getting started[2]
! ** QuickStartGuide
! ** The Roller Web Application
! ** Roller Navigation Bars
! ** The Roller Editor UI
! * Managing your weblog[3]
! ** The Weblog:Edit Page
** Adding a new entry
! ** Working with old entries
! ** Sending Trackbacks
! ** Weblog:Categories Page
! ** Weblog:Referers Page
! ** Weblog:Flush Cache Page
* Customizing your website[4]
! ** Website:Settings Page
! ** Website:Themes Page
! ** Website:Pages Page
! ** Website:Files Page
! ** Website:User Page
! * Customizing your Page Templates with Roller Macros[5]
! ** The Page Concept
! ** VelociMacros and Variables
! ** Upgrading Roller 0.9.6 Pages
! * Using Roller for Bookmark and Blogroll Management[6]
! ** The Bookmarks:All Folders Page
! ** Importing OPML via the Bookmarks:Import Page
! ** Bookmark Display Macros
! * Using Roller for Display of RSS Newsfeeds[7]
! ** Newsfeeds:Subscriptions Page
! ** Newsfeeds:View All Page
! ** Newsfeed Display Macros
! * Using a Blogging Client with Roller[8]
! ** The Blogger and MetaWeblog APIs
! ** Confiuguring w:bloggar
!
! * Configuration and Administration of Roller[9]
! ** The Website:Config Page
! ** The Website:Admin Page
***************
*** 63,111 ****
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.
! 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 JIRA issue
tracking system.
- !!!Getting Started [#2]
- !!Signing up for a new account
! 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 blogskins.com: these are shown
below. There is also a new XHTML/CSS based theme called x2 that was contributed
by Matt Raible.
! 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.
! Your initial website
! 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:
! Figure: your initial Weblog page, assuming you chose the basic theme
! !!Logging in
! 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.
! !!!Editing your Weblog [#3]
! !!Adding a new entry
! 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.
! 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.
! 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.
! Figure: the Edit-Weblog page
! !!Publishing an entry
! 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.
! 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
dd.MM.yyyy HH:mm:ss
! !!Editing an old entry
! 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.
! Posting using a Blogger API client
! 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.
! 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 w:bloggarclient. 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.
!!Flushing the cache
--- 59,191 ----
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.
! 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 [JIRA issue
tracking system|http://opensource.atlassian.com/projects/roller/Dashboard.jspa].
! !!!Gettings started [#2]
! To get started with Roller you need to either 1) find a Roller site somewhere
that is offering new user registration or 2) install Roller yourself. There are
a couple of sites offering free Roller accounts. One is AnthonyEden's aptly
named FreeRoller site, hosted by JavaLobby. Another is
[http://blogs.application-servers.com]. Both of these sites are currently
running Roller 0.9.6, so some of the features described in this guide will not
be available. What about installing Roller? You should only attempt to install
Roller yourself if you are comfortable with system, database, and Java app
server administation. If you are ready for the challenge, download Roller from
the DownloadPage on SourceForge and follow the instructions in the Roller
InstallationGuide to install and start Roller.
! !!QuickStartGuide
! So, how do you get started? The Roller QuickStartGuide shows you how to
create a new Roller account and how to make your first weblog post (it's on a
separate page because it has lots of images and is only interesting to first
time users).
! !!The Roller Web Application
! There are three main parts of the Roller Web Application: the main page, user
website pages, and the Editor UI.
! * __The Roller main page__: The main page of a Roller site shows the most 15
most recent weblog posts for all of the users weblogs that are hosted on the
site and a the 15 most popular weblogs for the day (according the referer
ranking). Under the list of the most recent weblog posts, there is a bright
orange XML icon that links to an RssFeed that combines all of the weblogs on
the site into one aggregated new feed. For each of the weblogs listed in the
most popular weblogs list there is a bright orange XML icon that links to the
RssFeed for that weblog.
! * __User pages__: Each Roller user has his or her own "website" within the
Roller installation. A website is a set of pages, each page is defined by an
HTML page template that may be edited by the user. These page may contain
VelocityTemplateLanguage expressions, control statements, and a special set of
VelociMacros for useful things like a WeblogCalendar, EditorNavBar, PageNavBar,
RefererList, and other things. One of these pages is the user's weblog page or
default weblog page. More about this later...
! * __The Editor UI__: The Roller Editor UI is a web-based user interface that
allows you to edit your weblog, manage weblog categories, manage bookmarks,
manage newsfeeds, and control setting for your website.
! !!Roller Navigation Bars
! There are three types of Navigation Bars in Roller: the Navigation-Bar, the
Page Navigation Bar and the Editor Navigation Bar.
! !Navigation Bar
! The Navigation Bar appears at the top of the Roller main page and at the top
of the Roller Editor UI. When you are not logged into Roller the navigation bar
looks like this:
! [http://www.rollerweblogger.org/userguide/images/navbar.png]
! When you logged to Roller, the navigation bar expands to show links to all of
your public pages, to the Weblog:Edit page and to the Website:Settings page.
For example, if you had pages named 'Weblog', 'Bookmarks', and 'Archive' and
you were logged into Roller, your Navigation Bar would look like this:
! [http://www.rollerweblogger.org/userguide/images/navbar-auth.png]
! !Page Navigation Bar
! The Page Navigation Bar is produced by a Roller macro that may be used in
Roller user pages. The macro is called #showNavBar() and it is included in all
of the default Roller template, but you could choose to remove it if you
wanted. For example, if you had pages named 'Weblog', 'Bookmarks', and
'Archive' and you were not logged into Roller, your Page Navigation Bar would
look like this:
! [http://www.rollerweblogger.org/userguide/images/page-navbar.png]
!
! After you logged into Roller your Page Navigation Bar would look like this:
!
! [http://www.rollerweblogger.org/userguide/images/page-navbar-auth.png]
!
! !Editor Navigation Bar
!
! The purpose of the Editor Navigation Bar is to make it easy for you, when you
are logged into Roller, to access the Roller Editor UI directly from your
weblog page. Like the Page Navigation Bar, the Editor Navigation Bar is also
produced by a Roller macro. The macro is called #showEditorNavBar() and it is
also included in all of the default Roller templates. If you are not logged
into Roller, the Editor Navigation Bar will hide itself. The Editor Navigation
Bar looks like this:
!
! [http://www.rollerweblogger.org/userguide/images/editor-navbar.png]
!
! Clicking on any of the links on the Editor Navigation Bar will take you into
the Roller Editor UI and coincidentally, the very next topic is...
!
! !!The Roller Editor UI
!
! The Roller Editor UI is a web-based UI for editing your weblog, managing
weblog categories, managing a bookmark collection (AKA blogroll) managing
newsfeeds, configuring, and administering a Roller website and installation.
The menu for the Editor UI contains the same items as the Editor Navigation
Bar, but is presented in an Amazon-style tabbed menu format. The rest of this
guide will walk you through using the Editor UI to do all these things and
we'll take a closer look at the Roller Editor UI menu.
!
! !!!Managing your Weblog [#3]
!
! In Roller, managing your weblog includes writing new weblog posts, editing
old weblog posts, deleting comments, sending trackbacks, creating weblog
categories, and viewing your referer logs. Here is the Weblog sub-menu of the
Roller Editor UI:
!
! [http://www.rollerweblogger.org/userguide/images/eui-weblog.png]
!
! !!Adding a new weblog post
!
! To add a new Weblog post you simply go to the Weblog:Edit page, enter an
optional title in the Title field, enter the your post in the Content text
area, choose a category from the Category combo, and hit the __Post to Weblog__
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 Weblog:Edit page.
!
! [http://www.rollerweblogger.org/userguide/images/new-post.png]
!
! The above screenshow shows the default plain text weblog post editor. With
this editor, you are entering raw HTML and if you don't know HTML you will not
be able to do bold, italics, paragraph breaks, etc. Roller also support several
other WysiwygEditors and you can pick the one you want using the
Website:Settings menu of the Editor UI.
!
! !The Pub Time field
!
! When you make a new weblog post, you don't need to enter anything into the
Publication Time field. Roller will fill that in for you when you hit the post
or save button. When you edit your post later, you may choose to change this
Publication Time. I know this is lame, but you must enter the date in the
format 'dd.MM.yyyy HH:mm:ss'. If you don't like it then fix it and send
[us|http://sourceforge.net/mail/?group_id=47722] the code.
!
! !Save as Draft
!
! If you want to save your post as a draft, a private draft that nobody can see
but you, then hit the __Save as Draft__ button. Your entry will be saved and
you can edit and post it later.
!
! !Spell Check
!
! If you want to spell check your entry before posting it or saving it as a
draft, then hit the __Spell Check__ button. The Spell Checker will note each
misspelling and will offer alternatives for each, as shown below:
!
! [http://www.rollerweblogger.org/userguide/images/spell-check.png]
!
! !!Working with old posts
!
! You can also use the Weblog:Edit page to manage your old posts. Below the
Title and Content fields, and below the Post and Save buttons is a table that
lists your most recent weblog posts, both public and private (AKA drafts).
There is also a calendar so that you can navigate to even older posts. The
bottom of the Weblog:Edit page looks like this:
!
! [http://www.rollerweblogger.org/userguide/images/edit-old-posts.png]
!
! There are a number of operations that you can perform on each post. Here is a
summary:
!
! *__Edit__: This will load the post into the edit-weblog text area so that you
may edit it and then either repost it, save it as a draft or spell check it.
!
! *__Comments__: This will display the comments that have been made by users
either through the comment form or Roller's Trackback facility. You may choose
to delete comment, but you cannot edit them.
!
! *__Send Trackback__: This will display the Send Trackback page so that you
can send a Trackback ping to another blog to tell that blog that you are
writing about them.
!
! *__Remove__: This will remove the weblog post. First, Roller will ask you
"are you sure?"
!
! !!Sending a Trackback
!
! If you are writing about something you read on another weblog, you want to
let the author adn readers of that weblog know that you are doing so, and that
other weblog is [MT Trackback|http://www.movabletype.org/docs/mttrackback.html]
enabled, then you should send that weblog a Trackback ping.
!
! To send a Trackback for one of your weblog entries following these steps:
!
! # Locate the Trackback URL for the weblog entry that you wish to ping on the
other site, copy it with ALT-C (or whatever).
! # Click the __Send Trackback__ link your weblog entry in the Weblog:Edit
page. The Roller __Send a Trackback__ page will appear.
! # Paste the Trackback URL that you found step 1 into the Trackback URL field
of the __Send A Trackback__ page and click the send button.
!
! Here is the __Send a Trackback__ page:
!
! [http://www.rollerweblogger.org/userguide/images/send-trackback.png]
!
! If the Trackback completed successfully, you should see a page like the one
below with the number 0 in the <error> tags. If the Trackback failed you should
see an error message that explains what went wrong.
!
! [http://www.rollerweblogger.org/userguide/images/sent-trackback.png]
!
! !!Deleting Comments
!
! If you have enabled comments in your Website:Settings page and you have one
of the comments macros in your day template (#showCommentsLink() or
#showCommentsPageLink()) then your users may leave comments on each of your
weblog entries. Also, Trackbacks that come in from other weblogs are treated as
comments.
!
! You can't edit comments, that wouldn't be right now would it? However, you
can delete the comments that you do not like. From the Editor UI you can view
and delete the comments that are associated with your weblog entries. To view
the comments for a weblog entry, click on the __Comments__ link for that entry
on the Weblog:Edit page. You'll see the Delete Comments page as shown below.
Click the checkboxes for the comments and/or Trackbacks you wish to delete and
blow them away.
!
! [http://www.rollerweblogger.org/userguide/images/delete-comments.png]
!
! !!Managing your categories
!!Flushing the cache
***************
*** 117,128 ****
--- 197,215 ----
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.
+
+
!!!Customizing Your Website [#4]
!!Website settings
+ Website Settings, Configuration, and Administration Submenu:
+
+ [http://www.rollerweblogger.org/userguide/images/eui-website.png]
+
Figure: the Edit-Website page
The website settings form allows you to set the following properties for your
weblog website:
+
* Website title - 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 $macros.website.title
***************
*** 157,160 ****
--- 244,248 ----
!!Your Weblog page
+
Roller assumes that the page that you specify as your Default Page is your
main weblog page. The page where your weblogs entries are displayed. There are
certain things you should always have on your main weblog page. These are:
***************
*** 182,190 ****
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. __Export is currently disabled in Roller__
! !!!Roller Macros [#5]
** [Macro Reference
Guide|http://www.rollerweblogger.org/velocidocs/index.html]
** [Macro Conversion Guide|http://rollerweblogger.org/docs/macro_conv.html]
!!Macros intended for use on any page template
--- 270,297 ----
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. __Export is currently disabled in Roller__
! !!!Customizing your Page Templates with Roller Macros [#5]
** [Macro Reference
Guide|http://www.rollerweblogger.org/velocidocs/index.html]
** [Macro Conversion Guide|http://rollerweblogger.org/docs/macro_conv.html]
+ !!Velocimacro Variables[#5.1]
+
+ __These are the "variables" available for use in your pages and macros.__
+
+ For more information on the available Velocimacros see the [Macro API
docs|http://www.rollerweblogger.org/velocidocs/index.html] and if you are
upgrading your pages from Roller 0.9.6, then see the [Macro Conversion Guide
|http://rollerweblogger.org/docs/macro_conv.html].
+
+ |__$now__ | The current time (a java.util.Date object).
+ |__$ctxPath__ | The path under which Roller is running (see Webapp context).
+ |__$baseURL__ | The complete URL prefix upto and including the ctxPath.
+ |__$uploadPath__ | The location where uploaded files are placed.
+ |__$user__ | The current user for the page/entry being viewed.
+ |__$userName__ | The current user's username.
+ |__$fullName__ | The current user's full name.
+ |__$emailAddress__ | The current user's email address.
+ |__$website__ | The website for the current user.
+ |__$page__ | The current page being viewed.
+ |__$toStringFormat__ | A date format to be used with the macro formatDate(
$dateFormat $date ) :\\ EEEE MMMM dd, yyyy
+ |__$plainFormat__ | Another date format for use with the formatDate()
macro:\\ yyyyMMdd
+
!!Macros intended for use on any page template
***************
*** 206,210 ****
org.roller.presentation.weblog.WeblogEntryDataEx
! !!!Editing your bookmark collection [#6]
!!Adding new bookmark folders
--- 313,321 ----
org.roller.presentation.weblog.WeblogEntryDataEx
! !!! Using Roller for Bookmark and Blogroll Management [#6]
!
! Bookmarks Management Submenu:
!
! [http://www.rollerweblogger.org/userguide/images/eui-bookmarks.png]
!!Adding new bookmark folders
***************
*** 238,242 ****
#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.
! !!!Editing your newsfeed collection [#7]
!!Adding and deleting newsfeeds
--- 349,357 ----
#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.
! !!!Using Roller for Display of RSS Newsfeeds [#7]
!
! Newsfeed Aggregation Submenu:
!
! [http://www.rollerweblogger.org/userguide/images/eui-newsfeeds.png]
!!Adding and deleting newsfeeds
***************
*** 250,307 ****
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.
! !!!Example weblog page and day templates [#8]
! Here is the weblog page template for the basic theme, shown in figure 1
(macros are shown in blue):
! {{{
! <html>
! <head>
! <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
! <title>$macros.showWebsiteTitle()</title>
! <style type="text/css">$macros.includePage("_css")
! </style>
! </head>
! <body background="/roller/images/bg-greylines.gif">
! <table cellpadding="5" cellspacing="15" border="0" align="center"
width="95%">
! <tr>
! <td width="20%" valign="top" bgcolor="#ffffff">
! $macros.showNavBar(true)<br>
! $macros.showEditorNavBar(true)<br>
! $macros.showBookmarks("Blogrolling",true)<br>
! $macros.showBookmarks("News",true)
! </td>
! <td width="60%" valign="top" bgcolor="#ffffff">
! <h2>$macros.showWebsiteTitle()</h2>
! $macros.showWeblogCategoryChooser()<br>
! $macros.showWeblogEntries()
! </td>
! <td valign="top" bgcolor="#ffffff" width="20%">
! $macros.showWeblogCalendar()<br>
! $macros.showRSSBadge()
! </td>
! </tr>
! </table>
! </body>
! </html>
! }}}
- Here is the Day Template for the Weblog shown in figure 1:
! {{{
! <table width="95%">
! <tr>
! <td>
! $macros.showPermalink()
! $macros.showEntryDate()
! </td>
! </tr>
! </table>
! #foreach( $entry in $entries )
! <p>
! <b>$entry.title</b> $entry.text
! <font size="2">($entry.updateTime/$entry.pubTime)</font>
! </p>
! #end
! }}}
!!!Configuration and Administration of Roller [#9]
--- 365,376 ----
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.
! !!!Using a Blogging Client with Roller [#8]
! !!Posting using a Blogger API client
! 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.
! 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 w:bloggarclient. 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.
!!!Configuration and Administration of Roller [#9]
-------------------------------------------------------
This sf.net email is sponsored by:ThinkGeek
Welcome to geek heaven.
http://thinkgeek.com/sf
|
