CONFIGURING ELINKS
******************


Enabling Native Gopher Support
------------------------------

In the source code, edit the following file:
features.conf

Locate the line:
CONFIG_GOPHER=no

Replace no with yes, compile, and install.


Viewing Images
--------------

Download and install a suitable image viewing programme. I recommend
fbida as it can be used to display images in the console and X.

Fbida can be downloaded here:
http://linux.bytesex.org/fbida/

Edit:
~/.elinks/elinks.conf.

Add the desired MIME types:

set mime.extension.jpeg="image/jpeg"
set mime.extension.jpg="image/jpeg"
set mime.extension.png="image/png"
set mime.extension.gif="image/gif"
set mime.extension.bmp="image/bmp"

Add the following handlers:

set mime.handler.image_viewer.unix.ask = 1
set mime.handler.image_viewer.unix-xwin.ask = 0

set mime.handler.image_viewer.unix.block = 1
set mime.handler.image_viewer.unix-xwin.block = 0

set mime.handler.image_viewer.unix.program = "fbi %"
set mime.handler.image_viewer.unix-xwin.program = "ida %"

The unix entry defines elinks' behaviour in the console, while the
unix-xwin entry defines its behaviour under X. 1 = yes, 0 = no. In the
last two entries, elinks is being told to use fbi to display images in
the console, and ida in X.

Associate the image types with the image viewer:

set mime.type.image.jpeg = "image_viewer"
set mime.type.image.jpg = "image_viewer"
set mime.type.image.png = "image_viewer"
set mime.type.image.gif = "image_viewer"
set mime.type.image.bmp = "image_viewer"

Note: if you are running elinks under screen, you will not be able to
display images using fbi.


URI Passing
-----------

Edit:
~/.elinks/elinks.conf

Add (for Konqueror and Opera---other browsers follow the same pattern):

set document.uri_passing.konqueror = "konqueror %c 2>/dev/null"
set document.uri_passing.opera = "opera %c 2>/dev/null"

Next you will need to define the keybindings for at least one of the
three methods of passing the URI to an external programme which are as
follows:

* Pass URI of current frame to external command
* Pass URI of current link to external command
* Pass URI of current tab to external command

Add (replace F12 with desired key, or key combination):

bind "main" "F12" = "frame-external-command"
bind "main" "F12" = "link-external-command"
bind "main" "F12" = "tab-external-command"


Links
-----

http://elinks.or.cz/
http://www.xteddy.org/elinks/
http://www.calmar.ws/elinks/index.php