andponlin/deen

Simple German-English Bi-lingual Dictionary Program

Deen

Deen is a simple German-English bi-lingual dictionary program. It provides only a simple prefix-search, but that's actually fairly helpful. The indexing process takes a very long time, but this only needs to happen initially.

Contact / Author

Andrew Lindesay [email protected] (web)

License

Please see the LICENSE.TXT file for the license that governs the use of this software.

Building

This software is designed to be built and run in a UN*X-like environment. To build this software requires;

• C-Compiler
• make build tool
• flex parser generator tool
• wget file-download tool
• unzip decompression tool
• Internet connection to download sqlite3 library

To build the software run the make command at the top level. This will fairly quickly produce a deen executable. If you want to get a debug build use make DEBUG=1.

Windows

Deen will build on the MinGW environment. You will need to ensure that the prerequisite tools listed above are installed using the MinGW installation tool.

Debian / Ubuntu

Your installation should have the tools required to build, but in case not;

sudo apt-get install wget flex make unzip gcc

macOS

Install the Apple developers' tools.

Haiku-OS

The Haiku default install should have all the tools necessary to compile deen.

Installation

There is presently no installation target so just use the resultant binary directly. This is either deen or deen.exe on Windows.

Release

To release a Deen version, edit the version number in the Makefile. To obtain a release version;

make clean
make

Data

The data used with Deen comes from a project known as Ding. You will need to download Ding's data to use Deen. At the time of writing this data can be found here. You will need to decompress the Ding data before use. By default, Deen will install the data into a .deen directory in the user's home directory. To specify another location where Deen should store its data, configure an environment variable DEENDATAHOME.

Removal

If you no longer want to use Deen then you should delete this directory as well as the Deen binary. See the "Data" section for information on the location of this directory.

Command Line Tool Usage

The deen command can be run with no arguments to see what options can be used with it.

Installation

To install the data and index it, you need to run the deen tool as follows;

deen -i de-en.txt

This will take some time to complete. It will output to the console to indicate what it is doing.

Searching

To search for an entry, you run deen as follows;

deen Werkzeug

If you would like to find entries with two words then provide those as one argument by quoting them.

deen "astronaut launch"

In most modern terminals, the software should be able to cope with "umlaut characters" or the "scharfes S". If your terminal doesn't support such characters, Deen can also handle abbreviations such as "ae" and "oe" (as in "Koenig") and will translate those latinizations to the corresponding accented characters.

Deen only shows a small number of the results. Use the -c option to opt to show more or less results.