2021-10-22 02:20:04 +02:00
|
|
|
StarDict Terminal and Graphical UI
|
|
|
|
==================================
|
2013-05-17 00:54:11 +02:00
|
|
|
|
2015-09-27 01:44:06 +02:00
|
|
|
'sdtui' aims to provide an easy way of viewing translation as well as other
|
2021-07-23 20:43:53 +02:00
|
|
|
kinds of dictionaries in your terminal, and is inspired by the dictionary
|
|
|
|
component of PC Translator. I wasn't successful in finding any free software
|
|
|
|
of this kind, GUI or not, and thus decided to write my own.
|
2013-05-17 00:54:11 +02:00
|
|
|
|
2015-02-26 22:58:40 +01:00
|
|
|
The project is covered by a permissive license, unlike vast majority of other
|
2013-05-17 00:54:11 +02:00
|
|
|
similar projects, and can serve as a base for implementing other dictionary
|
2021-10-07 20:08:56 +02:00
|
|
|
software.
|
2013-05-17 00:54:11 +02:00
|
|
|
|
2021-07-23 20:43:53 +02:00
|
|
|
image::sdtui.png[align="center"]
|
|
|
|
|
2021-10-22 02:20:04 +02:00
|
|
|
As a recent addition, there is now an alternative GTK+ 3 based frontend as well,
|
|
|
|
called 'sdgui'. It shares its dictionary list with 'sdtui', but styling will
|
|
|
|
follow your theme, and may be customized from 'gtk.css'.
|
2021-10-20 14:01:46 +02:00
|
|
|
|
2016-03-14 21:27:57 +01:00
|
|
|
Packages
|
|
|
|
--------
|
|
|
|
Regular releases are sporadic. git master should be stable enough. You can get
|
2018-06-24 05:23:48 +02:00
|
|
|
a package with the latest development version from Archlinux's AUR.
|
2016-03-14 21:27:57 +01:00
|
|
|
|
2021-10-07 20:08:56 +02:00
|
|
|
Documentation
|
|
|
|
-------------
|
|
|
|
See the link:docs/sdtui.1.adoc[man page] for information about usage.
|
|
|
|
The rest of this README will concern itself with externalities.
|
|
|
|
|
2015-02-07 21:38:27 +01:00
|
|
|
Building and Running
|
|
|
|
--------------------
|
2021-10-27 09:48:57 +02:00
|
|
|
Build dependencies: CMake, pkg-config, asciidoctor, librsvg (for the GUI) +
|
2021-10-06 16:09:35 +02:00
|
|
|
Runtime dependencies: ncursesw, zlib, ICU, termo (included), glib-2.0 >= 2.38,
|
2021-10-20 14:01:46 +02:00
|
|
|
pango, xcb, xcb-xfixes (the latter two optional for the TUI),
|
2021-10-27 09:48:57 +02:00
|
|
|
gtk+-3.0 (for the GUI)
|
2015-02-07 21:38:27 +01:00
|
|
|
|
2018-06-24 05:23:48 +02:00
|
|
|
$ git clone --recursive https://git.janouch.name/p/sdtui.git
|
2015-09-27 01:36:36 +02:00
|
|
|
$ mkdir sdtui/build
|
|
|
|
$ cd sdtui/build
|
2021-10-22 01:59:09 +02:00
|
|
|
$ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug \
|
|
|
|
-DWITH_X11=ON -DWITH_GUI=ON
|
2015-02-07 21:38:27 +01:00
|
|
|
$ make
|
|
|
|
|
|
|
|
To install the application, you can do either the usual:
|
2015-09-27 01:44:06 +02:00
|
|
|
|
2015-02-26 22:58:40 +01:00
|
|
|
# make install
|
2015-02-07 21:38:27 +01:00
|
|
|
|
|
|
|
Or you can try telling CMake to make a package for you. For Debian it is:
|
2015-09-27 01:44:06 +02:00
|
|
|
|
2015-02-07 21:38:27 +01:00
|
|
|
$ cpack -G DEB
|
|
|
|
# dpkg -i sdtui-*.deb
|
|
|
|
|
2021-10-07 20:08:56 +02:00
|
|
|
Having the program installed, simply run it with a StarDict '.ifo' file as
|
|
|
|
an argument. It is, however, preferable to
|
|
|
|
link:docs/sdtui.1.adoc#_configuration[configure it] to load your dictionaries
|
|
|
|
automatically.
|
2021-07-23 20:43:53 +02:00
|
|
|
|
2021-10-22 01:59:09 +02:00
|
|
|
Windows
|
|
|
|
~~~~~~~
|
2021-10-22 02:20:04 +02:00
|
|
|
With the help of Mingw-w64 and WINE, 'sdgui' will successfully cross-compile
|
2021-10-22 01:59:09 +02:00
|
|
|
for Windows. It isn't particularly usable on that system, if only because
|
|
|
|
selection watching is a very X11/Wayland-specific feature. Beware that build
|
|
|
|
dependencies take up almost a gigabyte of disk space.
|
|
|
|
|
2021-10-22 14:39:34 +02:00
|
|
|
$ sh cmake/Win64Depends.sh
|
2021-10-22 01:59:09 +02:00
|
|
|
$ cmake -DCMAKE_TOOLCHAIN_FILE=cmake/Win64CrossToolchain.cmake \
|
|
|
|
-DCMAKE_BUILD_TYPE=Release -B build
|
|
|
|
$ cmake --build build -- package
|
|
|
|
|
2015-02-08 00:36:45 +01:00
|
|
|
Dictionaries
|
|
|
|
------------
|
2021-10-11 02:44:58 +02:00
|
|
|
This application is intended for use with specific dictionaries: each line
|
|
|
|
should contain one short word definition. Moreover, the only supported content
|
|
|
|
types are plain text, Pango markup, and XDXF (the visual format works better).
|
2015-02-08 00:36:45 +01:00
|
|
|
|
2021-10-11 02:44:58 +02:00
|
|
|
The `make dicts` command will build some examples from freely available sources:
|
2021-10-07 03:37:12 +02:00
|
|
|
|
2021-10-11 02:44:58 +02:00
|
|
|
- GNU/FDL Czech-English dictionary
|
|
|
|
- Czech foreign words
|
|
|
|
- Czech WordNet 1.9 PDT (synonyms, hypernyms, hyponyms)
|
|
|
|
|
|
|
|
You can use the included 'transform' tool to convert already existing StarDict
|
|
|
|
dictionaries that are nearly good as they are. Remember that you can change
|
|
|
|
the `sametypesequence` of the resulting '.ifo' file to another format, or run
|
|
|
|
'dictzip' on '.dict' files to make them compact.
|
2020-09-03 23:17:17 +02:00
|
|
|
|
2021-10-07 03:37:12 +02:00
|
|
|
https://mega.co.nz/#!axtD0QRK!sbtBgizksyfkPqKvKEgr8GQ11rsWhtqyRgUUV0B7pwg[CZ <--> EN/DE/PL/RU dictionaries]
|
2015-02-08 00:36:45 +01:00
|
|
|
|
2021-10-07 20:08:56 +02:00
|
|
|
Further Development
|
|
|
|
-------------------
|
2021-11-03 18:14:36 +01:00
|
|
|
While I've been successfully using 'sdtui' for many years now, some issues
|
|
|
|
should be addressed before including the software in regular Linux and/or
|
|
|
|
BSD distributions:
|
2021-10-07 20:08:56 +02:00
|
|
|
|
2021-11-03 18:14:36 +01:00
|
|
|
- The tab bar doesn't handle overflows well in the TUI.
|
|
|
|
- The GUI doesn't support text selection, and is awkward to configure.
|
2021-10-11 02:44:58 +02:00
|
|
|
- Lacking configuration, standard StarDict locations should be scanned.
|
2021-10-07 20:08:56 +02:00
|
|
|
|
2021-10-20 14:01:46 +02:00
|
|
|
Given all issues with the file format, it might be better to start anew.
|
2021-10-15 12:08:44 +02:00
|
|
|
|
2015-09-27 01:36:36 +02:00
|
|
|
Contributing and Support
|
|
|
|
------------------------
|
2018-06-24 05:23:48 +02:00
|
|
|
Use https://git.janouch.name/p/sdtui to report any bugs, request features,
|
|
|
|
or submit pull requests. `git send-email` is tolerated. If you want to discuss
|
|
|
|
the project, feel free to join me at ircs://irc.janouch.name, channel #dev.
|
2015-09-27 01:36:36 +02:00
|
|
|
|
2018-06-24 05:23:48 +02:00
|
|
|
Bitcoin donations are accepted at: 12r5uEWEgcHC46xd64tt3hHt9EUvYYDHe9
|
2017-06-20 06:37:28 +02:00
|
|
|
|
2015-02-07 21:38:27 +01:00
|
|
|
License
|
|
|
|
-------
|
2018-06-24 05:23:31 +02:00
|
|
|
This software is released under the terms of the 0BSD license, the text of which
|
|
|
|
is included within the package along with the list of authors.
|