1. Войдите как преподаватель
Откройте личную ссылку входа, полученную от владельца сервера. Она имеет вид https://ваш-сервер/admin/k/… и открывает панель преподавателя. Пароль и почтовое подтверждение не нужны.
Если вы впервые настраиваете собственный сервер, откройте /admin и используйте setup-token. Он хранится в DATA_DIR/setup-token; в стандартной установке k3s это /var/lib/colloq/data/setup-token. Завершите первичную настройку владельца. Этот же ключ позволяет восстановить доступ позже.
В этой документации названия кнопок приведены для русского интерфейса. Владелец может выбрать русский или английский для всего сервера.
2. Создайте занятие
В панели откройте список «Занятия» и форму нового занятия. Задайте понятное название, выберите доступное Python-окружение и формат.
| Формат | Начальные правила | Когда выбрать |
|---|---|---|
| Обычный | Группа редактирует общую тетрадь и запускает код. | Практика и совместный разбор. |
| Лекция | Редактирование, исполнение и управление общим экраном у преподавателя. | Объяснение с демонстрацией. |
| Консилиум | Правила лекции; открытие ячейки выдаёт каждому свой лист. | Задача с последующим обсуждением ответов. |
Это начальные наборы правил. Их можно менять по ходу занятия. Доступность оракула — выключен, подсказки или полный ответ — выбирается при создании; отдельного переключателя для её изменения после создания нет.
3. Подготовьте рабочее место
- Добавьте код и пояснения в тетрадь; при необходимости загрузите ноутбук и данные.
- Запустите подготовительные ячейки. Убедитесь, что нужные библиотеки доступны в выбранном окружении.
- Проверьте права студентов: редактирование, исполнение, файлы, оракул и общий экран.
- Откройте ссылку занятия в отдельном приватном окне и войдите как студент. Проверьте именно этот вид перед началом пары.
Для лекции заранее загрузите PDF и проверьте проектор и пульт. Для Консилиума выполните общий подготовительный код до открытия задания.
4. Пригласите группу
Скопируйте ссылку занятия из панели и отправьте её в чат группы. Студенту достаточно открыть её в браузере и ввести имя. Устанавливать Python на студенческие компьютеры не требуется: код выполняется на сервере.
Если в ссылке оказался localhost, сначала исправьте внешний адрес сервера. Проверьте открытие ссылки с другой сети, а не только с преподавательского ноутбука.
5. Завершите занятие
Нажмите «Закончить занятие» в комнате или в списке занятий. Студенты смогут перечитать материалы, файлы, историю терминала и ответы оракула, но активные действия останутся преподавателю. «Продолжить занятие» вернёт исходные правила.
Для отдельной страницы чтения используйте публикацию. Завершение занятия, публикация и удаление комнаты — разные действия.
Доступ других преподавателей
Владелец добавляет преподавателя на странице Who can teach: имя и email используются для идентификации, Colloq не отправляет письма. Передайте созданную ссылку входа лично. При утрате или раскрытии ссылки смените ключ в панели: прежняя ссылка и открытые с ней сессии перестанут работать.