Prev | Index | Next (Reading News)
Installing Olive is a simple, streamlined process (so long as you're
not on OS X). After unpacking the tarball, cd into the
resultant directory and run 'make'.
NB: If you are on a BSD system, run 'gmake' instead of
'make'.
This will run a dependancy check and report the results. You may see:
mdxi@fornax:~/olive$ make
Checking for dependancies...looks good.
mdxi@fornax:~/olive$
but chances are that you'll see something more like this:
mdxi@fornax:~/olive$ make
Checking for dependancies...Required modules not found:
Config::YAML
DBD::SQLite
XML::Simple
make: *** [olive] Error 1
mdxi@fornax:~/olive$
The easiest thing to do, should you be missing modules, is to let
the cpan script install Bundle::Olive for you. This
will install all of Olive's dependancies (and all of their
dependancies), all at once. If, for whatever reason, you don't wish
to do this, install the list of modules reported as missing by
whatever mechanism you wish. The effect is the same.
With all deps installed, you may want to look at the top of the Makefile, where you'll find this:
PREFIX = /usr/local
BINDIR = $(PREFIX)/bin
LIBDIR = $(PREFIX)/share/olive
DOCDIR = $(PREFIX)/share/doc/olive
If this (very standard) layout isn't to your liking, modify it to suit you. Now it's time for the actual install.
mdxi@fornax:~/olive$ sudo make install
Checking for dependancies...looks good.
Prepping for install.
Creating install directories.
Installing Olive.
Cleaning up.
Done. Now run /usr/local/bin/olive to get started!
That's all there is to it.
If you have been using NetNewsWire or Bloglines, Olive can import OPML files exported by them, sparing you from having to manually add those feeds. This would be a good time to do that.
Just run 'olive [OPML_FILE]' and the import process will
proceed.
mdxi@fomalhaut:~$ ./olive bloglines.opml
Olive starting up.
Loading modules.
Initialising objects and data.
Beginning OPML import.
Descending into HTML-CSS-DTHML-Javascript...
Descending into News...
Descending into Of Interest...
Descending into People...
Descending into Perl...
Descending into User Groups...
Descending into VIm...
71 of 75 feeds imported
See ~/.olive/errors.log for more information
mdxi@fomalhaut:~$ cat ~/.olive/errors.log
-- Starting up at 2006-00-04T19:47:15 --
The nick 'The Daily Herald' is in use or reduces to a nick which is in use (http://www.harktheherald.com/feed_letters.php).
The nick 'The Daily Herald' is in use or reduces to a nick which is in use (http://www.harktheherald.com/feed_top.php).
The nick 'The Daily Herald' is in use or reduces to a nick which is in use (http://www.harktheherald.com/feed_opinion.php).
The nick 'Jeremy Zawodny's' is in use or reduces to a nick which is in use (http://jeremy.zawodny.com/blog/rss2.xml).
mdxi@fomalhaut:~$
This can be done at any time (but shouldn't be done when another copy of Olive is running).
As the example above shows, any feeds in the OPML file which are already found in the Olive feed list will be rejected and a notice will be written to the error log. Feeds whose descriptions cause collisions with existing feeds will be similarly rejected.
The first thing you'll see is a splash screen welcoming you to Olive and telling you how to get to the help popup. This will only be shown the first time you run Olive.
Once the welcome message is cleared, you'll be looking at the main
Olive interface. If you have already imported a feed list, the feeds
will be polled and processed and you'll be ready to go. If not, your
screen will be mostly blank and you'll need to add some feeds. You
can do this by pressing 'C-a' and filling in values in
the dialogue which pops up. You will also want to set your external
browser command in the Options panel. Press 'C-o' to
invoke that panel and see Section 3.5
for more information.
The top half of the screen is occupied by the List Pane, where the
list of available stories is displayed. Use the up and down arrow
keys to navigate it and the Enter key to select a
story. Once selected, the content of the story will be displayed in
the Story Pane, at the bottom of the screen (if you need to scroll
this pane, use the Spacebar to page the story text down
and the '-' key to page it up).
To exit Olive, press 'Q'.
There are more advanced functionality and alternate keys available (that's what the rest of this manual is for) but those are the basics.
As long as there isn't a dialog on screen, you can press
'h' or '?' to access the help popup, which
contains a list of keybindings and some other information.
More complete help is found in this manual, which can be accessed
from within Olive by pressing 'C-n'. This will launch
an external browser with the manual index loaded.
You
can view
existing bug reports
and file new
ones at the Olive Trac wiki. If that doesn't work for you, or
if you just have comments or questions, send them to me at
<mdxi@cpan.org>
Prev | Index | Next (Reading News)
$Id: start.html 426 2006-02-15 04:00:59Z mdxi $