aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorPřemysl Eric Janouch <p@janouch.name>2021-07-23 20:43:53 +0200
committerPřemysl Eric Janouch <p@janouch.name>2021-07-23 20:46:14 +0200
commit4245dc35df513a0bad63d01b1616cec97073c849 (patch)
tree42677b9ef16e928b9f238650c91dd3e0dfbbabbd
parent87f90f64204efa3b5c71f0bac422a438a9195bf2 (diff)
downloadtdv-4245dc35df513a0bad63d01b1616cec97073c849.tar.gz
tdv-4245dc35df513a0bad63d01b1616cec97073c849.tar.xz
tdv-4245dc35df513a0bad63d01b1616cec97073c849.zip
Update README, add a screenshot
I've given up on the idea of a "proper" TUI framework. I've also learnt that Wayland isn't a completely dead end.
-rw-r--r--README.adoc21
-rw-r--r--sdtui.pngbin0 -> 29303 bytes
2 files changed, 12 insertions, 9 deletions
diff --git a/README.adoc b/README.adoc
index 476d1b5..52be085 100644
--- a/README.adoc
+++ b/README.adoc
@@ -2,13 +2,16 @@ 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.
+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.
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_ for StarDict.
+image::sdtui.png[align="center"]
+
Further Development
-------------------
While I've been successfully using sdtui for a long time now, some work has to
@@ -17,11 +20,8 @@ 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
- - possibly make it work better with multiple dictionaries as now it's only
- acceptable if you give them short names in the configuration so that they
- all fit in the header
- - figure out a way to become capable of displaying most dictionaries
+ - the tab bar and the text input field don't handle overflows well
+ - figure out a way to become capable of displaying most StarDict dictionaries
Packages
--------
@@ -32,7 +32,7 @@ Building and Running
--------------------
Build dependencies: CMake, pkg-config, asciidoctor +
Runtime dependencies: ncursesw, zlib, ICU, termo (included),
- glib-2.0, pango, xcb and xcb-xfixes (optional)
+ glib-2.0, pango, xcb, xcb-xfixes (the latter two optional)
$ git clone --recursive https://git.janouch.name/p/sdtui.git
$ mkdir sdtui/build
@@ -82,7 +82,8 @@ odd = 16 255
The `watch-selection` option makes the application watch the X11 primary
selection for changes and automatically search for selected text.
-This feature requires XCB and it will never work on Wayland by its design.
+This feature requires XCB. Wayland is currently unsupported, but would require
+a compositor supporting the wlr-data-control protocol.
You can also set up some dictionaries to be loaded at startup automatically:
@@ -92,6 +93,8 @@ name1 = ~/path/to/dict.ifo
name2 = ~/another/dict.ifo
....
+The names define how they will appear in the tab bar.
+
Dictionaries
------------
Unfortunately this application only really works with specific dictionaries.
diff --git a/sdtui.png b/sdtui.png
new file mode 100644
index 0000000..a628ed7
--- /dev/null
+++ b/sdtui.png
Binary files differ