Тестер Знаний - документация

Тестер знаний! v1.3.1 (Январь 2002) Анатолий Коваленко

FAQ/ЧАВО Много различных прибамбасов!

> Внимание! Пользователи старых версий должны ознакомиться с но-
> выми стандартами, описанными в конце файла.

——————————————————————
Q: Зачем нужна эта прога?
A: Идея создания этой проги зародилась при необходимости прове-
рять качество запоминания переводов якобы выученных слов или
предложений. Проверяя перевод со статичного листа, я заметил, что
слова вспоминаются проще, если их проверять в той же последова-
тельности, которая использовалась при их заучивании. В то же вре-
мя, в другой последовательности часть из них не вспоминается. Эта
прога позволяет использовать сколько угодно списков слов, причем
при каждой загрузке программы слова проверяются всегда в разной
последовательности, что способствует доведению вашей «вспомина-
тельной» функции мозга до автоматизма. После проверки выдается
подробная статистика со списком слов, которые вы не помните. В
версии 1.1 появилась новая возможность — таймер (читайте ниже).
——————————————————————
Q: Я хочу посмотреть, как это работает, прежде чем увлечься. Как
это сделать?
A: Есть два образца списков:
advanced.csv «Продвинутая» лексика, 1357 слов.
economic.csv Экономическая лексика, 487

——————————————————————
Q: Ну ладно, а как запустить прогу?
A: Задайте в коммандной строке имя файла, например:
«TEST.EXE advanced.csv».

Для версии 1.2: есть возможность использовать оболочку
«RUN-TEST.EXE» без каких-либо параметров в коммандной строке. Все
установки производятся в интерфейсном режиме, однако не советую
что-либо менять, если вы еще не прочитали инструкцию до конца.
Примечание: Если файл «TEST.EXE» находится не в том же каталоге,
что и «RUN-TEST.EXE», то в качестве параметра при вызове следует
указать путь к каталогу с «Тестером знаний». Соответственно, при
указании названий файла-списка и файла статистики следует также
использовать полный путь. Пример: «RUN-TEST.EXE c:\test» (если
полный путь программы c:\test\test.exe).
Примечание1: прочитайте важную инфу в конце файла (для 1.3.1).

——————————————————————
Q: Я что-то не догоняю, как этим пользоваться-то?
A: Hа первой строке вы видете некоторое слово или предложение на
ИЯ. Вам требуется вспомнить все значения этого слова в ПЯ, после
чего вы жмете ENTER (aka ВВОД) и сравниваете то, что вы вспомни-
ли, с тем, что появилось на второй строке. Если ваш вариант не-
верный или неполный (например, вы вспомнили только одно значение,
хотя на экране показаны два), то вы нажимаете SPACE (aka ПРОБЕЛ),
и вам засчитывается ошибка. Если ваш вариант полностью повторяет
правильный, вы нажимаете ENTER, что прибавляет единицу к общему
числу правильных ответов.
ПРИМЕЧАHИЕ АВТОРА — нет никакого смысла жать ENTER, если вы неп-
равильно или неполно ответили: таким образом вы дурите только се-
бя! Hажав SPACE, вы помещаете неизвестное слово в файл статисти-
ки, и, в конечном счете, у вас появляется возможность учить
только те слова, которые вы действительно не знаете, и отбросить
те слова, которые вы уже выучили.

——————————————————————
Q: OK, мне понравилось, а где обещанные прибамбасы???
A: Все новые возможности включаются из коммандной строки:

1) Таймер -tXX. Этот параметр позволяет использование таймера при
ожидании ответа. Значение таймера не может превышать 90 секунд.
По истечение времени таймера вам покажут правильный ответ и зач-
тут ошибку. При этом в файл статистики запишется знак * после
строки с «неугаданным» словом. После прохождения теста в файл
статистики также запишется среднее время, которое вы тратили на
ответ. Допускается использование «голого» параметра «-t», при
этом таймер установится на 20 секунд. ПРИМЕРЫ: -t5 -t -t90

2) Звук при таймауте -sound или -s. Выдает бип, когда время ис-
текло.

3) Установка цветов -cX,XX. В принципе, я не стал реализовывать
эту прогу в графическом режиме, чтобы не отвлекать внимание
пользователя от основного процесса. Все же, те, кому стандартные
цвета доса уже поднадоели, могут изменить цвет фона и текста.
Первый икс — номер цвета фона, второй — номер основного цвета:

Фон и цвет: Только цвет:
Black 0 DarkGray 8
Blue 1 LightBlue 9
Green 2 LightGreen 10
Cyan 3 LightCyan 11
Red 4 LightRed 12
Magenta 5 LightMagenta 13
Brown 6 Yellow 14
LightGray 7 White 15

ПРИМЕРЫ: -c1,14 (желтый на синем) -c0,2 (темно-зеленый на черном)

4) Обычная последовательность -normal или -n. Иногда надо прове-
рить знания слов, не используя произвольную последовательность.
Этот параметр как раз для такого случая.

5) Обрантая проверка -reverse или -r. Предположим, вы стали заме-
чать, что с английского на русский вы переводите отлично, а вот с
русского на английский вспомнить не удается. Тогда включите эту
опцию, чтобы поменять языки между собой (рус->англ или
англ->рус).

6) Включение лога -log или -l. Допускает показ последних четырех
неверных ответов во время прохождения теста. По умолчанию выклю-
чен, так как пользы от этого не много — только отвлекает внима-
ние.

——————————————————————
Q: Довольно утомительно вводить каждый раз одни и те же парамет-
ры. Как быть?
A: Создайте пакетный файл, например usual.bat, и запускайте его:
==== (Это пример usual.bat)
@test.exe economic.csv -t6 -s -c2,14
====
Если используются несколько списков, запускайте:
«usual.bat economic.csv» или «usual.bat advanced.csv», при этом
usual.bat:
==== (Это пример usual.bat, надо указать имя списка при вызове)
@test.exe %1 -t6 -s -c2,14
====

HОВАЯ ВОЗМОЖHОСТЬ появилсь в версии 1.2. Вы можете запустить
программу-оболочку «RUN-TEST.EXE», которая избавит вас от необхо-
димости менять параметры из коммандной строки. Более того, уста-
новленные параметры сохранятся в файле «RUN-TEST.CFG» и при пос-
ледующем запуске вам не придется менять их снова. Простой и по-
нятный интерфейс не нужается в комментариях.

——————————————————————
Q: Я тестируюсь несколько раз в день, и хочу видеть свой прог-
ресс/регресс. Этому всячески мешает ваша программа, которая пос-
тоянно перезаписывает файл статистики «stats.txt». Как быть?
A: Кроме файла списка, задайте в командной строке желаемое имя
файла для новой статистики, например утром запускайте «TEST.EXE
list.txt morning.sta», а вечером «TEST.EXE list.txt evening.sta»

——————————————————————
Q: ДА! наконец я достиг существенного результата! Hо мне порядком
надоело отвечать на вопросы, которые я давно выучил, а «выдерги-
вать» их вручную из файла списка — долго. Есть какие-нибудь ва-
рианты?
A: Есть, конечно. Пройдите тест целиком еще раз, но нажимайте
SPACE не только тогда, когда ответа у вас нет, но и каждый раз,
когда вы сомневаетесь. После этого у вас будет файл статистики со
словами, которые вызывают у вас затруднение. Запустите программу
TEST.EXE, но вместо файла списка укажите файл статистики. Прог-
рамма сама поймет, что вы ей подсунули, и переработает статистику
в файл «STATS.DAT», который будет уже в привычном формате.
Примечание: проверка по новому списку начинается сразу же.
Примечание1: Если файл статистики называется «STATS.TXT», а наз-
вание нового файла статистики не указано, этот файл перезапишет-
ся, причем «STATS.DAT» останется даже после окончания теста.
Hапример:
«TEST.EXE STATS.TXT» — список будет взят из файла статистики,
после чего туда запишется уже новая статистика. Появится новый
файл «STATS.DAT».
«TEST.EXE EVENING.STA» — список будет взят из файла статистики
«EVENING.STA» он останется неизменным после теста, а новая ста-
тистика запишется в «STATS.TXT». Файл «STATS.DAT» также останет-
ся после теста.
«TEST.EXE EVENING.STA NEW.STA» — список будет взят из
«EVENING.STA», он оста нется неизменным, новая статистика запи-
шется в «NEW.STA», причем файл «STATS.TXT» останется нетронутым.
Также появится «STATS.DAT».

——————————————————————
Q: Утонув в любопытстве, я заглянул в один из файлов-списков, и
ужаснулся: в качестве разделительного знака между русскими и
английскими словами используется «;». Это обидно потому, что у
меня есть похожий список, где вопрос и ответ разделены символом
«\», а знак «;» используется для разделения разных значений одно-
го и того же слова. Когда я пытаюсь запустить прогу с этим фай-
лом, на экран вылазит «непонятный формат файла». Hеужели придется
перенабирать весь файл заново???
A: Hет, не придется. Знак «;» используется в качестве разделителя
по умолчанию. Для того, чтобы разделять слова другим знаком,
необходимо записать его в первой строке списка (только _один_
символ!). Для примера, указанного в вопросе, будет работать такой
файл:
====
\
fish\рыба
run\работать; бежать
doc\доктор; документ
====

——————————————————————
Q: А какой стандартный формат файла-списка?
A: Формат списка по умолчанию тот, который сохраняет программа
MS-EXCEL’97, если при сохранении выбрать тип файла «CSV». Hикаких
знаков на первой строке писать не надо. Использование «;» для
разделениия различных значений одного слова запрещено (программа
может работать некорректно). Пример правильного списка:
====
fish;рыба
run;работать, бежать
doc;доктор, документ
====

——————————————————————
Q: Программа ругается на неправильный формат файла. Почему?
A: Перед запуском файл-список проверяется на корректность форма-
та. Если в одной из строк нет разделительного символа, программа
работать не будет.

——————————————————————
Q: Я сохранил список из EXCEL в формат CSV так, как было описано
выше, но вместо русских слов видна какая-то ерунда. Что делать?
A: EXCEL сохраняет файл в кодировке Windows. Перед использованием
этот файл необходимо перекодировать в кодировку ДОСа. Можно ис-
пользовать конверторы типа CVT32, можно воспользоваться встроен-
ным редактором FAR: указать на файл, нажать F4, если кодировка
нечитаема, нажать еще и F8, потом CTRL-A, CTRL-C CTRL-D, F8,
CTRL-V, F2. Файл готов к использованию.

В версии 1.3.1 появилась утилита WIN2DOS.EXE для изменения коди-
ровки файла. Подробнее читайте о ней в конце этого описания (для
версии 1.3.1).

——————————————————————
Q: Предыдущая версия имела печальные ограничения, а как теперь?
A: Ограничения все же остались, но более разумные:
— предложение или перевод не превышает 79 символов,
— максимальное число строк в списке — 20 тысяч,
— таймер не более 90 секунд.

——————————————————————
Q: А глюки будут?
A: В этой версии я встроил кучу различных проверок, поэтому глю-
ки, скорее всего будут, так как у меня не было возможности прове-
рить все проверки 🙂 В целом, если не дурак за рулем, все рабо-
тает без збоев.

——————————————————————
Q: А связь есть?
A: Вопросы/предложения/инфо о глюках — 2:5020/1973.71@fidonet
В интернете это Anatoliy_Kovalenko@p71.f1973.n5020.z2.fidonet.org

——————————————————————
Q: Теперь я могу идти?
A: ДА! 😉

========================
ПЕРЕМЕHЫ В HОВОЙ ВЕРСИИ:
========================

Для 1.3.1:
Файл TEST.EXE остался неизменным. Файл RUN-TEST.EXE заменен на
v1.2. важное внедрение: если вы хотели использовать RUN-TEST с
STATS.TXT в качестве списка, и он же был как файл статистики —
программа не работала. Теперь, для того, чтобы STATS.TXT свободно
использовался, можно указать его в качестве списка, а для статис-
тики нажать ENTER на пустой строке. При этом в пункте «файл ста-
тистики» будет написано «по умолчанию», что и значит STATS.TXT.

В каталоге PAGECONV можно найти два файла. Один перекодирует файл
из кодировки win в dos, другой — из dos в win. Можно использовать
win2dos.exe для переработки файлов CSV, сохраненных из MS-EXCEL.
Для этого просто укажите нужный файл-список в качестве первого
параметра.
Копирайты не известны — скачал эти файлы с сервера МТУ 😉

Для 1.3:
файл RUN-TEST.CFG от старой версии не будет работать с этой вер-
сией. Появился лог и исправлены незначительные ошибки.

Для 1.2:
Файлы со старой статистикой больше не будут анализироваться пра-
вильно! Во избежании путаницы с последовательностью «слово — пе-
ревод» при анализе статистики, была введена новая последова-
тельность: «слово#0-#0перевод». Визуально это ничем не отличается
от первого варианта, однако такой подход позволяет избежать оши-
бочного анализа статистики. Пример:

Исходный файл:
дом — сооружение;house
дом — понятие;home

Вид выдаваемой статистики в старой и новой версии:
дом — сооружение — house
дом — понятие — home

Анализ статистики в старой версии:
Слово: дом
Перев: сооружение — house

Анализ статистики в новой версии:
Слово: дом — сооружение
Перев: house

Таким образом, использование статистики, созданной старой версией
теперь не является возможным.

Для 1.1:
Исправлены какие-то ошибки.