Перейти к содержанию

Вывод

Рекомендуемый стек для публикации результатов моей работы

Для публикации результатов экспериментов по записи взгляда в 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 и на хостинге нужно снять на реальных запусках; значения в таблицах локальные.