% dingonyms(1) for ding	Version 0.5

NAME

dingonyms — basic synonym/antonym lookup tool

SYNOPSIS

dingonyms "word"

dingonyms [--thesaurus] [--merriamwebster] [--wordhippo] "find"

dingonyms [--openthesaurus	--woxikon	--urban] "Wort"
dingonyms [--reverso	--fr	--es	--it	--jp] "bonjour"

dingonyms [--no-antonyms] [--async] --all "word"

dictcc [en-es	en-ru	de-nl	de-it] "translate"

DESCRIPTION

To be used as lookup tool for ding(1). Scans the specified online service for synonyms.
It's not very useful as CLI tool by itself, because of the particular dict formatting.

PARAMS

Parameters can be introdoced with any combination of - or -- dashes or + signs.
Most can also be abbreviated (should cover some typos).

Parameter	Aliases	Class
--thesaurus	-t --thes	EN
--merriamwebster	-mw --merr --webster --merweb	EN
--synonym	-s --syn --synonym.com	EN
--reverso	--rev // -fr -es -it -pt -nl -ru -jp	EN/**
--wordhippo	-hippo --wordhip	EN
--mobythesaurus	-mby --moby	EN
--urban	-u --urb --ubn	LEXICON
--dictcc	--en-es --en-it --de-fr --en-pt	DICT
--openthesaurus	-ot --othes --open	DE
--woxikon	-wx --woxi	DE
--synonyme_de	-sd --desyn	DE
--all	(-t +mw +syn +rev +ot +wx +urban)	MIXED
--en	(-t +mw +syn +rev)	MIXED
--de	(-ot -wx -sd)	MIXED
--no-antonyms	-na	FLAG
--no-headers	-nh	FLAG
--async	--parallel ++io	FLAG

They can also be combined (dingonyms -t -mw -u "find"), so two or more services get queried at once.

• And obviously there's also --all to query most supported sites.
• While --en and --de combine the other main services.
• Reverso offers some alternative languages (-fr, -it, -ru).
• And --dictcc that allows for pair-language specifiers (-en-tr, -de-fr)

Execution flags should/must be noted before any translation service:

• The --no-antonyms flag isn't consistently supported by all backends. (It's actually more effort to skip around unwanted data, rather just outputting it as it comes in.)
• --no-headers to omit the "✎ {Sitename}" titles before any output.
• And --asnyc speeds up the processing of multiple sites, at the cost of potentially intermingling their output. It's a rather crude threading scheme, and no care has been taken to rewrite dingonyms to fully support that. It's primarily meant for --all and --de, --en. There's preliminary support for asyncing selected sites as well (e.g. dingonyms --async ++thes ++merr ++urb "word"), where it would be less likely mash up antonyms. (The execution speed of the regex+print loops determines if there's any mashup whenever HTTP requests complete at the same time.)

DICTCC

The dictcc mode is special, in that it provides an actual translation dictionary between different languages. The default mode is en→de, but alternative --from-to options can be specified. Additionally there's a commandline shortcut just for this backend:

dictcc en-it -- "translate"

The -- is optional as is the --lng-lng dash prefix. Otherwise it's the same as invoking dingonyms.

CONFIG

The search services can be configured through the GUI (somewhat fiddly with Change+New). Alternatively via dingonyms --setup for a single entry.
Or by editing ~/.dingrc directly. To have all services present for example:

set searchmeth(3,name) {Synonyms}
set searchmeth(3,type) {3}
set searchmeth(3,dictfile) {}
set searchmeth(3,separator) { :: }
set searchmeth(3,language1) {Group}
set searchmeth(3,language2) {Synonyms}
set searchmeth(3,grepcmd) {dingonyms}
set searchmeth(3,grepopts) {--thesaurus}
set searchmeth(3,maxlength) {30}
set searchmeth(3,maxresults) {200}
set searchmeth(3,minlength) {2}
set searchmeth(3,shapedresult) {1}
set searchmeth(3,foldedresult) {0}
set searchmeth(4,name) {Merriam-Webster}
set searchmeth(4,type) {3}
set searchmeth(4,dictfile) {}
set searchmeth(4,separator) { :: }
set searchmeth(4,language1) {Group}
set searchmeth(4,language2) {Synonym}
set searchmeth(4,grepcmd) {dingonyms}
set searchmeth(4,grepopts) {--merriamwebster}
set searchmeth(4,maxlength) {30}
set searchmeth(4,maxresults) {200}
set searchmeth(4,minlength) {2}
set searchmeth(4,shapedresult) {1}
set searchmeth(4,foldedresult) {0}
set searchmeth(5,name) {OpenThesaurus}
set searchmeth(5,type) {3}
set searchmeth(5,dictfile) {}
set searchmeth(5,separator) { :: }
set searchmeth(5,language1) {Group}
set searchmeth(5,language2) {Synonyms}
set searchmeth(5,grepcmd) {dingonyms}
set searchmeth(5,grepopts) {--openthesaurus}
set searchmeth(5,maxlength) {30}
set searchmeth(5,maxresults) {200}
set searchmeth(5,minlength) {2}
set searchmeth(5,shapedresult) {1}
set searchmeth(5,foldedresult) {0}
set searchmeth(6,name) {Urban}
set searchmeth(6,type) {3}
set searchmeth(6,dictfile) {}
set searchmeth(6,separator) { :: }
set searchmeth(6,language1) {Word}
set searchmeth(6,language2) {Definition}
set searchmeth(6,grepcmd) {dingonyms}
set searchmeth(6,grepopts) {--urban}
set searchmeth(6,maxlength) {30}
set searchmeth(6,maxresults) {200}
set searchmeth(6,minlength) {2}
set searchmeth(6,shapedresult) {1}
set searchmeth(6,foldedresult) {0}

Beware not to overwrite existing/custom entries.
If the entries don't show up, ding might not see dingonyms in the PATH:

SETUP

ding started from the Desktop environment might not find dingonyms, if installed per pip. You'll have to symlink it:

ln -s ~/.local/bin/dingonyms ~/bin/

Or reconfigure ~/.profile to generally include ~/.local/bin (which doesn't seem to be standard in most distros).

SEE ALSO

ding(1), python(1)