(Getting Started) Prev | Index | Next (Setting Options)
Olive does not mimic GUI-style user interfaces by implementing
text-based menus, controls, and the like. Instead it takes programs
like mutt
as its inspiration and stays out of your way
as much as possible. Transient panels and message dialogues aside,
the Olive UI is composed of 4 components (listed here
top-to-bottomly): Title Bar, List Pane, Status Line, and Story
Pane. Only the List Pane and Story Pane can be interacted with in
any meaningful way.
Focus is shifted between the List Pane and Story Pane with the
'w
' key, but this is rarely needed anymore.
The titlebar is simply the top line of the window, used to display Olive's name and version number in white-on-blue text.
|
| Olive b7
|
You can hide the titlebar and have this line of screen real-estate for your own use. See Section 3.2.4 for details on how to do this.
The top half of Olive's window is used by the List Pane. This is where the stories from the feeds currently in your feed list are displayed, one story per line. Each line displays the following information:
Stories are sorted as follows:
If there are both new and old stories present in the list, a separator line of dashes will be displayed between them.
TITLE FEED AGE S U |------ (Width - 29 chars) -------| |-- 16 chars --| |- 7 -| 1 1 | Martian rover rolls free of trap BBC News 00h 52m @ | Pacman comes to life virtually BBC News 00h 38m * @ | Many dead in Nepalese bus blast BBC News 00h 12m @ | ---------------------------------------------------------------- | China dismisses US Tiananmen call BBC News 03h 38m * - | Japanese firms raise investment BBC News 04h 12m -
The age field displays 'HHh MMm
' for stories less than
one day old, 'DDd HHh
' for stories between 1 and 100
days old, '___+99d
' for stories 100 or more days old,
and '____???
' for stories with no date (or invalid
dates) in their RSS data.
The Starred indicator displays '*
' for stories you have
flagged as starred and nothing for stories which are
unstarred. See Section 2.4 for more information
on this.
The Read/Unread indicator displays '@
' for unread
stories and '-
' for stories which you have already
read. As you read stories, they will remain in place among the new
stories until the next feed poll (see
Section 3.3) occurs; they will then
be sorted with the old stories.
The list cursor is displayed as a bolded reverse-video bar spanning the width of the pane.
| Martian rover rolls free of trap BBC News 00h 52m @
| Pacman comes to life virtually BBC News 00h 38m * @
| Many dead in Nepalese bus blast BBC News 00h 12m @
| --------------------------------------------------------------
| China dismisses US Tiananmen call BBC News 03h 38m * -
| Japanese firms raise investment BBC News 04h 12m -
When the cursor is moved from the currently selected story, that story is displayed in bold face:
| Martian rover rolls free of trap BBC News 00h 52m @
| Pacman comes to life virtually BBC News 00h 38m * @
| Many dead in Nepalese bus blast BBC News 00h 12m @
| --------------------------------------------------------------
| China dismisses US Tiananmen call BBC News 03h 38m * -
| Japanese firms raise investment BBC News 04h 12m -
The cursor will return to the top of the list when a feed poll occurs.
Between the List Pane and the Story Pane sits the Status Line. It is a single line which displays various and sundry informational mesasges for you. It cannot be turned off, but its behavior can be modified.
Most of the status line is taken up by the Staus Area. If enabled as per Section 3.2.1, the Status Area will display a message in the following format when no other activity is happening:
|
| [S: 1/175] [U/N: 21/21] [P: 5 @ 05:45 | 6 since 02:41] [F: F,S]
|
It is read as follows:
[S: n/n]
[U/N: n/n]
[P: n @ HH:MM | n since HH:MM]
[F: X,Y,..Z]
F
for
flagged feeds and S
for starred stories. If no
filters are active, this block will not display at all.
When polling is active, the Status Area displays brief messages about the polling process (Checking..., Fetching..., etc.) for each feed being polled. When the Story Pane is focused, the Status Area displays the title (the actual title, taken from the feed, not the nickname displayed in the story list) of the feed from which the currently selected story is taken.
The rightmost character of the Status Line is the Focus Pointer. It
simply points to whichever of the the List Pane (^
) or
the Story Pane (V
) is focused.
The bottom half of Olive's window is used by the Story Pane. This is where the content of (and some other information from) the currently selected story is displayed.
| Story Title | ----------- | | -- Header | | Lorem ipsum dolor sit amet, consectetuer | adipiscing elit. Vivamus rhoncus libero. | | Aenean sit amet risus sed felis molestie | hendrerit. Pellentesque feugiat mauris. | | -- | http://someurl/pathto/story.html
The List and Story panes, as well as the feed Edit and Remove
panels, have capabilities much like those
of the Unix utility less
.
/
' to start a search, then...Enter
, which will
cause the cursor to jump to the first matching line, or
display Not found
if there is no match.
n
' to repeat the search forward or
'N
' to repeat it backwards,
Enter
to select the current match and end the
search or...
q
' to end the search without selecting
anything.
The selection cursor in the List Pane is moved one line at a time
with the up and down arrow keys or the 'j
' and
'k
' keys, Pressing Enter
selects the
current story and causes its contents to be loaded into the Story
Pane.
Cursor movement and story selection functions are combined in the
'[
' and ']
' keys, which select the
previous and next stories,respectively.
The cursor can also be moved one screen at a time
with PgUp
and PgDn
, or to the top and
bottom of the list with Home
and End
.
Individual stories can be marked or unmarked as read with the
'm
' and 'u
' keys. All stories can
be marked/unmarked at once with 'M
' and
'U
'.
When the Story Pane is focused, the story text can be scrolled one
line up or down with the arrow keys or the 'j
' and
'k
' keys. It can also be scrolled one screen at a time
with PgUp
and PgDn
, or to the top and
bottom with Home
and End
.
Nearly all stories will have a single link URL attached to them
which leads to a fuller or permanent copy of the story from the
feed. This URL is displayed after the story text, and can be
followed by pressing the 'l
' (ell) key.
Some news stories have URLs embedded in their content, in addition
to the dedicated link URL. These can be accessed by pressing
'L
', which will pop up a Linklist in the top-right
corner of the Olive window.
.[ Linklist ]-----------------------------------. | | | [ 6] permalink || | [ 7] incorporated || | [ 8] entry #| | [ 9] discovery #| | [10] Patrick Stewart #| | [11] Circulating intentional data || | | | < Cancel > | | | '-----------------------------------------------'
The numbers correspond to markers which are placed in the story text, as in:
On the test version of the catalog he has [incorporated][7] tagging, which he discusses in a recent [entry][8] on his blog.
Select a link with the Up/Down arrow keys and
press Enter
to launch an external browser session with
the URL of that link as the
target. If Global Story Paging has
not been disabled, the story text can be paged while the Linklist is
displayed. The linklist will be dismissed when you Tab
to the "Cancel" button and press Enter
.
Olive has a pair of selector mechanisms to help you separate the wheat from the chaff in your newsreading: starring stories and flagging feeds.
Starred stories will remain in your story list even after they have
"fallen off" the feed they were sourced from. This lets you force
stories to stick around if you need them for later reference. The
star flag of a story is toggled on/off with the 's
'
key. Once unstarred, a story will be removed from the story
database if it is no longer in the feed it came from. The secondary
effect of starring stories is that you can filter the story list to
show only the currently starred stories with the 'S
'
key.
Unlike starred stories, which are immortal, There is nothing special
about flagged feeds except that you have "flagged" them as special
in some way. For instance, I flag the feeds which belong to journals
of my friends, marking them as distinct from the general news feeds
I subscribe to. The story list can be filtered to show only stories
from flagged feeds with the 'F
'
key. See Section 4.1 for information on
flagging feeds.
(Getting Started) Prev | Index | Next (Setting Options)
$Id: news.html 368 2006-01-05 01:20:15Z mdxi $