Skip to content
NickRuiz edited this page Nov 8, 2010 · 9 revisions

Welcome to the WikiTrans-Pootle wiki!

WikiTrans is an open-source machine translation project that is intended for use with the Wikipedia community. Using Pootle as a platform, users are able to request translations of Wikipedia articles into various languages. The user community can review and post-edit machine translations before submitting the new article to Wikipedia. Eventually, these post-edits will be used to update the MT systems.

This project is a branch from the original wikitrans project, located here: http://github.com/j2labs/wikitrans. The purpose of this project is to integrate WikiTrans with Pootle and eventually replace the original wikitrans project.

Documentation

  • See license for more information.

Dependencies

  • MT Server Land (Git project)
  • httplib2>=0.6.0
  • libxml2-dev
  • lxml
  • mwlib>=0.8
  • nltk==2.0b7
  • pycountry>=0.12.1

See requirements.txt for a PIP-friendly list of libraries to install.

(An installation script is provided to attempt to retrieve this project from GitHub and to install all necessary dependencies. However, you will need to install MT Server Land yourself.)

Quick Setup Guide (Linux)

1. Install Python 2.6.×.

2. Before retrieving this project from GitHub, try to use the installation script provided in dependencies/install.sh (requires sudo access).

The following information needs to be updated before running:
GIT_PARENT_DIRECTORY="/path/to/my/parent/dir"

3. Assuming that the installation script runs successfully, execute nltk_config.py to prepare NLTK for sentence parsing.

4. Prepare development database (See next section)

5. (Optional) In order to handle translations on your local machine, you will need MT Server Land. Please see MT Server Land for installation and configuration instructions.

6. With MT Server Land, create an account and generate an authentication token (MT Server Land’s API uses this token to allow you to manage your translations).

7. Identify the URI for MT Server Land’s XML-RPC server. This is used to access the API for translations.

8. Open localsettings.py and modify the variables listed below.

9. python PootleServer <port> (By default, the server runs on port 8080.)

10. Point your browser to http://localhost:8080.

# MT Serverland Configuration
SERVERLAND_TOKEN = '7594f0db'
# TODO: Currently the Serverland protocol uses a XML-RPC server to issue a translation request.
SERVERLAND_XMLRPC = 'http://0.0.0.0:6666'

More details to be added soon. If you have any questions, please contact Nick Ruiz (NickRuiz on GitHub).

Setting Up the Development Database

Use python manage.py syncdb to create the necessary database file. Answer “yes” when the creation of a superuser account is proposed. Enter a username, an email address and the corresponding password. This user will have ALL privileges.