Открытая математика

Современные учебники по математике — понятные, интересные, детальные.
Репозиторий контента на русском языке.

🌐 Сайт ✍🏻 Предложить правки 💎 Поддержать

▨

Установка локально

Если вы планируете вносить серьезные правки в материал проекта (например, переписать целые разделы или написать тему), то лучшим вариантом будет установить локальную копию проекта к себе на компьютер. Чтобы это сделать:

1. Установите Node.js

2. Установите Bun

3. Сделайте форк репозитория Открытой Математики

4. Подготовьте папку на вашем компьютере и скопируйте в нее репозиторий вашего форка с помощью приложения GitHub Desktop или напрямую.
   Находясь внутри папки, скопировать можно при помощи вот этой команды в терминале:

   git clone https://github.com/__ИМЯ_ПОЛЬЗОВАТЕЛЯ__/ru.omath.net.git ./

5. Установите зависимости:

   bun install

6. Соберите проект (процесс долгий, до нескольких минут):

   bun run build

Теперь все готово к тому, чтобы вносить правки! Все содержимое учебников находится в папке content. Чтобы видеть вносимые изменения в реальном времени, выполните команду launch:

bun launch

После этого все вносимые изменения будут видны по адресу: http://localhost:3000

Альтернативный способ вообще без сборки проекта, это использовать команду bun dev. Результат тот же, но сайт может работать чуть медленнее, так как все изменения будут обрабатываться на лету.

Когда будете готовы, просто создайте pull request со своими изменениями.

Используемые технологии

Весь контент "Открытой Математики" написан с использованием синтаксиса TSX. Он позволяет писать XML-подобную разметку с помощью тегов прямо внутри файлов TypeScript.

Весь TSX-контент обрабатывается при помощи пакета tsprose. Он отвечает за трансофрмацию всех тегов в обычные объекты, а также отдельно обрабатывает элементы для "поиска", ключевые элементы, заголовки и так далее.

Система управления контентом Erudit берет на себя все остальные задачи: слежение за изменениями контента, сборка сайта, набор тегов по умолчанию и еще очень много чего...