Путь в конце вы упомянули об использовании Github Вы можете поделиться записной книжкой напрямую в форме .ipynb (на самом деле json в кодировке), используя этот сайт или сайт Github Gist, и любой, кому вы отправите ссылку, сможет увидеть ее как хорошо обработанную stati c. Вы, конечно, можете опубликовать sh до html, но тогда вам нужно разместить html или использовать githack для ссылки на него. Всегда есть возможность перейти в PDF и отправить его по электронной почте. Поскольку вы говорите о конвертации, я полагаю, вам не нужно, чтобы она была активной; однако это также возможно при использовании MyBinder.org, см. пример здесь , где вы можете нажать верхнюю кнопку «Пуск» и раскрутить блокнот, который ранее сделал кто-то другой.
Я буду рассмотрите каждое из этих предложений с дополнительными пояснениями.
GitHub и nbviewer для совместного использования блокнота
Вы можете использовать Github для обмена блокнотом, если он опубликован c. Представьте, что вы сделали репозиторий c и поместили в него записную книжку в виде .ipynb. (Примечание: все эти шаги можно выполнить непосредственно в веб-интерфейсе Github, не используя git на локальном компьютере.) Давайте использовать здесь в качестве теоретического примера. Если вы сделаете go репо, вы увидите записную книжку index.ipynb в списке. Нажмите на ссылку, чтобы просмотреть ее. (Теперь вы должны быть здесь .) Записная книжка может отрендериться или попытаться отключиться. Рендеринг Github не идеален, поэтому не надейтесь на него. Лучше использовать сайт nbviewer. А чтобы использовать сайт nbviewer, вам нужно скопировать URL-адрес записной книжки из адресной строки. В этом примере вы должны скопировать:
https://github.com/binder-examples/r/blob/master/index.ipynb
С этим URL в буфере обмена go на сайт nbviewer по адресу https://nbviewer.jupyter.org/. Когда вы попадете на первую страницу nbviewer, вставьте URL-адрес в форму вверху под заголовком «Введите местоположение ноутбука Jupyter ...» и нажмите Go!. Это перенесет вас на красивую страницу записной книжки без каких-либо заголовков / искажений Github. Обратите внимание, что не имеет значения, является ли это Python код или код R в записной книжке. Это будет хорошо смотреться на nbviewer. Чтобы поделиться этим мнением с кем-либо, скопируйте URL-адрес из адресной строки этой страницы. В этом случае это будет:
https://nbviewer.jupyter.org/github/binder-examples/r/blob/master/index.ipynb
Вы можете поделиться этой ссылкой с кем угодно.
Эта ссылка сообщает сайту nbviewer получить код ноутбука от Github и сделать его. Если вы обновите его позже, они все равно смогут использовать ту же ссылку и получить обновленное открытие формы. (Обратите внимание, что nbviewer иногда может занять около 10 минут, прежде чем он собирает обновления от Github.) Можно также поделиться указанной c версией ноутбука, используя URL-адреса Github и nbviewer. Вы хотели бы узнать о том, как просматривать файлы, указанные в c, которые фиксируются на Github, и использовать эти URL.
Следует отметить, что ссылка на страницу рендеринга nbviewer следует шаблону, ссылающемуся на репозиторий Github, и поэтому можно сделать ссылку, не пройдя все эти шаги.
Еще одна вещь, которую стоит отметить, - это символ с тремя кольцами в верхнем правом углу, слева от кнопка загрузки. Если вы нажмете на эти кольца, вы сможете запустить активную версию этого ноутбука через MyBinder.org. Когда сеанс раскручивается, эта записная книжка будет работать без необходимости установки каких-либо дополнительных пакетов или чего-либо еще , если хранилище было настроено так, чтобы базовый специалист распознал файлы конфигурации и создал надлежащую среду. Он все равно откроет записная книжка, если хранилище не было настроено с учетом Binder, но вы можете получить ошибки при попытке запуска, так как среда не полностью совместима по умолчанию.
Gist site и nbviewer для совместного использования ноутбука
Этот процесс очень похож на описанный в разделе «GitHub и nbviewer для совместного использования ноутбука». Первые несколько шагов о том, куда вы положили файл ноутбука .ipynb, отличаются. Вы бы go отправились на сайт Github's Gist по https://gist.github.com/. Этот сайт предназначен для обмена фрагментами кода или всего лишь несколькими файлами, и он не обладает всеми функциями полного репозитория Github. Тем не менее, это отлично подходит для вашего использования. Вы можете вставить содержимое файла .ipynb или загрузить его туда, а затем использовать URL-адрес в nbviewer, как описано в разделе «GitHub и nbviewer для общего доступа к блокноту».
Gist site и githack для общего доступа блокнот HTML
Этот процесс очень похож на описанный в разделе «Gist site и nbviewer для совместного использования блокнота». Однако то, что вы загружаете на сайт Gist, и технологии, которые вы используете для публикации рендеринга, отличаются. На этот раз вы захотите разместить упомянутый файл HTML на сайте Gist. На данный момент он будет выглядеть как код HTML, а не как блокнот. Скопируйте URL-адрес страницы на сайте Gist в буфер обмена. Go на сайт raw.githack.com по http://raw.githack.com/. Вставьте URL в строку формы вверху, где написано, чтобы вставить URL. Теперь вы go перейдете на страницу, представляющую собой HTML. Вы можете скопировать URL-адрес из адресной строки и поделиться им с кем-либо, аналогично тому, как вы используете nbviewer для просмотра записной книжки.
Github-репозиторий и githack для предоставления доступа к блокноту HTML
This очень похоже на то, что описано в разделе «Gist site и githack для совместного использования ноутбука HTML» Разница в том, что вы использовали бы реальное Github-репо для хранения HTMl версии ноутбука.
Поделиться PDF-файлом ноутбука
Вы не упомянули этот маршрут. Так что я буду кратким. В зависимости от вашей установки Jupyter или от того, где вы ее используете, сохранение формы PDF может показаться непоследовательным. Одно место, которое должно быть возможно, это здесь . Если вы go там и нажали кнопку launch binder, вы можете ускорить сеанс, в котором работает сохранение PDF. Вы можете специально использовать значок Export to PDF, который будет отображаться на слишком красной строке прямо над блокнотом.
Поделиться активной формой вашего блокнота
Я также буду держать это краткое поскольку он был затронут в различных формах в разделах выше и является более продвинутым, чем использование nbviewer.
Один из способов сделать это был описан в конце раздела «GitHub и nbviewer для совместного использования записной книжки». Вы можете сделать это без использования nbviewer. Давайте go вернемся к примеру репо здесь . Скопируйте URL-адрес из верхней части этой страницы:
https://github.com/binder-examples/r
Now go на сайт MyBinder.org по адресу https://mybinder.org/ и вставьте этот URL-адрес в вверху формы, где написано «Имя репозитория GitHub или URL», и нажмите «Запустить». Это ускорит временный сеанс с использованием среды, настроенной специальными файлами, которые он видел в этом хранилище. Вы сможете нажать на блокнот index.ipynb и запустить его. Никогда не делитесь ссылкой на запущенную сессию, поскольку она временная.
Чтобы поделиться чем-то, чтобы другие могли запускать там свой сеанс с вашим ноутбуком, вы можете изучить варианты формы больше на https://mybinder.org/ для создания ссылок, которые вы можете поделиться с другими. Например, вы можете добавить путь к определенной записной книжке c, чтобы при запуске сеанса он начинался с уже открытой записной книжки. Заполнив форму, которую вы хотите скопировать, чтобы поделиться URL-адресом, который будет отображаться в разделе «Скопировать URL-адрес ниже и поделиться своим Binder с другими:». Вы увидите, что эта форма также позволяет создавать код для интерактивных значков, как вы видите на https://github.com/binder-examples/r.
Обратите внимание, что запуск сеанса с записной книжкой, который можно запустить, работает, потому что этот репозиторий был настроен для установки irkernel. Это не будет работать, чтобы запустить любой ноутбук из любого репозитория с R без некоторой конфигурации. (По умолчанию будет иметь только Python ядер.) Однако пример репозитория, на который я ссылался, может использоваться в качестве шаблона для создания нового собственного репозитория с помощью кнопки Use this template здесь для облегчить шаги, необходимые для этого. Существует также Holepunch , который может помочь в аналогичных действиях по обмену кодом на основе R.
Объединение технологий, когда вы хотите поделиться личным файлом блокнота .ipynb и позволить кому-то просматривать или запускать его
Вы также можете отправить людям записную книжку .ipynb, и тогда у них будет несколько вариантов. Они могут использовать nbpreview , который позволяет загружать локальный файл блокнота .ipynb и отображать его из локального источника. Если это чувствительная работа в ноутбуке, и вы беспокоитесь о загрузке, также возможно установить и запустить nbpreview локально, см. здесь . Также есть возможность установить nbviewer локально и просмотреть его. Или они могут запустить файл записной книжки, который вы отправили, используя свою систему Jupyter. Поскольку элементы некоторых из этих опций основаны на продвинутых навыках и знании того, как устанавливать вещи, они могут быть не лучшими для всех участников.
Один из способов обойти эти препятствия - создать хранилище, способное обслуживать через MyBinder среду, полностью подходящую для работы с личной записной книжкой, а затем посоветовать пользователю, как ускорить сеанс и загрузить записную книжку, которой вы поделились с ними отдельно, например по электронной почте. Вы можете увидеть здесь для получения дополнительной информации о безопасности на MyBinder.org.
Подождите ... есть больше
Поскольку ноутбуки становятся все более популярными, появляется все больше способов их использования и поделитесь ими. Этот ответ затронул только некоторые из более открытых, опубликованных c способов. Когда вы добавляете Jubyter Hubs с авторизацией, это еще не все, потому что вы можете поделиться ссылкой на свой ноутбук в сети JupyterHub. Также есть коммерческие предложения сейчас. Вы также можете всегда использовать Google Colab или Azure записные книжки, чтобы делиться ими.