Introduction:
-------------

atlantis is a lightweight web browser based on gtkhtml2 and gnome-vfs. it was
started as education to learn more about the new gnome 2.x api and to get
myself back into programming. in the past months i got a lot of positive
feedback about atlantis and the pressure to release new versions came with it.
i never thought that something which was started as an education got so much
positive feedback. this leads to one conclusion: there are many people outside
that would like a light, easy and fast web browser to read their news, scan for
new files on various places and do some basic stuff with it. a web browswer
that fully integrates into the desktop and that don't depend on another browser
or parts of that browser (e.g. mozilla with nearly 30mb of code). why the need
of 30mb of another browsers core and again another 5mb of something else and
suggest the users that they use something light, when simple browsing can be
done with less than 50kb of code ?



Important:
----------

there is a serious bug inside gtkhtml2 till version 2.3.1 which causes the
engine to crash permanently. you only need to click a handful of links and it
crashes. it took me some time to figure out that this was a memory corruption
bug inside the gtkhtml2 engine so please make sure before using atlantis that
you use at least gtkhtml2 version 2.3.2 or grab the latest version from cvs
which already solves the problem. please don't mess with gtkhtml 3.0 or
something in the wrong assumption that 3.0 is newer. gtkhtml3 is a complete
different (and less featurerich) library which only get used inside evolution.

furthermore you need a working gnome 2.x (or never) installed in your '/usr'
directory. the place where the majority of distributions install gnome.



Features:
---------

* supports DOM, CSS 1&2, HTML 4.x, accessibility, fully supports anti aliased
  fonts, native widgetset inside the rendering window, no lame XUL. this makes
  atlantis full themeable, it starts in less than 2 seconds and finally fully
  integrates into GNOME and supports it's MIME and configuration system.

* 'atlantis %s'. you can specify a url in the commandline and it loads up e.g.
  you can run it within xchat or any other application. place it as default web
  browser in the urlhandler section within gconf.

* you can use your native galeon 'bookmarks.xbel' or konqueror 'bookmarks.xml'
  file in atlantis. simply take your galeon or konqueror bookmarks file and put
  it into the atlantis datadir named 'bookmarks.xml'. you can also create an
  ~/.atlantis directory and put the bookmarks.xml file there.

* variable windowsize, history size and zoom size which can be altered in the
  gconf section. you only need to start up gconf-editor and look under
  '/apps/atlantis' and you can change the values.



Installation:
-------------

to use atlantis please untar the archive and move all the files to the right
locations. or simply do:

cd / && tar xfjv <path_to_tarball/atlantis-xxx.tar.bz2>

as root and it will unpack and put all the files in the right directories. make
sure that the permission and ownership of the files are correct. logout and
then login into your gnome desktop to see the atlantis icon in the menu. now
you need to open an terminal and enter the following lines as user:

	;--- cut here ---
	gconftool-2 --install-schema-file=atlantis.schemas
	gconftool-2 --shutdown
	;--- cut here ---

that's it. now you should be able to run atlantis without problems. you can
also verify that the schema files for gconf are installed properly when you run
gconf-editor and look under '/apps/atlantis' directory, see if there are values
inside.

atlantis requires gnome 2.x libraries and should work on i686 like systems
(e.g. intel or athlon).



Disclaimer:
-----------

be said that you deal with experimental stuff. i am in no way responsible for
damages, loss of data, other unconfortable things that this program may cause
for you. use the program at your own risk. i'm not responsible for the contents
of the linked webpages. you have been instructed. if you are unsure you can
contact me anytime.



Copyright:
----------

atlantis with all its released files are fully copyrighted by me, Ali Akcaagac.
It's not allowed to re-use any components or files inside other projects
without written permission.
