BLumiaOJ

Переиздание HUSTOJ Web

English Version

Обратите внимание

Если вы хотите развернуть систему, внимательно прочитайте раздел "Развертывание и краткое описание". Если вы уже развернули систему, рекомендуется отслеживать изменения этого репозитория, чтобы получать уведомления о новых обновлениях и исправлении ошибок. Если у вас есть вопросы, пожалуйста, откройте issue.

Описание

Полностью переизданный вариант HUSTOJ Web. Поддерживает PHP 7, более удобный интерфейс пользователя, новые полезные функции, а также повышает читаемость и поддерживаемость кода.

Пример использования

Если вам требуется просмотреть систему, вы можете увидеть состояние новой системы тестирования здесь (Tencent Cloud location).

Развертывание и краткое описание

Текущий выпуск включает большую часть функциональностей оригинальной версии HUSTOJ, но он ещё не был полностью протестирован. Если вы заметили какие-либо проблемы, пожалуйста, сообщите об этом через issue. Если вы хотите развернуть систему, участвовать в разработке или просто попробовать её, вы можете воспользоваться следующими указаниями.Если у вас уже развернутая работающая версия HUSTOJ, вы можете заменить все файлы кода в директории backend вашего HUSTOJ web (обычно это может быть /var/www/html/JudgeOnline) на соответствующие файлы из данного репозитория. Если вы хотите сохранить вашу текущую установку HUSTOJ, вы можете поместить данный репозиторий в любое другое место. После этого вам потребуется скопировать файл config.sample.php из папки include данного репозитория в файл config.php, а затем отредактировать этот файл конфигурации согласно вашему существующему файлу конфигурации HUSTOJ (db_info.inc.php). Сохраните его; если конфигурация правильна, вы сможете использовать BLumiaOJ.Если вы ещё не развернули HUSTOJ, вы можете выбрать метод развертывания через GitHub:zhblue/hustoj и после этого применить вышеупомянутые шаги для развертывания BLumiaOJ (рекомендованное действие), либо попытаться самостоятельно установить BLumiaOJ. Если вы предпочитаете самостоятельную установку, ниже приведены некоторые руководства:

• GitHub:BLumia/BLumiaOJ-Installation-Helper Этот репозиторий предоставляет скрипт установки BLumiaOJ для быстрого развертывания, но он может использоваться только с Debian 8 и не был протестирован на работоспособность.

• GitHub:BLumia/HUSTOJ-Core Этот репозиторий является зеркалом репозитория с основной частью системы проверки задач HUSTOJ. Если вы не хотите клонировать полный репозиторий HUSTOJ для получения части кода проверки задач (потому что он всё ещё использует структуру файлов SVN, которая довольно объёмна), вы можете использовать этот репозиторий.- GitHub:zhblue/hustoj Инструкция по установке HUSTOJ Инструкция по ручной установке HUSTOJ. BLumiaOJ требует версию PHP не ниже 5.1 (в связи с использованием PDO). В большинстве случаев вам достаточно будет поместить все файлы кода в папку вашего веб-сервера, поддерживающего PHP. Однако есть некоторые особенности, которые следует учесть. Если вы используете более раннюю версию установочного диска HUSTOJ или старую версию PHP (раньше 5.4.0), вам может потребоваться проверить значение опции magic_quotes_gpc в конфигурационном файле php.ini. Вы также можете войти в административную панель и проверить наличие предупреждений, чтобы удостовериться, что всё правильно настроено.Независимо от способа установки, важно убедиться, что ваш компонент оценки решений работает корректно (хотя это непосредственно не связано с BLumiaOJ). Сам BLumiaOJ не имеет дополнительных требований к размещению; его можно разместить там, где вам удобно, при условии правильной настройки вашего сервера Apache/Nginx или любого другого веб-сервера, поддерживающего PHP, а также правильной конфигурации необходимых файлов (например, config.php). При тестировании автор использовал прямое взаимодействие с базой данных MySQL, поэтому он не уверен, работает ли HTTP Judge корректно. Если вы столкнулись с проблемами, связанными с работой BLumiaOJ после правильной настройки, вы можете создать новый запрос об ошибке на GitHub (создание нового Issue) или форкнуть проект и отправить Pull Request.

Основные отличия BLumiaOJ от HUSTOJ:

• Экспорт задач в формате FreeProblemSet XML
• Внутренний форум (discuss) не позволяет управлять ответами на сообщения (API существует, но фронтенд еще не реализован)

Основные различия между текущей версией BLumiaOJ и HUSTOJ:

• Использование PDO для работы с базой данных, что обеспечивает совместимость со свежими версиями PHP
• Переработанный модуль форума
• Улучшенный интерфейс управления
• Привязка меток к задачам (в разработке)Кроме того, если вы уже установили HUSTOJ и планируете клонировать этот репозиторий в вашу директорию WWW_PATH, рекомендуется создать правило, которое будет ограничивать доступ к каталогу .git. Этот репозиторий предоставляет правила для Apache (.htaccess), которые можно использовать, изменяя опцию AllowOverride None в конфигурационном файле apache2.conf (или httpd.conf) на AllowOverride All.

Участие в разработкеЕсли вы когда-либо читали код GitHub:zhblue/hustoj, то вам должно быть легко прочесть код этого репозитория. Это связано с тем, что данный репозиторий был полностью переписан после длительной работы над модификацией исходного кода HUSTOJ, поэтому его структура очень похожа на структуру HUSTOJ. Однако даже если вы раньше не сталкивались с кодом HUSTOJ, не стоит беспокоиться — этот проект не использует сложные шаблоны проектирования, так что вам достаточно будет просто последовательно проследить за любым PHP-файлом в корневой директории.

Если вы хотите принять участие в разработке, приветствуем ваш fork, изменения и отправку Pull Requests, а также открытие Issues для отчета о проблемах или предложениях.

Лицензия