Differences

This shows you the differences between two versions of the page.

--- plugin:judge [2016-01-19 20:12] – removed Aleksandr
+++ plugin:judge [2020-02-01 17:09] (current) – Aleksandr
@@ Line 1: / Line 1: @@
+====== judge Plugin ======
+---- plugin ----
+description: Adds a judgement facility for computer science training wikis
+author     : S. M. Masoud Sadrnezhaad
+email      : masoud@sadrnezhaad.ir
+type       : syntax
+lastupdate : 2016-01-18
+compatible : !Binky, Ponder Stibbons
+depends    : sqlite
+conflicts  :
+similar    :
+tags       : judge, plugins
+downloadurl: https://github.com/smmsadrnezh/dokuwiki-plugin-judge/zipball/master
+bugtracker : https://github.com/smmsadrnezh/dokuwiki-plugin-judge/issues
+sourcerepo : https://github.com/smmsadrnezh/dokuwiki-plugin-judge/
+donationurl:
+screenshot_img :
+----
+//:!: This is a prereleased version. Don't use it in production environment unless you are sure about what you are doing.//
+**Note:** it's not compatible with [[:old_changes#release_2013-12-08_binky|Binky]] because it use template actions but it's compatible with last version.
+===== Description =====
+The aim of Judge system is to test the correctness of programs and user's answers to questions related to computer science. The main difference between this plugin and other similar judge systems is it's simplicity and minimalistic design and making use of integrated tools of a Wiki software for defining the questions and their answers or test cases. Other main features of this system is the dependency of where users submit their answers or write questions from the other system which run the codes and send back the result, simplicity of nominating a question for judgement, controlling user's access to questions, submissions or answers. The installation process is straightforward and do not need to hack the core of DokuWiki to use this system with.
+===== Installation =====
+Search and install the plugin using the [[plugin:extension|Extension Manager]]. Refer to [[:Plugins]] on how to install plugins manually.
+Set the directory which submission codes uploaded into after the installation. You must make this directory outside of directories which is in the web.
+:!: **External requirements:** This plugin requires the following additional components that must be installed separately:
+  * [[sqlite]] module for the web server you are using.
+===== Examples/Usage =====
+Use the following syntax to create a simple judge block in the page:
+  {{judge}}
+==== Demo ====
+See the plugin in action [[http://judge.sadrnezhaad.ir/wiki/|here]]. The sample page shows all the styles available with the plugin.
+===== Syntax =====
+^ Parameter Name  ^ Description       ^ How plugin find the value   ^ Default Value          ^  Optional/Mandatory          ^
+| submit_id     | unique number for every submission  | generated by the plugin  |  auto increment  | Mandatory  |
+| timestamp     | submission time |saving current time on submission insert  |  .now  | Mandatory  |
+| problem_name  | unique name of every question which is equal to page id of the problem  | plugin syntax parameters  |  | Mandatory  |
+| username      | username of submitter   | dokuwiki this user  |  | Mandatory  |
+| language      | programming language of submission |syntax parameters or user choice when submit ل file format  |  java  | Mandatory  |
+| type          | two possible values: output-only and test-case  | syntax parameter |  test-case  | Mandatory  |
+| status_code   | 0 means running and 1 means done |first it's 0. when the answer specified it became 1  |  0  | Mandatory  |
+| valid_number  | string which show the run status of programs |set by program which run the codes  |  null  | Optional  |
+| runtime       | the time of running the codes |set by program which run the codes  |  null  | Optional  |
+Basic syntax:
+''%%{{judge key=value}}%%''
+  * **key** can be one of this:
+    * ''problem_name'' --- ID of question page
+    * ''type'' --- test-case/output-only
+    * ''language'' --- programming language for test-case kind of questions
+    * ''runtime'' --- maximum runtime of the program
+    * ''method'' --- tester.cpp/tester.java/diff
+===== Configuration and Settings =====
+Set the directory which submission codes uploaded into.
+===== Development =====
+=== Change Log ===
+  * **2016-01-29**
+    * Initial release
+=== Known Bugs and Issues ===
+=== ToDo/Wish List ===
+===== FAQ =====
+===== Discussion =====