IPYNB to PDF: помощь и поддержка
Решения самых частых проблем при конвертации ноутбука Jupyter в PDF с помощью IPYNB to PDF. Если вашей проблемы здесь нет, напишите в поддержку, и мы разберёмся.
С чего начать
- Перезагрузите вкладки GitHub, которые были открыты до установки расширения.
- Откройте конвертер значком на панели инструментов и перетащите файл .ipynb на страницу.
- В окне печати выберите «Сохранить как PDF» в поле «Принтер».
- Перед сохранением проверьте размер страницы, ориентацию и Показывать код в настройках PDF.
- Если ноутбук с GitHub не скачивается, нажмите на GitHub «Download raw file» и перетащите файл.
Частые проблемы и решения
На GitHub нет кнопки «Скачать PDF»
Перезагрузите вкладку GitHub: вкладки, открытые до установки расширения, получают кнопку только после перезагрузки. Кнопка появляется только на странице файла ноутбука (адрес с /blob/, оканчивающийся на .ipynb) рядом с Raw или в правом нижнем углу, если GitHub не показывает кнопку Raw.
«Ноутбук не найден на GitHub» для приватного репозитория
Расширение скачивает ноутбук с вашим входом в GitHub, поэтому войдите в GitHub в том же профиле Chrome и попробуйте снова. Если не помогло, откройте файл на GitHub, нажмите «Download raw file» и перетащите .ipynb на страницу конвертера.
Ошибка «Это указатель Git LFS»
Репозиторий хранит ноутбук в Git LFS, поэтому расширение получило лишь маленький файл-указатель. Нажмите на GitHub «Download raw file», чтобы скачать настоящий .ipynb, и перетащите его на страницу конвертера.
«Файл не является корректным JSON» или «не ноутбук Jupyter»
Файл повреждён, обрезан или не является ноутбуком. Откройте его в Jupyter, JupyterLab или VS Code и сохраните заново либо скачайте ещё раз из источника. Ноутбук должен быть файлом JSON со списком «cells».
Ошибка «Неподдерживаемая версия ноутбука»
Поддерживаются только ноутбуки nbformat 3 и 4. Откройте ноутбук в актуальной версии Jupyter и сохраните — он обновится до nbformat 4, — затем конвертируйте снова.
На каждой странице PDF есть дата и адрес chrome-extension://
Верните в окне печати для Поля значение По умолчанию. Конвертер задаёт размер страницы, ориентацию и поля так, чтобы у Chrome не осталось места для своих колонтитулов; изменение полей в окне может их вернуть, и тогда также снимите флажок Верхние и нижние колонтитулы в разделе «Дополнительные настройки».
В PDF нет графика или виджета
PDF не может содержать интерактивный вывод, поэтому вместо виджетов и графиков без сохранённого статичного изображения стоит «Интерактивный вывод пропущен». Сохраните в ноутбуке статичное изображение графика (например, экспорт в PNG), выполните ячейку, сохраните ноутбук и конвертируйте снова. Изображения по ссылкам из интернета не загружаются, и на их месте стоит «Внешнее изображение не загружено».
Большой ноутбук долго конвертируется
Для файлов больше 50 MB показывается предупреждение, но они всё равно конвертируются, и это может занять время. Ноутбуки чаще всего большие из-за встроенных изображений; если очистить ненужные выводы в Jupyter, файл станет меньше.
Сконвертировался только один из моих ноутбуков
Конвертер обрабатывает один ноутбук за раз. Если перетащить несколько файлов, он конвертирует первый и сообщит, какой именно; следующий файл перетащите после сохранения PDF.
Ваши данные
IPYNB to PDF хранит только ваши настройки PDF (размер страницы, ориентация, показ кода, номера In/Out, имя файла как заголовок и нижний колонтитул) в синхронизируемом хранилище расширений Chrome, поэтому они доступны на других компьютерах, где вы вошли в Chrome с включённой синхронизацией. Ноутбуки никогда не сохраняются: они читаются во вкладке конвертера и исчезают, когда вы её закрываете. Делать резервную копию нечего. Чтобы сбросить настройки, верните их во всплывающем окне или удалите расширение — это сотрёт их.
Когда пишете нам
- Точный текст ошибки, которую показал конвертер.
- Откуда ноутбук (ваш компьютер, публичный или приватный репозиторий GitHub, Colab или Kaggle) и его размер.
- Что не так в предпросмотре или PDF, например какая ячейка или вывод выглядит не так, как в Jupyter.
- Если можете поделиться, небольшой ноутбук, на котором видна проблема (необязательно).
- Название расширения и его версию из
chrome://extensions. - Версию Chrome из
chrome://settings/helpи вашу операционную систему. - Что вы сделали, чего ожидали и что произошло на самом деле.
- Скриншот, если проблему видно на экране.