📚 Lecture Notes (Лекции на Astro SSR)

Минималистичный сервис для публикации и чтения лекций, практических занятий и конспектов из Obsidian на базе Astro SSR.

---

⚡ Особенности

• Настоящий динамический SSR в реальном времени:
  • Файлы читаются с диска напрямую по запросу без какой-либо модификации исходников.
  • При добавлении или редактировании .md файлов в /server/data/lecture новые лекции появляются на сайте мгновенно без перезапуска или пересборки контейнера.
• Стандартные библиотеки рендеринга Markdown:
  • markdown-it: быстрый и надежный парсер.
  • @renbaoshuo/markdown-it-katex: формулы $ ... $ и $$ ... $$ с поддержкой русских физических единиц СИ.
  • markdown-it-obsidian-callouts: блоки заметок > [!note], > [!tip], > [!warning].
  • markdown-it-anchor: ссылки на заголовки и автоматическое оглавление (TOC).
• Удобство чтения и минимализм:
  • Маршруты строятся строго по именам папок и файлов (с поддержкой кириллицы и дат).
  • Поиск/фильтр по названиям.
  • Оглавление конспекта.
  • Предыдущий / следующий материал.
  • Переключение темной и светлой тем.
• Полная защита от поисковых роботов:
  • robots.txt: User-agent: * \n Disallow: /
  • Мета-теги noindex, nofollow, noarchive, nosnippet.
• Деплой:
  • Dockerfile (чистый SSR runner на node:22-alpine без сторонних скриптов).
  • docker-compose.yml (порт 127.0.0.1:4330:80, монтирование тома /server/data/lecture).
  • deploy.sh (деплой через DOCKER_BUILDKIT с ключами Forgejo).

---

🚀 Команды

• Локальный запуск (dev):

  npm run dev
  

• Сборка и запуск SSR сервера:

  npm run build
  npm run start
  

• Деплой на сервере:

  ./deploy.sh