Annotated NCFresco browser configuration
----------------------------------------

The information below describes how an NCFresco configuration file is
constructed on a per-user basis. The file lives in ~<user>/Choices/NCFresco
, and for global configuration options to take effect (eg proxying), must be
stored in each user's home hierarchy.

Cheers,

Dave

[snip]

# Maximum number of image files in transit at one time
#  The browser will fetch this number of images per HTML file simultaneously.
#  In fact the number of simultaneous connections is limited by the HTTP module
#  This value controls hjow many the browser thinks it is fetching.
image.max: 64

# Do we want deep colour for images?
#  Yes: Use 32k colours for JPEGs and full-palettes for GIFs
#  No:  Dither to standard 256 palette for JPEGs and GIFs
#  This is ignored if in 256 colours or less (treated as No)
image.deep: Yes

# Don't load images until the user asks
#  Deferred images can be loaded with ALT-SELECT
image.defer: No

# Underline links?
display.links.underlined: Yes

# Use colour and background directives in BODY tags
#  Yes: BACKGROUND, BGCOLOR, TEXT, LINK, VLINK, ALINK recognised
#       FONT COLOUR, TABLE BGCOLOR recognised
#  No:  All the above are ignored
display.body_colours: Yes

# Antialias the displayed text
display.antialias: Yes

# Display button bar
#  ignored
display.control.buttons: Yes

# Display URL line
#  ignored
display.control.urlline: Yes

# Display status line
#  ignored
display.control.status: Yes

# Initial scaling factor (%)
#  The fonts only are scaled by this amount
display.scale: 100

# Scaling factor for images (%)
#  The images only are scaled by this amount (not currently supported)
display.scale.image: 100

# Default page width in characters
#  ignored
display.width: 71

# Blend fonts to background
#  Use the new FontManager feature if available
display.blending: Yes

# The safe area margins for a TV

# Margin left (%)
display.margin.left: 0
# Margin right (%)
display.margin.right: 0
# Margin top (%)
display.margin.top: 0
# Margin bottom (%)
display.margin.bottom: 0

# Use ROM values
#  Yes: use the values returned by ths OS
#  No:  use the values above
display.margin.auto: Yes

# Display frames
display.frames: Yes

# Use smooth scrolling
#  Try to scroll the page smoothly in increments of the given number 
#  of pixels (not currently supported)
#  0 means no smooth scrolling
display.smooth_scrolling: 0

# Time to activate links for
#  maximum time in centiseconds to activate a link for if the 
#  mouse button is held down after which the page is dragged
display.time.activate: 50
 
# Default document
#  Page to jump to when Home is selected
document.default: <NCFresco$Home>

# Search page
#  Page to jump to when Search is selected
document.search: <NCFresco$Home>

# Default document
#  Page to jump to when Home is selected
document.default: <NCFresco$Home>

# Hotlist file
files.hots: <NCFresco$Hotlist>

# File to store passwords in
files.passwords: <NCFresco$Users>

# Store passwords scrambled
#  encryption is just BASE64 encoding
files.passwords.encrypted: No

# This file lists the file types of files that will be run when fetched.
#  File is a list of filetypes, one per line (not currently used)
files.runable: <NCFresco$Runables>

# If given, only allow access to sites listed in this file.
#  File is a list of domains, one per line
files.allow: 

# If given, don't allow access to sites listed in this file.
#  File is a list of domains, one per line
files.deny: 

# URL of help pages
files.Help: <NCFresco$Help>

# Where to store the users cookies
files.cookie: <NCFresco$Cookies>
 
# Number of chars to truncate file names to
#  ignored
truncate.length: 0

# Do we remove the file extension when we choose a file name?
#  ignored
truncate.suffix: No
 
# User's email address
#  ignored
user.email: 

# Prefix string for animation sprite names
#  !Run file overrides if in NTSC/PAL mode, 
#  sprites are in application or wimp sprite area
animation.name: nc_vlogo

# Number of frames in the progress animation
animation.frames: 10
 
# Point sizes for fonts
#  H1 = font.size.7
#  H6 = font.size.2
font.size.1: 8
font.size.2: 10
font.size.3: 12
font.size.4: 14
font.size.5: 16
font.size.6: 18
font.size.7: 24

# Name of standard font
font.base: Homerton.Medium
# ... the bold form
font.base.b: Homerton.Bold
# ... the italic form
font.base.i: Homerton.Medium.Oblique
# ... bold and italic
font.base.bi: Homerton.Bold.Oblique
# Name of fixed space font
font.fixed: Corpus.Medium
# ... the bold form
font.fixed.b: Corpus.Bold
# ... the italic form
font.fixed.i: Corpus.Medium.Oblique
# ... bold and italic
font.fixed.bi: Corpus.Bold.Oblique

# Colours are specified R,G,B
 
# Colour for normal text
colour.plain: 0x00, 0x00, 0x00
# Colour for text in hypertext links
colour.anchor: 0x00, 0x22, 0xdd
# Colour for text in links that have been visited
colour.visited: 0xcc, 0x00, 0x99
# Background colour
colour.back: 0xc0, 0xc0, 0xc0
# Colour for for action buttons
colour.action: 0x88, 0x88, 0x88
# Colour for writable areas
colour.write: 0xff, 0xff, 0xff
# Colour for the light side of rules
colour.line.light: 0xdd, 0xdd, 0xdd
# Colour for the dark side of rules
colour.line.dark: 0x55, 0x55, 0x55
# Colour for text on buttons
colour.button.text: 0x00, 0x00, 0x00
# Background colour for buttons
colour.button.back: 0xdd, 0xdd, 0xdd
# Colour for highlighted link
colour.highlight: 0xaa, 0x44, 0x22
 
# Enable proxies
#  These should be Yes or No to as appropriate
proxy.http.enable: No
proxy.gopher.enable: No
proxy.ftp.enable: No

# Proxy server name (and port)
#  name can be actual name or ip address
#  eg proxy.http: 136.170.135.27:3128 to proxy off bungle for HTTP only
proxy.http: 
proxy.gopher: 
proxy.ftp: 

# No proxy on these domains
#  space or comma separated list of domains not to proxy on
#  eg proxy.http.ignore: acorn.co.uk, 
proxy.http.ignore: 
proxy.gopher.ignore: 
proxy.ftp.ignore: 

# Size in K for cache (0 = unlimited)
#  The cache is trimmed to this value after each download
#  Use 1 for no caching
cache.size: 0

# Max number of items in the cache
#  This is the maximum that can be held currently
cache.items: 5625

# Should the cache be kept across closedowns?
#   /cachedump files are created and reloaded on startup
cache.keep: Yes

# Save the cachedump on every update
#  Update the /cachedump files every time the cache changes
#  This protects against power offs without shutting down
#  !Run file overrides this if cache is not in CacheFS
cache.keep.uptodate: No

# Printing magnification in %
#  This is based on default values, display scales are ignored
print.scale: 100

# Border, in points, around the printed page
#  On top of the printer driver border
print.border: 18

# Supress pictures in printout
#  Yes: don't display any images in the print out
print.nopics: No

# Supress backgrounds in printout
#  Yes: don't print background tiles or colours and don't use
#       colours specified in BODY tag either.
print.noback: Yes

# Supress text colours in printout
#  Yes: don't use the default colours for links/visited. 
#       Print everything in black.
print.nocols: No

# Print pages sideways
#  Yes: Landscape
#  No:  Portrait
print.sideways: No

# Collate multiple copies
print.collated: No

# Print pages in reverse order
print.reversed: No

# Command to run when selecting
#  a *command that will be run (with OS_CLI) whenever a link is clicked on
sound.click: 

# Are we mouseless
#  ignored on NCFresco
mode.keyboard: Yes

# Platform type
#  0: RISC OS desktop (allow Ctrl-F2 to quit)
#  1: NC OS
#  2: STB (allow Home-Home to quit)
mode.platform: 1

# The number of pages in the per-view history list
#  ignored
history.length: 50

# The number of unique pages in the global history list
#  ignored
history.global.length: 250

# Set this to use Netscape POST redirections
broken.formpost: Yes

# Shall we receive and send cookies
#  No: all cookies are ignored
cookie.enable: Yes

# Save cookies on every update
#  Yes: update the cookie file whenever a cookie is added or deleted
cookie.uptodate: Yes

# Save passwords on every update
#  Yes: update the passwords file whenever a new password is entered successfully
passwords.uptodate: Yes

# Configure file for plugins
#  Where to store the plugin configure information
plugin.file: <NCFresco$Plugins>

# Keep plugin file up to date
#  Yes: save the plugin file when user changes any config entry
plugin.uptodate: Yes

# Alter UserAgent header
#  Yes: send Mozilla style UserAgent string
#  No:  sned normal UserAgent string
#  The actual string templates are defined in the Messages file
netscape.fake: Yes