mirrors/netsurf
1
0
Fork 0
mirror of https://github.com/netsurf-browser/netsurf synced 2024-11-24 23:39:51 +03:00
Code Issues Packages Projects Releases Wiki Activity

[project @ 2003-09-26 16:40:57 by tlsa]

Browse Source 
New Documentation

svn path=/import/netsurf/; revision=316
This commit is contained in:
Michael Drake 2003-09-26 16:40:57 +00:00
parent 9671fa03c4
commit 92f3368c87
15 changed files with 263 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

27
!NetSurf/Docs/en/dev,faf Normal file
View File

@ -0,0 +1,27 @@
<!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="http://netsurf.sourceforge.net/"><img src="images/logosmall" alt="NetSurf"></a></p>
<h1>Developer Information</h1>
<h2><a name="contri">Contribution to the project</a></h2>
<p>As <em>NetSurf</em> is an open source project, everyone is welcome to contribute. If you would like to add some functionality to NetSurf then you can <a href="info#devel">contact the other developers</a> via either the #netsurf-develop IRC channel or mailing list.</p>
<h2><a name="libs">Libraries used</a></h2>
<p>NetSurf makes use of the following libraries:</p>
<ul>
<li><a href="http://curl.haxx.se/libcurl/">libcurl</a>
<li><a href="http://netsurf.strcprstskrzkrk.co.uk/developer/">IFClib</a>
<li><a href="http://www.openssl.org/">OpenSSL</a>
<li><a href="http://ro-oslib.sourceforge.net/">OSLib</a>
<li><a href="http://www.libpng.org/pub/png/libpng.html">libpng</a>
<li><a href="http://www.xmlsoft.org/">libxml2</a>
</ul>
<h2><a name="further">Further information</a></h2>
<p>There is further developer information in the <a href="http://cvs.semichrome.net/netsurf/Docs/">Docs section</a> of the NetSurf <a href="http://cvs.semichrome.net/netsurf/">CVS repository</a>.</p>
<p class="footer">NetSurf is copyright 2003 The NetSurf Developers<br>This page was written by Michael Drake</p>
</body></html>

BIN
!NetSurf/Docs/en/images/bmenu,b60 Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 4.7 KiB

BIN
!NetSurf/Docs/en/images/bnmenu,b60 Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 10 KiB

BIN
!NetSurf/Docs/en/images/bwin,b60 Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 14 KiB

BIN
!NetSurf/Docs/en/images/conpan,b60 Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 11 KiB

BIN
!NetSurf/Docs/en/images/conthem,b60 Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 28 KiB

BIN
!NetSurf/Docs/en/images/imenu,b60 Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 4.6 KiB

BIN
!NetSurf/Docs/en/images/logofull,b60 Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 13 KiB

BIN
!NetSurf/Docs/en/images/logosmall,b60 Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 7.8 KiB

BIN
!NetSurf/Docs/en/images/proxy,b60 Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 6.4 KiB

BIN
!NetSurf/Docs/en/images/toolb,b60 Normal file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 8.3 KiB

64
!NetSurf/Docs/en/index,faf Normal file
View File

@ -0,0 +1,64 @@
<!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>
<h1 class="logofull"><a href="http://netsurf.sourceforge.net/"><img src="images/logofull" alt="NetSurf"></a></h1>
<h2>Introduction</h2>
<p><em>NetSurf</em> is an open-source web browser for RISC&nbsp;OS. Its aim is to bring the HTML 4 (HyperText Markup Language) and CSS (Cascading Style Sheet) technologies to the RISC&nbsp;OS platform. Currently, NetSurf supports only a fraction of these standards.</p>
<h2>Documentation</h2>
<p>The NetSurf documentation has been split into the following sections.</p>
<div class="center">
<table border="0" cellpadding="10" cellspacing="0">
<tr>
<th class="contents"><p><a href="info">User Information</a></p></th>
<td class="contents">
<ul><li><a href="info#downloading">Downloading NetSurf</a></li>
<li><a href="info#versions">Different versions</a></li>
<li><a href="info#requ">Requirements</a></li>
<li><a href="info#devel">Contacting the developers</a></li>
<li><a href="info#features">Current features &amp; limitations</a></li>
<li><a href="info#known">Known bugs</a></li>
</ul></td>
</tr>
<tr>
<th class="contents"><p><a href="user">User Guide</a></p></th>
<td class="contents">
<ul><li><a href="user#using">Using NetSurf</a></li>
<li><a href="user#toolbar">Toolbar description</a></li>
<li><a href="user#menus">Menus</a></li>
<li><a href="user#conf">Configuration</a></li>
</ul></td>
</tr>
<tr>
<th class="contents"><p><a href="dev">Developer Information</a></p></th>
<td class="contents">
<ul><li><a href="dev#contri">Contribution to the project</a></li>
<li><a href="dev#libs">Libraries used</a></li>
<li><a href="dev#further">Further information</a></li>
</ul></td>
</tr>
</table>
</div>
<h2>Developers</h2>
<p>NetSurf's main developers are:</p>
<ul>
<li>James Bursa</li>
<li>John Bell</li>
<li>Phil Mellor</li>
<li>Phil Pemberton</li>
<li>Rob Jackson</li>
</ul>
<h2>License</h2>
<p>NetSurf is released under the GPL license.</p>
<h2>NetSurf Links</h2>
<p><a href="http://netsurf.sourceforge.net/">Project homepage</a><br><a href="http://netsurf.strcprstskrzkrk.co.uk/">Recent builds</a><br><a href="http://cvs.semichrome.net/netsurf/">Web CVS interface</a></p>
<p class="footer">NetSurf is copyright 2003 The NetSurf Developers<br>This page was written by Michael Drake</p>
</body></html>

62
!NetSurf/Docs/en/info,faf Normal file
View File

@ -0,0 +1,62 @@
<!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="http://netsurf.sourceforge.net/"><img src="images/logosmall" alt="NetSurf"></a></p>
<h1>User Information</h1>
<h2><a name="downloading">Downloading NetSurf</a></h2>
<p><em>NetSurf</em> is currently in beta. The latest version of NetSurf can be obtained from <a href="http://netsurf.strcprstskrzkrk.co.uk/">netsurf.strcprstskrzkrk.co.uk</a>. As these builds are generated automatically from <a href="http://cvs.semichrome.net/netsurf/">CVS</a>, they are likely to be unstable and may crash your machine.</p>
<h3><a name="versions">Different Versions</a></h3>
<p>There are 32-bit and 26-bit NetSurf builds. The 26-bit versions are suitable for any processor up to StrongARM and the 32-bit versions will work on ARM6 and higher. Only the 32-bit versions will run on Castle's IYONIX pc.</p>
<p>The 32-bit builds of NetSurf include https support, although they require more memory.</p>
<h3><a name="requ">Requirements</a></h3>
<p>NetSurf requires the <a href="http://www.chocky.org/unix/usage.html">SharedUnixLibrary</a> to run. Also, you may need to download the <a href="http://sudden.recoil.org/others/">Acorn URI module</a>.</p>
<h2><a name="devel">Contacting the Developers</a></h2>
<p>If you want to contribute to the NetSurf project, please see the <a href="dev">Developer Information</a>. Before submitting a bug report, please check that you have the latest version and check to see if the bug has <a href="#known">already been discovered</a>. Bug reports and questions about NetSurf can be raised in the following forms.</p>
<h3>Mailing List</h3>
<p>The <a href="http://lists.sourceforge.net/lists/listinfo/netsurf-develop">netsurf-develop</a> mailing list is for discussion of NetSurf. If you are interested in NetSurf's development, please subscribe to this list.</p>
<h3>IRC Channel</h3>
<p>The #netsurf-develop IRC channel on the IRCNet network is also for discussion of NetSurf. Both the ircnet.demon.co.uk and ircnet.easynet.co.uk servers are suitable.</p>
<h3>Bug Tracker</h3>
<p>Please submit any bugs to the <a href="http://sourceforge.net/tracker/?group_id=51719&amp;atid=464312">bug tracker</a>.</p>
<h2><a name="features">Current Features &amp; Limitations</a></h2>
<p>The following features have been implemented:</p>
<ul>
<li>Basic HTML 4, including tables</li>
<li>Parts of CSS (display, text-align, float, width &amp; height)</li>
<li>Local and HTTP fetching</li>
<li>Memory cache</li>
<li>External CSS files</li>
<li><em>&lt;style&gt;</em> element</li>
<li>Encrypted HTTP or https (32-bit builds only)</li>
<li>Plugin System</li>
<li>Redirects</li>
<li>View Source</li>
<li>Support for Acorn URI Protocol and URI files</li>
<li>HTML forms, using GET method</li>
</ul>
<p>The following is in progress:</p>
<ul>
<li>GUI</li>
<li>PNG Support</li>
<li>JPEG Support</li>
<li>GIF Support</li>
<li>File downloads (eg. zip files)</li>
<li>HTML forms, using POST method</li>
<li>Improved Memory handling</li>
</ul>
<p>We want to release a stable and fairly complete HTML / CSS browser before considering JavaScript support. To see what remains to be done in more detail, please see the <a href="http://cvs.semichrome.net/netsurf/Docs/">TODO lists</a>.</p>
<h2><a name="known">Known Bugs</a></h2>
<ul>
<li>No way to re-download a webpage, if it has been updated, without quitting NetSurf.</li>
<li>PNGs with transparency don't display correctly unless you have Select.</li>
<li>NetSurf quits when it runs out of memory</li>
</ul>
<p class="footer"><em>NetSurf</em> is copyright 2003 The NetSurf Developers<br>This page was written by Michael Drake</p>
</body>
</html>

57
!NetSurf/Docs/en/netsurf,f79 Normal file
View File

@ -0,0 +1,57 @@
html, body {
margin: 0;
padding: 0;
}
h1.logofull {
padding: 0;
color: black;
text-align: left;
margin: 0 0 5mm 0;
background-color: #94adff;
border-bottom: medium solid black;
}
p.logosmall {
padding: 0;
color: black;
text-align: right;
margin: 0 0 5mm 0;
background-color: #94adff;
border-bottom: medium solid black;
}
h1 img { vertical-align: middle; }
p img { vertical-align: middle; }
h1, h2, h3 { font-family: sans-serif; }
h1, h2, h3, p, dl { margin: 5mm; }
h2, .thanks { padding-top: 5mm; border-top: thin solid black; }
.screenshot, .footer {
text-align: center;
font-size: x-small;
}
.contents {
text-align: left;
vertical-align: top;
}
.center { text-align: center; }
th { font-size: large; }
img { border: none; }
div.cell { display: table-cell; }
.links { display: table-cell;
border-left: thin solid black;
}
dd { margin-bottom: 0.5em; }
.thanks img { vertical-align: middle; }
a:link { color: #0000ff}
a:visited { color: #6678ff}
a:hover { color: #7070ff}
a:active {text-decoration: none; color: #7070ff}

53
!NetSurf/Docs/en/user,faf Normal file
View File

@ -0,0 +1,53 @@
<!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="http://netsurf.sourceforge.net/"><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="289" width="331"></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.</p>
<p class="screenshot"><img src="images/toolb" alt="Toolbar" height="236" width="592"></p>
<p><strong>Back:</strong> Clicking on this button, makes NetSurf go back the 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.</p>
<p><strong>Reload:</strong> Clicking on this button causes NetSurf to reload the current page.</p>
<p><strong>Forward:</strong> Clicking on this button allows you to advance through the history list.</p>
<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>
<p><strong>URL Bar:</strong> This shows the location of the current page. Here, you can enter the address of the page you want to view next.</p>
<p><strong>Throbber:</strong> This animates while a page is downloading or rendering. It indicates that NetSurf is doing something.</p>
<p><strong>Status Line:</strong> This 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>
<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="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 The NetSurf Developers<br>This page was written by Michael Drake</p>
</body></html>