aboutsummaryrefslogtreecommitdiff
path: root/README
diff options
context:
space:
mode:
authorPřemysl Janouch <p.janouch@gmail.com>2015-09-27 01:44:06 +0200
committerPřemysl Janouch <p.janouch@gmail.com>2015-09-27 01:44:06 +0200
commit4c30a622460922ce75251403511b0112c24dfd32 (patch)
tree62cf2ab1e01d89a5267b78c1a41d7fc9ceda1c59 /README
parent533ea1044a58184a698045a11b774e5a66381c9d (diff)
downloadtdv-4c30a622460922ce75251403511b0112c24dfd32.tar.gz
tdv-4c30a622460922ce75251403511b0112c24dfd32.tar.xz
tdv-4c30a622460922ce75251403511b0112c24dfd32.zip
Convert README to AsciiDoc
Diffstat (limited to 'README')
-rw-r--r--README81
1 files changed, 0 insertions, 81 deletions
diff --git a/README b/README
deleted file mode 100644
index ace6523..0000000
--- a/README
+++ /dev/null
@@ -1,81 +0,0 @@
-StarDict Terminal UI
-====================
-
-`sdtui' aims to provide an easy way of viewing translation as well as other
-kinds of dictionaries in your terminal. I wasn't successful in finding any free
-dictionary software of this kind, GUI or not, and thus decided to write my own.
-
-The project is covered by a permissive license, unlike vast majority of other
-similar projects, and can serve as a base for implementing other dictionary
-software. I wasn't able to reuse _anything_.
-
-Further Development
--------------------
-While I've been successfully using sdtui for a long time now, some work has to
-be done yet before the software can be considered fit for inclusion in regular
-Linux and/or BSD distributions. Help is much appreciated.
-
-An approximate list of things that need to be resolved:
- - rewrite the frontend using a proper TUI framework
- - load a list of installed dictionaries at startup (use the default locations
- used by StarDict) and let the user choose which dictionary to open
- - figure out a way to become capable of displaying most dictionaries
-
-Building and Running
---------------------
-Build dependencies: CMake, pkg-config, xsltproc, docbook-xsl
-Runtime dependencies: ncursesw, zlib, ICU, termo (included),
- glib-2.0, pango, gtk+ (optional, any version)
-
- $ git clone --recursive https://github.com/pjanouch/sdtui.git
- $ mkdir sdtui/build
- $ cd sdtui/build
- $ cmake .. -DCMAKE_INSTALL_PREFIX=/usr -DCMAKE_BUILD_TYPE=Debug -DWITH_GTK=ON
- $ make
-
-To install the application, you can do either the usual:
- # make install
-
-Or you can try telling CMake to make a package for you. For Debian it is:
- $ cpack -G DEB
- # dpkg -i sdtui-*.deb
-
-Note that for versions of CMake before 2.8.9, you need to prefix cpack with
-`fakeroot' or file ownership will end up wrong.
-
-Having the program installed, simply run it with a StarDict .ifo file as an
-argument. If you want the application to watch the X11 primary selection for
-changes and automatically search for the selected text, use the -w switch.
-This feature requires GTK+.
-
-Extensions
-----------
-As the original StarDict is a bit of a clusterfuck with regard to collation of
-dictionary entries, I had to introduce an additional "collation" field into the
-.ifo file. When sdtui discovers this field while reading the dictionary, it
-automatically reorders the index according to that locale (e.g. "cs_CZ").
-This operation may take a little while.
-
-Dictionaries
-------------
-Unfortunately this application only really works with specific dictionaries.
-Word definitions have to be in plain text, separated by newlines.
-
-CZ <-> { EN, DE, PL, RU } dictionaries:
-https://mega.co.nz/#!axtD0QRK!sbtBgizksyfkPqKvKEgr8GQ11rsWhtqyRgUUV0B7pwg
-
-Contributing and Support
-------------------------
-Use this project's GitHub to report any bugs, request features, or submit pull
-requests. If you want to discuss this project, or maybe just hang out with
-the developer, feel free to join me at irc://anathema.irc.so, channel #anathema.
-
-License
--------
-`sdtui' is written by Přemysl Janouch <p.janouch@gmail.com>.
-
-You may use the software under the terms of the ISC license, the text of which
-is included within the package, or, at your option, you may relicense the work
-under the MIT or the Modified BSD License, as listed at the following site:
-
-http://www.gnu.org/licenses/license-list.html