dmoj / docs Goto Github PK
View Code? Open in Web Editor NEWDocumentation for setting up and using the DMOJ judge.
Home Page: https://docs.dmoj.ca
Documentation for setting up and using the DMOJ judge.
Home Page: https://docs.dmoj.ca
In the Problem examples it says:
"Signature Grading (IOI-style) - implements https://dmoj.ca/problem/siggrade"
However, https://dmoj.ca/problem/siggrade leads to no problem
Most people seem to use site managed test data, but we don't mention how to set that up in the docs, so this question often pops up in the Slack.
Some of the file paths for sample files point to nonexistent files. These are mostly of the form name.example.ext
and should be refactored into sample_files/name.ext
hi im trying to install on google cloud platform. But while using nginx resources are not loading
Has not been updated since 2015, and the stats are very different now.
phantomjs
+ related settings
if site in docker and use nginx proxy , it may cause trouble ... fix it like
location ~ .*\.(js)$ {
add_header Content-Type application/javascript;
gzip_static on;
expires max;
root /website;
break;
}
location ~ .*\.(css)$ {
add_header Content-Type text/css;
gzip_static on;
expires max;
root /website;
break;
}
location /static {
gzip_static on;
expires max;
root /website;
}
A table of which executor needs what nodes, plus any extra useful info.
Executor | Required Nodes | Additional Info |
---|---|---|
Java 8 | java8 , javac8 |
Source will be compiled with -profile compact1 , for optimal performance if an EJRE is installed |
C++17 | g++17 |
— |
Site runs on Python 3 now, so all instances of Python 2 (e.g. python-dev
vs python3-dev
) should be replaced with their Python 3 counterparts.
Right now, the v1 API is documented here and the v2 API is document in this gist.
Some services choose to include the API documentation in their official documentation (such as Prometheus) but others don't.
What do we want to do for DMOJ? My vote is to include it in the official docs.
I can't run dmoj without a configuration file and I don't know how to build one.
For mathoid
and texoid
I have run dmoj-cli and it is working fine. But I don't understand the working of dmoj live judge. I am looking to integrate this into my custom site where I aim to submit the code to the judge and the judge must return the response (whether all the test cases have been passed or not). How can I achieve this?
Would be nice to have a reference of what builtin checker does what. A table like
Checker ID | Extra parameters | Description |
---|---|---|
standard |
— | describe whitespace-ignoring behaviour |
floats |
precision (float) |
describe abs/rel precision |
For all checkers in https://github.com/DMOJ/judge/tree/master/dmoj/checkers
I needed to run sudo apt install pkg-config
before I can run pip3 install mysqlclient
successfully. Add this command to the docs somewhere.
the dochment said
wsevent.conf to /etc/supervisor/conf/wsevent.conf
but it might be
wsevent.conf to /etc/supervisor/conf.d/wsevent.conf
CELERY_RESULT_BACKEND
is deprecated. We should remove it from the docs.
Later versions of autoprefixer
seem to not work with postcss
the way make_style.sh
uses it. We should pin specific versions.
Edit: It seems like version [email protected]
fixes it, or a fix might be coming soon (postcss/postcss-cli#344)?
home_page_top
, footer
, announcement
, analytics
, meta_description
T
should be passed as a argument to the generator, instead of from an input file.
Hi , i want to know which path should I put in the uwsgi.ini.
if the virtualenv is in /dmoj/
is chdir /dmoj/site? how about pythonpath?
I refer a lot on 'dmoj.readthedocs.io' when installing the site or adminstering(adding problems).
A printed version of the manual will be really helpful when doing those jobs.
Can you select the 'Generate PDF' on the read the docs admin panel?
🦀🦀🦀 PYTHON2 IS GONE🦀🦀🦀
In the installation guide, Celery is tested to see if it able to connect to Redis, but will result in an error as the Redis
package is not installed.
https://github.com/DMOJ/docs/blob/master/docs/site/installation.md?plain=1#L159
pip3 install Redis
should be ran before the command.
I'd be happy to open a PR to fix this, thank you!
docs/sample_files/local_settings.py
Lines 10 to 13 in 4034f22
Find or create a better key creator. As shown below, this website is full of ads and is annoying to use.
Math on docs/problem_format/custom_checkers.md
and docs/problem_format/custom_graders.md
is rendered incorrectly.
As of now, my break has started, so now it's time to update the docs with the changes from the site (like removing support for RabbitMQ), actually finishing the site docs, and rewrite the judge docs as of the judge major changes in structure. Here by I present a nice task list, which I will modify as I have done them:
uwsgi
way of running the site.More things will come here as time passes.
Having to copy an existing generator or peek at judge.py
every time I write a generator is just... bad.
There is no documentation for the output_limit_length
and output_prefix_length
fields specified in the init.yml
for a problem.
If we are going to say in the docs that we use python's glob module (which is fine), we should link to it.
git pull origin master
pip install -r requirements.txt
python manage.py migrate
python manage.py check
./make_style.sh
python manage.py collectstatic
python manage.py compilemessages
python manage.py compilejsi18n
Mention no guarantee of backwards compatibility; message us on Slack if you have doubts etc.
The database schema generated through the migrations do not support FTS. The indexes must be created manually:
ALTER TABLE judge_problem ADD FULLTEXT(code, name, description);
/update/problems
)Should expect users know how to set up NFS, and just describe the data pushing
The demo
fixture creates a default account with a username and password of admin
. This superuser account allows completely access to everything on the site, and isn't documented anywhere. Finding DMOJ instances with this account left is common in the Slack help channels.
Because the documentation explains how to create a superuser account shortly after the loaddata
command, the default admin:admin
one should be removed.
when I manage problems through the site interface and upload test data, i found that the data was upload on site directory, but I set problem_storage_root
to another path and the data between them can not sync, how can I solve this?
.*\.txt
A declarative, efficient, and flexible JavaScript library for building user interfaces.
🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. 📊📈🎉
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google ❤️ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.