 Quanta Plus - a WEB Development 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 overall 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 lots 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 from 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 your ./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 from 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 forgotten 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... classes), 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 your shell uses for environment variable setting)
    before running make.
In most cases one of the above is the problem (and the solution).

5. Common problems
------------------
 
  a) In case Quanta refuses to open a source file from it's treeviews, saying that the file
is a binary one, check in Control Center->File Associations that the mimetype correcponding 
to this file extension is under the text node. There were reports that Mandrake 9.0 puts
the mimetype for php under the application node, so users could not open PHP files from
Quanta...

Enjoy Quanta+!

The Quanta team
