Об этом проекте
H5P Game Map — это тип контента H5P, позволяющий студентам выбирать собственные упражнения из интерфейса игровой карты.
Ожидания по поддержке: в README указано, что тип контента является результатом контрактной работы с конкретными требованиями, которые могут не соответствовать ожиданиям других пользователей. Разработчик сделал его открыто доступным для бесплатного использования, но не обязан предоставлять бесплатную поддержку, принимать запросы на функции или pull-запросы; он может продолжать работу над ним в своем собственном темпе.
Рабочий процесс сборки, как описано:
- Клонируйте репозиторий с помощью git и переключитесь на интересующую вас ветку.
- Выполните npm install для установки необходимых модулей.
- Выполните npm run build для сборки проекта или npm run watch для непрерывной пересборки при редактировании.
- Всегда выполняйте npm run build перед выводом кода в производство.
- Выполните npm run lint для проверки на нарушения руководства по стилю кодирования.
- Процесс сборки транспилирует ES6 в более ранние версии для улучшения совместимости со старыми браузерами; функции, которые некоторые браузеры не поддерживают, требуют полифилла.
- Процесс сборки также перемещает исходные файлы в один файл дистрибутива и минифицирует код.
Обход ограничения размера семантики: общие интеграции H5P используют базы данных mySQL, в которых поле semantics таблицы h5p_libraries имеет тип text, вмещающий до 64 КБ данных. Файл semantics.json для GameMap превышает этот лимит, поэтому проект хранит semantics_src.json и минифицирует его, для чего используется npm run build_semantics. В README отмечается, что это не идеально, потому что его нужно запускать при изменении семантики, и что npm run build и npm run watch также строят минифицированную семантику.
Упаковка: в README рекомендуется установить инструмент командной строки H5P вместо ручного архивирования всего, потому что этот инструмент автоматически обрабатывает несколько вещей. В простых случаях достаточно выполнить h5p pack с указанием каталога репозитория и имени целевого файла. Для получения дополнительной информации об использовании файлов дистрибутива в H5P в README есть ссылка на вводное видео и руководство разработчика H5P на h5p.org/library-development.
В предоставленном README нет условий лицензии, информации о версии, списка функций или документации по использованию конечным пользователем, кроме этих заметок по сборке, семантике и упаковке.
Comments
0 Rating appears after 10 ratings
Sign in to join the discussion.