OpenOffice.org 2 extension manager
Go to Table of contents, or to the next page.
In order to use Thessalonica, you must have OpenOffice.org 2.1 or above installed. As Thessalonica is written in Java, it also requires Java Runtime Environment 1.5 or above. So please ensure you have set up OpenOffice.org to use Java. If you haven’t adjusted your Java connection during the setup process, you can do that via the OpenOffice.org GUI: just go to Tools->Options->OpenOffice.org->Java and specify the path to your Java installation directory (of course it should be present in your system). Note that Thessalonica 3.0 no longer contains any modules implemented in Python, and so it is not necessary to have the Python — UNO bridge installed.
In addition to Thessalonica and OpenOffice.org itself you will probably need some Unicode fonts which would support characters you are planning to input with Thessalonica’s keyboard layouts. In order to provide a good companion font for Thessalonica I have designed my own typeface, called Old Standard, which can be downloaded from the Thessalonica web site. Both the Universal Converter and most keyboard layouts distributed with Thessalonica are now configured to use Old Standard by default. Of course you can always replace it with another font of your choice.
Thessalonica for OpenOffice.org is distributed as an OpenOffice.org UNO package, called thessalonica*.uno.oxt, where * stands for the version number. Actually an UNO.OXT file is just a plain ZIP archive with a different extension; however, there is no need to unzip this file to install it.
Beginning from the version 2.0, OpenOffice.org has a nice graphical extension manager. So UNO packages installation is now simple and doesn’t require using any command line tools. The following steps are required to install Thessalonica:
OpenOffice.org 2 extension manager
click Tools->Extension Manager to start the OpenOffice.org extension manager. Double-click the “My extensions” line to view the list of installed UNO packages;
if you have previously installed an earlier version of Thessalonica, then you should uninstall it first (select the package and click “Remove”). Please be patient during the removal process: unregistering UNO components, and especially OpenOffice.org registry files may take several minutes;
when the removal is finished, close all OpenOffice.org windows and don’t forget to exit QuickStarter, if it is running. Then start OpenOffice.org again. This step is necessary, because Thessalonica installs its own type libraries, which cannot be removed from a running OpenOffice.org process. So installing a newer version of the same libraries can cause a conflict until you restart OpenOffice.org;
now start Extension Manager again, click “Add”, and browse to the location where you have placed the downloaded Thessalonica package. The installation process will start;
when installation is finished, it is recommended to restart OpenOffice.org again to ensure that all configuration files are properly registered.
Alternatively, you can install Thessalonica from your command line, using the unopkg tool, supplied with OpenOffice.org. You may get the full list of unopkg options by running
$ unopkg --help
For more information about installing/uninstalling UNO extensions under OpenOffice.org 2.* refer to the OOo Developer’s Guide, chapter 4.9.1 “UNO Package Installation Using unopkg”.
If you install Thessalonica 3.0 above an older version, please note that this version contains several (small) changes in its configuration files. Unfortunately, when you replace a UNO package with a newer version, OpenOffice.org doesn’t update automatically package-specific configuration files previously created in its main directory tree. This may cause version conflict between old and new registry files, so that both retrieving and saving configuration data into the corresponding registry branch becomes impossible. If this happens, just remove manually the following 2 files (either in <OfficeHome>/user/ or <OfficePath>/share/, depending from where you have installed Thessalonica:
registry/cache/org.openoffice.comp.thessalonica.Preferences
and
registry/data/org/openoffice/comp/thessalonica/Preferences.xcu
and after that restart OpenOffice.org.
Of course after that you have to configure Thessalonica once more, since your previously stored settings will be lost.
To remove Thessalonica from your OpenOffice.org installation, follow the previously described steps: start the extension manager, select the package you would like to uninstall and click “Remove”, Then wait until the uninstallation process is finished.
Go to Table of contents, or to the next page.