Skip to content
evilfaustPublic

About

Интерактивные пошаговые построения по геометрии

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Geometry

Небольшой статический сайт с интерактивными пошаговыми построениями геометрических фигур для учеников.

Сейчас в проекте есть пять учебных страниц:

  • compass-theory/ - теория базовых построений циркулем и линейкой
  • triangle-presentation/ - построение правильного треугольника
  • hexagon-presentation/ - построение правильного шестиугольника
  • pentagon-presentation/ - построение правильного пятиугольника
  • egg-presentation/ - построение контура яйца из дуг

На корневой странице index.html находится главная навигация по этим построениям.

Что есть на сайте

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

Каждая модель показывает чертеж по шагам: можно листать этапы вперед и назад, открывать нужный шаг из списка и пользоваться сайтом с телефона.

Структура проекта

geometry/
├── index.html
├── site.css
├── presentation.css
├── step-ux.js
├── README.md
├── DEPLOYMENT.md
├── compass-theory/
│   ├── index.html
│   └── script.js
├── egg-presentation/
│   ├── index.html
│   └── script.js
├── hexagon-presentation/
│   ├── index.html
│   └── script.js
├── nginx/
│   └── geometry.oipav.ru.conf
├── pentagon-presentation/
│   ├── index.html
│   └── script.js
└── triangle-presentation/
    ├── index.html
    └── script.js

Как запустить локально

Проект статический, поэтому достаточно любого простого HTTP-сервера.

Пример с Python:

cd /Users/evilfaust/Documents/APP/geometry
python3 -m http.server 4173

После этого сайт будет доступен по адресу:

http://127.0.0.1:4173

Что уже сделано по интерфейсу

  • добавлена главная страница с переходом ко всем моделям
  • добавлена отдельная учебная тема по теории построений
  • введен единый визуальный стиль для всего сайта
  • добавлена общая навигация между страницами
  • интерфейсы адаптированы под мобильные устройства
  • улучшены подсказки, карточка текущего шага и список всех этапов
  • подключен логотип проекта и favicon
  • на телефоне чертеж виден на первом экране: компактная шапка, меню в одну прокручиваемую строку, кнопки «Назад» и «Вперед» прилипают к низу экрана
  • элементы, появившиеся на текущем шаге, подсвечиваются; под чертежом есть легенда цветов
  • номер шага хранится в адресе (#step=3, для теории #model=2&step=3): ссылкой можно поделиться
  • шаги листаются свайпом по чертежу, стрелками клавиатуры (без модификаторов) и из списка шагов

Общий скрипт step-ux.js

Подключается перед script.js каждой страницы с построением и дает глобальный объект StepUX:

  • highlightNew(container, scope, index) — подсвечивает новые элементы SVG при переходе на шаг вперед
  • readHash(), writeHash(values), onHashChange(callback) — номер шага и модели в адресе
  • bindNavigation({ board, onPrev, onNext }) — клавиши ← → и свайпы
  • renderStepsList(list, steps, activeIndex, onSelect) — список шагов без пересборки при каждом переходе
  • revealViewer(), revealViewerOnLoad(), centerInScroller() — прокрутка к чертежу и горизонтальных лент

Технические особенности

  • проект не требует сборщика и backend-части
  • каждая страница работает как самостоятельный HTML + JS интерактив
  • логотип проекта хранится в корне репозитория в файле logo.png
  • стили разделены на:
    • site.css для общей оболочки сайта и главной страницы
    • presentation.css для страниц с пошаговыми построениями

Публикация

Инструкция по выкладке на VPS и настройке домена находится в файле DEPLOYMENT.md.

About

Интерактивные пошаговые построения по геометрии

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages