Как добавить тест на Gee!tesT

Основной механизм

В настоящее время процесс загрузки тестов автоматизирован не до конца и не позволяет выполнять загрузку полностью автономно от администратора системы.

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

add@geetest.ru

Обратите внимание!
при отправке теста обязательно укажите правильные ответы любым способом.
После получения теста, он будет загружен в течение 2 рабочих дней и станет доступен на сайте и в приложении. Содержание теста присылается в файле формата TXT. Если Вы знакомы с форматом XML, можете отправить тест в этом формате.
Скачайте образец теста и сделайте свой по образцу:

TXT XML

Кстати, образец теста доступен для тренировки и тестирования. Вы можете найти его на сайте и пройти здесь. Это поможет Вам понять, как в итоге будет выглядеть тест.

Если у Вас возникают вопросы по структуре и оформлению теста, инструкции по составлению тестов для системы указаны в разделе "Как правильно оформить содержание теста?".

Какую информацию необходимо отправить?

Каждый тест в системе имеет ряд параметров. С целью выбора позициии теста в общем списке, необходимо указать следующие свойства:
  1. Название дисциплины
    Название теста должно отображать предмет, по которому составлен тест, например "Астрология". Название должно быть указано в Именительном и Дательном падежах. Если тест по данной дисциплине уже имеется в системе, то к его названию стоит добавить номер, Ваше имя, ВУЗ или любое другое уникальное понятие. Например "акушерство II", "Маркетинг от Вани Иванова", "Основы программирования - ИТМО" и т.д.

  2. Категория дисциплины
    Чтобы искать тест было легко, все тесты разделены по категориям. Это значит, что Ваш тест необходимо отнести к одной из них, либо отправить свою категорию. Например, на сайте нет категории "Магия". Если Вы хотите отправить тест по дисциплине "магические зелья", то дополнительно нужно указать и категорию в Именитольном и Дательном падежах. Например: я не нашел категорию для своего теста, поэтому прошу ее добавить : "Магия", "Магии".

  3. Разделение на темы
    Любая дисциплина содержит в себе большое количество тем. Поэтому в Gee!tesT сужествует поддержка тем в тестах. Если Ваш тест разделен на темы, нужно указать, что он раделен на темы. Если нет - то указать, что тест на темы не разделен.

  4. Содержание теста
    Самое главное - это вопросы и ответы. О том, как правильно их оформить, написано в следующем разделе

  5. Дополнительная информация
    Этот параметр необходимо указать обязательно. В него нужно включить информацию, о том, кто составил или отправил тест, его краткое описание. Так же можно добавить подсказки по подготовке - как лучше его изучать - по темам или все темы сразу и т.д.

Как правильно оформить содержание теста?

Тест состоит из тем, вопросов и ответов. Причем, если тест не разделен на темы, он все равно состоит из одной темы. Но, поскольку она одна, мы считаем, что на темы он не разделен.

Итак, тест состоит из тем, темы состоят из вопросов, вопросы предполагают ответы. Это не сложно, прямо как на картинке:

труктура теста Gee Test
Структура теста

Содержание теста необходимо построить по этой схеме и записать все в текстовый файл (txt). При этом необходимо соблюдать определенные правила. Перепечатывать тест вручную, чтобы добавить в систему - это крайне не рационально. Так же не рационально перемещать тест через буфер обмена (копировать/вставить). Основная задача при добавлении теста - разбить его на структурные составляющие (темы, вопросы, ответы) и записать в систему. Этот процесс должен быть автоматизирован, поэтому работает за нас определенная программа - парсер. Чтобы программа сработала без ошибок, необходимо соблюсти определенные правила оформления теста.

Как должен быть оформлен тест?

Чтобы парсер понял, где тема, а где вопрос, нужно ему сказать об этом при помощи определенных символов. Главное условие - это логика построения.

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

Темы

Для того, чтобы указать на начало темы, необходимо использовать три символа звездочки в квадратных скобках [***]. Давайте запишем в тест 4 темы, например:

Обозначение тем:
...
[***]Сложение
[***]Вычитание
[***]Деление
[***]Умножение
...

Вопросы

В теме есть несколько вопросов. Вопрос обозначается числом в квадратных скобках [1],[2],.... Давайте оставим только две темы и напишем в каждую их них по три вопроса.

Обозначение вопросов:
...
[***]Сложение
  [1]Сколько будет 2+2?
  [2]Если к двум яблокам положить еще одно, сколько будет в итоге?
  [3]Пятеро ребят катались на великах. Встретили еще двоих. Сколько стало ребят?
  
[***]Вычитание
  [1]Сколько будет 2-1?
  [2]Вова забрал один из двух колиных карандашей. Сколько карандашей осталось у Коли?
  [3]Сколько будет 5-2?
...

Варианты ответов

Теперь, после того, как мы составили вопросы и разбили их по темам, нужно указать варианты ответов на вопросы. Для простоты, будем называть их просто ответами. Ответ может быть правильным или неправильным.

У каждого вопросы должно быть как минимум два ответа и как минимум один правильный ответ. Неправильные ответы обозначаются знаком минус в квадратных скобках [-]. Правильные знаком плюс в квадратных скобках [+]. Давайте составим ответы:

Обозначение ответов:
...
[***]Сложение

[1]Сколько будет 2+2?
	[-]восем
	[+]четыре
	[-]шесть
	[-]три
	
[2]Если к двум яблокам положить еще одно, сколько будет в итоге?
	[+]3
	[-]останется два, так как я съел одно
	[-]в итоге возникнет каскадный резонанс
	[-]Изначально все яблоки находятся все вместе,в одном мире, и сосчитать мы их не сможем
	
[3]Пятеро ребят катались на великах. Встретили еще двоих. Сколько стало ребят?
	[-]семь
	[-]три
	[+]шестеро, потому что один из них был я, и у меня всегда спускает колесо в самый неподходящий момент

[***]Вычитание

[1]Сколько будет 2-1?
	[+]один
	[-]ноль
	[-]мнус один
	[-]пятнадцать
	
[2]Вова забрал один из двух колиных карандашей. Сколько карандашей осталось у Коли?
	[+]останется один карандаш
	[-]Коля заберет карандаш обратно и останется два
	[-]Карандашей не останется, так как второй заберет Маша
	[-]Сто тридцать восемь
	
[3]Можно ли из трех вычесть шесть?
	[-]Нет, потому что шесть больше трех
	[+]Можно
...

Примите поздравления! Теперь Вы умеете оформлять тесты для системы!

Контрольный пример

Давайте проверим навык оформления теста на контрольном примере:

тест "Как загрузить свой тест на Gee!tesT ?":
[***]Информация о тесте

[1]Какую информацию обязательно нужно отправить?
	[+]Название дисциплины
	[+]Категория дисциплины
	[+]Факт разделения на темы или его отсутствие
	[+]Содержание теста
	[+]Дополнительную информацию
	
[2]В каких падежах необходимо отправить название дисциплины
	[+]Именительном
	[+]Дательном
	[-]Родительном
	[-]Творительном
	[-]Предложном
	[-]Винительном
	
[3]Что нужно делать, если в системе нет категории для Вашего теста?
	[+]прислать ее название
	[-]Выбрать наиболее подходящую категорию
	[-]Не относить тест к категории вовсе

[***]Оформление теста

[1]В какие символы необходимо обрамлять указатели для парсера?
	[+]квадратные скобки
	[-]Фигурные скобки
	[-]Круглые скобки
	[-]Угловые скобки
	
[2]Как обозначается тема?
	[+]три звездочки
	[-]три диеза
	[-]две звездочки
	[-]два диеза
	
[3]Как обозначается вопрос?
	[+]Арабским числом
	[-]Римским числом
	[-]Латинской буквой
	[-]Греческой буквой
	
[4]Как обозначается правильный ответ?
	[+]Знаком "плюс"
	[-]Знаком "минус"
	[-]Знаком "разделить"
	[-]знаком "умножить"
	
[5]Как обозначается неправильный ответ?
	[-]Знаком "плюс"
	[+]Знаком "минус"
	[-]Знаком "разделить"
	[-]знаком "умножить"
	
[6]Сколько у вопроса должно быть ответов?
	[-]минимум три
	[+]минимум два
	[-]сто
	[-]один
	[+]больше одного
	
[7]Сколько у вопроса должно быть правильных ответов?
	[-]минимум три
	[+]минимум один
	[-]сто
	[-]один
	[+]не меньше одного
	
[***]Отправка теста

[1]На какой адрес отправлять тест?
	[+]add@geetest.ru
	[-]delete@geetest.ru
	[-]upload@geetest.ru
	[-]crushServer@geetest.ru
	
[2]В каком формате отправлять содержимое теста?
	[+]TXT
	[-]DOC
	[-]DOCX
	[-]RTF

Как оформить XML?

Структура XML весьма проста и по архитектуре не отличается от структуры теста. Разве что тем, что дополнительная информация тоже указывается в файле.

Итак, ниже представлен образец того же теста с комментариями.

пример теста в XML

<?xml version="1.0" encoding="utf-8"?>
<test>

	<name>Загрузка теста на Gee Test</name>
	<give>Загрузке теста на Gee Test</give>
	<category>Общие вопросы</category>
	<isThemes>1</isThemes>
	<description>Данный тест предназначен для того, чтобы выполнять роль образца, по которому следует оформлять тесты для загрузки.</description>

	<themes>
		<theme id="0">Информация о тесте</theme>
		<theme id="1">Оформление теста</theme>
		<theme id="2">Отправка теста</theme>
	</themes>


	<question theme="0" answer="0,1,2,3,4">
		<text>
		Какую информацию обязательно нужно отправить?
		</text>
		<answers>
			<answer id="0" isCorrect="1">Название дисциплины</answer>
			<answer id="1" isCorrect="1">Категория дисциплины</answer>
			<answer id="2" isCorrect="1">Факт разделения на темы или его отсутствие</answer>
			<answer id="3" isCorrect="1">Содержание теста</answer>
			<answer id="4" isCorrect="1">Дополнительную информацию</answer>
		</answers>
	</question>
	<question theme="0" answer="0,1">
		<text>
		В каких падежах необходимо отправить название дисциплины
		</text>
		<answers>
			<answer id="0" isCorrect="1">Именительном</answer>
			<answer id="1" isCorrect="1">Дательном</answer>
			<answer id="2" isCorrect="0">Родительном</answer>
			<answer id="3" isCorrect="0">Творительном</answer>
			<answer id="4" isCorrect="0">Предложном</answer>
			<answer id="5" isCorrect="0">Винительном</answer>
		</answers>
	</question>
	<question theme="0" answer="0">
		<text>
		Что нужно делать, если в системе нет категории для Вашего теста?
		</text>
		<answers>
			<answer id="0" isCorrect="1">прислать ее название</answer>
			<answer id="1" isCorrect="0">Выбрать наиболее подходящую категорию</answer>
			<answer id="2" isCorrect="0">Не относить тест к категории вовсе</answer>
		</answers>
	</question>
	<question theme="1" answer="0">
		<text>
		В какие символы необходимо обрамлять указатели для парсера?
		</text>
		<answers>
			<answer id="0" isCorrect="1">квадратные скобки</answer>
			<answer id="1" isCorrect="0">Фигурные скобки</answer>
			<answer id="2" isCorrect="0">Круглые скобки</answer>
			<answer id="3" isCorrect="0">Угловые скобки</answer>
		</answers>
	</question>
	<question theme="1" answer="0">
		<text>
		Как обозначается тема?
		</text>
		<answers>
			<answer id="0" isCorrect="1">три звездочки</answer>
			<answer id="1" isCorrect="0">три диеза</answer>
			<answer id="2" isCorrect="0">две звездочки</answer>
			<answer id="3" isCorrect="0">два диеза</answer>
		</answers>
	</question>
	<question theme="1" answer="0">
		<text>
		Как обозначается вопрос?
		</text>
		<answers>
			<answer id="0" isCorrect="1">Арабским числом</answer>
			<answer id="1" isCorrect="0">Римским числом</answer>
			<answer id="2" isCorrect="0">Латинской буквой</answer>
			<answer id="3" isCorrect="0">Греческой буквой</answer>
		</answers>
	</question>
	<question theme="1" answer="0">
		<text>
		Как обозначается правильный ответ?
		</text>
		<answers>
			<answer id="0" isCorrect="1">Знаком "плюс"</answer>
			<answer id="1" isCorrect="0">Знаком "минус"</answer>
			<answer id="2" isCorrect="0">Знаком "разделить"</answer>
			<answer id="3" isCorrect="0">знаком "умножить"</answer>
		</answers>
	</question>
	<question theme="1" answer="1">
		<text>
		Как обозначается неправильный ответ?
		</text>
		<answers>
			<answer id="0" isCorrect="0">Знаком "плюс"</answer>
			<answer id="1" isCorrect="1">Знаком "минус"</answer>
			<answer id="2" isCorrect="0">Знаком "разделить"</answer>
			<answer id="3" isCorrect="0">знаком "умножить"</answer>
		</answers>
	</question>
	<question theme="1" answer="1,4">
		<text>
		Сколько у вопроса должно быть ответов?
		</text>
		<answers>
			<answer id="0" isCorrect="0">минимум три</answer>
			<answer id="1" isCorrect="1">минимум два</answer>
			<answer id="2" isCorrect="0">сто</answer>
			<answer id="3" isCorrect="0">один</answer>
			<answer id="4" isCorrect="1">больше одного</answer>
		</answers>
	</question>
	<question theme="1" answer="1,4">
		<text>
		Сколько у вопроса должно быть правильных ответов?
		</text>
		<answers>
			<answer id="0" isCorrect="0">минимум три</answer>
			<answer id="1" isCorrect="1">минимум один</answer>
			<answer id="2" isCorrect="0">сто</answer>
			<answer id="3" isCorrect="0">один</answer>
			<answer id="4" isCorrect="1">не меньше одного</answer>
		</answers>
	</question>
	<question theme="2" answer="0">
		<text>
		На какой адрес отправлять тест?
		</text>
		<answers>
			<answer id="0" isCorrect="1">add@geetest.ru</answer>
			<answer id="1" isCorrect="0">delete@geetest.ru</answer>
			<answer id="2" isCorrect="0">upload@geetest.ru</answer>
			<answer id="3" isCorrect="0">crushServer@geetest.ru</answer>
		</answers>
	</question>
	<question theme="2" answer="0">
		<text>
		В каком формате отправлять содержимое теста?
		</text>
		<answers>
			<answer id="0" isCorrect="1">TXT</answer>
			<answer id="1" isCorrect="0">DOC</answer>
			<answer id="2" isCorrect="0">DOCX</answer>
			<answer id="3" isCorrect="0">RTF</answer>
		</answers>
	</question>
</test>

Если тест разделен на темы, в файле должен присутсвовать тег с темами (<themes>). Если же тем в тесте нет, а он представляет из себя одну тему, то тег с темами (<themes>) включать не обязательно, а атрибут "theme" тега <question> либо опустить, либо всегда делать равным нулю.

Что делать, если тест оформлен иначе?

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

Темы, например, могут быть обозначены просто числом с точкой, вопросы - числом со скобкой, а ответы - латинскими буквами.

Главное - чтобы каждый из элементов был обозначен одинаково, а правильныые ответы имели свой признак. Так же необходимо понимать, что символы, которые обозначают структурные элементы, не должны встречаться в текстах тем, вопросов и ответов. Например, если вопрос обозначается цифрой со скобкой, то следующий вопрос запишется с ошибкой:

пример вопроса сошибкой
...
1)Как поведут себя два (2) мыльных пузыря, если встретятся?
...

В таком случае вопрос будет разделен из-за того, что в его тексте есть цифра со скобкой. Но в то же время, мы можем заметить, что перед началом вопроса есть символ новой строки, который тоже может послужить меткой начала вопроса.

Если тест у Вас есть, но оформлен он иначе, то присылайте как есть. В таком случае время его добавления увеличится.






The Android robot is reproduced or modified from work created and shared by Google and used according to terms described in the Creative Commons 3.0 Attribution License.
Android is a trademark of Google Inc.