Difference between revisions of "MediawikiQuizzer/ru"

From Wiki4Intranet
Jump to: navigation, search
 
(One intermediate revision by the same user not shown)
Line 80: Line 80:
 
% успехов слишком простых вопросов | Autofilter success percent | См. подробнее [[#Автоудаление простых вопросов]]
 
% успехов слишком простых вопросов | Autofilter success percent | См. подробнее [[#Автоудаление простых вопросов]]
 
Спросить пользователя | Ask user | (Необязательный) Список названий полей через запятую, которые будут добавлены к форме тестирования для анкетирования проходящих тест людей. Если не пусто, то также всегда требуется заполнение поля «Ваше имя».
 
Спросить пользователя | Ask user | (Необязательный) Список названий полей через запятую, которые будут добавлены к форме тестирования для анкетирования проходящих тест людей. Если не пусто, то также всегда требуется заполнение поля «Ваше имя».
 +
Секретный | Secret | Если «да», то тест будет только администраторам (тем, кто может просмотреть его исходный текст), либо по заранее сгенерированным администраторами одноразовым ссылкам.
 
</tab>
 
</tab>
  
Line 108: Line 109:
 
* '''Метку''' для проверяющего. Эта метка будет показываться в печатных проверочных листах и может использоваться, например, проверяющим, чтобы сразу понять, для тестирования какой темы добавлен этот вопрос.<br />''Метку можно задать в заголовке секции вопроса или отдельной подсекцией с заголовком <tt>== Метка ==</tt>.''
 
* '''Метку''' для проверяющего. Эта метка будет показываться в печатных проверочных листах и может использоваться, например, проверяющим, чтобы сразу понять, для тестирования какой темы добавлен этот вопрос.<br />''Метку можно задать в заголовке секции вопроса или отдельной подсекцией с заголовком <tt>== Метка ==</tt>.''
 
* '''Комментарии к вопросу'''. Эти комментарии понимаются как комментарии в языке программирования — при обработке теста они просто вырезаются.<br />''Комментариями считается всё, что располагается в секциях с названием <tt>== Комментарии ==</tt>.
 
* '''Комментарии к вопросу'''. Эти комментарии понимаются как комментарии в языке программирования — при обработке теста они просто вырезаются.<br />''Комментариями считается всё, что располагается в секциях с названием <tt>== Комментарии ==</tt>.
* '''Варианты ответа'''.
+
* '''Варианты ответа'''. Можно либо дать несколько вариантов ответа (для этого задайте хотя бы 2 варианта ответа — 1 правильный и 1 неправильный), либо предложить пользователю ввести ответ в виде произвольной строки (для этого нужно задать >= 1 правильного варианта ответа и 0 (ни одного) неправильных).
  
 
Чтобы секция была принята за вопрос, её заголовок должен называться <tt>== Вопрос ==</tt> или <tt>== Вопрос: метка вопроса ==</tt>. Уровень заголовка роли не играет.
 
Чтобы секция была принята за вопрос, её заголовок должен называться <tt>== Вопрос ==</tt> или <tt>== Вопрос: метка вопроса ==</tt>. Уровень заголовка роли не играет.

Latest revision as of 15:12, 4 April 2016

MediawikiQuizzer — расширение MediaWiki.

  • Назначение: Система тестирования знаний на основе MediaWiki, с простым порождением тестов страницами в отдельном пространстве имён.
  • Репозиторий: https://github.com/mediawiki4intranet/MediawikiQuizzer
  • Домашняя страница: http://wiki.4intra.net/MediawikiQuizzer 
  • Версия MediaWiki: гарантирована совместимость с 1.13-1.18, возможна с другими
  • Лицензия: GPLv2.0+ 
  • Дата создания: 2006-04-25 
  • Последняя версия: 2013-04-15 
  • Оценка расширения: Вероятно полезное (4)

Включение в сборку Mediawiki4Intranet:

  • Дата включения: 2008-10-14
  • Включённая версия: последняя
  • Состояние доработок: Создано в рамках MediaWiki4Intranet

Позволяет:

  • Создавать тесты как обычные вики-страницы на обычном русском (или английском, или любом другом) языке.
  • Проводить тестирование через веб-интерфейс.
  • Просматривать результаты тестов.
  • Создавать печатные версии тестов — листы вопросов и ответов.

MediaWiki4Intranet и дистанционное обучение

Сборка MediaWiki4Intranet является очень удачной (близкой к идеальной) технологией дистанционного обучения — то есть, с учетом всевозможных расширений, в MediaWiki4Intranet можно использовать и удобную для ручного ввода Wiki-разметку, и HTML-код, и даже LateX-верстку, которая дает неограниченные возможности в представлении математики. Также можно размещать различные диаграммы (посредством Graphviz, Gnuplot, PlantUML), видеоролики, а также просто изображения, включая векторные.

Для получения полноценной системы дистанционного обучения, необходимо лишь дополнить MediaWiki4Intranet средствами контроля представленных знаний. Наиболее распространенная IT-технология контроля знаний — это тесты, являющие собой набор сформулированных вопросов, снабженных вариантами ответа, часть из которых являются правильными, а часть — нет. Это дает как максимальную простоту тестирования, так и точность проверки.

Проектировщику обучающих материалов нужно только сформулировать проверочную структуру — набор вопросов, каждый из которых имеет варианты правильных и неправильных ответов, и возможно разьяснение.

Технология будет удачной и используемой, если все это (редактирование структуры, формулировка вопросов) будет удобным — тогда написание тестов можно сделать обязательным для любого обучающего материала, как написание тестов для программного кода.

Для этого и служит расширения MediawikiQuizzer.

Установка MediaWikiQuizzer

Как обычно с расширениями MediaWiki, нужно скопировать исходники в поддиректорию extensions/mediawikiquizzer/ вашей установки MediaWiki, добавить в LocalSettings.php несколько строчек и запустить скрипт php maintenance/update.php.

В LocalSettings.php:

$egMWQuizzerAdmins = array('WikiSysop');
require_once('extensions/mediawikiquizzer/mediawikiquizzer.php');
MediaWikiQuizzer::setupNamespace(104); // 104 - свободный индекс пространства имён

Attention niels epting.svg Но есть нюанс!

В связи со спецификой расширения, а именно в связи с тем, что все вопросы и правильные варианты ответов для удобства создаются и сохраняются на обычных вики-страницах в отдельном пространстве имён Quiz, требуется защита от просмотра его обычными пользователями. Однако в рамках MediaWiki это проблема: система изначально рассчитана на открытый доступ. Единственными расширениями, которые способны надёжно защищать вики-страницы от просмотра, являются IntraACL и его предок — HaloACL, и не все пользователи mediawikiquizzer’а захотят устанавливать и настраивать эти расширения — HaloACL имеет большое число проблем удобства, багов и производительности, наш IntraACL получше, но тоже неидеален.

Поэтому есть второй способ, более простой: создать рядом с уже установленной MediaWiki ещё одну, полностью закрытую (например, HTTP-авторизацией) и воспользоваться фичей MediaWiki под названием «Разделяемые таблицы БД». То есть, прописать следующее в её LocalSettings.php:

$wgSharedDB = 'original_wiki'; // база данных основной wiki
$wgSharedTables = array('user', 'mwq_choice', 'mwq_choice_stats', 'mwq_question', 'mwq_question_test', 'mwq_test', 'mwq_ticket');
$wgSharedPrefix = ''; // или префикс, используемый основной wiki

Таким образом получится, что дополнительная вики будет использовать ту же базу данных пользователей и ту же базу данных вопросов/ответов/тестов/результатов тестирования MediaWikiQuizzer’а, но именно на её страницах будут располагаться исходники самих тестов, и поэтому они будут закрыты от обычных пользователей.

Создание и редактирование тестов

Для ведения проверочной структуры тестов применяется человеческий язык :)

Тесты

Отдельный тест описывается отдельной невложенной вики-страницей в пространстве имён Quiz. Например, Quiz:Тест задаёт тест. Quiz:Тест/Вопросы не задаёт тест.

Тест состоит из:

  • Параметров теста
  • Вопросов и вариантов ответов

И то, и другое описывается по-человечески и может включаться с других вики-страниц обычными вики-включениями {{Quiz:ИмяСтраницы}}. То есть, например, можно создавать библиотеки вопросов, а потом, набирая разные вопросы, формировать разные тесты.

Обновление теста происходит при пересохранении страницы теста или любой статьи пространства имён Quiz, включаемой в страницу теста.

Attention niels epting.svg Если в тест включаются статьи не из пространства имён Quiz, то тест не обновится автоматически при сохранении включаемой статьи! Все вопросы нужно хранить в пространстве имён Quiz!

Параметры теста

Параметры теста описываются обычным списком определений в вики-синтаксисе со специальными именами «терминов». Имена локализованы, нужно использовать либо английские (они работают всегда), либо соответствующие $wgContLang, то есть, языку вашей вики по умолчанию.

Параметр (рус.) Параметр (англ.) Значение
Название Name Просто некий заголовок. Если этого пункта нет, в качестве заголовка будет взято название вики-страницы.
Введение Intro Этот текст будет показан в режиме тестирования над тестом. Если для введения мало одной строчки, в начале страницы можно создать подраздел с заголовком == Введение ==, и его содержимое будет принято за этот текст.
Режим Mode Возможные значения: TEST или TUTOR. Подробнее см. #Обучающие тесты
Число вопросов Limit questions Если на странице много вопросов, а тестировать нужно только по части из них, здесь задаётся размер этой части.
Переставлять вопросы Shuffle questions Если «да», то вопросы теста будут случайным образом переставлены. Если при этом задано «Число вопросов» равное, к примеру, 10, то будет выбрано 10 случайных вопросов из всех доступных.
Переставлять ответы Shuffle choices Если «да», то варианты ответа на каждый вопрос также будут случайным образом переставлены.
Процент завершения Completion percent Требуемый % правильных ответов для того, чтобы результат был признан успешным прохождением теста.
Мин. попыток слишком простых вопросов Autofilter min tries См. подробнее #Автоудаление простых вопросов
% успехов слишком простых вопросов Autofilter success percent См. подробнее #Автоудаление простых вопросов
Спросить пользователя Ask user (Необязательный) Список названий полей через запятую, которые будут добавлены к форме тестирования для анкетирования проходящих тест людей. Если не пусто, то также всегда требуется заполнение поля «Ваше имя».
Секретный Secret Если «да», то тест будет только администраторам (тем, кто может просмотреть его исходный текст), либо по заранее сгенерированным администраторами одноразовым ссылкам.

Пример кода с параметрами теста:

;Название: Основый SQL
;Введение: Данный тест позволит вам проверить базовы навыки в области языка запросов SQL.
;Режим: TUTOR
;Число вопросов: 10
;Переставлять вопросы: да
;Переставлять ответы: да
;Процент завершения: 80
;Мин. попыток слишком простых вопросов: 5
;% успехов слишком простых вопросов: 90
;Спросить пользователя: ВУЗ, Факультет

Анкета

Одновременно с тестированием можно отображать анкету с различными видами полей.

Вопросы

Каждый вопрос задаётся отдельной секцией статьи («подзаголовком» статьи) и имеет:

  • Текст вопроса.
  • Текст объяснения для режима обучающего теста. Этот текст будет показан в результатах тестирования, если человек ответит на вопрос неправильно. Подробнее см. #Обучающие тесты.
    Объяснение задаётся секцией с названием == Объяснение ==.
  • Метку для проверяющего. Эта метка будет показываться в печатных проверочных листах и может использоваться, например, проверяющим, чтобы сразу понять, для тестирования какой темы добавлен этот вопрос.
    Метку можно задать в заголовке секции вопроса или отдельной подсекцией с заголовком == Метка ==.
  • Комментарии к вопросу. Эти комментарии понимаются как комментарии в языке программирования — при обработке теста они просто вырезаются.
    Комментариями считается всё, что располагается в секциях с названием == Комментарии ==.
  • Варианты ответа. Можно либо дать несколько вариантов ответа (для этого задайте хотя бы 2 варианта ответа — 1 правильный и 1 неправильный), либо предложить пользователю ввести ответ в виде произвольной строки (для этого нужно задать >= 1 правильного варианта ответа и 0 (ни одного) неправильных).

Чтобы секция была принята за вопрос, её заголовок должен называться == Вопрос == или == Вопрос: метка вопроса ==. Уровень заголовка роли не играет.

Ответы

Варианты ответа можно задать двумя способами:

1. Одной секцией с названием == Ответы == или Варианты ответа, содержащей в себе нумерованный (*) или маркированный (#) список, каждый элемент которого будет признан отдельным вариантом ответа. При этом правильными вариантами будут признаны те, в начале текста которых есть слова Правильный ответ: (далее текст ответа).

2. Если на текст варианта ответа недостаточно одной строчки, его можно задать отдельной секцией с названием == Ответ == или == Правильный ответ ==. В принципе, оба способа задания можно также и смешивать.

Лог разбора страницы

После сохранения вверху страницы каждого теста можно увидеть ссылку «[+] Показать лог разбора страницы теста». Если на неё кликнуть, будет показана некоторая отладочная информация, по которой можно понять, как mediawikiquizzer разбирал страницу теста. Зелёные маркеры говорят о том, что всё ОК, жёлтые — о возможной ошибке, красные — о явной ошибке. Явной ошибкой является, к примеру, вопрос без единого правильного варианта ответа.

Тестирование

После сохранения вверху страницы каждого теста можно увидеть также и две ссылки:

  • Пройти тест «Название теста»
  • Версия для печати

Как несложно догадаться, первая служит для перехода на саму страницу тестирования, а вторая — для вывода печатной версии теста.

Каждый раз при тестировании или выводе печатной версии генерируется новый вариант теста. Вариант теста, по сути, есть выборка из его вопросов и ответов, по которой в будущем можно восстановить, как именно был перемешан тест при показе пользователю. Реальные номера вопросов и ответов пользователь увидеть не может. Для удобства вариант теста характеризуется некоторой 32-битной цифрой, по этой цифре можно искать результаты на странице просмотра результатов (см. #Просмотр результатов).

После выбора вариантов ответа и их отправки на сервер пользователь увидит свой результат. Это будут две цифры:

  • Правильные ответы — количество правильных ответов.
  • Очки — (количество правильных ответов) минус (сумма отношений числа правильных ответов к числу неправильных ответов для каждого ответа). То есть то же значение минус штраф за неправильные ответы. Невыбранный ответ не считается неправильным. При случайном выборе «очки» имеют матожидание, равное нулю :)

Печатная версия теста

Печатная версия теста включает в себя три части, разделённые разрывами страниц:

  • Лист вопросов — просто список вопросов, выведенных друг под другом.
  • Форма для тестирования — таблица с номерами вопросов и пустыми клетками для вписания ответов и примечаний.
  • Проверочный лист — похожая таблица с номерами вопросов, номерами правильных ответов, статистикой правильных ответов по каждом вопросу и метками вопросов. Кстати, если на ссылку печатной версии теста попадёт пользователь, не имеющий доступа к странице — исходнику теста, и не являющийся одним из $egMWQuizzerAdmins (см. #Установка MediawikiQuizzer), проверочный лист ему показан не будет. Так как нечего подглядывать правильные ответы! :)

Обучающие тесты

Если задать для теста режим TUTOR (см. #Параметры теста), то тест станет «обучающим». Это означает, что после прохождения теста будет показан не только количественный результат правильных/неправильных ответов, но и будут перечислены вопросы, на которые человек ответил неправильно, причём будут показаны и тексты вопросов, и выбранные ответы, и правильные ответы, и объяснения к вопросам. Таким образом человек сможет учиться, или по крайней мере заучить правильные ответы, что тоже неплохо, если их много.

Автоудаление простых вопросов

Предположим, у вас есть куча вопросов, но какие-то из них, возможно, слишком простые и их в будущем хотелось бы удалить. А какие — неизвестно. С помощью MediawikiQuizzer’а можно воспользоваться статистическим методом их удаления :)

Нужно задать 2 параметра теста:

Мин. попыток слишком простых вопросов
N. Чтобы фильтрация работала, N нужно задать обязательно. При N <= 0, или когда N не задан, фильтрация отключается.
% успехов слишком простых вопросов
M. По умолчанию M=80.

Тогда вопросы, на которые ответило по меньшей мере N человек, и из них успешно ответило >= M процентов, будут признаны «слишком простыми» и в следующие варианты тестов не попадут.

Например, можно задать N=5, M=80.

Просмотр результатов

Для просмотра результатов используется служебная страница «Опросы MediaWiki». Просматривать результаты могут администраторы и/или те, кто имеет доступ к исходному коду теста.

Можно выбирать результаты по варианту, пользователю, времени начала/окончания тестирования; можно просматривать полученный список по страницами и выбирать количество записей на странице. Некоторые хитрые ссылки:

  • В колонке «ID попытки» содержится ссылка на результат тестирования в том виде, в котором он был представлен пользователю.
  • В колонке «Тест» содержится две ссылки — на страницу теста и на страницу прохождения теста заново.
  • В колонке «Вариант» содержится ссылка на печатную версию именно того варианта теста, который проходил пользователь.

Note.svg Обратите внимание — на печатной версии теста возле вопросов есть ссылки «править» (похожие на обычные вики-ссылки правки секций), которые направят вас сразу на редактирование нужного раздела нужной страницы! Это даёт возможность очень легкой отладки тестов: тестируемый пожаловался на ошибку в «вопросе таком-то, варианте таком-то», вы открываете просмотр результатов, открываете вариант и редактируете вопрос прямо оттуда!

Остальные колонки говорят сами за себя. Разве что ещё «Очки» и «Ответы» красятся в зелёный цвет, если попытка прохождения была засчитана успешной, и в красный, если нет.

QR-коды

Ещё одно замечание — QR-коды. На странице с результатом теста пользователю отображается QR-код, содержащий ссылку на этот результат. Зачем это надо, как это можно применить: например, пройдя тест на мобильном устройстве, можно быстро передать ссылку администратору для проверки результата. Ссылка содержит секретный код, и поэтому будет ясно, что человек, показавший ссылку — это именно тот, кто проходил тест, а не кто-то другой.