Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Zhudi is a graphical interface to xDICT kind of free dictionaries.
Python Shell
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
doc
scripts
zhudi-data
zhudi
.gitignore
COPYING.tex GPLv3 licence text
NEWS
PKGBUILD
README.md
dict_test.u8
setup.py
test_cli.py
tests.py
zhudi.install

README.md

What is Zhudi?

Zhudi is a graphical interface to CEDICT, CFDICT, HanDeDict, ChE-Dicc). Therefore, it allows you to have a Chinese to English, French, German and Spanish dictionary.

Zhudi is designed to help users by providing them good choices. Consequently, a Bopomofo engine is included to provide pronunciation along with pinyin. Traditional and simplified characters are fully supported too.

What platforms are supported?

Since this project is written in Python 3, it should be able to run on any given platform. However, I only have tested it under GNU/Linux.

Currently, Zhudi can easily be installed on Archlinux from AUR.

What are the dependencies of Zhudi?

In order to run Zhudi, you need the following packages:

  • python 3+
  • python-gobject
  • pygobject-devel
  • gobject-introspection

Versions

Version 0.9 is made to work with python2 and is now obsolete. You should use version 1.0 and later instead.

Installation

Archlinux

Zhudi is available in AUR.

Others

You may install it thanks to Python setup tools:

python setup.py install

Launching

Zhudi can be launched from the command line by providing it proper files.

First launch

When you first launch Zhudi, you need to provide a dictionary file. You are free to use the one you like among:

You have to download the *.u8 version of the dictionary for using with Zhudi. Once you have downloaded it, simply run Zhudi to prepare the dictionary for future uses. Here is an example with the CEDICT dictionary (cedict.u8):

zhudi -s cedict.u8

When Zhudi is finished, it would have created 5 files: pinyin, zhuyin, simplified, traditional and translation.

Normal usage

When the previous 5 files are created, you can simply launch Zhudi:

zhudi -p pinyin -z zhuyin -tr translation -td traditional -sd simplified

However, you can just copy these files in your ~/.zhudi/ directory and launch Zhudi without arguments:

zhudi

Testing

As zhudi is using Python's setup tools, you can always "install" the developpment version as follow:

python setup.py develop

From now on, zhudi of your system is actually a link to the developpment directory, so you can modify things, and test them on the fly, without re-installing.

Unit tests

dict_test.u8 is used to test the splitting of the dictionary, and then for the rest of the unittests.

First, test that splitting the dictionary is working well:

python test_cli.py

Then, test the rest of the units:

python tests.py
Something went wrong with that request. Please try again.