Сценарии публикации контента на lms.cdto.life

Портал: https://lms.cdto.life (Moodle 4.5)
Дата: 2026-02-13

Документ сохраняет общий сценарий публикации контента и его варианты для разных типов страниц и курсов. Используется при добавлении новых материалов и для воспроизводимости процесса.

1. Общая схема публикации

[Исходник в репозитории]  →  Конвертация (MD→HTML при необходимости)  →  Публикация в Moodle (ресурс «Страница»)
       ↓                                                                              ↓
  Подготовка, согласование                                                    Курс + раздел (section)
       ↓                                                                              ↓
  Сохранение в git                                                           Опционально: блок на главной
                                                                                      ↓
                                                                             Проверка (авто + ручная)

Общие предусловия: контейнер Moodle запущен; курс-приёмник создан в Moodle (shortname известен); при публикации из Markdown — на хосте установлен python3-markdown.

2. Сценарии по типам контента

2.1 Инструкция BigBlueButton → Moodle (одна страница в курсе «Академия CDTO»)

Порядок: подготовить/обновить MD → запустить скрипт → открыть VERIFY_URL, сравнить с исходником.

2.2 Политика конфиденциальности и Правила использования (две страницы, курс «Права и обязанности», блок на главной)

Порядок: согласовать шаблоны с юристом → при необходимости создать курс → публикация (или полный цикл одной командой) → автопроверка → ручная проверка по чек-листу.

2.3 Произвольная страница в выбранном курсе (универсальный сценарий)

Подходит для любой одной страницы в любом курсе, если известны shortname курса и путь к HTML/контенту.

Пример для новой инструкции в курсе «Академия CDTO»:

1. Положить исходник, например docs/setup/my-instruction.md.
2. Сконвертировать в HTML (локально или в скрипте).
3. Скопировать HTML и moodle-publish-portal-policy.php в контейнер.
4. Вызвать PHP: --course=akademiya-cdto --title="Моя инструкция" --content-file=/tmp/my-instruction.html.

Для повторяемого использования оформить обёртку .sh по аналогии с publish-portal-policies-to-moodle.sh (исходник, курс, заголовок — параметры или константы).

3. Сводная таблица скриптов публикации

4. Добавление нового сценария (новая страница/тип контента)

1. Определить: курс (существующий или создать), название страницы, исходник (путь в репо).
2. Публикация:
3. если один курс и одна страница по шаблону BBB — скопировать логику publish-bbb-instruction-to-moodle.sh и поменять SRC_MD, курс, заголовок;
4. если универсально — использовать moodle-publish-portal-policy.php с нужными --course, --title, --content-file и при необходимости обёртку .sh.
5. Блок на главной: если нужна ссылка с главной — либо ручное добавление блока в Moodle, либо скрипт по аналогии с moodle-add-frontpage-block-prava-links.php (жёстко или с параметрами).
6. Проверка: curl по URL страницы/курса или скрипт проверки (при необходимости расширить verify-portal-policies-placement.sh или вынести общие проверки в отдельный скрипт).
7. Документация: добавить строку в п. 2 и строку в таблицу п. 3 этого документа; при необходимости — отдельный чек-лист (по аналогии с portal-policies-placement-checklist.md).

5. Связанные документы

• Публикация на портал Академии CDTO (метод, роли, чек-лист)
• Разрешительные и уведомительные документы портала
• Чек-лист: размещение контента (политика и правила) и проверка
• Порядок обновления и публикации документации
• Правило Cursor: .cursor/rules/lms-publication.mdc — список скриптов публикации

Сценарий сохранён для воспроизводимости и расширения под новые страницы и курсы.

Технический директор: AI Denkart
Владелец ресурсов: CDTO Dkvark