QSTARDICT(1)						      General Commands Manual						      QSTARDICT(1)

NAME

       qstardict - a Qt4 dictionary

DESCRIPTION

       QStarDict is a StarDict clone written with Qt4. The user interface is similar to StarDict. You can start QStarDict from the menu or by run-
       ning the qstardict command.

TRANSLATION REFORMATTING AND ABBREVIATION EXPANSION

       QStarDict can reformat translations and expand dictionary abbreviations. For example this translation:

       1> First _val. of _w. 2> Second _val. of _w. ...

       can be shown as

       1. Fist value of word
       2. Second value of word
       3. ...

       But reformatting and expanding takes additional CPU time. If the translation reformatting and instant search are both turned on this can decrease QStarDict performance.

DICTIONARIES

       Dictionaries for StarDict plugin are in StarDict format and by default must  be	placed	into  /usr/share/stardict/dic  or  ~/.stardict/dic
       directories. A dictionary must consist of three files:

	- .dict[.dz] file - main dictionary file
	- .idx - index file
	- .ifo - description file

       These files must be placed together in one directory.

PRONOUNCING PROGRAMS

       QStarDict can pronounce words using external program when popup window is shown. You must set a voice program to pronounce text from stdin.
       By default this is festival with --tts option.

D-BUS
       QStarDict supports D-Bus message bus. List of available methods:

       void org.qstardict.dbus.showPopup(QString text)
       void org.qstardict.dbus.showTranslation(QString text)
       QString org.qstardict.dbus.translate(QString text)
       QString org.qstardict.dbus.translateHtml(QString text)
       QDBusVariant org.freedesktop.DBus.Properties.Get(QString interface_name, QString property_name)
       void org.freedesktop.DBus.Properties.Set(QString interface_name, QString property_name, QDBusVariant value)
       QString org.freedesktop.DBus.Introspectable.Introspect()

       List of available properties:

       readwrite int org.qstardict.dbus.mainWindowVisible

       You can call these methods from your applications or by using the qdbus program.  This command

       qdbus org.qstardict.dbus /qstardict org.qstardict.dbus.showPopup "text"

       will show a QStarDict popup window with a translation of the "text".

       If you want to show/hide QStarDict window using keyboard shortcuts you must bind the following command to a shortcut:

       qdbus org.qstardict.dbus /qstardict org.freedesktop.DBus.Properties.Set 
       org.qstardict.dbus mainWindowVisible 
       $(( ! $(qdbus org.qstardict.dbus /qstardict 
       org.freedesktop.DBus.Properties.Get org.qstardict.dbus mainWindowVisible)))

HOMEPAGE

       QStarDict website <http://qstardict.ylsoftware.com>

AUTHOR

       QStarDict was written by Alexander Rodin <rodin.alexander@gmail.com>.

       This manual page was written by Alexander Rodin <rodin.alexander@gmail.com>, for the Debian project (but may be used by others).

SEE ALSO

       stardict(1) sdcv(1) qdbus(1)

								 November 11, 2007						      QSTARDICT(1)