Skip to content

Лабораторная работа №1

📌 Тема

Создание и развертывание статического сайта на базе MkDocs с публикацией на GitHub Pages

🎯 Цели работы

  • Освоить процесс создания статического сайта с использованием генератора документации MkDocs.
  • Научиться организовывать структуру документации проекта (портфолио лабораторных работ).
  • Изучить базовые принципы работы с системой контроля версий Git и платформой GitHub.
  • Развернуть статический сайт с использованием механизма GitHub Pages на домене вида username.github.io.
  • Освоить базовую настройку темы оформления и конфигурационного файла mkdocs.yml.

📝 Описание задачи и решение

  • Создан публичный репозиторий на GitHub для портфолио
  • Настроен GitHub Pages (публикация из /docs ветки main)
  • Проект клонирован локально, настроено виртуальное окружение
  • Установлен MkDocs, инициализирован сайт
  • Настроен .gitignore
  • Подключена тема оформления (material)
  • Настроен mkdocs.yml: название сайта, тема, навигация через nav
  • Создана структура из 5+ страниц:

✅ Выводы

В ходе лабораторной работы были освоены принципы создания статических сайтов с использованием MkDocs, организации структуры документации и работы с Git, реализовано портфолио с корректной навигацией и темой оформления, успешно настроена публикация через GitHub Pages, а все изменения зафиксированы в истории коммитов.

💻 Код

https://github.com/Lisa15080/Lisa15080.github.io.git