Гипертекстовый учебник

1. Общие сведения.

1.1 Запуск

Для открытия гипертекстового учебника в Web-браузере достаточно выбрать пункт главного меню Кумира "Инструменты" - "Гипертекстовый учебник".
После этого запускается Web-браузер, используемый по умолчанию, и в нём открывается файл ht\index.html (путь указан относительно директории Кумира), который и содержит "корень" учебника. Учебник может читаться любым браузером, поддерживающим выполнение скриптов JavaScript.

Замечание. При выполнении описанных выше действий внутри системы Кумир стартует HTTP-сервер (по умолчанию на порту 4243). Кроме того, как независимое от Кумира приложение, запускается внешний Web-браузер; в браузере открывается страница http://localhost:номер_порта. Эта страница связана с указанным выше файлом.

1.2. Файлы гипертекстового учебника.

Файлы гипертекстового учебника (далее -- учебника) располагаются в подкаталоге ht основного каталога системы КуМир; ниже этот подкаталог называется каталогом учебника. При создании учебника допускается использование файлов следующих видов:

Замечание. Учебник может располагаться и вне подкаталога ht. Путь к каталогу с файлами учебника можно задавать в окне настроек Кумира, на вкладке "Каталоги и файлы".

1.3. Основной скрипт.

Один из js-файлов (httpd.js)- служебный. Этот файл содержит скрипты, необходимые для организации пересылки сообщений между браузером и запущенным Кумиром. Присутствие этого файла в каталоге гипертекста обязательно. Основной скрипт должен быть подключен к каждому HTML-файлу учебника с помощью строки в заголовке (head) HTML-файла:
<script type="text/javascript" src="httpd.js"></script>

При необходимости расширить набор возможностей взаимодействия браузера с системой КуМир, список функций, описанных в файле httpd.js может быть дополнен. Набор функций, реализованных в версии от 10.07.09 описан ниже в разделе 2.

1.4. Создание новых гипертекстовых страниц

Для создания новых гипертекстов необходимо:
  1. Создать страницу на языке HTML.
  2. Включить в заголовке этой страницы использование файла httpd.js. См. выше.
  3. Подготовить текст страницы. Для реализации управления системой Кумир используйте функции JavaScript, описанные в файле httpd.js. Подробнее см. ниже.
  4. Сохранить страницу в подкаталог с гипертекстами Кумира (например, под именем xxx1.html).
  5. Открыть полученную страницу в браузере можно по адресу http://localhost:номер_порта/xxx1.html. Этот адрес можно непосредственно ввести в адресную строку браузера либо использовать в качестве гиперссылки.

2. Функции, описанные в файле httpd.js

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

Проверить соединение с Кумиром

Нажмите эту ссылку для проверки

Установить текст программы в редакторе Кумира

Вызов: setProgramText(text)

Параметр вызова text -- текст программы.

Пример:

Открыть файл с текстом программы в Кумире

Вызов: setProgramFile(file)

Параметр вызова file -- имя файла с программой. Имя файла задается относительно каталога HTML-файла.

Пример:

Выполнить программу в Кумире

Вызов: runProgram()

Пример:

Сделать большой ШАГ выполнения

Вызов: STEP()

Пример:

Сделать маленький шаг выполнения

Вызов: step()

Пример:

Выполнить алгоритм

Вызов: runAlg(name)

Параметр вызова name -- имя алгоритма.

Пример:

Вернуть значение переменной

Вызов: val(module, alg, name)

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

Пример 1: Значение "а"
Пример 2: Значение "с"

Остановить выполнение

Вызов: stop()

Пример:

Установить обстановку Робота

Вызов: setRobotField(file)

Параметр вызова file -- имя файла с обстановкой. Имя файла задается относительно каталога HTML-файла.

Пример:
Установить обстановку Задать текст программы Выполнить программу