sdcv(1) - f38

1SDCV(1)                     General Commands Manual                    SDCV(1)
2
3
4

NAME

6       sdcv - console version of StarDict program
7

SYNOPSIS

9       sdcv [ options ] [list of words]
10

DESCRIPTION

12       sdcv  is  a  simple, cross-platform text-based utility for working with
13       dictionaries in StarDict format.  Each word from "list of words" may be
14       a  string with a leading '/' for using a Fuzzy search algorithm, with a
15       leading '|' for using full-text search, and the string may contain  '?'
16       and '*' for regexp search.  It works in interactive and non-interactive
17       mode.  To exit from interactive  mode  press  Ctrl+D.   In  interactive
18       mode,  if  sdcv was compiled with readline library support, you can use
19       the UP and DOWN keys to cycle through history.
20

OPTIONS

22       -h  --help
23               Display help message and exit
24
25       -v --version
26               Display version and exit
27
28       -l --list-dicts
29               Display list of available dictionaries and exit
30
31       -u --use-dict filename
32               For search use only dictionary with this bookname
33
34       -n --non-interactive
35               For use in scripts
36
37       -x --only-data-dir
38               For use in scripts: only use the dictionaries in  data-dir,  do
39               not search in user and system directories
40
41       -e --exact-search
42               Do  not  fuzzy-search  for  similar  words,  only  return exact
43               matches
44
45       -j --json
46               Print the results of list-dicts and searches as  json,  not  as
47               plain text.  For use in automatically processing the results of
48               a dictionary lookup.
49
50       --utf8-output
51               Force sdcv to not convert to locale charset, output in utf8
52
53       --utf8-input
54               Force sdcv to not convert from locale charset, assume that  in‐
55               put is in utf8
56
57       --data-dir path/to/directory
58               Use  this directory as the path to the stardict data directory.
59               This means that sdcv searches for dictionaries in  data-dir/dic
60               directory.
61
62       --color Use ANSI escape codes for colorizing sdcv output (does not work
63               with json output).
64

FILES

66       /usr/share/stardict/dic
67
68       $(XDG_DATA_HOME)/stardict/dic
69
70              Place where sdcv  expects  to  find  dictionaries.   Instead  of
71              /usr/share/stardict/dic you can use any directory you want, just
72              set the STARDICT_DATA_DIR environment variable.  For example, if
73              you have dictionaries in /mnt/data/stardict-dicts/dic, set STAR‐
74              DICT_DATA_DIR to /mnt/data/stardict-dicts.
75
76       $(XDG_DATA_HOME)/sdcv_history
77
78              This file includes the last $(SDCV_HISTSIZE)  words,  which  you
79              sought  with  sdcv.  SDCV uses this file only if it was compiled
80              with readline library support.
81
82       $(XDG_CONFIG_HOME)/sdcv_ordering
83
84              This is a text file containing one dictionary bookname per line.
85              It  specifies  in  which order the results of a search should be
86              shown.
87

ENVIRONMENT

89       Environment Variables Used By sdcv:
90
91       STARDICT_DATA_DIR   If set, sdcv uses this variable as the data  direc‐
92                           tory, this means that sdcv searches dictionaries in
93                           $STARDICT_DATA_DIR/dic
94
95       SDCV_HISTSIZE       If set, sdcv writes  in  $(XDG_DATA_HOME)/sdcv_his‐
96                           tory  (or  $(SDCV_HISTFILE))  the last $(SDCV_HIST‐
97                           SIZE) words, which you look up using sdcv. If it is
98                           not  set,  then  the  last  2000 words are saved in
99                           $(XDG_DATA_HOME)/sdcv_history.
100
101       SDCV_HISTFILE       If set, sdcv writes it's  history  to  $(SDCV_HIST‐
102                           FILE).   If   it  is  not  set,  then  the  default
103                           $(XDG_DATA_HOME)/sdcv_history path will be used.
104
105       SDCV_PAGER          If SDCV_PAGER is set, its value is used as the name
106                           of the program to use to display the dictionary ar‐
107                           ticle.
108

BUGS

110       Email bug reports to dushistov at mail dot ru. Be sure to  include  the
111       word "sdcv" somewhere in the "Subject:" field.
112

AUTHORS

114       Evgeniy A. Dushistov, Hu Zheng
115