tdv/docs/sdtui.1.adoc

98 lines
2.8 KiB
Plaintext
Raw Normal View History

sdtui(1)
========
:doctype: manpage
:manmanual: sdtui Manual
:mansource: sdtui {release-version}
Name
----
sdtui - StarDict terminal UI
Synopsis
--------
*sdtui* [_OPTION_]... [_DICTIONARY_.ifo]...
Description
-----------
2021-10-07 20:08:56 +02:00
*sdtui* is a StarDict dictionary viewer, custom-tailored for translation
dictionaries, with a simple curses-based terminal UI.
2021-10-07 20:08:56 +02:00
Without any command line arguments, the program expects to find a list of
dictionaries to load on start-up in its configuration file. The _.ifo_ files
contain information required to load dictionaries from their accompanying
database files.
Options
-------
*-h*, *--help*::
Display a help message and exit.
*-V*, *--version*::
Output version information and exit.
2021-10-07 20:08:56 +02:00
Configuration
-------------
You can start your _sdtui.conf_ file with the following snippet:
[Settings]
center-search = true # Ensure visibility of preceding entries?
underline-last = false # Underline the last line of entries?
hl-common-prefix = true # Highlight the longest common prefix?
watch-selection = true # Watch X11 selection for changes?
The _watch-selection_ option makes the application watch the X11 PRIMARY
selection for changes and automatically search for any selected text.
This feature requires XCB. Wayland is currently unsupported,
but would require a compositor supporting the wlr-data-control protocol.
Luckily, some compositors, such as Sway, synchronize selections with Xwayland.
To set up automatically loaded dictionaries, use the following scheme:
// AsciiDoc would otherwise like to process tildes as a long subscript.
:tilde: ~
2021-10-07 20:08:56 +02:00
[subs="normal"]
[Dictionaries]
_name 1_ = __{tilde}/path/to/dict.ifo__
_name 2_ = __{tilde}/another/dict.ifo__
2021-10-07 20:08:56 +02:00
The left-hand side keys define their appearance in the tab bar.
Finally, to make the program look nicer in 256color black-on-white terminals,
rather than rely on the universal default, try:
[Colors]
header = reverse
header-active = ul
search = ul
even = 16 231
odd = 16 255
Terminal attributes are accepted in a format similar to that of *git-config*(1),
only named colours aren't supported.
Extensions
----------
Because the StarDict file format is a bit of a clusterfuck with regard to
collation of dictionary entries, this software introduces an additional,
optional "collation" field into the '.ifo' file. When *sdtui* discovers this
field while reading a dictionary, it automatically reorders the index according
to that locale (e.g., "cs_CZ"). This operation may take a little while,
in the order of seconds.
Files
-----
2021-10-07 20:08:56 +02:00
*sdtui* follows the XDG Base Directory Specification.
_~/.config/sdtui/sdtui.conf_::
2021-10-07 20:08:56 +02:00
The configuration file.
Reporting bugs
--------------
Use https://git.janouch.name/p/sdtui to report bugs, request features,
or submit pull requests.
2021-10-07 20:08:56 +02:00
See also
--------
*dictzip*(1)