koffice
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
TDE Gitea 07e76df132 Reset submodule main/applications/koffice/cmake to latest HEAD před 4 dny
admin @ 68f23556e6 Reset submodule main/applications/koffice/admin to latest HEAD před 4 dny
autocorrect Fix incorrect characters. před 5 roky
chalk Add CMakeL10n rules. před 1 měsícem
cmake @ 0a40752779 Reset submodule main/applications/koffice/cmake to latest HEAD před 4 dny
doc qt -> tqt conversion: před 4 měsíci
example Add CMakeL10n rules. před 1 měsícem
filters Add CMakeL10n rules. před 1 měsícem
interfaces Remove spurious TQ_OBJECT instances před 7 roky
karbon Add CMakeL10n rules. před 1 měsícem
kchart Add CMakeL10n rules. před 1 měsícem
kdgantt Fixed incorrect TTQ rename (TTQ -> TQ) před 4 měsíci
kexi Add CMakeL10n rules. před 1 měsícem
kformula Add CMakeL10n rules. před 1 měsícem
kivio Add CMakeL10n rules. před 1 měsícem
koshell Add CMakeL10n rules. před 1 měsícem
kounavail Add CMakeL10n rules. před 1 měsícem
kplato Fix empty translation. před 1 měsícem
kpresenter Add CMakeL10n rules. před 1 měsícem
kspread Add CMakeL10n rules. před 1 měsícem
kugar Add CMakeL10n rules. před 1 měsícem
kword Add CMakeL10n rules. před 1 měsícem
lib Add CMakeL10n rules. před 1 měsícem
mimetypes Bring most mimetypes in line with XDG specifications. The following are not fully verified in source as of this commit due to ubiquity: html, empty, info, make, man, misc, source, unknown před 4 roky
pics Fix invalid headers in PNG files and optimize for size před 2 roky
plugins Add CMakeL10n rules. před 1 měsícem
servicetypes Update XDG information in support of bug report 892. před 6 roky
templates Bring most mimetypes in line with XDG specifications. The following are not fully verified in source as of this commit due to ubiquity: html, empty, info, make, man, misc, source, unknown před 4 roky
tools Add CMakeL10n rules. před 1 měsícem
.gitmodules Added common directories před 7 roky
AUTHORS Added old abandoned KDE3 version of koffice před 9 roky
CMakeL10n.txt Add CMakeL10n rules. před 1 měsícem
COPYING Added old abandoned KDE3 version of koffice před 9 roky
COPYING.LIB Added old abandoned KDE3 version of koffice před 9 roky
Doxyfile.temp Rename kinit -> tdeinit. před 5 roky
INSTALL Rename kderc -> tderc in support of bug report 1447. před 5 roky
Mainpage.dox Added old abandoned KDE3 version of koffice před 9 roky
Makefile.am Added old abandoned KDE3 version of koffice před 9 roky
Makefile.am.in Added old abandoned KDE3 version of koffice před 9 roky
Makefile.cvs Added old abandoned KDE3 version of koffice před 9 roky
README Additional renaming of kde to tde před 7 roky
README.APPS Additional renaming of kde to tde před 7 roky
README.PACKAGERS Convert remaining references to kde3 (e.g. in paths) to trinity před 7 roky
changes-1.4 Rename a number of libraries and executables to avoid conflicts with KDE4 před 6 roky
changes-1.5 Additional renaming of kde to tde před 7 roky
configure.files Fix FTBFS with libwpd 0.9 and above před 5 roky
configure.in.in Add automake support for --enable-gcc-hidden-visibility. před 6 roky
install-sh Added old abandoned KDE3 version of koffice před 9 roky
koffice.lsm Update version number to R14.1.0 před 3 roky
stamp-h.in Added old abandoned KDE3 version of koffice před 9 roky
subdirs Fix FTBFS with libwpd 0.9 and above před 5 roky
vpat_koffice1.4.1.sxw Added old abandoned KDE3 version of koffice před 9 roky

README.PACKAGERS

Packaging Information for KOffice.
----------------------------------

We recommend building several binary packages from the KOffice source.

Splitting KOffice into packages:
* gives users a better choice of which components they have
installed;
* allows users to install just the applications without unnecessary
dependencies;
* helps to reduce packaging conflicts for users with non-standard
package selections.


Table Of Contents
-----------------

1. Database drivers (MySQL, PostgreSQL)
2. Development files
2.1. KexiDB development files
2.2. Chalk development files
3. Scripting support
4. Microsoft Access Import (optional, recommended)
5. Quick command-line tests of Kexi installation



1. Database drivers
-------------------

Kexi provides database drivers for MySQL and PostgreSQL. We suggest
putting each driver in a separate package, and that installation of
these packages be optional. Each driver package may then depend on
the corresponding 'native' libraries: libmysqlclient for MySQL; and
and libpqxx for PostgreSQL (libpqxx in turn depends on libpq).

Thus, the MySQL driver package could contain:
lib/trinity/kexidb_mysqldriver.so
lib/trinity/kexidb_mysqldriver.la
lib/trinity/keximigrate_mysql.so
lib/trinity/keximigrate_mysql.la
share/services/kexidb_mysqldriver.desktop
share/services/keximigrate_mysql.desktop

The PostgreSQL driver package consists of the following files:
lib/trinity/kexidb_pqxxsqldriver.so
lib/trinity/kexidb_pqxxsqldriver.la
lib/trinity/keximigrate_pqxx.so
lib/trinity/keximigrate_pqxx.la
share/services/kexidb_pqxxsqldriver.desktop
share/services/keximigrate_pqxx.desktop

Note that you SHOULD NOT care about SQLite database driver or adding
dependencies for SQLite, because SQLite support is built into Kexi
using a fork of SQLite source code.


2. Development files
--------------------

2.1. KexiDB development files

Location: koffice/kexi/kexiutils, koffice/kexi/kexidb, koffice/kexi/migration

KexiDB, the database abstraction library used in Kexi, installs some
development files which are required for building external plugins,
such as the MS Access import plugin described below.

We recommend providing KexiDB development files in a separate package.
The files are:
include/kexidb/*.h
include/kexiutils/*.h
lib/libkexidb.la
lib/libkexidb.so
lib/libkexidbparser.so
lib/libkexidbparser.la

The installation can be tested by building the MS Access import plugin
as described in the Microsoft Access import plugin section below.

2.2. Chalk development files

Location: koffice/chalk/core, koffice/chalk/sdk,
koffice/chalk/chalkcolor, koffice/chalk/ui

These directories contain header files that are installed and can be
used by plugin developers to extend Chalk with new tools, colorspaces,
paint-ops and more. If your distribution packages development files
separately, it may be a good idea to make a package with these headers.


3. Scripting support
--------------------

Preliminary support for Ruby and Python scripting is available for
Chalk and Kexi.
It can be disabled by passing the '--disable-scripting' option to
'configure'.

The 'Kross' scripting library (koffice/lib/kross) provides access to
the Python and Ruby scripting languages by the dynamically loaded
plugins.

Build time dependencies:
Python and Ruby development packages need to be installed in order
to build KOffice with full scripting support. In addition, the Ruby
interpreter is also required at build time.

Run time dependencies:
Kross detects which of these libraries is installed dynamically, at
run-time. Therefore, KOffice packages need not have any run-time
dependencies on any scripting interpreter.

The scripting language plugins can be found in:
koffice/lib/kross/python; and
koffice/lib/kross/ruby.
They install as:
lib/trinity/krosspython.{la,so}; and
lib/trinity/krossruby.{la,so}

It is recommended to put each interpreter plugin into a separate
package, and the user decide if they would like support for each
language individually.

For example, the Python scripting package may contain:
lib/trinity/krosspython.so
lib/trinity/krosspython.la
share/apps/kexi/scripts/exportxhtml/ExportXHTML.py
share/apps/kexi/scripts/exportxhtml/ExportXHTML.rc
share/apps/kexi/scripts/importxhtml/ImportXHTML.py
share/apps/kexi/scripts/importxhtml/ImportXHTML.rc
share/apps/kexi/scripts/projectdocumentor/ProjectDocumentor.py
share/apps/kexi/scripts/projectdocumentor/ProjectDocumentor.rc
share/apps/chalk/scripts/invert.py
share/apps/chalk/scripts/reshapehisto.py

and the Ruby scripting package may contain:
lib/trinity/krossruby.so
lib/trinity/krossruby.la
share/apps/chalk/scripts/ruby/invert.rb
share/apps/chalk/scripts/ruby/changecs.rb
share/apps/chalk/scripts/ruby/randompaint.rb


4. Microsoft Access Import (optional, recommended)
-------------------------------------

A plugin to allow the import of MS Access (.mdb) files is available
for packaging separately. It is called KexiMDB.

This package is based on a stripped-down and modified version of
mdbtools: http://mdbtools.sf.net/
The package should be built after KOffice. It requires GLib, and the
Kexi development files as described above.

The version of the plugin for use with KOffice 1.5 should be available
from:
ftp://ftp.kde.org/pub/kde/stable/apps/KDE3.x/database/keximdb-1.0.tar.gz

Alternatively, it can be found in the KDE Subversion repository. It
can be built as follows:
svn export svn://anonsvn.kde.org/home/kde/branches/work/keximdb/koffice-1.5 keximdb-1.0
cd keximdb-1.0
make -f Makefile.cvs
./configure --enable-debug=full
make
make install

Configure may need to be informed of the location of the KexiDB
headers using the --with-kexidb-includes=... and the
--with-kexidb-libraries=... options.


5. Quick command-line tests of Kexi installation
------------------------------------------------

If you don't want to click through Kexi interface but still want
to make (almost) sure the application is properly packaged, please
install it and type the following from the command line:

kexi --create-opendb --drv sqlite3 --new form testdb

(ignore possible warning message)
This will:
- create a new empty database file "testdb",
- open it,
- create a new empty form