Merge branch 'master' of https://github.com/LQDJudge/online-judge
This commit is contained in:
cuom1999
commit
a1b82aadbc
1 changed files with 108 additions and 17 deletions
125
README.md
125
README.md
|
|
@ -1,25 +1,116 @@
|
|||
# online-judge
|
||||
### 1. Activate virtualenv:
|
||||
LQDOJ: Le Quy Don Online Judge
|
||||
===
|
||||
|
||||
[](https://lqdoj.edu.vn/)
|
||||
[](https://python.org)
|
||||
[](https://ubuntu.com/download)
|
||||
[](https://www.gnu.org/licenses/agpl-3.0.en.html)
|
||||
|
||||
## Overview
|
||||
|
||||
Homepage: [https://lqdoj.edu.vn](https://lqdoj.edu.vn)
|
||||
|
||||
Based on [DMOJ](https://dmoj.ca/).
|
||||
|
||||
Supported languages:
|
||||
|
||||
- Assembly (x64)
|
||||
- AWK
|
||||
- C
|
||||
- C++03 / C++11 / C++14 / C++17
|
||||
- Java 11
|
||||
- Pascal
|
||||
- Perl
|
||||
- Python 2 / Python 3
|
||||
|
||||
Support plagiarism detection via [Stanford MOSS](https://theory.stanford.edu/~aiken/moss/).
|
||||
|
||||
## Installation
|
||||
|
||||
Most of the setup are the same as DMOJ installations. You can view the installation guide of DMOJ here: https://docs.dmoj.ca/#/site/installation.
|
||||
There is one minor change: Instead of `git clone https://github.com/DMOJ/site.git`, you clone this repo `git clone https://github.com/LQDJudge/online-judge.git`.
|
||||
|
||||
Some frequent difficulties when installation:
|
||||
|
||||
1. Missing the `local_settings.py`. You need to copy the `local_settings.py` in order to pass the check.
|
||||
2. Missing the problem folder in `local_settings.py`. You need to create a folder to contain all problem packages and configure in `local_settings.py`.
|
||||
3. Missing static folder in `local_settings.py`. Similar to problem folder, make sure to configure `STATIC_FILES` inside `local_settings.py`.
|
||||
4. Missing configure file for judges. Each judge must have a seperate configure file. To create this file, you can run `python dmojauto-conf`. Checkout all sample files here https://github.com/DMOJ/docs/blob/master/sample_files.
|
||||
|
||||
## Usage
|
||||
|
||||
Suppose you finished all the installation. Everytime you want to run a local server, follow these steps:
|
||||
|
||||
1. Activate virtualenv:
|
||||
```bash
|
||||
source dmojsite/bin/activate
|
||||
### 2. Remember to change the local_settings
|
||||
```
|
||||
|
||||
### 3. Run server:
|
||||
2. Run server:
|
||||
```bash
|
||||
python manage.py runserver 0.0.0.0:8000
|
||||
```
|
||||
|
||||
### 4. Create configure file for judge:
|
||||
python dmojauto-conf
|
||||
3. Create a bridge (this is opened in a different terminal with the second step if you are using the same machine)
|
||||
```bash
|
||||
python manage.py runbridged
|
||||
```
|
||||
|
||||
### 5. Create folder for problems, change the dir in judge conf file and local_settings.py
|
||||
4. Create a judge (another terminal)
|
||||
```bash
|
||||
dmoj 0.0.0.0 -p 9999 -c <path to yml configure file>
|
||||
```
|
||||
Here we suppose you use the default port 9999 for bridge in `settings.py`. You can create multiple judges, each should be in a seperate terminal.
|
||||
|
||||
### 6. Connect judge:
|
||||
+ python manage.py runbridged
|
||||
+ dmoj 0.0.0.0 -p 9999 -c judge/conf1.yml (depend on port in the local_settings.py and directory of conf file)
|
||||
**Optional**
|
||||
|
||||
### 7. Update vietnamese translation:
|
||||
- go to locale/vi
|
||||
- modify .po file
|
||||
- python manage.py compilemessages
|
||||
- python manage.py compilejsi18n
|
||||
5. Run celery worker (This is server's queue. It may be necessary in some functions)
|
||||
```bash
|
||||
celery -A dmoj_celery worker
|
||||
```
|
||||
|
||||
###8. Run chat server:
|
||||
docker run -p 6379:6379 -d redis:2.8
|
||||
6. Run a live event server (So everything is updated lively like in the production)
|
||||
```bash
|
||||
node websocket/daemon.js
|
||||
```
|
||||
|
||||
## Deploy
|
||||
Most of the steps are similar to Django tutorials. Here are two usual steps:
|
||||
|
||||
1. Update vietnamese translation:
|
||||
- If you add any new phrases in the code, ```python manage.py makemessages```
|
||||
- go to `locale/vi`
|
||||
- modify `.po` file
|
||||
- ```python manage.py compilemessages```
|
||||
- ```python manage.py compilejsi18n```
|
||||
|
||||
2. Update styles (using SASS)
|
||||
- Change .css/.scss files in `resources` folder
|
||||
- ```./make_style && python manage.py collectstatic```
|
||||
- Sometimes you need to `Ctrl + F5` to see the new user interface in browser.
|
||||
|
||||
## Screenshots
|
||||
|
||||
### Leaderboard
|
||||
|
||||
Leaderboard with information about contest rating, performance points and real name of all users.
|
||||
|
||||
|
||||
|
||||
### Admin dashboard
|
||||
|
||||
Admin dashboard helps you easily managing problems, users, contests and blog posts.
|
||||
|
||||
|
||||
|
||||
### Statement editor
|
||||
|
||||
You can write the problems' statement in Markdown with LaTeX figures and formulas supported.
|
||||
|
||||
|
||||
|
||||
### Chat
|
||||
|
||||
Users can communicate with each other and can see who's online.
|
||||
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue