.. -*- coding: utf-8 -*-

================================

 Installing gadict dictionaries

================================

.. contents::

   :local:

Downloading

===========

Official sources tarballs and compiled builds are available at:

* http://gadict.defun.work/download/

* https://sourceforge.net/projects/gadict/files/

Compiled tarball provides:

* Compiled dictionaries (with extension ``.dict.dz``) and indexes (with

  extension ``.index``) in ``/dictd`` directory for use with ``dictd``.

  Goldendict and other end used dictionary programs understand this format.

* Documentation in plain text in ``/doc/txt`` directory (with extension

  ``.rst``) and in HTML in ``/doc/html`` directory (with extension ``.html``).

* Import files in Packaged Anki Desk format for Anki and AnkiDroid software in

  ``/srs`` directory (files with extension ``.apkg``). Do not forget to enable

  random order of cards review!

* Import files in TAB format for SRS software in ``/srs`` directory (files with

  extension ``.tab.txt``). Anki, Mnemosyne, Anymemo and many other SRS packages

  able to import TAB files. Don't forget to enable HTML markup on import!

Compiled tarballs have names like::

  gadict-$major.$minor.tar.gz

  gadict-$major.$minor.zip

Source tarballs have names like::

  gadict-$major.$minor_src.tar.gz

Installation instruction for GoldenDict

=======================================

Get distribution tarball and extract files from ``dictd`` directory in desired

place.

Select ``Edit ==> Dictionaries...`` in GoldenDict menu (or just press ``F3``)

and add directory where you extracted files. Press ``Refresh`` button and enjoy!

.. NOTE:: Only ``*.dict.dz`` and ``*.index`` files are required for GoldenDict.

To build and install to ``/usr/local/`` run as root::

  $ make install

For regular user ``prefix`` is set to::

  $HOME/usr

To install to different place run::

To uninstall run one of::

  $ make uninstall

Register dictionaries in dictd server in Debian

===============================================

For given directory ``/home/user/usr/share/dictd/``::

  $ su

  # cat >>/etc/dictd/dictd.order <<EOF

  gadict

  /home/user/usr/share/dictd/

  ^D

  # dictdconfig --write

  # /etc/init.d/dictd restart

  ^D

  $ dictdconfig --list

  $ dict -d gadict v