From 4c30a622460922ce75251403511b0112c24dfd32 Mon Sep 17 00:00:00 2001
From: Přemysl Janouch <p.janouch@gmail.com>
Date: Sun, 27 Sep 2015 01:44:06 +0200
Subject: Convert README to AsciiDoc

---
 README.adoc | 84 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 84 insertions(+)
 create mode 100644 README.adoc

(limited to 'README.adoc')

diff --git a/README.adoc b/README.adoc
new file mode 100644
index 0000000..5f04337
--- /dev/null
+++ b/README.adoc
@@ -0,0 +1,84 @@
+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.
+
+https://mega.co.nz/#!axtD0QRK!sbtBgizksyfkPqKvKEgr8GQ11rsWhtqyRgUUV0B7pwg[
+CZ <--> { EN, DE, PL, RU } dictionaries]
+
+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
-- 
cgit v1.2.3-70-g09d2

