Skip to content
This repository has been archived by the owner on Jul 12, 2019. It is now read-only.

Latest commit

 

History

History
74 lines (57 loc) · 3.28 KB

README.md

File metadata and controls

74 lines (57 loc) · 3.28 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, used in IOI 2018, contains AWS S3 support for the file storage and CMS integration.

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). For the actual deployment in IOI 2018, refer to https://github.com/jcioi/ioi-htc (especially ECS and nginx configuration and CMS integration)

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:8000/. You may optionally perform the following tasks:

  • To create essential data for the system such as admin users and groups, run docker-compose exec web 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.
  • 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 dokcer-compose logs. To follow the logs from now on, run docker-compose logs -f --tail=0.
  • To stop the system, run dokcer-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