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

================================
 Installing gadict dictionaries
================================
.. contents::
   :local:

Downloading
===========

Official sources and compiled builds are available at:

* http://gadict.defun.work/download/
* https://sourceforge.net/projects/gadict/files/

Compiled tarball provide dictionaries in different formats:

* ``dict.dz`` for use with ``dictd``. Goldendict and other end used dictionary
  programs understand this format.

Compiled tarballs have names like::

  gadict-$major.$minor.tar.bz2

Source tarballs have names like::

  gadict-$major.$minor_src.tar.gz

Manual installation instruction for GoldenDict.
===============================================

Get distribution tarboll and extract all files to any directory. Select::

 Edit ==> Dictionaries...

in GoldenDict menu (or just press ``F3``) and add directory to where you
extracted files. Press ``Refresh`` button. That's all.

**Note** only ``*.dict.dz`` and ``*.index`` files are required for GoldenDict.
You can safely remove other fils.

How to build and install from supplied Makefile.
================================================

To build and install in /usr/local/ run as root::

  $ make install

If you run as regular user ``prefix`` set to::

  $HOME/usr

To build and install in different place run::

  $ make install prefix=PREFIX

How to uninstall from supplied Makefile.
========================================

To uninstall run one command from list accordingly to installation procedure::

  $ make uninstall
  $ make uninstall prefix=PREFIX
  $ make prefix=PREFIX uninstall uninstall-local-symlink