Viola World Wide Web browser interface.

This document details the specifics of the user interface of the Motif version of ViolaWWW (there is also a pure X11 version).


File Menu

Open

[Access a file, WWW document, or other WWW service.]

(Keyboard: Ctrl-O in the browser window.)

You can access World Wide Web documents using the "Open" item in the File menu. I file selection dialog box will pop up, enabling you to browse the local file system and select a file for opening. Although this dialog is primarily designed for opening local files, for convenience, you can also use it to access other documents and WWW services on the network.

Filter Field

The "Filter" field is used to restrict what files are displayed in the scrolling "Files" list. The user specifies a standard UNIX file-matching regular expression in this field and the scrolling list will list only the files in the specified directory that match the pattern.

For example, if your home directory is /usr/home/me and you wish to see all files in this directory, you would enter /usr/home/me/* into the filter field, specifying all files in the directory /usr/home/me. If you only wished to see the files in your home directory that end with the suffix .html, then you would enter /usr/home/me/*.html into the Filter field. (If you are not familiar with UNIX regular expressions, you should be able to find a discussion of them in a general UNIX book, or possibly in the man pages on the C Shell on your system (type man csh)).

After you have typed a regular expression in the Filter field, you must tell the file selection dialog to use the new filter by either typing the key in the field or by clicking on the "Filter" button at the bottom of the file dialog.

Directories List

The scrolling list of directories on the middle left of the dialog displays all of the directories in the "current directory". You can tell what the current directory is by looking at the file matching pattern in the "Filter" field. To change the current directory, scroll through the list of directories and double-click on the one you wish to change to. You will notice that the list of directories and the list of files change to represent the files and directories in the new current working directory. To move up one directory, double click on the ".." directory, shown at the top of the directories list.

If you wish to change to a directory without having to traverse all of the directories in between, you can simply type the new directory name into the filter field and click on the "Filter" button. If you do this, remember to add an asterisk "*" at the end of the Filter field so that the files in the new directory will be displayed in the "Files" list.

Files List

This scrolling list displays all the files in the current directory that match the regular expression in the Filter field.

File Name Field

This field shows the currently selected file. If you select a file in the file list, this field will change to display the full path name of that file. You may use this field to specify the full path name of a file that you wish to open: simply delete the current contents and type in the full path of the file you wish to open. Then click on the "OK" button at the bottom of the dialog.

As an added convenience, you may also enter URL's of http files or other network services in this field as well. For example, if you wish to access the file "/hypertext/WWW/TheProject.html" at info.cern.ch, you could enter the URL "http://info.cern.ch/hypertext/WWW/TheProject.html" and click on the OK button. The following URL protocols are supported by the Viola WWW Browser: file, http, gopher, wais, and ftp.

Cancel

If, after bringing up the "Open" dialog, you decide not to open any file, you may close the dialog by clicking on the "Cancel" button. This will get rid of the dialog without taking any action.

Open URL

[Access a World Wide Web http file or other network service.]

(Keyboard: Ctrl-U)

This dialog presents a simple way of opening a file or WWW URL without having to bother with the complex file selection dialog. Simply type in the URL you wish to open and click on the "OK" button. If you wish to replace the text that is already in the text field, simply click and drag the mouse over it (selecting the text) and then type in the new URL (whatever you type will replace the text that you selected).

Reload

[Reload the current document or URL.]

(Keyboard: Ctrl-R)

This command simply reloads the current document. If you display an html file, for example, make some changes in the document with a text editor, and want to see what the changes look like in the browser, you can use the "Reload" command to reread the file data without having to type in the URL again. As a convenient shortcut for the "Reload" command, you can click the left mouse button in the title area at the top of the browser window to reload the document as well (this is equivalent to selecting the "Reload" item from the "File" menu).

Save As

[Save the current document source to a local file.]

(Keyboard: Ctrl-S)

If you wish to save the source of the current document to a file on your local disk, you may do so by selecting the "Save As..." item in the "File" menu. Simply enter the full path name of the file you wish to save the document source to and click on the "OK" button. Note that if you are reading an HTML file, the document will be saved in HTML form on your disk. Once you have saved a file to disk, you can edit the file and load it into the Viola browser to display it.

Quit

[Exit the Viola WWW browser.]

(Keyboard: Ctrl-Q)

This item causes the application to exit. If you have changed data in an editor window, this data will be lost if you click on the "OK" button in the Quit dialog before saving the changes.


Navigation Menu

Home

[Go to WWW_HOME document.]

The document which the browser started with is your Home document. You can specify a URL for this document in your WWW_HOME environment variable or you can run the browser with a URL on the command line to set the Home Home document. Another to go to the Home document is to click on the icon in the upper left of the browser window.

Back Up

[Delete the current document from browser memory.]

(Keyboard: Ctrl-B)

If you traverse to a document that you no longer wish to read and you don't want to keep it in the history list, you can use the Back Up command. This function removes the current document from browser memory and from the history list and then redisplays the previous document in history.

Previous

[Back up one document in the history list.]

(Keyboard: Ctrl-P)

This command moves you to the previous document in the history list without removing the current one.

Next

[Go forward one document in the history list.]

(Keyboard: Ctrl-N)

If you have backed up to a previous document in the history list, the Next command will traverse one document forward in history.

History List

[Show the list of previously visited documents by their URL's.]

(Keyboard: Ctrl-H)

The History Manager window displays a list of documents which you have previously visited. Click on an item in the scrolling list to reload that document. To remove a document from the list, click on that document and then select the Back Up command from the Navigation menu or from the button bar at the bottom of the viewer window. Click on the Hide button in the History Manager if you do not wish to continue using it (you can bring it back by simply selecting the History List item from the Navigation menu again).


Help Menu

On This Browser

This command loads this document.

On Viola

The 'About this ViolaWWW browser' page...

On World Wide Web

The World Wide Web document, which resides at CERN in Switzerland, is the birth place of the World Wide Web project. There you can find much of the project W3 information.

On Available Services

This is the CERN's top level document which contains links to many useful WWW sites all over the network.


Main Window

Icon

The icon is located in the upper left corner of the browser window. To reload the home document, click on the icon with the left mouse button.

Title

The document title and URL are in the upper right corner of the browser window (to the right of the icon). If the document doesn't have an official title, then the title region only displays the document URL. If you wish to easily copy the current document URL to another window, you can select the URL for pasting by clicking the right mouse button in the title region. When the URL is ready for pasting, the title will be highlighted with a rectangle. To deselect the URL, click in the title region a second time. To paste the URL in a separate xterm while it is selected in the browser, simply click the middle mouse button in the xterm window.

ScrollBar

Clicking on the arrow buttons in the scrollbar will scroll the document by small increments. Clicking in the trough above and below the scrollbar thumb control will scroll the document in large increments. To quickly scroll the document to an arbitrary location, you can click and drag the scrollbar thumb control.

HyperLinks

Hyperlinks in HTML documents are displayed as underlined words and phrases. Icons and images that represent hyperlinks will be outlined with an extra border. To travers to the document that a hyperlink references, simply click on the underlined words or image with any mouse button.

Search Box

Some documents may be searched for keywords and some network services may be issued commands by using the search near the bottom of the browser interface window. Many documents do not support searching; In this case, the search box will be grayed out and will not take keyboard input. However, when a document is noted as being searchable, the search box will become an active. To search for a keyword in a searchable document, simply type in the keyword you want to lookfor and type the key. Other network services may be issued commands through this control as instructed by the site in question.

Dynamic Help

Just below the search box at the bottom of the browser window is a rectangle window that displays simple help messages relevant to the component of the browser interface that the mouse cursor is currently pointed at. If you are curious about a particular control in the browser interface, simply point the mouse at it and read the help message in this window for a short explanation of that component's function.


Button Bar

Back Up

[Delete the current document from browser memory.]

(Keyboard: Ctrl-B)

If you traverse to a document that you no longer wish to read and you don't want to keep it in the history list, you can use the Back Up command. This function removes the current document from browser memory and from the history list and then redisplays the previous document in history.

Previous

[Back up one document in the history list.]

(Keyboard: Ctrl-P)

This command moves you to the previous document in the history list without removing the current one.

Next

[Go forward one document in the history list.]

(Keyboard: Ctrl-N)

If you have backed up to a previous document in the history list, the Next command will traverse one document forward in history.

Show Source

[Display the source of the current document for editing.]

This command pops up an editor window with the source of the current document in an editable text region. The text may be edited and saved to a local file. For more information, see the "Source Editor" section below.

Clone Page

[Make another document viewer window with the current document.]

When traversing a complex tree of documents, it is not uncommon to come across a document that is intended to be used as a major source of links to many other documents and services. Traversing one of these links, unfortunately, replaces this document with the target of the link you clicked on. It is often convenient in this case to make a copy of the view of such a file so that you can browse all of it's links without having to flip back and forth between the targets of the links and the top level document itself. This is what the "Clone Page" button does.

The cloned view created is called a "Navigational Viewer". When you click on links in this window, the PARENT window will display the target of the link, saving the cloned view for further browsing. For further information, see the section below labeled "Navigational Clone".


Source Editor

Editing text.

The source editor functions with the standard Motif text interface. Click the mouse to set the insertion point and enter text. Click and drag to select text for pasting elsewhere. You can paste text into the editor by selecting and then clicking the middle mouse button at the location where you wish the selected text to go. Typing when text is selected will replace the text with what you type.

Title

The editor title functions like the main browser title region; You may select the document URL for pasting in another window by clicking the right mouse button. When the URL is selected, the title is highlighted by a border rectangle. When the URL is selected, you can paste it in other applications or other text windows (usually by clicking the middle mouse button in the window in question). When the URL is selected, clicking on the title again will deselect it.

Upload

This feature is not yet implemented.

Save

At first, this button is grayed out to indicate that there are no changes to save. However, if you have made changes to the document, this button will become active.

This function is dependent on the URL of the document you are editing. If the current document source came from a WWW server (URL starts with "http:"), then it does not make sense to save the file (Web servers do not support the uploading of files from WWW browsers). However, if the current URL is a local file (URL starts with "file:"), then the editor will attempt to save your changes to this file. If you do not have write permission on the file, you will not be permitted to overwrite it with your changes.

Save As...

The Save As function will save the current contents of the source editor to a file. A dialog will pop up prompting you for the full path name of the file you wish to save to. If you do not have write permission to the file or directory you select, you will not be permitted to save the source text to that file.

Close

This shuts down the source editor. If there are changes that have not been saved to disk, you will be asked if you wish to save the changes before exiting the editor.


Navigational Clone

Navigation

The Navigational Document viewer displays a copy of the document in the main browser window. Unlike the main browser, however, clicking on the links in this window does not replace the document with the target of the link in question. Instead, the main browser window will display the target of the link you clicked on. This enables you to save a view of a major document which has several links you wish to examine without losing track of the document itself.

Close

This button quits the navigational viewer (but leaves all other Viola windows active).

Title

The navigational viewer title functions like the main browser title region; You may select the document URL for pasting in another window by clicking the right mouse button. When the URL is selected, the title is highlighted by a border rectangle. When the URL is selected, you can paste it in other applications or other text windows (usually by clicking the middle mouse button in the window in question). When the URL is selected, clicking on the title again will deselect it.