summaryrefslogtreecommitdiff
path: root/!NetSurf/Docs/en/user,faf
blob: fa5fd84e3486b27ebca05cf4f08fa4ad6a9853a9 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN"
        "http://www.w3.org/TR/html4/strict.dtd">
<html>
<head>
<title>NetSurf: The open-source web browser for RISC OS</title>
<link rel="stylesheet" type="text/css" href="netsurf">
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
</head>
<body>
<p class="logosmall"><a href="index"><img src="images/logosmall" alt="NetSurf"></a></p>
<h1>User Guide</h1>
<h2><a name="using">Using NetSurf</a></h2>
<p>To run <em>NetSurf</em>, simply double click on the NetSurf application.  This will cause the NetSurf icon to appear on the iconbar.  Select clicking on this icon will open a browser window.  It should be noted that as NetSurf is at a very early stage of development, much of the following information is subject to change without warning.</p>
<p class="screenshot"><img src="images/bwin" alt="Browser Window" height="273" width="359"></p>
<h3><a name="toolbar">The Toolbar</a></h3>
<p>The section at the top of the window is called the toolbar.  It allows quick access to various functions and information.  The standard, or <em>Default</em>, toolbar is shown below.</p>
<p class="screenshot"><img src="images/toolb" alt="Toolbar" height="70" width="483"></p>
<p>There are several different variations on this toolbar available, eg this minimal one:</p>
<p class="screenshot"><img src="images/mini" alt="Mini Toolbar" height="60" width="483"></p>
<p>In addition to this, NetSurf supports themes, which allow users to customize the look and feel of the program.</p>
<h3>Toolbar Icons</h3>
<p>Again, it should be noted that, as NetSurf is in development, many of the icons don't do anything yet.  In such situations, the following text describes what the icon will do, when the associated feature has been implemented.</p>
<p><strong>URL Bar:</strong> The white writable icon on the toolbar is called the URL Bar and it shows the location of the current page.  Here, you can enter the address of the page you want to view next.</p>
<p><strong>Status Line:</strong> This text displays information to the user.  When you move the pointer over a link, this will show the URL that the link points to.  The status line also displays information about NetSurf's progress while retrieving a page.</p>
<p><strong>Throbber:</strong> This NetSurf logo animates while a page is downloading or rendering.  It indicates that NetSurf is doing something.</p>
<table border="0" cellpadding="4" cellspacing="0">
<tr><td class="icon"><img src="images/back" alt="Back Button" height="34" width="34"></td><td><p><strong>Back:</strong> Clicking on this button makes NetSurf go back to the previous page in the history list.  If you followed a link from one page to another, this button allows you to get back to the first page.  Select click to view the previous page in the current window.  Adjust click to view it in a new window.</p></td></tr>
<tr><td class="icon"><img src="images/mark" alt="Bookmark Button" height="34" width="34"></td><td><p><strong>Bookmark:</strong> Select clicking on this button adds the current location to the bookmarks or favourites.  Adjust clicking opens the bookmarks window.</p></td></tr>
<tr><td class="icon"><img src="images/forward" alt="Forward Button" height="34" width="34"></td><td><p><strong>Forward:</strong> Clicking on this button allows you to advance through the history list.  Select click to view the next page in the current window.  Adjust click to view it in a new window.</p></td></tr>
<tr><td class="icon"><img src="images/history" alt="History Button" height="34" width="34"></td><td><p><strong>History:</strong> Clicking on this button opens a window containing a history tree.  Clicking on an item in this window will move to the relevant page in the history.</p></td></tr>
<tr><td class="icon"><img src="images/home" alt="Home Button" height="34" width="34"></td><td><p><strong>Home:</strong> Clicking on this button returns to the configured home page.</p></td></tr>
<tr><td class="icon"><img src="images/print" alt="Print Button" height="34" width="34"></td><td><p><strong>Print:</strong> Clicking on this button will print the current page.</p></td></tr>
<tr><td class="icon"><img src="images/reload" alt="Reload Button" height="34" width="34"></td><td><p><strong>Reload:</strong> Clicking on this button will make NetSurf fetch and redraw the current page again.</p></td></tr>
<tr><td class="icon"><img src="images/save" alt="Save Button" height="34" width="34"></td><td><p><strong>Save:</strong> Clicking on this button will open a save dialogue box, to allow you to save the page for future reference.</p></td></tr>
<tr><td class="icon"><img src="images/stop" alt="Stop Button" height="34" width="34"></td><td><p><strong>Stop:</strong> Clicking on this button stops whatever process that window is doing.</p></td></tr>
</table>
<p>Buttons that are grayed out indicate that their function is unavailable.  This happens when you open a new browser window.  Since the window will be displaying its first page, there would be no previous page and the back button is grayed out.  Also, as this is the first page, the forward button is also grayed out.</p>
<h2><a name="menus">Menus</a></h2>
<p>NetSurf has two different menus, one is accessed by clicking menu over NetSurf's iconbar icon and the other is opened by clicking menu over a browser window.</p>
<h3>Iconbar Menu</h3>
<p>The iconbar menu is home to three options.  These are Info, Configure and Quit.  Info provides a little information about the application, while quit will exit the program, closing all browser windows.  The configure option opens a window for configuring NetSurf.  This is discussed in greater detail in the <a href="#conf">Configuring NetSurf</a> section.</p>
<p class="screenshot"><img src="images/imenu" alt="Iconbar Menu" height="91" width="103"></p>
<h3>Browser Window Menu</h3>
<p>The browser window menu contains options relating to the content of that window.  Many of these options are unavailable at present as this area of NetSurf is not complete.  The following options are currently available:</p>
<p class="screenshot"><img src="images/bmenu" alt="Browser Menu" height="91" width="98"></p>
<!-- <p>The selection sub menu relates to selected text in the browser window.</p>
<p><strong>Selection > Clear</strong> This deselects any highlighted text in the browser window.</p> -->
<p>The navigate sub menu contains options useful for navigating the web.</p>
<p class="screenshot"><img src="images/bnmenu" alt="Navigate Submenu" height="135" width="153"></p>
<p><strong>Navigate > Home</strong> This take you back to the NetSurf homepage.</p>
<p><strong>Navigate > Back</strong> This has the same function as the back button on the <a href="#toolbar">toolbar</a>.</p>
<p><strong>Navigate > Forward</strong> This has the same function as the forward button on the <a href="#toolbar">toolbar</a>.</p>
<h2><a name="keys">Keyboard Shortcuts</a></h2>
<p>NetSurf supports keyboard shortcuts, which allow quick access to features and make NetSurf easier to use.  The supported keypresses and corresponding functions are listed below.</p>
<table border="0" cellpadding="2" cellspacing="0">
<tr><th><p>Shortcut</p></th><th><p>Function</p></th></tr>
<tr><td><p>Page Down</p></td><td><p>Scroll down by one page</p></td></tr>
<tr><td><p>Page Up</p></td><td><p>Scroll up by one page</p></td></tr>
<tr><td><p>Cursor Down</p></td><td><p>Scroll down one line</p></td></tr>
<tr><td><p>Cursor Up</p></td><td><p>Scroll up one line</p></td></tr>
<tr><td><p>Ctrl+Cursor Down</p></td><td><p>Go to bottom of page</p></td></tr>
<tr><td><p>Ctrl+Cursor Up</p></td><td><p>Go to top of page</p></td></tr>
<tr><td><p>F8</p></td><td><p>View webpage source</p></td></tr>
<tr><td><p>F11</p></td><td><p>View box outlines.  This may be useful if you are creating your own webpage.  Cyan marks the content's edge, magenta marks the padding's edge and yellow marks the margin's edge.</p></td></tr>
<tr><td><p>Ctrl+F2</p></td><td><p>Closes the window</p></td></tr>
<tr><td><p>Ctrl+Shift+F3</p></td><td><p>Save the page as a Drawfile to <em>!NetSurf.draw</em></p></td></tr></table>
<h2><a name="urls">URL Shortcuts</a></h2>
<p>NetSurf also supports URL shortcuts, which allow quick access to various pages.  The supported URL shortcuts are listed below.  Type them into a NetSurf URL bar to see the corresponding page.</p>
<table border="0" cellpadding="2" cellspacing="0">
<tr><th><p>Shortcut</p></th><th><p>Page</p></th></tr>
<tr><td><p>about:</p></td><td><p>The NetSurf About page</p></td></tr>
<tr><td><p>about:cookies</p></td><td><p>List of cookies stored by NetSurf</p></td></tr>
<tr><td><p>help:</p></td><td><p>NetSurf documentation</p></td></tr>
<tr><td><p>home:</p></td><td><p>NetSurf home page</p></td></tr></table>
<h2><a name="conf">Configuring NetSurf</a></h2>
<p>You can change the way NetSurf looks and behaves, by configuring the program.  The configuration panel is opened by clicking menu over the iconbar icon and selecting Choices.</p>
<p class="screenshot"><img src="images/conpan" alt="Configuration Panel" height="135" width="228"><br>Note: Screenshot taken on RISC OS Select 3</p>
<p>The Cancel button will close the window, discarding any changes you've made.  Clicking on OK will save the new settings and close the window.  Clicking on one of the other icons will allow you to configure that aspect of NetSurf.</p>
<h3>Browser</h3>
<p>The browser configuration window contains some general configuration options that apply to the main browser window.  Many of these options are unavailable at the moment as NetSurf is still in development.</p>
<h3>Proxy</h3>
<p>The proxy configuration window allows you to enable and set an HTTP proxy.  You can enter the  address and port number of the proxy you want to use.</p>
<p class="screenshot"><img src="images/proxy" alt="Proxy Setup Window" height="134" width="366"><br>Note: Screenshot taken on RISC OS Select 3</p>
<h3>Theme</h3>
<p>NetSurf allows you to change the 'look and feel' of its interface.  New themes can be downloaded from the <a href="http://netsurf.sourceforge.net/themes/">NetSurf themes page</a> and you can select your desired theme from this window.</p>
<p class="screenshot"><img src="images/conthem" alt="Theme Selection Window" height="262" width="347"><br>Note: Screenshot taken on RISC OS Select 3</p>
<p class="footer">NetSurf is copyright 2003 - 2004 The NetSurf Developers<br>This page was written by Michael Drake</p>
</body></html>