NAME
navigator - browse and search AnswerBook on-line documenta-
tion
SYNOPSIS
navigator [ -b library-file ] [ -c card-catalog ]
DESCRIPTION
navigator and docviewer(1) together comprise an OpenWindows
application for viewing and navigating AnswerBook on-line
document collections.
navigator provides three modes for accessing AnswerBook
documents: Contents (table-of-contents browsing), Search
(full-text search and retrieval), and Bookmarks (links the
user creates to frequently referenced pages).
Documents found using navigator may then be viewed with
docviewer(1).
New to this version of navigator is the AnswerBook Library
feature. An AnswerBook library is a group of AnswerBooks
that can be browsed and searched as a single unit. naviga-
tor lets you select AnswerBooks of interest from those
available on the network, and add them to the current
AnswerBook Library. AnswerBook Library contents are stored
in files and thus saved between navigator sessions. In
addition, these files may be shared among groups of Answer-
Book users, and even mailed to others. See ab_library(4)
for more information.
You should not start navigator directly. Instead, use the
answerbook(1) script, which performs certain operations to
initialize and verify the AnswerBook environment before
starting navigator.
OPTIONS
-b library-file
Specify the AnswerBook library to load. The default
library is $HOME/.ab_library. See ab_library(4) for
more information.
-c card-catalog
Specify the name of the card catalog file(s) used to
locate AnswerBooks. See ab_cardcatalog(4) for more
information.
Contents Mode
Click SELECT on the "Contents" button near the top of
the Navigator window to browse the tables of contents
of the AnswerBooks in the current AnswerBook Library.
The Location list - the upper scrolling list in Con-
tents mode - shows the current path through the table
of contents hierarchy. The Contents (lower) list show
the contents of the current title in the location list.
Double-click SELECT on any bold-faced title in the Con-
tents list to display that title's contents. The title
itself moves to the bottom of the Location list, and
the first page of the corresponding document is
displayed in the Viewer window. Non-bold-faced titles
do not expand, but are displayed in the Viewer.
To move back up the table of contents hierarchy, just
click SELECT on any title in the Location list. That
document's contents will then appear in the Contents
list.
Search Mode
Click SELECT on the "Search" button near the top of the
Navigator window to perform full-text searches across
all the AnswerBooks in the current AnswerBook Library.
The search query syntax is generally free-form (but see
below). Simply enter one or more words or phrases in
the "Search Library for" text window, then hit RETURN
(or click SELECT on "Start Search" button) to initiate
the search. The navigator displays the list of titles
of documents found, ranked in order of relevance to the
search query. The algorithm used to determine document
relevance is heuristical, and is based on word-
occurrence statistics.
Double-click SELECT on any title in the list to display
the corresponding document in the Viewer window.
Search for literal phrases by enclosing them in double
quotes:
"workspace properties"
Search for words in proximity by enclosing them in
parentheses:
(print mail messages)
Match different work ending with an asterisk:
print* (matches "print", "printer", "printing", etc.)
Previous Searches
Click SELECT on "Previous Searches..." to bring up
a list of earlier search queries. The Previous
Searches window provides a simple copy-and-paste
facility for redoing or modifying queries.
Search Settings
Click SELECT on "Search Settings..." to modify
search properties. In the Search Settings window,
you can select the search scope (either the entire
document, or just document titles); the sorting
order for the results list (by relevance, or by
book and relevance); and the maximum number of
titles to display.
Bookmarks Mode
Click SELECT on the "Bookmarks" button near the top of
the Navigator window to browse the list of bookmarks in
the current AnswerBook Library. Click Select on a
bookmark in the "Bookmarks in Library" list to display
the annotation for that bookmark in the "Comment for"
window. Double-click SELECT on a bookmark to display
the corresponding document in the Viewer window
Click SELECT on the "Delete Bookmark" button to delete
the currently selected bookmark. This operation cannot
be undone.
The bookmark annotation in the "Comment for" window, as
well as the bookmark title on the "Comment for" line
are editable. Use the standard textedit editing func-
tions to modify them, then click SELECT on the "Save
Changes" button.
New Bookmark
Click SELECT on the "New Bookmark..." button to create
a bookmark to the current page in the Viewer window.
In the resulting New Bookmark pop-up window, edit the
bookmark title, and annotate it if desired, then click
SELECT on the "Create" button to add the new bookmark
to the bookmark list for the current AnswerBook
Library. The updated bookmark list is automatically
saved to the current Library file so that it can be
browsed the next time that file is loaded into naviga-
tor.
Modify Library
Click SELECT on the "Modify Library..." button to bring
up a list of available AnswerBooks to include in the
current AnswerBook Library. Select one or more Answer-
Books from the list, then click SELECT on the "Apply"
button to put those AnswerBooks in the current Library.
This list of AnswerBooks is automatically saved to the
current Library file so that it is available when you
next run navigator.
The AnswerBooks shown in the Modify Library list are
those found in the AnswerBook Card Catalogs in your
Card Catalog path. See ab_cardcatalog(4) for more
information.
To prevent two people from updating the same AnswerBook
Library file at the same time (and thus losing data
and/or corrupting the file), navigator sets an advisory
lock on the file upon opening it. If the file is
already locked, navigator gives you the option of open-
ing it read-only, or resetting the lock. If you open
an AnswerBook Library file read-only, changes to that
Library (including bookmark changes) will not be saved.
You should reset a lock only if you know that it is no
longer valid (e.g., the navigator that set it is no
longer running).
Starting Navigator
You should start navigator via the answerbook(1) script
rather than running it directly. Command line argu-
ments to answerbook are passed on to navigator.
You can also start AnswerBook by opening an AnswerBook
Library file in File Manager, MailTool, or other
DeskSet application. See filemgr(1) for details.
By default, navigator loads your personal AnswerBook
Library file ($HOME/.ab_library) when it starts. Use
the -b library-file option to load a different Library
file (see OPTIONS ).
Foreign Language Support
Some AnswerBooks contain translated documents in addi-
tion to the English versions. The user can specify the
preferred language at the beginning of an AnswerBook
session via the $LANG environment variable or the "-l"
command line flag. navigator and docviewer will
display, search, etc., documents in the preferred
language when they are present in the AnswerBook.
ENVIRONMENT
AB_CARDCATALOG
Specify the name of the card catalog file used to
locate AnswerBooks. See ab_cardcatalog(4) for more
information.
LANG
Specify the preferred language for browsing, searching,
etc. Can be overridden by "-l" command line flag.
FULTEMP
Directory for writing temporary files used during
search operation.
FILES
~/.ab_cardcatalog
Default AnswerBook Card Catalog file used to locate
AnswerBooks. See ab_cardcatalog(4) for more informa-
tion.
~/.ab_library
Default AnswerBook Library file loaded by navigator.
See ab_library(4) for more information.
/usr/tmp/ft*
$FULTEMP/ft*
Temporary files used during search operations.
SEE ALSO
docviewer(1), answerbook(1), ab_admin(1), setlocale(3),
ab_cardcatalog(4), ab_library(4),
NOTES
AnswerBook is a trademark of Sun Microsystems, Inc.,
licensed to SunSoft, Inc.
The OpenWindows environment may no longer be supported in a
future release. You may want to migrate to CDE, the Common
Desktop Environment.
|
Закладки на сайте Проследить за страницей |
Created 1996-2025 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |