Giter VIP home page Giter VIP logo

docs's Introduction

docs's People

Contributors

apoapsisalpha avatar avestura avatar carson-tang avatar ehhthing avatar fataleagle avatar fluix-dev avatar int-y1 avatar jdabtieu avatar jtyliu avatar kevinjycui avatar kiritofeng avatar malbareda avatar nils-emmenegger avatar ninjaclasher avatar ocadaruma avatar outloudvi avatar potatoeggy avatar pxpeterxu avatar quantum5 avatar riolku avatar walle256 avatar wesley-a-leung avatar xiaowuc1 avatar xyene avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar

docs's Issues

Doc on data sharing for judge clusters

  • NFS
  • Control server for pushing data changes
  • Monitor for each judge (/update/problems)

Should expect users know how to set up NFS, and just describe the data pushing

How do I integrate DMOJ judge into my website?

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?

Document setting up full text search

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);

Executor configuration

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 β€”

Document or remove default superuser account

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.

resources not loading

hi im trying to install on google cloud platform. But while using nginx resources are not loading

API documentation

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.

wsevent.conf β€˜s path

the dochment said

wsevent.conf to /etc/supervisor/conf/wsevent.conf

but it might be

wsevent.conf to /etc/supervisor/conf.d/wsevent.conf

problem_storage_root

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?

Remove link to a website that is full of ads

# SECURITY WARNING: keep the secret key used in production secret!
# You may use <http://www.miniwebtool.com/django-secret-key-generator/>
# to generate this key.
SECRET_KEY = 'This key is not very secure and you should change it.'

Find or create a better key creator. As shown below, this website is full of ads and is annoying to use.

Capture

Fix Sample File File Paths

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

Doc on updating site

  • 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.

Update Contest Formats

  • IOI -> IOI Legacy
  • Document ICPC format
  • Document IOI format based on 2016 rules
  • Document contest problem labels

Document DMOJ_PROBLEM_DATA_ROOT

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.

Generator documentation

Having to copy an existing generator or peek at judge.py every time I write a generator is just... bad.

add mine to js and css

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;
}

uwsgi.ini

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?

Docs review

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:

  • Removing RabbitMQ from the site docs.
  • Add the running project part.
  • Add the uwsgi way of running the site.
  • Rewrite the judge config docs.
  • Rewrite the problem formatting docs.
  • Update the problem examples.

More things will come here as time passes.

Update PY2 in docs to PY3

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.

misc_config docs

home_page_top, footer, announcement, analytics, meta_description

PDF Generation

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?

Math is rendered incorrectly

Math on docs/problem_format/custom_checkers.md and docs/problem_format/custom_graders.md is rendered incorrectly.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    πŸ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. πŸ“ŠπŸ“ˆπŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❀️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.