Публикация руководств на сайте¶

Сайт: https://m1.instack.info/, раздел «Демонстрационные экзамены → 2027 → 09.02.06 → Профильный уровень».

Изменить инструкцию¶

Редактируйте файл в docs/, затем из корня проекта:

git add docs/module1.md
git commit -m "Уточнить команды модуля 1"
git push gitlab main

Pipeline проекта instack/demo2027 автоматически запускает публикацию в instack/docs-portal. После успешной сборки изменения доступны читателям. Если проверка ссылок или сборка завершатся ошибкой, предыдущий сайт останется доступен. Причину смотрите в GitLab → CI/CD → Pipelines → downstream pipeline портала → job publish.

Можно редактировать Markdown непосредственно в веб-интерфейсе GitLab и сохранить изменения в main. Читателям сайта учётная запись GitLab не нужна; редактирование доступно только участникам проекта.

Предварительный просмотр без push¶

Рядом с этим каталогом расположен /home/danil/disk/projects/docs-portal. В нём подготовлено окружение:

cd ../docs-portal
.venv/bin/python scripts/preview.py

Откройте http://127.0.0.1:8000. Сохранение Markdown автоматически обновляет preview. Завершение — Ctrl+C. На другом компьютере сначала создайте venv и установите зависимости по README портала.

Добавление новой страницы¶

Создайте Markdown в docs/ и добавьте его в Git.
В соседнем репозитории портала добавьте страницу в sources.yml → источник demo2027 → pages.
Сначала отправьте новый файл в GitLab, затем обновлённое меню портала.

Без добавления в меню файл может быть доступен по адресу, но не появится в боковой навигации.

Другие годы и направления¶

Добавляются отдельными репозиториями через sources.yml в docs-portal. Полная инструкция, структура ВМ, правила доступа и откат описаны в README этого проекта.

Не коммитьте задание/stend.md, настоящие пароли инфраструктуры, токены и приватные ключи. Каталог задание/ исключён из Git; архивы установщиков также не публикуются. Учебные пароли в примерах рассчитаны только на изолированный экзаменационный стенд.