Три адреса, три назначения
| Ссылка | Что открывается |
|---|---|
/s/… | Живая комната. Действия зависят от правил и завершения занятия. |
/p/… | Отдельная публикация для чтения, без ядра и совместного редактирования. |
/c/… | Курс: список опубликованных занятий и будущих тем. |
Публикация не закрывает живую комнату. Если работа группы закончена, дополнительно нажмите «Закончить занятие».
Опубликуйте занятие
- В списке занятий откройте «Опубликовать…».
- Выберите отмеченные моменты, которые станут шагами объяснения, и при необходимости переименуйте их. Отметки ставят заранее, во время занятия: в панели «История» нажмите «Отметить момент», введите название и нажмите «Отметить». Отмечать может только преподаватель; если отметок нет, публикуется только текущая тетрадь.
- Проверьте код и выводы на данные, которые нельзя раскрывать.
- Нажмите «Опубликовать» и откройте полученную страницу как читатель.
- Поделитесь ссылкой
/p/…. При необходимости задайте короткое имя адреса.
Состояние тетради на момент публикации включается всегда. Повторная публикация обновляет материал по той же ссылке; обычные правки живой тетради сами в публикацию не переходят.
Что станет публичным
Публикуются текст и код ячеек, заметки и выводы выбранных шагов: графики, таблицы, сообщения и трейсбеки. Читатель может скопировать код и скачать тетрадь открытого шага в .ipynb: в файле код и текст ячеек, без результатов запуска.
Авторство действий, вопросы оракулу, история терминала и файлы комнаты в публикацию не включаются. Исключение — картинки из файлов комнаты, вставленные в текстовые ячейки: их копии попадают на страницу. Публикуется только основная тетрадь комнаты; другие тетради из панели файлов в неё не входят. Но имя, ключ или персональные данные, уже напечатанные в коде или выводе, остаются частью опубликованного текста. Проверьте каждый выбранный шаг, а не только итоговый.
Страница просит поисковые системы не индексировать её. Это не контроль доступа: любой, кто получил ссылку, может открыть материал и передать его дальше.
Соберите курс
В панели откройте «Курсы» и создайте курс. Задайте название и описание, добавьте занятия и расположите их в нужном порядке. Кнопка «+ Добавить занятие» добавляет в курс уже созданные занятия. Пока занятие не опубликовано, на странице курса у него стоит «ещё не опубликовано».
Будущие темы добавляет кнопка «+ Тема по плану»: тема обязательна, неделя по расписанию — нет. Нажмите «Добавить в план» или Enter; форма остаётся открытой для следующей темы. В панели такая строка помечена «по плану». Её можно исправить («Изменить»), передвинуть стрелками, убрать («Убрать») или заменить уже созданным занятием («Поставить занятие»): занятие встаёт на её место, а тема и неделя сменяются названием занятия. Для замены предлагаются только занятия, которых в курсе ещё нет. На странице курса строки плана показаны с неделей.
Дайте группе адрес /c/… один раз. По мере публикации занятий материалы появляются в списке. Страница курса не раскрывает адреса живых комнат: ссылку на текущее занятие выдавайте отдельно.
Короткие и старые адреса
Для публикации или курса можно задать имя из строчных латинских букв, цифр и дефисов длиной от 3 до 64 символов; начало и конец — буква или цифра. Например, /c/python-autumn.
После переименования прежний адрес продолжает вести к текущему материалу и остаётся занят. Освобождение прежнего имени прекращает работу старой ссылки и позволяет использовать его снова. Освобождайте его только тогда, когда готовы изменить уже розданный адрес.
Снять публикацию или удалить комнату
После снятия публикации страница сообщает об этом. Публикация и архивация не изменяют права живой комнаты. Удаление занятия по умолчанию сохраняет опубликованный материал; внимательно прочитайте варианты в подтверждении удаления. Такие публикации собраны на странице «Курсы» в разделе «Страницы без комнаты»: их можно снять («Снять страницу») или вернуть («Вернуть страницу»), а снятую страницу владелец может удалить навсегда.
Публикация удобна для чтения, но не заменяет резервную копию сервера: в ней нет всех рабочих файлов, конфигурации, секретов и данных комнаты.