The AnswerBook Navigator and Viewer are a pair of windows for browsing, searching, bookmarking, and printing on-line document collections, also known as an AnswerBook.
To start the AnswerBook Navigator to see AnswerBook products that may be available to you:
AnswerBooks are available to you if your system or site administrator has installed them and configured them for your use.
Choose Workspace -> Programs -> AnswerBook.
When the AnswerBook Navigator opens, it displays the contents of your on-line Library. Your on-line Library may contain the Solaris 2.6 User AnswerBook, a collection of basic manuals to help get you started using your Sun system. Your library may also contain more than one AnswerBook, provided that:
Your system/site administrator has installed them and configured them for your use, and
You or your administrator has included them in your Library (see "Modifying Your Library").
Together the AnswerBook Navigator and Viewer give you access to your Library. You locate what you want to read in the Navigator, and then read it in the Viewer, where it appears page for page as it would in a printed book.
The AnswerBook Navigator acts as a kind of remote control for the Viewer. Using the controls in the Navigator, you locate the information you want and display it in the Viewer.
The Navigator provides three ways of finding on-line information:
In Contents mode you can select an AnswerBook, and then browse through it, opening and closing books, chapters, and sections, as needed.
In Search mode you can enter a search phrase describing what you're looking for, and the Navigator displays a list of documents found, ranked by relevance.
In Bookmarks mode, you can go directly to pages where you previously created electronic bookmarks and edit them.
Use the AnswerBook Navigator window to:
Search for topics of interest
Modify your Library (by adding or removing an available AnswerBook)
Select and open an AnswerBook
Select topics for display in the Viewer
Browse through tables of contents
Leave bookmarks and comments on pages within a Library
Use the AnswerBook Viewer to read the documents you select in the Navigator and to print them. You can read pages sequentially or follow hypertext cross-reference links from topic to topic.
You can close the Navigator and Viewer windows separately. The closed Navigator and Viewer windows are represented by the icons in Figure 19-5.
Close each window by choosing Close
from its window menu or by pressing the Open key on your keyboard (which toggles Open/Close).
You can quit each window, or its icon, by choosing Quit from its window menu. When you quit the Navigator, you quit both the Navigator and the Viewer; quitting the Viewer quits only the Viewer.
You can also use the keyboard equivalents that apply to all DeskSet applications to close or quit the Navigator and Viewer. For more information, see Chapter 17, Customizing the Solaris Environment.
The default mode in the AnswerBook Navigator is Contents. In Contents mode, the Navigator has two panes: Location and Contents. Initially, the Location pane lists your Library, and the lower Contents pane lists the AnswerBook sets in the Library.
To see more of the contents of an AnswerBook:
In the lower Contents pane, double-click SELECT on a bold AnswerBook title.
The title expands to show more contents.
With the AnswerBook contents expanded, you can browse its sets and books. Some books appear in more than one set.
To expand any boldface listing, double-click SELECT on it. When you do so, the listing expands to show more of its contents.
With each expansion, the Contents list grows to reflect deeper levels of the documentation--sets, books, chapters, and headings. For example, if you double-click on a set title, the title moves up into the Location pane, and the list of books contained in that set is displayed in the Contents pane below.
When you double-click SELECT on any listing at or below the book level, the first page of that topic or document opens in the AnswerBook Viewer.
To display entries that have scrolled out of sight, use the scrollbar or Scrolling List menu (displayed by pressing MENU) in either pane to locate it, as shown in Figure 19-8.
In the AnswerBook Viewer, you can turn the pages of a book, chapter, or section almost as if you were reading a printed book. You can also follow hypertext cross-reference links between sections, chapters, and books.
To turn pages, click SELECT on the page-turning buttons at the top of the AnswerBook Viewer, or click SELECT on the Go Back button to retrace your steps successively, page by page. See Figure 19-4.
You can use keyboard shortcuts for the paging commands.
PgUp works like the previous-page
button.
PgDn works like the next-page
button.
Undo works like the Go Back
button.
Home displays the first page of the chapter you're in. If you're already at the first page of a chapter, Home displays the first page of the previous chapter.
End displays the first page of the next chapter.
Choose Page Info
from the View
button menu in the Viewer to look up the origin of the page currently on display. The Page Info
window, shown in Figure 19-9, is displayed.
Each time you choose the Page Info option, you see an update of the information for the current page.
Hypertext cross-reference links appear as text boxed with a thin outline.
You can follow hypertext cross-reference links within or between books. The quickest way to follow a cross-reference link is to double-click SELECT on the boxed link. Or, you can click SELECT on the hypertext link, then press MENU on the View
button and choose Follow Link
, as shown in Figure 19-10.
If, when you attempt to follow a link, you see the message, "Can't follow hypertext link" at the bottom of the Viewer window, probably the link points to a document that is not in any of the currently selected AnswerBooks in the Library. See "Modifying Your Library".
In Search mode, the Navigator can match your requests by searching through the text and titles of all documents you have included in your Library. You can enter search phrases in your own words, and enhance your searches (see "Advanced Search Techniques").
To change to Search mode, click SELECT on the Search
setting in the control area.
To search for a topic of interest:
Begin a search by typing a search phrase--a word, phrase, or sentence--in the pane marked "Search Library For."
Type any text up to 1024 characters including spaces and punctuation. Edit the search phrase as you would in any text window.
To start the search, press Return at the end of the search phrase.
Or, you can click SELECT on the Start Search
button.
When the search is complete, relevant topics are listed in the Documents Found pane. The topics are coded with squares, starting with black (most relevant) to white (least relevant), with shades of gray in between.
Figure 19-12 shows the result of a search. Each item points to a location in the Library where a document that matches your request was found.
To see a topic found in the search:
Double-click SELECT on an item in the Documents Found pane.
That page is then displayed in the Viewer.
Scroll the list in the Documents Found pane of the Navigator to see more items in the list.
Your search phrases dating from the last time you started the Navigator are saved so you can reuse them. You can reuse a search phrase as is, or you can edit it before starting a new search. Click SELECT on the Previous Searches
button. The Previous Searches window is displayed.
Your search phrases are listed with the most recent at bottom. You can copy and paste a phrase from the Previous Searches window into the Search For pane. Press Return or click SELECT on the Start Search
button.
To change search settings, click SELECT on the Search Settings
button. In the Search Settings window you can specify various options to control the results of your searches.
Search Library by:
Text and Titles searches all text included in your Library, while Titles Only searches only book and chapter titles, and section and subsection headings.
Sort Findings by:
Relevance Only simply lists all documents found in order of relevance, regardless of the books they appear in. Relevance and Book means the documents found will be listed grouped by book, with topics within a given book listed by relevance.
Limit Findings to:
Click SELECT to increase or decrease the default number of 30 findings per search.
Click SELECT on Apply
to preserve your settings, or click SELECT on Reset
to undo your choices and restore the previous ones.
To make your searches more precise and more productive, you can:
Restrict (modify) the contents of your Library to constrain the scope of the search.
Choose the search setting "Titles Only" to search through book, chapter, and section titles rather than searching through the full text of documents.
Use special characters to mark your search phrases for literal, suffix-expansion, and "nearness" matching.
By adding or removing an AnswerBook from your Library, you can widen or narrow the scope of your search. See "Modifying Your Library".
The Titles Only option restricts searches to book titles and chapter and section headings. This search method is useful if you already know terms used in the titles or headings of documents you are looking for.
By adding special characters--quotation marks, parentheses, and asterisks--to your search phrases, you can make searching more precise. You can combine the characters to further refine your search.
Place the search phrase between double quotation marks to find documents that contain that literal phrase. For example, the search phrase "reading mail" finds documents containing that phrase. On the other hand, if you type reading mail, you will find documents containing one or both words.
Place words between parentheses to find documents with those words in proximity to each other. For example, the search phrase (reading mail) will find all documents that have "reading" and "mail" within a few lines of each other, in either order.
Place an asterisk at the end of a word to match all possible endings of the word. For example, the search phrase chang* will expand to "change," "changed," "changes," "changing," and so on.
If you do not know whether a term is one word, two words, or hyphenated in the documentation, you can insert the hyphen to look for all three forms. For example, to search for "mail tool," "mailtool," and "mail-tool," type mail-tool in the Search For pane.
Words connected by punctuation other than a hyphen are treated character for character as literal phrases, for example: /usr/local/bin, win_client_data, and in.rlogind.
You can combine any or all of the above search techniques to further refine your search. For example:
"chang* mail-tool" finds documents containing literal phrases such as "change mailtool," "change mail tool," "change mail tool," "change mail-tool," "changing mailtool," "changing mail tool," "changing mail-tool," and so on.
"display button" viewer searches for "display button" and "viewer" in proximity to each other.
Placing bookmarks helps you relocate pages of interest quickly. You can also use bookmarks to annotate a page with your comments. Note that bookmarks do not appear on the marked pages. When you put the Navigator in Bookmarks mode, you'll see a list of all the bookmarks you've created to date.
You can create a bookmark in any Navigator mode, but you must change the Navigator to Bookmarks mode if you want to read, edit, or delete bookmarks or print or display bookmarked pages. See "Viewing and Editing Your Bookmarks".
To create a new bookmark for the page currently displayed in the Viewer, click SELECT on the New Bookmark
button at the top of the Navigator.
In the New Bookmark window, the text at the top specifies the current page. You can edit the text in the "Bookmark for" field, which is used in the Existing Bookmarks list when the Navigator is in Bookmarks mode. You can also type an annotation in the Comment pane.
Click SELECT on the Create
button to create the new bookmark. Or, if you decide not to create a bookmark, dismiss the New Bookmark window.
To see your list of bookmarks, click SELECT on Bookmarks.
The Bookmarks list shows the Bookmark titles listed under the associated AnswerBook. To see the comment for a particular bookmark, select (highlight) it in the Bookmarks list.
You can edit a bookmark directly in the Bookmarks list. When you're done, save the bookmark changes.
To delete a bookmark, select it and then click on the Delete Bookmark
button. The Navigator asks for your confirmation before deleting. Note that you cannot undelete a deleted bookmark.
Bookmarks serve as links to pages you've marked in the AnswerBook Viewer. Double-click SELECT on a bookmark to display the bookmarked page.
You can add AnswerBooks to your Library, provided they have been installed and configured for your use. You can also remove AnswerBooks from your Library to constrain browsing and searching.
The System Administration Guide provides information for system administrators on how to make an AnswerBook available to users.
Click SELECT on the Modify Library button at the top of the Navigator.
The AnswerBook browser opens and displays a list of available AnswerBook products.
Click SELECT on each AnswerBook you want to add.
A check mark appears next to each title you select. To deselect (uncheck) an AnswerBook, click SELECT on it again. If an AnswerBook title is not checked, it means it is not included in your Library.
When you're ready, save your selections.
Click on Apply.
This updates the Library to include each newly selected AnswerBook.
Any AnswerBook you add to the Library will be included in the Navigator Contents listing and in your searches.
If you deselect AnswerBooks to constrain searching, don't forget to reselect those AnswerBooks for future browsing.
The View
button menu provides two options for setting the display magnification of the Viewer page. Press MENU on the View
button to see these menu options: Standard Magnification and Custom Magnification.
Standard Magnification
is the magnification determined by the publisher of the documents--that is, the default. You can set other magnification values by choosing Custom Magnification
. This opens the Custom Magnification window.
Drag the slider to the desired value.
Press SELECT on the slider control as you move it. The amount of magnification is specified in the Magnification Percentage field.
Click SELECT on Apply
.
This puts the new page magnification into effect.
Clicking SELECT on Reset
reverts to the previous setting. Single clicks on the left or right of the slider cause one-percent increments up or down the scale.
Use the Print
button in the Viewer when you want to print books, chapters, sections, subsections, or single pages.
In the Print window that is displayed, you can choose printing options (Figure 19-19). The default printing option is Current Viewer Page
, which prints just the page you see in the Viewer.