Вывод¶
Рекомендуемый стек для публикации результатов моей работы¶
Для публикации результатов экспериментов по записи взгляда в VR я рекомендую связку: MkDocs с темой Material как генератор, Python-скрипт обработки данных, вызываемый из Makefile перед сборкой, GitHub Actions (или совместимый GitVerse) для автоматизации и доставку командой wrangler pages deploy на Cloudflare Pages рядом с публикацией на GitHub Pages.
Причины выбора:
- Сайт состоит в основном из текста, таблиц и нескольких графиков. Markdown-исходники и готовая тема Material закрывают это без настройки.
- Расчёт отделён от вёрстки: скрипт строит таблицы и графики, MkDocs подключает их как готовые артефакты. Так сборка остаётся быстрой, а результат привязывается к версии кода и данных через метку версии.
- Режим
--strictи проверка опубликованной страницы после выкладки не дают выложить сломанный сайт. - Доставка на shell-командах (
wrangler,rsync,curl) переносится между платформами почти без изменений, в отличие от действий, специфичных для GitHub.
Когда рекомендация меняется¶
| Условие | Что менять |
|---|---|
| Нужны нумерованные формулы, перекрёстные ссылки на рисунки и BibTeX-библиография, как в статье | перейти на Sphinx с MyST-Parser или Quarto, у них эти возможности встроены |
| Результаты считаются прямо в ноутбуках и должны исполняться при сборке | Quarto или MyST-NB вместо отдельного скрипта |
| Вычисления тяжёлые (обучение модели-стабилизатора, видеозаписи сессий) | считать вне CI, а сайт собирать из готовых артефактов; в метке версии хранить хеши данных и модели |
| Данные содержат записи участников с ОВЗ | не публиковать сырые записи; на сайт выкладывать только агрегированные метрики и получать отдельное согласие участников |
| Репозиторий нужно держать на отечественной платформе | GitVerse, как наиболее близкая по синтаксису к GitHub Actions; публикацию на Pages заменить доставкой по SSH или S3 |
| Нужно версионирование опубликованных результатов | добавить mike и привязать выкладку версии к git-тегу |
Что не проверено¶
Результаты на странице P3 получены на небольшой пилотной записи и описывают один набор данных одного автора. Сравнение групп с ОВЗ и без ОВЗ в этой работе не выполнялось. Время сборки в CI и на хостинге нужно снять на реальных запусках; значения в таблицах локальные.