2013-07-19 2 views
1

IPython notebooks, размещенный на github, можно легко просмотреть с помощью nbviewer. У меня есть несколько ноутбуков, которые я хотел бы разместить там и выставлять на nbviewer, но некоторые из ноутбуков импортируют пакет python, который я разработал (который можно установить через pip или easy_install), и использовать внешний файл данных (~ 10 МБ).Хостинг IPython-ноутбука с внешними зависимостями от github

Я читал, что если ноутбук размещен как сущность (рекомендуется) и требует доступа к внешним файлам данных, файлы данных должны находиться в том же самом реестре, что и ноутбук. Если я это правильно понял, мне нужно было бы (повторно) разместить как файл данных, так и пакет python в сущности ноутбука. Это кажется вполне подходящим для единственной сути, но если есть несколько гистограмм ноутбуков, использующих один и тот же пакет данных &, тогда мне нужно будет размещать их отдельно для каждого объекта. Кроме того, если есть обновление пакета python, мне нужно будет обновить этот код в нескольких репозиториях gist.

Так что, учитывая эту ситуацию, это правильный/предпочтительный способ размещения ноутбуков на github для использования с nbviewer? Другой вариант, который я рассматриваю, заключается в том, чтобы разместить все ноутбуки в одном нормальном github repo, где мне нужно было бы только разместить данные/пакет один раз, но это потеряло бы простоту использования каждого ноутбука в качестве сути.

ответ

2

Хорошая вещь о nbviewer заключается в том, что он просто разделяет состояние IPython-ноутбука во время сохранения. Это означает, что все ваши сюжеты (закодированные PNGs base64), код, html, уценка, все, что было отображено, будут отображаться. Ваша потенциальная аудитория не нуждается в доступе к исходным данным/модулям при просмотре gists на nbviewer.

Конечно, если они должны иметь возможность воспроизводить вашу работу или добавлять к ней, то да, они нуждаются в доступе к вашим данным/модулям.