Для открытия гипертекстового учебника в Web-браузере достаточно выбрать пункт главного меню Кумира "Инструменты" - "Гипертекстовый учебник".
После этого запускается Web-браузер, используемый по умолчанию, и в нём открывается файл ht\index.html (путь указан относительно директории Кумира), который и содержит "корень" учебника. Учебник может читаться любым браузером, поддерживающим выполнение скриптов JavaScript.
Замечание. При выполнении описанных выше действий внутри системы Кумир стартует HTTP-сервер (по умолчанию на порту 4243). Кроме того, как независимое от Кумира приложение, запускается внешний Web-браузер; в браузере открывается страница http://localhost:номер_порта. Эта страница связана с указанным выше файлом.
Файлы гипертекстового учебника (далее -- учебника) располагаются в подкаталоге ht основного каталога системы КуМир; ниже этот подкаталог называется каталогом учебника. При создании учебника допускается использование файлов следующих видов:
Один из js-файлов (httpd.js)- служебный. Этот файл содержит скрипты, необходимые для организации пересылки сообщений между браузером и запущенным Кумиром. Присутствие этого файла в каталоге гипертекста обязательно.
Основной скрипт должен быть подключен к каждому HTML-файлу учебника с помощью строки в заголовке (head) HTML-файла:
<script type="text/javascript" src="httpd.js"></script>
При необходимости расширить набор возможностей взаимодействия браузера с системой КуМир, список функций, описанных в файле httpd.js может быть дополнен. Набор функций, реализованных в версии от 10.07.09 описан ниже в разделе 2.
Вызов: setProgramText(text)
Параметр вызова text
-- текст программы.
Вызов: setProgramFile(file)
Параметр вызова file
-- имя файла с программой. Имя файла задается относительно каталога HTML-файла.
Пример:
Вызов: runProgram()
Вызов: STEP()
Вызов: step()
Вызов: runAlg(name)
Параметр вызова name
-- имя алгоритма.
Вызов: val(module, alg, name)
Параметры вызова:
module
-- имя исполнителяalg
-- имя алгоритмаname
-- имя переменнойВызов: stop()
Вызов: setRobotField(file)
Параметр вызова file
-- имя файла с обстановкой. Имя файла задается относительно каталога HTML-файла.
Пример:
Установить обстановку
Задать текст программы
Выполнить программу