Quanta Plus - a WEB Development tool for the Trinity Desktop Environment. Version: 3.5 line Last updated: 2006-03-16 Table of contents ----------------- 1. Introduction 2. Requirements 3. Release notes 4. Getting Quanta Plus 5. Installation 5.1 Installing two versions in parallel 5.2 Common installation and compilation problems 6. Common runtime problems 7. Reporting bugs 8. Developer info 9. Contactins 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. Our objective is to product a complete web development environment! We are well on our way to those objectives, supporting basic HTML that now assists you to write compliant mark up, as well as XML support. Our newest features allow for the DTD to be read in on the fly and for visual page layout. Look for active development with a focus on supporting professional level development. This means full HTML/XML 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.5 was developed for KDE 3.5. We do our best to support running it on KDE 3.4.x, but you should understand that as it is part of KDE 3.5, it's best working under this version. Under KDE 3.4.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.5 software. Generally for KDE 3.5.x you will need at least QT 3.3.2 or above. Quanta also has some other runtime and compile time (optional) dependencies as described in the toplevel PACKAGING file. 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" or "-dev" packages in RPM based distros, but this depends on the distribution you use. Some distributions put the .la files for libraries to the devel packages, resulting in a linker error at the end of the make process if you don't have the devel package installed. For some more information about what do you need and how to compile KDE (and TDE applications) read the documents from the following site: http://developer.kde.org/build/index.html 3. Release notes ---------------- No known issues at this time. 4. 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.kdewebdev.org, and here you can find the latest news regarding the development, announcements, merchandise and you can make some donation to support Quanta. An alternative way to use the latest and greatest version is to get it from the Subversion repository. More info about getting the sources from KDE SVN can be found at: http://developer.kde.org/source/. The module name for Quanta is "tdewebdev". 5. 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 TDEDIRS=:$TDEDIRS - export QTDIR= - run "make -f Makefile.cvs" - run "./configure" The recommended place where to install Quanta is your $TDEDIR. To find out, use "tde-config --prefix" or simply configure Quanta with: ./configure --prefix `tde-config --prefix` If you use Quanta+ from SVN, 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. 5.1. Installing two versions in parallel ---------------------------------------- If you wish to install Quanta BE and still keep your stable Quanta, you don't have to do anything special, just follow the above instructions. The Quanta BE executable name is quanta_be and all the resource directories and files are under a different name than for the stable Quanta. If you wish to install two stable versions in parallel, you have to install them using different prefixes (see above). Before running the one installed outside of the KDE tree, you should do: export TDEDIRS=$prefix-of-second-instace:$TDEDIRS export PATH=$prefix-of-second-instace/bin:$PATH export LD_LIBRARY_PATH=$prefix-of-second-instace/lib:$LD_LIBRARY_PATH export TDEHOME=home-for-second-version and run "quanta". An example would be: ./configure --prefix=/opt/new-quanta make make install mkdir ~/.new-quanta export TDEDIRS=/opt/new-quanta:$TDEDIRS export PATH=/opt/new-quanta/bin:$PATH export LD_LIBRARY_PATH=/opt/new-quanta/lib:$LD_LIBRARY_PATH export TDEHOME=~/.new-quanta quanta You can put the lines starting with the first "export" into a separate file, call it "new-quanta", make it executable, put it in your PATH and when you run "new-quanta" the version installed into /opt/new-quanta will be run. NOTE: In case of BE releases, only the Quanta BE executable name is different of the stable version, for the other applications when installing into the same directory as the old versions are, the old versions will be upgraded. To avoid this, use the way descibed above for the whole tdewebdev module. NOTE2: There is no newer BE release than 3.3.0. Please don't use BE1 or BE2, they are much older than 3.3.0. 5.2. 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 $TDEHOME/share/config - you have old files in $TDEHOME/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 tdewidgets.so (and tdewidgets.la) in your $TDEDIR/lib/trinity/plugins/designer. If there isn't, you have a broken KDE (tdelibs) install. - check your $HOME/.qt/qtrc file. Add the above path as the first entry to the libraryPath (like: libraryPath=/opt/kde-cvs/lib/trinity/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 tdelibs (or QT). - check that your $TDEDIR and $QTDIR path is set correctly. - do an export kde_widgetdir="$TDEDIR/lib/trinity/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). 6. 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 with Quanta 3.2 on KDE 3.1.1 or newer. b) If Quanta crashes on startup then rename your local quantarc file (in $TDEHOME/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. One known cause of such crash is if you use the same $TDEHOME for Quanta 3.2 and Quanta 3.3. Due to some incompatible changes in the quantarc file regarding the user interface, Quanta 3.2 cannot interpret the settings correctly and will crash. See section 5.1 how to deal with different $TDEHOME directories. c) If you removed the editor/treeviews from the main window and you cannot dock them back anymore, do one of the following (in order of preference): - check the Settings->Configure Quanta->User Intreface->Reset window layout to the default on the next startup and restart Quanta - start Quanta with the --resetlayout command line switch (quanta ---resetlayout) - as a last resort, locate your local quantarc file, and remove the whole [dock_setting_default] group. 7. 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.trinitydesktop.org (or use Help->Report Bug). If it is not possible, than report in E-Mail to the amantia@kde.org address. As this is my private address, please use the KDE bug reporting system if you can. 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. 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 6/b.) I'm waiting your bugs and wishes. 8. Developer info ----------------- If you are a C++ developer, first of all read the HACKING file about coding rules. If you are interested in getting involved with the development of Quanta contact us on our developer list (quanta-devel@kde.org). You can contribute in more ways than just coding in C++. For example you can create templates, XML files to adapt new languages and more. If you would like to make a contribution to the project to help defer our very real development expenses you may use PayPal and send to Eric Laffoon sequitur@easystreet.com. Bank transfers are also possible. 9. 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