diff options
| author | Přemysl Eric Janouch <p@janouch.name> | 2021-07-23 20:43:53 +0200 |
|---|---|---|
| committer | Přemysl Eric Janouch <p@janouch.name> | 2021-07-23 20:46:14 +0200 |
| commit | 4245dc35df513a0bad63d01b1616cec97073c849 (patch) | |
| tree | 42677b9ef16e928b9f238650c91dd3e0dfbbabbd /README.adoc | |
| parent | 87f90f64204efa3b5c71f0bac422a438a9195bf2 (diff) | |
| download | tdv-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.
Diffstat (limited to 'README.adoc')
| -rw-r--r-- | README.adoc | 21 |
1 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. |