|
 |
8d72f88 |
.\" -*- nroff -*-
|
|
|
8d72f88 |
.TH QSTARDICT 1 "November 11, 2007"
|
|
|
8d72f88 |
.SH NAME
|
|
|
8d72f88 |
\fBqstardict\fP \- a Qt4 dictionary
|
|
|
8d72f88 |
.SH DESCRIPTION
|
|
|
8d72f88 |
\fBQStarDict\fP is a StarDict clone written with Qt4. The user interface is similar to StarDict. You can start QStarDict from the menu or by running the \fBqstardict\fP command.
|
|
|
8d72f88 |
.SH TRANSLATION REFORMATTING AND ABBREVIATION EXPANSION
|
|
|
8d72f88 |
QStarDict can reformat translations and expand dictionary abbreviations. For example this translation:
|
|
|
8d72f88 |
.PP
|
|
|
8d72f88 |
.nf
|
|
|
8d72f88 |
1> First _val. of _w. 2> Second _val. of _w. ...
|
|
|
8d72f88 |
.PP
|
|
|
8d72f88 |
can be shown as
|
|
|
8d72f88 |
.PP
|
|
|
8d72f88 |
.nf
|
|
|
8d72f88 |
1. Fist value of word
|
|
|
8d72f88 |
2. Second value of word
|
|
|
8d72f88 |
3. ...
|
|
|
8d72f88 |
.PP
|
|
|
8d72f88 |
But reformatting and expanding takes additional CPU time. If the translation reformatting and instant search are both turned on this can decrease QStarDict performance.
|
|
|
8d72f88 |
.SH DICTIONARIES
|
|
|
8d72f88 |
|
|
|
8d72f88 |
Dictionaries for StarDict plugin are in \fBStarDict\fP format and by default must be placed into /usr/share/stardict/dic or ~/.stardict/dic directories. A dictionary must consist of three files:
|
|
|
8d72f88 |
|
|
|
8d72f88 |
- .dict[.dz] file - main dictionary file
|
|
|
8d72f88 |
- .idx - index file
|
|
|
8d72f88 |
- .ifo - description file
|
|
|
8d72f88 |
|
|
|
8d72f88 |
These files must be placed together in one directory.
|
|
|
8d72f88 |
.SH PRONOUNCING PROGRAMS
|
|
|
8d72f88 |
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 \fBfestival\fP with \fB--tts\fP option.
|
|
|
8d72f88 |
.SH D-BUS
|
|
|
8d72f88 |
QStarDict supports D-Bus message bus. List of available methods:
|
|
|
8d72f88 |
.PP
|
|
|
8d72f88 |
.BI "void org.qstardict.dbus.showPopup(\^QString\ "text "\^)"
|
|
|
8d72f88 |
.br
|
|
|
8d72f88 |
.BI "void org.qstardict.dbus.showTranslation(\^QString\ "text "\^)"
|
|
|
8d72f88 |
.br
|
|
|
8d72f88 |
.BI "QString org.qstardict.dbus.translate(\^QString\ "text "\^)"
|
|
|
8d72f88 |
.br
|
|
|
8d72f88 |
.BI "QString org.qstardict.dbus.translateHtml(\^QString\ "text "\^)"
|
|
|
8d72f88 |
.br
|
|
|
8d72f88 |
.BI "QDBusVariant org.freedesktop.DBus.Properties.Get(\^QString\ "interface_name ", \^QString\ "property_name ")"
|
|
|
8d72f88 |
.br
|
|
|
8d72f88 |
.BI "void org.freedesktop.DBus.Properties.Set(\^QString\ "interface_name ", \^QString\ "property_name ", \^QDBusVariant\ "value "\^)"
|
|
|
8d72f88 |
.br
|
|
|
8d72f88 |
.BI "QString org.freedesktop.DBus.Introspectable.Introspect()"
|
|
|
8d72f88 |
.br
|
|
|
8d72f88 |
|
|
|
8d72f88 |
.PP
|
|
|
8d72f88 |
List of available properties:
|
|
|
8d72f88 |
.PP
|
|
|
8d72f88 |
.BI "readwrite int org.qstardict.dbus.mainWindowVisible"
|
|
|
8d72f88 |
|
|
|
8d72f88 |
.PP
|
|
|
8d72f88 |
You can call these methods from your applications or by using the \fBqdbus\fP program.
|
|
|
8d72f88 |
This command
|
|
|
8d72f88 |
.PP
|
|
|
8d72f88 |
.nf
|
|
|
8d72f88 |
qdbus\ org.qstardict.dbus\ /qstardict\ org.qstardict.dbus.showPopup\ "text"
|
|
|
8d72f88 |
.PP
|
|
|
8d72f88 |
will show a QStarDict popup window with a translation of the "text".
|
|
|
8d72f88 |
.PP
|
|
|
8d72f88 |
If you want to show/hide QStarDict window using keyboard shortcuts you must bind the following command to a shortcut:
|
|
|
8d72f88 |
.PP
|
|
|
8d72f88 |
.nf
|
|
|
8d72f88 |
qdbus\ org.qstardict.dbus\ /qstardict\ org.freedesktop.DBus.Properties.Set\ \\
|
|
|
8d72f88 |
.br
|
|
|
8d72f88 |
org.qstardict.dbus mainWindowVisible\ \\
|
|
|
8d72f88 |
.br
|
|
|
8d72f88 |
$(( ! $(qdbus org.qstardict.dbus\ /qstardict\ \\
|
|
|
8d72f88 |
.br
|
|
|
8d72f88 |
org.freedesktop.DBus.Properties.Get\ org.qstardict.dbus mainWindowVisible)))
|
|
|
8d72f88 |
|
|
|
8d72f88 |
.de URL
|
|
|
8d72f88 |
\\$2 \(laURL: \\$1 \(ra\\$3
|
|
|
8d72f88 |
..
|
|
|
8d72f88 |
.if \n[.g] .mso www.tmac
|
|
|
8d72f88 |
.SH HOMEPAGE
|
|
|
8d72f88 |
.URL "http://qstardict.ylsoftware.com" "QStarDict website"
|
|
|
8d72f88 |
.SH AUTHOR
|
|
|
8d72f88 |
\fBQStarDict\fP was written by Alexander Rodin <rodin.alexander@gmail.com>.
|
|
|
8d72f88 |
.PP
|
|
|
8d72f88 |
This manual page was written by Alexander Rodin <rodin.alexander@gmail.com>,
|
|
|
8d72f88 |
for the Debian project (but may be used by others).
|
|
|
8d72f88 |
|
|
|
8d72f88 |
.SH SEE ALSO
|
|
|
8d72f88 |
.BR stardict(1)
|
|
|
8d72f88 |
.BR sdcv(1)
|
|
|
8d72f88 |
.BR qdbus(1)
|
|
|
8d72f88 |
|