Inteligenta vortaro de Esperanto / An intelligent Esperanto dictionary
Switch branches/tags
Clone or download
Latest commit 737e458 Dec 3, 2016
Type Name Latest commit message Commit time
Failed to load latest commit information.
api API should not crash when Morphemes have no primary word Dec 3, 2016
static Documenting search API. Sep 28, 2014
templates Format all the 'neniu trovita' messages consistently. Sep 28, 2014
vortaro Morpheme repr() should not crash if we have no primary word Dec 3, 2016
.gitignore Don't check in the word db Dec 3, 2016
.travis.yml Updating requirements path for travis file. Sep 21, 2014
COPYING added informative readme and copyright stuff Sep 18, 2010
DEPLOY use normal template on 500 error page and update deploy notes Nov 30, 2010 Simplify virtualenv creation Dec 3, 2016
TODO further TODO updates, some UI simplification and minor polish Oct 20, 2010 settings (so import is reliable), adding files for comple… Oct 28, 2010 Allow whole -e words in word building Dec 3, 2016 Use collectstatic in production. Sep 28, 2014 Allow whole -e words in word building Dec 3, 2016 Upgrading to Django 1.6. Sep 28, 2014
requirements.txt Set CORS headers so it's possible to use the API from JS. Mar 21, 2015
requirements_pinned.txt Set CORS headers so it's possible to use the API from JS. Mar 21, 2015 Set CORS headers so it's possible to use the API from JS. Mar 21, 2015 Allow viewing the 500 page during dev. Sep 28, 2014 Use dj_static to serve static content during both dev and prod. Sep 28, 2014

Build Status Coverage Status Requirements Status

La Simpla Vortaro is a Django website intended to push what's possible with online Esperanto dictionaries.

The main areas of interest:

  • built on Django
  • simple, logical interface
  • spell checking and orthography flexibility (unicode, x-system, h-system)
  • morphology analysis
  • definitions courtesy of La Reta Vortaro

AGPLv3 licence, see COPYING for details.


Create a virtual environment:

$ mkvirtualenv simpla -p `which python2`
$ pip install -r requirements_pinned.txt

Then copy word.db from the GitHub downloads page for this project. It should be in the root of the project with the name word_db. Finally:

$ python runserver

Creating a database

You can create a database of definitions from the XML files provided by Reta Vortaro. Use ReVo-utilities to create a JSON file of definitions.

Copy the JSON file to the root of the project and call it dictionary.json. You can then create a database with:

$ python flush
$ python shell
In [1]: %run

Running the tests

The unit tests (as run by Travis) have no dependencies, and can be run with:

$ python test

The word parsing tests require the full dictionary dataset. Make sure you have word_db set up.

$ DJANGO_SETTINGS_MODULE=settings python

Updating requirements

You can find out which packages are out of date with:

$ pip-review

We also keep a dump of a known-good set of packages, which you can update with:

$ pip freeze > requirements_pinned.txt


Make sure you turn off debug in