= ИНСТРУКЦИЯ ПО ФОРМИРОВАНИЮ ПАКЕТОВ УЧЕБНЫХ МАТЕРИАЛОВ
:figure-caption: Рисунок
:table-caption: Таблица
:note-caption: Примечание
:imagesdir: ./images
:sectnums:
:toc: left
:toc-title: Содержание

<<<
== ИСПОЛЬЗУЕМОЕ ПО. ЗАПУСК

Для формирования пакетов учебных материалов (далее – ПУМ) используйте конвертер, который размещен на сервере: _________. Конвертер также можно загрузить из 
https://msk.dinamika-avia.ru/redmine/issues/7326[Redmine].

Скопируйте программу на свое рабочее место.

Для открытия программы запустите файл «Converter.exe» (рис. 1).

Окно программы после запуска имеет вид, показанный на рис. 2.

.Файл «Converter.exe»
image::image01.png[100%, align="center"]

.Стартовое окно конвертера
image::image02.png[100%, align="center"]

<<<
== ЗАГРУЗКА СТРУКТУРЫ АУК ПОИСК ОШИБОК

Для открытия файла со структурой автоматизированного учебного курса (далее – АУК) нажмите кнопку «Импортировать данные из файла Lyx» image:pic1.png[100%] . В появившемся системном окне выберите файл со структурой АУК и нажмите «Открыть».

Открытая в программе структура АУК показана на рис. 3.

[NOTE]
====
. Если модуль сценария имеет длинное название, то при попытке открытия оно будет обрезано. Перед работой в конвертере рекомендуется скопировать АУК на свое рабочее место.
. При повторном открытии конвертера по умолчанию будет открыт АУК, с которым велась работа в последний раз.
====

.Структура АУК
image::image03.png[100%, align="center"]

Для просмотра наличия ошибок в файле сценария нажмите по его названию в структуре АУК. В разделе «Ошибки импорта файла Lyx» при наличии ошибок будут выведены соответствующие данные (рис. 4):

* расположение файла сценария;
* результаты импорта.

.Отображение файла сценария. Раздел «Ошибки импорта файла Lyx»
image::image04.png[100%, align="center"]

Возможны следующие варианты отображения данных импорта:

* ошибки отсутствуют (рис. 5);
* ошибки некритичные (рис. 6) – обозначаются серым цветом;
* в файле сценария есть ошибки, требующие устранения (рис. 7) – обозначаются красным цветом.

В квадратных скобках рядом с ошибкой указывается строка файла сценария, в которой она обнаружена.

.Результат импорта: ошибки отсутствуют
image::image05.png[100%, align="center"]

.Результат импорта: есть некритичные ошибки
image::image06.png[100%, align="center"]

.Результат импорта: есть ошибки 
image::image07.png[100%, align="center"]

Если ошибку невозможно отследить (визуально ее не видно) в редакторе «Lyx», откройте файл сценария в программе «Notepad» и перейдите к той строке, которая указана в описании ошибки.

После исправления ошибок в файлах сценариев нажмите кнопку «Обновить из Lyx файла» image:pic2.png[100%] . Убедитесь в том, что ошибки отсутствуют. Для проверки отсутствия ошибок необходимо просмотреть все модули сценариев, последовательно выбирая каждую ветку дерева АУК.

После проверки данных темы / раздела / модуля нажмите на значок image:pic3.png[100%] , чтобы вручную отметить в системе завершение проверки темы / раздела / модуля (рис. 8). Значок поменяет вид на image:pic4.png[100%] . Если метка устанавливалась в модуле сценария, то в дереве АУК с названия модуля будет снята метка image:pic3.png[100%] (рис. 9).

Если модуль сценария был обновлен, и в нем сохранились критические ошибки, то его метка вернется к виду image:pic3.png[100%] (см. рис. 8).

.Вид метки – модуль не проверен
image::image08.png[100%, align="center"]

.Вид метки – модуль проверен
image::image09.png[100%, align="center"]

<<<
== ПРОСМОТР ПУБЛИКАЦИИ

Для просмотра публикации в окне браузера нажмите кнопку «Открыть модуль в браузере» image:pic5.png[100%] (рис. 10), которая доступна только для модулей сценариев.

Просмотр сценариев посредством браузера – обязательная процедура тестирования.

Возможность просматривать файлы с вопросами до их загрузки в систему управления обучением (далее – СУО) отсутствует.

Пример окна просмотра публикации показан на рис. 11.

.Кнопка «Открыть модуль в браузере» на панели инструментов
image::image10.png[100%, align="center"]

.Просмотр публикации
image::image11.png[100%, align="center"]

В окне просмотра публикации отображается панель (см. рис. 11), которая открывается при нажатии левой кнопкой мыши по любой кнопке панели (рис. 12):

image:pic6.png[50, 50] – список логических частей модуля сценария (для них при редактировании сценария в «Lyx» должен быть назначен стиль «Подподраздел*», см. «Создание сценариев АУК в редакторе «Lyx», п. 2.21);

image:pic7.png[50, 50] – список рисунков сценария;

image:pic8.png[50, 50] – список мультимедийных элементов (видео) сценария;

image:pic9.png[50, 50] – список таблиц сценария.

Для перехода к любому элементу списка нажмите по его названию в списке.

Нажмите кнопку image:pic10.png[100%] , чтобы скрыть панель.

Для возврата к началу модуля сценария нажмите кнопку image:pic11.png[100%] внизу окна просмотра.

.Панель окна просмотра: список рисунков модуля сценария
image::image12.png[100%, align="center"]

Распространенные ошибки, которые встречаются в тексте сценария при его просмотре в браузере или конвертере, представлены в таблице 1.

.Наиболее распространенные ошибки в сценариях
[cols="2,^4,3"]
|===
|Тип ошибки |Вид ошибки в сценарии |Описание и причины ошибки. Способы ее устранения

|Некорректная ссылка на термин 
|image:pic12.png[100%]
|Рядом с глоссарным термином появляется многоточие – это означает, что ссылка на глоссарный термин введена в модуле, который в структуре курса располагается «ниже» текущего.

Введите термин в текущем модуле или модуле, который в структуре АУК располагается «выше».

.2+|Неверное оформление стиля для заголовка части модуля
|image:pic13.png[100%]
|При вызове панели не отображается заголовок выделенной части модуля. Это означает, что такой заголовок оформлен не стилем «Подподраздел*», а выделен полужирным.

В редакторе «Lyx» оформите заголовок стилем «Подподраздел*» (см. «Создание сценариев АУК в редакторе «Lyx», п. 2.21).

|image:pic14.png[100%]
<|Перед заголовком части модуля указано «\series bold». Это означает, что к заголовку применили формат «полужирный».

Примените в «Lyx» для заголовка сначала формат «Обычный» (чтобы снять все стили), а затем – «Подподраздел*» (см. «Создание сценариев АУК в редакторе «Lyx», п. 2.21). 

|Неверное оформление стиля для рисунка
|image:pic15.png[100%]
|В конвертере в разделе ошибок отображается описание ошибки с меткой «fig». Это означает, что для указанного рисунка применен неверный стиль.

Поставьте курсор в начало строки с объектом «рисунок» и выберите стиль «Обычный».

|Неверное оформление стиля для таблицы
|image:pic16.png[100%]
|В конвертере в разделе ошибок отображается описание ошибки с меткой «tab». Это означает, что для указанной таблицы применен неверный стиль.

Поставьте курсор в начало строки с объектом «таблица» и выберите стиль «Обычный».
|===


<<<
== ЗАПОЛНЕНИЕ СЛУЖЕБНЫХ ДАННЫХ

В разделе программы «Публикация» информационные поля, требующие заполнения, подсвечены розовым цветом (рис. 13-15).

Заполнение данных полей осуществляется автоматически для каждой темы / раздела / модуля в отдельности при нажатии кнопки «Сформировать пакеты выходных данных»  . После нажатия кнопки   перейдите к выполнению п. 5.1.

Если в окне конвертера были изменены названия тем / разделов / модулей (поля «Титул» или «Техническое имя»), то эти изменения попадут только в публикацию, названия в исходных файлах останутся прежними.

.Раздел «Публикация» для уровня темы АУК
image::image13.png[100%, align="center"]

.Раздел «Публикация» для уровня раздела АУК
image::image14.png[100%, align="center"]

.Раздел «Публикация» для уровня модуля АУК
image::image15.png[100%, align="center"]

<<<
== ФОРМИРОВАНИЕ ПАКЕТОВ ВЫХОДНЫХ ДАННЫХ

=== Конфигурирование пакетов

Для формирования пакетов выходных данных на панели инструментов нажмите кнопку «Сформировать пакеты выходных данных» image:pic17.png[100%] . Откроется окно «Формирование и конфигурирование пакетов» (рис. 16).

При обнаружении ошибки будет выведено сообщение (рис. 17). Нажмите «ОК».

[NOTE]
====
Если в конвертере для модуля сценария или файла с вопросами метка image:pic3.png[100%] не была изменена на image:pic4.png[100%] , то в окне конфигурирования пакетов напротив соответствующего сценария будет стоять значок image:pic18.png[100%] (см. рис. 16).
====

.Окно «Формирование и конфигурирование пакетов»
image::image16.png[100%, align="center"]

.Пример окна с сообщением об ошибке
image::image17.png[100%, align="center"]

Для добавления пакета необходимо последовательно выполнить следующие шаги.

. В поле «Имя конфигурации пакета» введите его краткое обозначение.
+
--
Имя конфигурации пакета – это название категории обучаемых.

Имя конфигурации пакета не должно содержать символы русского языка и пробелы.

В одном пакете нельзя указывать одновременно две категории обучаемых.

Рекомендуемые имена для конфигурации пакета приведены в таблице 2.

.Наиболее распространенные ошибки в сценариях
[cols="^1,1"]
|===
|Имя пакета |Категория обучаемых

|K
|Командир комплекса

|OB
|Оператор ВМ-БЛА

|OV
|Оператор ВМ-В

|T
|Техник

|===
--

. Поле «Титул АУК» заполняется автоматически, конвертер использует название первой темы АУК. При необходимости укажите название АУК (после изменения названия АУК оно будет запомнено системой).
+
Поле «Титул АУК» одинаково для всех категорий.

.	Поле «Имя файла» по умолчанию заполнено кодом первой по списку публикации.
+
--
При необходимости укажите имя файла.

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

Поле «Имя файла» одинаково для всех категорий.
--

.	В разделе «Состав пакета» установите флажки напротив тем / разделов / модулей, которые необходимо включить в ПУМ для выбранной категории обучаемых   согласно документу «.doc1».

. Нажмите кнопку «Создать». Повторите для каждой создаваемой категории.
Для переключения между пакетами используйте выпадающий список «Имя конфигурации пакета» (рис. 18).
+
Для удаления пакета выберите его из выпадающего списка и нажмите кнопку «Удалить».
+
.Пример выбора пакета
image::image18.png[100%, align="center"]

.	При закрытии окна экспорта сконфигурированные пакеты будут сохранены в корневую папку АУК в файл с именем открываемого файла «LyX» и расширением «.xml» (например, «auk-04_klen.xml»).
+
Для выхода из окна экспорта нажмите клавишу «Esc». Все внесенные изменения сохранятся автоматически.


=== Формирование пакетов учебных материалов в оконном режиме

Нажмите кнопку «Сформировать пакеты выходных данных» image:pic17.png[100%] .

В окне экспорта выберите настроенный пакет конфигурации (см. рис. 18).

В поле «Расположение» укажите место на жестком диске, куда будет сохранен сформированный ПУМ (рис. 19).

Кнопки image:pic19.png[100%] и image:pic20.png[100%] не используются для АОС КБЛА ИВЦ (они позволяют сформировать ПУМ в наборе «.zip» архивов в форматах «S1000D» и «SCORM» соответственно).

Нажмите кнопку image:pic21.png[100%] , чтобы сформировать ПУМ в единой папке в формате «SCORM» для отображения учебных материалов через систему отображения электронной документации (просмотр ПУМ возможен без загрузки в СУО; в сформированной папке файл «index» открывает в браузере учебные материалы по всем категориям).

.Окно «Формирование и конфигурирование пакетов»
image::image19.png[100%, align="center"]

Если при сохранении файл с указанным именем ПУМ уже существует, то программа выдаст окно с предупреждением.

При успешном завершении процедуры формирования ПУМ появится кратковременное сообщение «Успешно» (рис. 20).

.Сообщение «Успешно»
image::image20.png[100%, align="center"]


=== Формирование пакетов учебных материалов в консольном режиме

Данный функционал предназначен для автоматического формирования сконфигурированных ПУМ.

Описание требуемых параметров выводится при запуске конвертера посредством командной строки с аргументом «-h» (рис. 21).

Использование русских символов в путях «lyxfile» и «dstpath» не допускается.

Для проекта АОС КБЛА ИВЦ конвертер необходимо запускать только с аргументом 
«-SingleSCORM».

.Формирование ПУМ в консольном режиме
image::image21.png[100%]

<<<
== ПОДКЛЮЧЕНИЕ ПУМ В СУО. ПРОСМОТР АУК

Текст.

Пусть здесь будет начинаться текст.

Тут текст продолжается.


*Жирный текст*

_Курсив_

Нумерованный список:

. Первый.
. Второй:
.. с третьего по пятый:
... с пятого по девятый;
. Десятый.

Ненумерованный список:

* пункт;
* пункт:
** подпункт;
** подпункт:
*** мини:
**** микро;
* пункт.

https://oc.msk.dinamika-avia.ru[Облачко]

image::test.png[100%,align="center"]