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