 Quanta Plus - a WEB Development tool for the K Desktop Environment.
 Version: 3.1.3


Table of contents
-----------------

    1. Introduction
    2. Requirements
    3. Getting Quanta Plus
    4. Installation
       4.1 Common installation and compilation problems
    5. Common runtime problems
    6. Reporting bugs
    7. Contacting us, mailing lists



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 development,
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.6.1 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 runtime 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 corresponding 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... This shouldn't be a
problem in case of local files with Quanta 3.1.1 on KDE 3.1.1 or newer.
  b) If Quanta crashes on startup then rename your local quantarc file
(in $KDEHOME/share/config) and send this file to me, so I can find out why does
it crash. in case of any  crash, please send me a backtrace.
  c) If you see the same DTD more than once in the DTD selection lists, it means
that you have more than one Quanta installed, one in your KDE directories and
the other in some other place. If you start the second one, it will pick up also
the DTD's from the KDE directories. The rule is: install Quanta in the KDE dir,
or if you wish to have more than one Quanta version, install both of them in
another dir than the KDE one! In this case you should remove the
$KDEDIR/share/apps/quanta directory.
  d) If you removed the editor/treeviews from the main window and you cannot dock
them back anymore, locate your local quantarc file, and remove the whole
[dock_setting_default] group.


6. Reporting bugs
-----------------
  Good reports make my work easier. I usually cannot locate the problem and fix
it, if the report is bad or incomplete. Some rules:

    a) Report ALL your bugs and wishes on http://bugs.kde.org (or use
    Help->Report Bug). If it is not possible, than report in E-Mail to the
    amantia@freemail.hu address. As this is my private address, please use the
    KDE bug reporting system if you can. You may also want to subscribe to our
    user list at http://mail.kde.org/mailman/listinfo/quanta .
    b) Specify the Quanta version in your report. "quanta --version" will tell
    it to you, or you can find it from Help->About Quanta. In case of
    compilation errors, look at the quanta.lsm file to find out the current
    version.
    c) Specify the KDE and QT version. "quanta --version" is your friend here.
    d) Specify the used package (if it is a pre-built binary package).
    e) Tell me the compiler version. (g++ --version)
    f) Tell me how the bug can be reproduced. This is essentially.
    g) In case of crashes re-configure Quanta with the --enable-debug switch and
    generate a backtrace. You must have gdb installed to do so. Send me the
    backtrace.
    h) Send me the document which caused the problem, or the quantarc file if
    it's a startup crash. (See 5/c.)

I'm waiting your bugs and wishes.


7. Contacting us, mailing lists
-------------------------------
  We have two mailing lists. For the general users there is the Quanta user
mailing lists at http://mail.kde.org/mailman/listinfo/quanta .
  If you would like to become a Quanta developer, you may want to subscribe to
the Quanta developer list at http://mail.kde.org/mailman/listinfo/quanta-devel
Subscription to this list is moderated.
  In case of urgent issues, and if the above isn't good for you, contact the
current maintainers using their addresses found at Help->About Quanta->Authors.

Enjoy Quanta+!

The Quanta team
