Yoltia README


Yoltia is a graphical picture editor that provides the functionality to do simple changes to a large number of files quickly and very comfortable and exactly. Some of the features are:
- Resizing
- Rotating
- RGB- and HSV-manipulation
- JPEG and PNG compression preview
- Clipboard interaction
- Many zoom-modes
- Browsing through directories or custom file lists
- Slideshow
- Macros
- Printing

You can get the source code and translation sources from Yoltia's web page <http://freenet-homepage.de/yoltia>.

To build Yoltia, you need the Qt3 library by Trolltech with the corresponding development package, the GNU make utility and a C++ compiler. The build process runs like this:

  Unpack - if not already done - the whole package to a directory of your choice (i.e. /usr/src/, from now on called $UNPACKDIR)
$ cd $UNPACKDIR/yoltia-VERSION/src/     // Change to source code directory
$ qmake			                // Creates the "Makefile" out of the project file "yoltia.pro"
$ make			      	        // Starts compiling using the created "Makefile", creates an executable binary "yoltia"
$ lrelease yoltia.pro		        // Creates the translation files ("yoltia_*.qm") out of the translation sources ("yoltia_*.ts")

After this, you will get an executable named "yoltia" and some "yoltia_*.qm" translation files in the source code directory.
If you want, log in as root and run the install.sh script to integrate Yoltia into the system, or copy the binary and translation files to a destination of your choice yourself.

$ $UNPACKDIR/yoltia-VERSION/install.sh  // Integrates Yoltia into the system, root-login necessary

The install.sh script will create the following files/directories:

/usr/X11/bin/yoltia 			// Executable binary
/usr/share/pixmaps/yoltia.xpm		// Yoltias ugly icon
/usr/share/applications/yoltia.desktop	// Desktop integration (compilant to freedesktop.org's Desktop Entry Specification 0.9.4)
/usr/share/doc/packages/yoltia/		// Directory where the doc files will be copyed into
/usr/share/yoltia/			// Directory for the translation files

The translation files have to be integrated in Yoltia via the settings dialog (Edit => Settings => Internationalization => Select). Note that you have to restart Yoltia to use the set translation files.

Yoltia uses another 2 files while running:
$HOME/.qt/yoltiarc			// Settings file
/tmp/kvs-$USER				// Temporary file for testing compression of JPEG an PNG pictures
If you want to run Yoltia on different platforms than Linux, you may have to change the paths to these files in the code. If you can't find the right place, just send me an e-mail.

Finally, I hope you enjoy to use Yoltia!


--Stefan Bauer <yoltia-maintain@freenet.de>

Last modified 2007-01-22