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-2024 by Maxim Chirkov Добавить, Поддержать, Вебмастеру |