===========================================================================
    eXeLearning, the EXtremely Easy to use eLearning authoring tool
===========================================================================

eXeLearning is a GPL2+ free/libre tool for the educational community to create
and publish open educational resources. This authoring environment enables 
teachers and students to create and publish educational content without the
need to become proficient in HTML or XML markup. Content generated using
eXeLearning can be exported as web pages, as educational-standard packages
used by any Learning Management System, as epub3 files and on mobile devices.

===========================================================================

Current Version:
Copyright 2008-2015 eXeLearning.net project contributors.  For details see
information contained within source files.

Previous Version:
 Copyright 2004-2005, University of Auckland
 Copyright 2004-2008 eXe Project, http://exelearning.org/

All rights reserved and license, see COPYING for details.

This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
===========================================================================

SUPPORT
=======
If you have any problems or have any feedback please report them at
http://exelearning.net/forums/?lang=en if you are a user, or
http://forja.cenatic.es/tracker/?atid=1107&group_id=197&func=browse
if you are a developer. Suggestions and patches are welcome.


SOURCE
======
The source is available at our git repository
http://forja.cenatic.es/scm/?group_id=197

It includes tools and instructions to build packages for the most
common operating systems.

BUILDING FROM SOURCE
-------------------
Please see the wiki page for building from source for any given os:
 
https://forja.cenatic.es/plugins/mediawiki/wiki/iteexe/index.php/
  
Each operating system supported by exe has a folder in the installs 
directory that generates an os specific installer.


WINDOWS
=======
If you download the sources, installs/windows/README
will five you the information you need to buid an executive package.
Or you can download the package from http://forja.cenatic.es/frs/?group_id=197

INSTALLATION
------------
- Download eXe-install-X.YY.exe, double click it to launch the installer,
  and then follow the instructions. 
- You will be asked what directory to install eXe in.  The default will
  normally be fine.  (You should always use the same directory when
  installing a new version of eXe.)
- The installer will create an eXe icon on the desktop and a menu-item under
  "All Programs".

RUNNING
-------
Double click on the shortcut on the desktop to launch eXe.

To close eXe you must use the File... Quit menu item.  Do not simply try
to close the eXe display window with the window close button.  Remember to
save your content before exiting.


MAC OSX
=======
If you download the sources, installs/osx/README
will five you the information you need to buid an executive package.
Or you can download the package from http://forja.cenatic.es/frs/?group_id=197

To install eXe, simply open the .dmg and drag the app to your 
Applications folder.


FEDORA LINUX 
=============
The eXe Fedora Linux install consists of a single RPM. 

There are HowTos on http://exelearning.net/ explaining how you can use
these RPMs on some other RPM-based Linux distributions.

From the command line type exe to start.  If you are using a standard
window manager, you should find an eXe entry in your Accessories menu.


DEBIAN/UBUNTU LINUX 
===================
If you download the sources, installs/debian/ubuntu/README
will five you the information you need to buid an executive package.
Or you can download the package from http://forja.cenatic.es/frs/?group_id=197

Install the .deb the file and you will find eXe in your program menu.
From the command line type exe to start.

An Ubuntu PPA is available at:
https://launchpad.net/~exelearning/+archive/exelearning

Note for users of localepurge
-----------------------------
Since version 2.1 we use the FHS directories for the locales. Therefore, 
localepurge will delete all the locales you don't save explicitly.
If you use localepurge, please pay attention to the languages you are
interested in keeping.


KNOWN BUGS
==========
See https://forja.cenatic.es/tracker/?atid=883&group_id=197&func=browse 
for the eXe issue list.


CREDITS
=======

Please see the Copyright file.