Skip to content

Latest commit

 

History

History
79 lines (62 loc) · 3 KB

README.md

File metadata and controls

79 lines (62 loc) · 3 KB
Raw

IOI Translation System

The IOI Translation System provides a web interface for translating the tasks (problems) into various languages during the International Olympiads in Informatics. The system has been developed and first used in the IOI 2017 in Tehran, Iran.

This fork is used in IOI 2020, Singapore.

Features

  • Markdown editor with mathematical expressions support
  • Support for right-to-left and southeastern languages
  • Embedded printing system
  • User-friendly editing environment with parallel view
  • PDF generation with custom fonts
  • Revision history with diff mode
  • Handy notification system
  • Full-featured admin page
  • Support for multiple contests
  • Dockerized and easy to develop and deploy

Deployment

ioi-translation is designed to be deployed on a Docker-compatible container platform. PostgreSQL and Redis are required for persistent storage and session store, respectively. Deployment behind reverse proxy such as nginx is recommended.

See docker-compose.yml for example deployment configurations (Note that docker-compose.yml in this repository is for development and not intended for use in production deployment).

Development Installation

You can install the translation system in just three steps:

  1. Install docker and docker-compose.
  2. Clone the project on your machine.
  3. Run docker-compose up -d.

At this point, you will have a copy of the translation system up and running at http://your_server_address:9000/. You may optionally perform the following tasks:

  • To create essential data for the system such as admin users and groups, run docker-compose exec app bash after the system has been started, and then in the shell, execute python3 manage.py loaddata initial_data.json for the very first time. Then exit from the shell by typing exit.
  • The default users are:
    • admin:ioipassword
    • staff:ioipassword
    • ISC:ioipassword
    • Usernames and passwords are case-sensitive.
  • For importing data such as countries, languages, and sample tasks, use the CSV importer in the admin console.
  • You can get access to the system logs by running docker-compose logs. To follow the logs from now on, run docker-compose logs -f --tail=0.
  • To stop the system, run docker-compose stop.

For using docker in development settings, add --reload option to the execution line of gunicorn in docker-entrypoint.sh file. Then run docker by docker-compose up --build.

Screenshots

Editing panel See more screenshots here.

License

This software is distributed under the MIT license, and uses third party libraries that are distributed under their own terms (see LICENSE-3RD-PARTY.txt).

Copyright

Copyright (c) 2017, IOI 2017 Host Technical Committee