 Quanta Plus - a WEB Developement tool for the K Desktop Environment.

1. Introduction:
---------------- 
 It is more than a HTML editor, altough currently the majority of the users are
using Quanta+ to create web pages (HTML and PHP). Quanta+ supports a lot of
markup and script languages, and the number of supported languages can be easily
extended, even by the user.

 Currently this program can be very useful for quick web development, however it
is still in the early stages of the over all objectives.
 Our objective is to product a complete web development environment!
 
 Look for active development with a focus on supporting professional level
development. This means full HTML 4.0 support including cascading style sheets
and lot's of time saving features.
 Also improved support is planned for Perl, Javascript and PHP.

2. Requirements
--------------- 
 Quanta Plus 3.1 was developed for KDE 3.1. We do our best to keep it runnable under
KDE 3.0.x, but you should understand that as it is part of KDE 3.1, we strongly recommend
to upgrade your KDE to 3.1. Under KDE 3.0.x some of the new features are not available or
they may not work as expected.
 Check out the KDE webpage (http://www.kde.org) for the requirements running and compiling
KDE 3.1 software. Generally for KDE 3.0.x you will need at least QT 3.0.2 or above.
For KDE 3.1 you need QT 3.1 and above.
 Don't forget that for compilation you need an environment set up for developing. This
means that aside of the compiler (usually GCC) and the make tools (autoconf, automake,
gmake/make and so) you need some additional libraries and the _header_ files for those
libraries. The headers are usually located in the so called "-devel" packages, but this
depends on the distribution you use.
 For some more information about what do you need and how to compile KDE (and KDE
applications) read the documents from the following site:
 http://developer.kde.org/build/index.html

3. Getting Quanta Plus
----------------------
 Starting from version 3.1, you can download Quanta Plus from the same place as the rest of
KDE. Start to browse at http://www.kde.org.
 The homepage of Quanta Plus is located at http://quanta.sourceforge.net, and here you can
find the latest news regarding the developement, announcements, merchandise and you can
make some donation to support Quanta. The homepage contains links to download it for
KDE 3.0.x.
 An alternative way to use the latest and greatest version is to get it from CVS. More info
about getting the sources from KDE CVS can be found at: http://developer.kde.org/source/.
The module name for Quanta is "quanta".

4. Installation
---------------
 In order to install Quanta Plus on your computer do the following:
 
./configure
make
make install (as root)

Should you have trouble during ./configure or the make process, try the following:
 - export KDEDIRS=<path to kde installation>:$KDEDIRS
 - export QTDIR=<path to qt3>
 - run  "make -f Makefile.cvs"
 - run "./configure"

If you use Quanta+ from CVS, or you're ./configure script is missing,
run "make -f Makefile.cvs" and you will get it.

 For more information regarding the configuration and make process read the instructions
form the INSTALL file, and run the ./configure --help command.

4.1. Common installation and compilation problems
-------------------------------------------------
Possible problem sources can be:
  - old autoconf was used (2.52 or newer is required). Check with "autoconf --version".
  - old automake was used (1.5 or newer is required). Check with "automake --version".
  - wrong --prefix given to ./configure
  - "make install" process was forgot or failed
  - you have an old quantarc file in $KDEHOME/share/config
  - you have old files in $KDEHOME/share/apps/quanta

In the latter two cases backup the old files, then remove them and try to start Quanta again.  

 For those having compilation errors like:

copytos.cpp:47: invalid use of undefined type `class KURLRequester'
copytos.h:17: forward declaration of `class KURLRequester'

(or the same error in other files for other K... class), try the following:
  - check if there is a kdewidgets.so (and kdewidgets.la) in your
$KDEDIR/lib/kde3/plugins/designer. If there isn't, you have a broken KDE (kdelibs) install.
  - check your $HOME/.qt/qtrc file. Add the above path as the first entry to the
libraryPath (like: libraryPath=/opt/kde-cvs/lib/kde3/plugins/:/home/user/cvs/head/qt-copy/plugins).
You can use the qtconfig tool to do this.
  - recompile the QT tools (uic, designer) if you have upgraded kdelibs (or QT).
  - check that your $KDEDIR and $QTDIR path is set correctly.
  - do an
       export kde_widgetdir="$KDEDIR/lib/kde3/plugins/designer"
    (or whatever command uses your shell for environment variable setting) before
    running make.
In most cases one of the above is the problem (and the solution).


Enjoy Quanta+!

The Quanta team