This repository contains the source of the website of Prologin: https://prologin.org.
Prologin is a computer science contest in France open to all students under 20, introducing students to the world of programming and algorithms with exciting challenges.
- License
- Table of Contents
- Installation
- Hacking on the website
- Deploying the regional event environment
- Troubleshooting
This software is licensed under the GNU General Public License v3.0 or any later version.
Copyright © Association Prologin.
Running the Prologin website requires the following dependencies:
- Git
- Python 3
- NPM (for Javascript & CSS assets)
- PostgreSQL
- Redis (for training & contest)
- texlive (for latexmk, pdflatex, and a few packages).
You can use the following commands to install those dependencies:
-
For Archlinux:
sudo pacman -S --needed git python3 npm postgresql imagemagick redis \ texlive-core sudo systemctl enable --now redis -
For Ubuntu and Debian ≥ 10 (buster):
sudo apt install git python3 python3-venv npm postgresql imagemagick \ redis-server texlive -
For Debian ≤ 9 (stretch)
curl https://deb.nodesource.com/setup_8.x | sudo bash sudo apt install git python3 python3-venv nodejs postgresql imagemagick \ redis-server texlive
You need to have access to a running PostgreSQL instance to setup the Prologin database. If you don't have that already, this section contains information to setup PostgreSQL for the first time:
-
for Ubuntu and Debian, the previous step (installation) should be enough.
-
for Archlinux, you have to initialize the database cluster and enable
postgresql.service:sudo -u postgres initdb -D '/var/lib/postgres/data' sudo systemctl enable --now postgresql
-
for other platforms and more information, refer to the PostgreSQL installation documentation .
Once PostgreSQL is running, you also need an user that will have access to the Prologin database. The easiest way to achieve that is simply to create an account that has the same name as your username and that can create databases:
sudo -u postgres createuser --createdb $USERClone the website and the other Prologin repositories needed for the different modules of the website:
git clone [email protected]:prologin/concours/site.git
git clone [email protected]:prologin/concours/problems.git # Training exercises (private)
git clone [email protected]:prologin/concours/archives.git # Edition archives (private)
git clone [email protected]:prologin/asso/documents.git # Admin. documents (private)Then, enter the website directory:
cd site
Use a virtual environment to install the Python dependencies of the website:
python3 -m venv .venv
source .venv/bin/activate
pip install -U pip
pip install -r requirements.txtDownload the web dependencies from NPM:
( cd assets && npm install )Copy the sample configuration to a file of your choice. I recommend to use
dev.py for a development environment:
cp prologin/prologin/settings/{conf.sample,dev}.pyThe default settings should work by default if you are following this guide,
but if needed, you can edit prologin/prologin/settings/dev.py to adjust some
settings.
Create the prologin PostgreSQL database, and run the migrations :
createdb prologin
./prologin/manage.py migrate(Note: If you would rather work with an anonymized database dump of the website, ask one of the Prologin roots to provide you one.)
The website has to display some data about the current Prologin edition,
upcoming events, and the like. That is why it is necessary to setup at least
one Edition and the corresponding qualification (a.ka. QCM) Event. As the
website crashes intentionally without theses minimal objects, you can not add
them using the admin. Use the edition command instead:
./prologin/manage.py edition create
# Answer the questionsThis step is not required but in case you want to access the admin interface, you can create a super user:
./prologin/manage.py createsuperuser
# Answer the questionsEvery time you need to work on the website:
- Enter the virtualenv:
source .venv/bin/activate - Launch the local dev server:
make runserver
- If needed, you can launch a debug SMTP server to check that mails are
correctly sent with the right content. This will print the outbound mails on
the console.
make smtpserver
- If needed (mailing, training & contest submissions), you can launch a debug celery
worker:
make celeryworker
The website user-facing strings are internationalized through Django's internal i18n framework.
You can translate the strings locally by editing the .po files in your editor
or using a dedicated software such as poedit.
To ease the community translation process, it is possible to upload the
untranslated (English) strings to Transifex, ask people to translate them (eg.
using the Transifex web app) and download them back to the repository.
To that end, use the provided make commands:
# I've created/update source (English) strings, let's push them
# (we pull before to update local strings just in case)
make tx-pull tx-push
# ... translate on Transifex ...
# Get back the translated strings
make tx-pull
# Commit
git commit prologin/locale -m 'locale: update for <feature>'Go to https://prologin.org/docs/ and use the “Data export” orange button to obtain a JSON file you have to copy to the machine hosting the regional event website.
Follow the generic installation procedure, with the following differences:
- create the semifinal settings (eg.
prologin/settings/semifinal.py) using the following template:cp prologin/prologin/settings/{semifinal.sample,semifinal}.py - check that the settings match your database, edition, correctors etc.
- do not create the minimal context;
- don't forget to migrate the database for the next step;
- import the user data you previously exported:
# activate venv, export DJANGO_SETTINGS_MODULE ./prologin/manage.py semifinal_bootstrap export-semifinal-2016-center.json - during the initial setup, you may want to set
DEBUG = Truein the settings. Do not forget to set it toFalseduring the contest.
You can refer to this StackOverflow answer to fix the problem.