Загрузка файлов с расширением .md (Markdown)
1. Вопрос
2. Ответ
2.1. С конвертацией в другой формат (HTML, PDF, Word)
2.2. В изначальном виде без конвертации
2.3. С использованием специального редактора
1. Вопрос:
Создатель курсов планирует загружать в СЭО 3KL теоретические материалы, но имеющиеся файлы представлены в формате с расширением .md (Markdown). Как можно загрузить файлы такого формата в курс, чтобы слушатели курса могли изучать предоставленный материал?
2. Ответ:
Загрузить в СЭО 3KL файлы в формате с расширением .md (Markdown) можно использовать три варианта реализации: Табл. 2.1.
| Вариант реализации | Преимущества | Недостатки |
| С конвертацией в другой формат (HTML, Word, PDF) | Позволяет разместить в СЭО 3KL файл, в котором синтаксис Markdown будет преобразован в форматированный текст. Подойдет, если разместить в СЭО 3KL нужно только один файл в формате Markdown | Требует использования посторонних конвертеров |
| В изначальном виде без конвертации | Наиболее простой способ размещения, не требует предварительной настройки СЭО 3KL или конвертации файла | Файл будет размещен без преобразования синтаксиса Markdown в форматированный текст |
| С использованием специального редактора | Решение позволяет пользователю выбрать в качестве редактора для отображения в СЭО 3KL редактор «Простой текст», который позволяет автоматически обрабатывать текст в формате Markdown, добавленный в элементы курса или ресурсы. Поэтому способ подойдет в случае, если пользователю нужно разместить в СЭО 3KL несколько файлов Markdown подряд или размещать их регулярно | Пользователю нужно будет при работе с материалами СЭО 3KL переключаться между редактором «Простой текст» для размещения материалов в формате Markdown и редактором TinyMCE для использования широких возможностей для форматирования текстов при вводе их в текстовых областях СЭО 3KL |
2.1. С конвертацией в другой формат (HTML, PDF, Word)
Рекомендуется использовать данный способ, если создатель курса в будущем планирует вносить изменения в загруженный материал, используя для этого инструменты редактирования и форматирования СЭО 3KL. При использовании данного способа файл сначала необходимо переконвертировать в формат документа Word, затем загрузить в один из ресурсов: «Страница» или «Книга».
Для того, чтобы после импорта в СЭО 3KL файла с расширением .md иметь возможность форматирования и редактирования материалов, рекомендуем воспользоваться конвертацией файла в один из форматов: HTML, Word, PDF.
Преимущество конвертации в HTML формат – это универсальные возможности по размещению контента. Большинство текстовых редакторов, в том числе редактор по умолчанию в СЭО 3KL – TinyMCE, поддерживают возможность редактирования HTML-кода. Это значит, что сконвертированный файл вы сможете интегрировать туда, где в курсе предполагается размещение текста. Также файл HTML формата можно загрузить в курс с помощью ресурса «Файл» (подробнее об этом варианте читайте в разделе «Конвертация в формат PDF», т. к. загрузка файлов в различных форматах в этот ресурс аналогична).
Вы можете переконвертировать файл в формат HTML-документа. Для конвертации вы можете воспользоваться любым конвертером, например, бесплатной утилитой Pandoc (подробнее – https://pandoc.org/demos.html и https://pandoc.org/app/). Для этой утилиты доступна не только онлайн версия, но и версия для командной строки, в которой файлы можно сконвертировать пакетно.
Сконвертированный в HTML-файл можно загрузить в один из ресурсов в курсе: «Книга» или «Страница».
Чтобы разместить в ресурсе «Книга» HTML-код переконвертированного файла, нужно в меню инструментов редактора нажать на кнопку «Инструменты» (поз. 1 Рис. 2.1.1) и выбрать опцию «Исходный код» (поз. 2 Рис. 2.1.1).
Откроется модальное окно, в основную область которого нужно вставить HTML-код из файла (поз. 1 Рис. 2.1.2), затем нажать на кнопку «Сохранить» (поз. 2 Рис. 2.1.2).
После сохранения главы Книги она отобразится на странице курса с тем форматированием, которое оформляет текст по правилам синтаксиса Markdown, а также применяется к заголовкам ресурса «Книга» (Рис. 2.1.3).
Можно переконвертировать файлы в формате с расширением .md в формат документа Word с расширением .doc или .docx. Для конвертации нужно воспользоваться конвертером Markdown в Word (docx).
После конвертации файл с материалами можно будет загрузить в один из ресурсов в курсе: «Книга» или «Страница».
Для импорта материалов в ресурс «Страница» в меню инструментов редактора необходимо нажать «Импорт файла Word» (Рис. 2.1.4).
Далее необходимо загрузить конвертированный файл. В открывшемся всплывающем окне нужно выбрать хранилище «Загрузить файл» (поз. 1 Рис. 2.1.5) и нажать на «Обзор» (поз. 2 Рис. 2.1.5).
Затем нужно выбрать файл в файловой системе устройства (поз. 1 Рис. 2.1.6) и нажать «Выбрать» (поз. 2 Рис. 2.1.6).
Название выбранного файла отобразится рядом с кнопкой «Обзор» (поз. 1 Рис. 2.1.7). Далее нужно нажать «Загрузить этот файл» (поз. 2 Рис. 2.1.7).
Импортированную в ресурс «Страница» информацию можно редактировать и форматировать.
После сохранения (нажатия на кнопку «Сохранить и показать» на странице настроек ресурса) материал отобразится в ресурсе «Страница».
1) «Добавление в Книгу конспекта лекции из doc-файла (Microsoft Word)»;
2) «Ресурс «Книга» - в разделе «Импорт из Microsoft Word»;
3) «Плагин Wordimport: импорт из Microsoft Word в ресурс Книга».
Можно переконвертировать файлы в формат PDF. Для конвертации можно воспользоваться любым конвертером.
Файлы в формате PDF можно загрузить в СЭО 3KL через ресурс «Файл».
Для этого нужно на странице создания ресурса «Файл» нажать на кнопку «Добавить...» (поз. 1 Рис. 2.1.8).
Далее необходимо загрузить конвертированный файл. В открывшемся всплывающем окне нужно выбрать хранилище «Загрузить файл» (поз. 1 Рис. 2.1.9) и нажать на «Обзор» (поз. 2 Рис. 2.1.9).
Затем нужно выбрать файл в файловой системе устройства (поз. 1 Рис. 2.1.10) и нажать «Выбрать» (поз. 2. Рис. 2.1.10).
Название выбранного файла отобразится рядом с кнопкой «Обзор» (поз. 1 Рис. 2.1.11). Далее нужно нажать «Загрузить этот файл» (поз. 2 Рис. 2.1.11).
Далее нужно выбрать «Способ отображения» = «Внедрить» (поз. 1 Рис. 2.1.12), чтобы материал отображался на странице ресурса «Файл», и нажать на кнопку «Сохранить и показать» (поз. 2 Рис. 2.1.12).
После таких настроек материал будет интегрирован в СЭО 3KL и будет отображаться в элементе курса «Файл» во встроенном просмотрщике PDF-файлов (Рис. 2.1.13).
2.2. В изначальном виде без конвертации
Рекомендуется использовать данный способ, если создателю курса не столь важно оформление документа и редактирование или форматирование документа в будущем не предполагается. При использовании данного способа материалы в курс загружаются с помощью ресурса «Файл», потому возможности вносить изменения в документ, используя для этого инструменты редактирования и форматирования СЭО 3KL у создателя курса не будет. Внешний вид материала будет зависеть от выбранного в настройках ресурса способа отображения.
Если создателю курса не важна эстетическая сторона отображения материала и он не планирует редактировать или форматировать содержимое документа, используя для этого инструменты СЭО 3KL, то можно загрузить файл в формате с расширением .md (Markdown) в ресурс «Файл» и настроить его отображение на странице ресурса.
Для того, чтобы загрузить файл в СЭО 3KL, нужно на странице настроек ресурса «Файл» в меню действий в поле «Выберите файл» нажать на кнопку «Добавить» (Рис. 2.2.1).
В открывшемся всплывающем окне нужно выбрать файл для загрузки: выбрать хранилище «Загрузить файл» (поз. 1 Рис. 2.2.2) и нажать на «Обзор» (поз. 2 Рис. 2.2.2).
Далее нужно выбрать файл в файловой системе устройства (поз. 1 Рис. 2.2.3) и нажать «Выбрать» (поз. 2 Рис. 2.2.3).
Название выбранного файла отобразится рядом с кнопкой «Обзор» (поз. 1 Рис. 2.2.4). Далее нужно нажать «Загрузить этот файл» (поз. 2 Рис. 2.2.4).
Загруженный файл появится в поле «Выберите файлы» (Рис. 2.2.5).
Далее необходимо выбрать «Способ отображения» (группа настроек «Внешний вид») (Рис. 2.2.6).
Чтобы содержимое документа отображалось на странице курса, рекомендуется использовать «Способ отображения» = «Внедрить» (см. поз. 1 Рис. 2.2.6).
В зависимости от выбранного способа отображения содержимое файла по-разному будет показано слушателю (Рис. 2.2.7).
1) Способ отображения «Внедрить»;
2) Способ отображения «Открыть»;
3) Способ отображения «Во всплывающем окне»;
4) Способ отображения «Принудительное скачивание».
2.3. С использованием специального редактора
Сотрудник, который занимается размещением контента, может выбрать в качестве текстового редактора для всех интерфейсов в СЭО 3KL редактор «Простой текст». Это редактор, с ограниченным функционалом, в котором нет быстрых клавиш и опций для форматирования текста прямо в редакторе, однако этот редактор позволяет преобразовать текст формата Markdown в форматированный текст.
Для того, чтобы выбрать текстовый редактор, пользователю нужно перейти по пути: меню навигации пользователя -> Настройки -> Раздел «Учетная запись пользователя» -> Настройки редактора (Рис. 2.3.1). На открывшейся странице пользователю нужно выбрать в качестве редактора «Простой текст» (поз. 1 Рис. 2.3.1).
После этого во всех интерфейсах СЭО 3KL, где доступен редактор для редактирования текста, пользователю будет отображаться редактор «Простой текст» (Рис. 2.3.2). Для того, чтобы преобразовать через этот редактор текст в формате Markdown, нужно выбрать под окном с редактором тип формата «Формат Markdown» (поз. 1 Рис. 2.3.2) и вставить текст в окно для текста (поз. 2 Рис. 2.3.2).
Текст будет обработан редактором и отобразится с оформлением, в котором применены элементы форматирования (Рис. 2.3.3).