Title: Руководство пользователя программы «Импорт курсов»
Author: Alexey Venediktov
Last saved by: User
Company: IRSoft

Руководство пользователя
программы «Импорт курсов»

Программа «Импорт курсов» предназначена для ввода учебных материалов, подготовленных пользователем самостоятельно, в систему NetSchool.

Создание учебных материалов

Учебные материалы представляют набор документов в формате HTML или txt, а также медиа-файлов, как правило, изображений в форматах JPEG, GIF или PNG. Для вновь создаваемого учебного материала рекомендуется завести отдельную папку, в которой будут находиться все файлы материалов. Внутри данной папки допускается создание структуры подкаталогов, если это нужно. Если используются изображения или другие медиа-файлы, то следует создать в каталоге учебных материалов подкаталог “Pictures” и скопировать изображения туда. Документы, содержащие картинки, должны ссылаться на изображения из этой папки, иначе картинки не будут отображаться после импорта в систему.

Пользователям, не ознакомленным со спецификациями формата HTML, рекомендуется пользоваться WYSIWYG-редакторами, такими как Microsoft FrontPage, Macromedia HomeSite+ или Microsoft Word.

Исходные данные

Исходными данными для ввода могут быть:
1.	Документы, созданные в любом редакторе HTML-файлов и сохраненные с расширением .htm или .html. Такие документы после ввода в NetSchool будут отображаться со всем HTML-форматированием.
2.	Документы, созданные в любом текстовом редакторе (например, Notepad) и сохраненные в формате .txt (“plain text”). Такие документы будут отображаться «как есть», поэтому в txt-файлах не должно быть какой-либо HTML-разметки или специального форматирования.
3.	Медиа-элементы, как правило, файлы изображений или графическая анимация, используемая в документах.

Настройки программы

После запуска программы пользователь увидит окно "Импорт курсов – настройки". 
Остановимся подробнее на настройке режимов работы программы:

Опции настройки режимов импорта | Назначение режимов импорта

“Удалять команды JavaScript и обработчики событий”

При включенной опции все сценарии JavaScript и обработчики событий (атрибуты вида “onmouseover” или “onload”) будут удалены из результирующего документа.
Цель: при непродуманном использовании или использовании неизвестных (возможно, содержащих ошибки) JavaScript в учебных материалах может нарушиться работоспособность системы или целостность восприятия учебного материала учеником.
Примечание: при выключенной опции “Удалять команды JavaScript и обработчики событий” сохранятся даже те скрипты, которые находятся за пределами тегов <BODY> и </BODY>.

“Корректировать ссылки перехода на другие документы”

При включенной опции во время импортирования все ссылки на локальные файлы (т.е. находящиеся на компьютере пользователя) будут удалены из результирующего документа. Ссылки на документы, находящиеся в Интернете, изменениям не подвергнутся.
Цель: система ”NetSchool” запускается с сервера (т.е. потенциально с другого компьютера) и ссылки на локальные файлы могут быть недействительными.

“Корректировать абсолютные ссылки на изображения”

При включенной опции во время импортирования все ссылки на локальные изображения (т.е. находящиеся на компьютере пользователя) будут изменены на относительные ссылки, как если бы эти изображения уже находились на сервере рядом с вашими HTML-файлами. Ссылки на документы, находящиеся в Интернете, изменениям не подвергнутся.
Цель: система ”NetSchool” запускается с сервера (т.е. потенциально с другого компьютера) и ссылки на локальные файлы могут быть недействительными.

“Удалять стили и классы тегов”

При включенной опции во время импортирования все стили документа и ссылки на стили (классы) будут удалены из результирующего документа.
Цель: при непродуманном использовании стилей в учебных материалах может нарушиться дизайн систем.
Примечание: при выключенной опции “Удалять стили и классы тегов” сохранятся даже те стили, которые определены за пределами тегов <BODY> и </BODY>.

“Корректировать XML-вложения”

При включенной опции во время импортирования все XML-вложения будут удалены из результирующего документа.
Цель: XML влияет на отображение учебного материала в браузере MS Internet Explorer и не влияет в браузере Netscape Navigator. При включенной опции будут удалены все “лишние” теги (т.е. не влияющие на визуализацию документа), остающиеся после подготовки материалов в MS Word (и последующем экспорте в HTML) или MS FrontPage.

Процесс ввода данных

После настройки режимов импорта и нажатия на кнопку “OK” пользователь попадает в главное окно программы «Импорт курсов». В этом окне необходимо задать каталог для поиска документов (в импорте будут участвовать и все подкаталоги указанного каталога). Медиа-файлы должны находиться в подкаталоге “Pictures” заданного пользователем каталога. В этом каталоге также будет создана результирующая база данных. Эти каталоги будут сохранены в реестре ОС компьютера пользователя и, при последующих запусках программы, будут указываться автоматически.

Пользователь может указать на необходимость прерывания импортирования при обнаружении ошибок в исходных данных. Для этого требуется включить опцию “Прервать импорт, если исходные данные неудовлетворительны” (опция включена по умолчанию). Файлы, содержащие ошибки HTML-кода, в любом случае не будут включены в результирующую базу данных, однако при импорте большого числа текстов, возможно, имеет смысл довести процесс до конца и после исправить все найденные ошибки за один раз. Если Вы считаете, что найденная ошибка не является ошибкой как таковой, то измените расширение документа на “txt”. Текстовые документы не проверяются на наличие ошибок, однако, при этом никак не модифицируется тело документа.

Для начала импортирования пользователю нужно нажать кнопку “Импорт”. При этом будут найдены все доступные для импортирования исходные материалы (внутри указанного пользователем каталога и его подкаталогов) и будет создана база данных.

Далее данные каждого файла будет проверены и скорректированы с учетом заданных настроек. После успешной коррекции исходного файла будет показано окно “Импорт курсов - информация”. В окне указано имя файла, имя базы данных, описание учебного материала. Пользователь может просмотреть и отредактировать измененный код HTML-файла или неизмененный текст txt-файла.  При наличии браузера MS Internet Explorer 5.0 и выше существует возможность просмотра результирующего документа и исходного файла для визуальной проверки внесенных изменений.

После импорта материалов будут импортированы все файлы из подкаталога “Pictures”. Размер отдельного файла из этого каталога не должен превышать 2Мб, файлы большего размера будут игнорированы при импорте. Пользователь должен стараться не оставлять в подкаталоге “Pictures” файлы, на которые нет ссылок из документов, так как это ведет к увеличению результирующей базы данных, времени закачки файла импорта на сервер, неэффективному использованию дискового пространства на сервере, усложнением последующей работы с материалами.

Описание содержимого курса

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

1.	Заполнять соответствующие поля в процессе импортирования текстов в окне диалога.
2.	В случае использования HTML-документов указывать элементы описания еще на этапе разработки материала. Для этого следует создать специальные теги описания в виде комментария к основному тексту:
<!--
<Тег описания 1>Содержание описания 1
<Тег описания 2>Содержание описания 2
…
<Тег описания N>Содержание описания N
-->
Второй способ предпочтителен, так как отпадает необходимость ручного заполнения в случае неоднократного исправления текстов и повторного ввода в базу данных.

Каждый тег описания может занимать несколько строчек. Порядок следования тегов описания и использование заглавного или строчного шрифта безразлично.

В системе NetSchool используются следующие элементы описания:

Элемент описания | Тег описания | Назначение
Заголовок | <TITLE> | Наименование текста

Тип

<TYPE>

Тип текста: (1) развлекательный, (2) функциональный, (3) образовательный.
Тип 3 выбирается по умолчанию.

Версия | <VERSION> | Версия текста – используется при обновлении.
Уровень сложности | <LEVEL> | Уровень сложности: принята условная шкала, в которой 1-му классу соответствует диапазон 100-200, 2-му классу - 200-300, и т.д.
Раздел | <SUBJECT> | Название предмета или раздела, к которому относится текст
Источник (Учебник) | <SOURCE> | Источник текста или использовавшийся учебник
Краткая аннотация | <SUMMARY> | Краткое содержание текста

При указании всех полей описания и нажатия кнопки “Добавить” текст сохраняется в базе данных, затем начинает обрабатываться следующий файл.

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

Если вы указали во всех исходных документах теги описания и уверены, что обработка курса производится корректно, то можно избежать подтверждения добавления текстов в базу данных, для этого отметьте опцию “Не показывать диалог, если все теги описания найдены и удовлетворительны”. При этом данное окно больше показываться не будет, и все тексты будут обработаны и добавлены автоматически, при условии отсутствия ошибок в исходных данных и нахождении всех тегов описания.

Полученную в результате базу данных в формате MS Access (.mdb) можно использовать для добавления в систему NetSchool. Обязательное условие - сохранение относительной структуры каталогов, при этом в качестве корневого выступает начальный каталог, предложенный программе «Импорт курсов».

Желаем вам успехов в создании собственных авторских курсов!

© 2007-2008 ИРТех
support@net-school.ru