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 ----------------------------------------------------------
README.adoc | 84 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 84 insertions(+), 81 deletions(-)
delete mode 100644 README
create mode 100644 README.adoc
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
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 .
+
+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