Этапы

Установка Python и pip

Установил актуальную версию Python и проверил работу pip, чтобы убедиться, что можно устанавливать необходимые пакеты.

Настройка виртуального окружения

Установил virtualenv, создал каталог проекта, развернул там виртуальное окружение и активировал его для работы.

# создание виртуального окружения
python -m venv venv

# активация виртуального окружения
source ./.venv/Scripts/activate

Установка MkDocs

Внутри окружения установил MkDocs и необходимые пакеты для генерации статического сайта.

# установка mkdocs
pip install mkdocs

# тема Material
pip install mkdocs-material

# запуск сервера со сгенерированным проектом
mkdocs serve

# генерация статических файлов из проекта
mkdocs build

Создание и работа с репозиторием

Инициализировал проект, связал его с репозиторием на GitHub и запушил все изменения.

Настройка GitHub Actions

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

Хостинг на GitHub Pages

Задеплоил проект на GitHub Pages, проверил доступность сайта по адресу и убедился, что он работает.

Отладка

Протестировал сайт, убедился в корректной сборке и устранил возможные мелкие ошибки.