Скрипт проверки (формат)

Скрипт проверки можно скачать на странице диктанта.

Скрипт с другими служебными файлами запакован в zip-архив.

В архиве содержится четыре файла:

1. js-файл (checkDictantScript_5f4404764b32fa3c9bd23dc0.js) — сам скрипт проверки диктанта;
2. css-файл (checkDictantScript_5f4404764b32fa3c9bd23dc0.css) — содержит, соответственно, стили для показа отчёта о проверке.
3. txt-файл (checkDictantInfo_5f4404764b32fa3c9bd23dc0.txt) — общая информация о диктанте: название, путь в Учительской, дата выгрузки;
4. HTML-файл (checkDictantExample_5f4404764b32fa3c9bd23dc0.html) — тестовая страница для проверки скрипта.

Каждый файл имеет в своём названии уникальный идентификатор диктанта dictID (например: 5f4404764b32fa3c9bd23dc0), который следует сохранять для передачи написанных диктантов в систему для импорта.

В js-файле содержатся две главные функция проверки:

function checkTextWithResultModelAndShowReport(text, reportContainerDomElement, onScoreCallback)

Параметры вызова:

• text — текст диктанта.
• reportContainerDomElement — DOM-элемент, где нужно нарисовать отчёт.
• onScoreCallback = function(fullCheckResultModel, score) — функция, в которую будет переданы: fullCheckResultModel — полная JSON-модель результата проверки и score — JSON-объект с данными о проверке.

Модель score имеет следующий вид:

 {errors: {ORFO:number, PUNCT: number, TYPO: number}, score: number, isTotalDict: boolean}

• ORFO — количество орфографических ошибок.
• PUNCT — количество пунктуационных ошибок.
• TYPO — количество опечаток (те ошибки, на которые нет разметки).
• score — оценка за диктант (5-балльная для русского, 100-балльная для английского).
• isTotalDict — похож ли переданный текст на оригинальный текст диктанта.

function checkTextWithoutShowReport(text: string, onResult: function(model: Model))

Параметры вызова:

• text — текст диктанта
• onResult — функция, в которую будет передан JSON-объект с подробными данными о результате проверки.

Содержащийся в архиве HTML-файл можно использовать для проверки текста диктанта и, соответственно, для проверки актуальности выгруженного скрипта. Для этого нужно:

• открыть HTML-файл в браузере;
• вставить в поле ввода текст диктанта с умышленно сделанными ошибками;
• нажать кнопку «Проверить»;
• оценить результат проверки.

Для демонстрации работы можно взять пример скрипта тестового диктанта с «черновой» разметкой checkdictant_5ed9d6caefb14f76c3f47e5e.zip

Текст диктанта для проверки:

Белка
В тёмном еловом лесу с утра до позднего вечера хлопочут проворные белки. Поднимутся белки на вершину высокой ели, перемахнут с ветки на ветку, а потом спускаются на землю за орехами. В развилке елового сучка белочка развесила сушить подосиновик, маленькие опенки. В лесных кладовых спрятала отборные орехи.
Поздней осенью переменит белка свое красное платье на серую зимнюю шубку. В вершине густой ели устроила белочка тёплое гнездо. Там она воспитывает бельчат, зимой спасается от лютых морозов и холодных ветров. Самый весёлый зверек в наших лесах – это шустрая белка.