From 4c30a622460922ce75251403511b0112c24dfd32 Mon Sep 17 00:00:00 2001 From: Přemysl Janouch Date: Sun, 27 Sep 2015 01:44:06 +0200 Subject: Convert README to AsciiDoc --- README | 81 ------------------------------------------------------------------ 1 file changed, 81 deletions(-) delete mode 100644 README (limited to 'README') 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 . - -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