Inteligenta vortaro de Esperanto / An intelligent Esperanto dictionary
Switch branches/tags
Clone or download
Latest commit 737e458 Dec 3, 2016
Permalink
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
README.md Simplify virtualenv creation Dec 3, 2016
TODO further TODO updates, some UI simplification and minor polish Oct 20, 2010
__init__.py settings (so import is reliable), adding __init__.py files for comple… Oct 28, 2010
_test_parser.py Allow whole -e words in word building Dec 3, 2016
fabfile.py Use collectstatic in production. Sep 28, 2014
initialise_database.py Allow whole -e words in word building Dec 3, 2016
manage.py 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
settings.py Set CORS headers so it's possible to use the API from JS. Mar 21, 2015
urls.py Allow viewing the 500 page during dev. Sep 28, 2014
wsgi.py Use dj_static to serve static content during both dev and prod. Sep 28, 2014

README.md

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.

Development

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 manage.py 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 manage.py flush
$ python manage.py shell
In [1]: %run initialise_database.py

Running the tests

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

$ python manage.py test

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

$ DJANGO_SETTINGS_MODULE=settings python _test_parser.py

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

Deployment

Make sure you turn off debug in settings.py.