<?xml version="1.0" encoding="ISO-8859-1"?>
<appendix id="sample-configuration"><title>Sample configuration File</title>
<para>

	Provided here is a sample &elinks.conf; file with some the default settings.

</para>
<example><title>Sample &elinks.conf; file</title>
<programlisting>
## if you wish so, but keep in mind that this file is overwritten
## by ELinks when you save options through UI and you are out of
## luck with your formatting and own comments then, so beware.
##
## Obviously, if you don't like what ELinks is going to do with
## this file, you can change it by altering the config.saving_style
## option. Come on, aren't we friendly guys after all?

## cookies.accept_policy &lt;num&gt;
# Cookies accepting policy:
# 0 is accept no cookies
# 1 is ask for confirmation before accepting cookie (UNIMPLEMENTED)
# 2 is accept all cookies
set cookies.accept_policy = 2

## document.browse.forms.confirm_submit [0|1]
# Ask for confirmation when submitting a form.
set document.browse.forms.confirm_submit = 1

## document.browse.images.show_as_links [0|1]
# Display links to images.
set document.browse.images.show_as_links = 0

## document.browse.links.color_dirs [0|1]
# Highlight links to directories in FTP and local directory listing.
set document.browse.links.color_dirs = 1

## document.browse.links.numbering [0|1]
# Display numbers next to the links.
set document.browse.links.numbering = 0

## document.browse.margin_width &lt;num&gt;
# Horizontal text margin.
set document.browse.margin_width = 3

## document.browse.scroll_margin &lt;num&gt;
# Size of the virtual margin - when you click inside of that margin,
# document scrolls in that direction.
set document.browse.scroll_margin = 3

## document.browse.table_move_order [0|1]
# Move by columns in table, instead of rows.
set document.browse.table_move_order = 0

## document.cache.ignore_cache_control [0|1]
# Ignore Cache-Control and Pragma server headers.
# When set, the document is cached even with 'Cache-Control: no-cache'.
set document.cache.ignore_cache_control = 1

## document.cache.memory.size &lt;num&gt;
# Memory cache size (in kilobytes).
set document.cache.memory.size = 1M

## document.codepage.assume &lt;codepage&gt;
# Default document codepage.
set document.codepage.assume = "ISO-8859-1"

## document.download.default_mime_type &lt;str&gt;
# Document MIME-type to assume by default (when we are unable to
# guess it properly from known information about the document).
set document.download.default_mime_type = "application/octet-stream"

## document.download.directory &lt;str&gt;
# Default download directory.
set document.download.directory = "./"

## document.download.overwrite &lt;num&gt;
# Prevent overwriting the local files:
# 0 is files will silently be overwritten.
# 1 is add a suffix .{number} (for example '.1') to the name.
set document.download.overwrite = 0

## document.dump.codepage &lt;codepage&gt;
# Codepage used in dump output.
set document.dump.codepage = "us-ascii"

## document.dump.width &lt;num&gt;
# Width of screen in characters when dumping a HTML document.
set document.dump.width = 80

## document.history.global.enable [0|1]
# Enable global history ("history of all pages visited").
set document.history.global.enable = 1

## document.history.global.max_items &lt;num&gt;
# Maximum number of entries in the global history.
set document.history.global.max_items = 1k

## document.history.global.display_type &lt;num&gt;
# What to display in global history dialog:
# 0 is URLs
# 1 is page titles
set document.history.global.display_type = 0

## document.history.keep_unhistory [0|1]
# Keep unhistory ("forward history")?
set document.history.keep_unhistory = 1

## document.html.display_frames [0|1]
# Display frames.
set document.html.display_frames = 1

## document.html.display_tables [0|1]
# Display tables.
set document.html.display_tables = 1

## document.html.display_subs [0|1]
# Display subscripts (as [thing]).
set document.html.display_subs = 1

## document.html.display_sups [0|1]
# Display superscripts (as ^thing).
set document.html.display_sups = 1

## protocol.http.referer.policy &lt;num&gt;
# Mode of sending HTTP referer:
# 0 is send no referer
# 1 is send current URL as referer
# 2 is send fixed fake referer
# 3 is send previous URL as referer (correct, but insecure)
# 
set protocol.http.referer.policy = 3

## protocol.http.accept_ui_language [0|1]
# Request localised versions of documents from web-servers (using the
# Accept-Language header) using the language you have configured for
# ELinks' user-interface. Note that some see this as a potential security
# risk because it tells web-masters about your preference in language.
set protocol.http.accept_ui_language = 1

## protocol.user.mailto.unix &lt;str&gt;
set protocol.user.mailto.unix = "mutt %h -s \"%s\""
## protocol.user.mailto.unix-xwin &lt;str&gt;
set protocol.user.mailto.unix-xwin = "mutt %h -s \"%s\""

## protocol.user.news.unix &lt;str&gt;
set protocol.user.news.unix = "slrn %u"
## protocol.user.news.unix-xwin &lt;str&gt;
set protocol.user.news.unix-xwin = "slrn %u"

## secure_file_saving [0|1]
# First write data to 'file.tmp', then rename to 'file' upon
# successfully finishing this. Note that this relates only to
# config files, not downloaded files. You may want to disable
# it, if you want some config file with some exotic permissions.
# Secure file saving is automagically disabled if file is symlink.
set secure_file_saving = 1
</programlisting>
</example>

</appendix>
