Tab & Tap
한국어
Chrome 웹 스토어에서 제공

IPYNB to PDF 도움말 및 지원

IPYNB to PDF로 Jupyter 노트북을 PDF로 변환할 때 자주 발생하는 문제의 해결 방법입니다. 여기에 없는 문제는 지원팀에 이메일을 보내 주시면 살펴보겠습니다.

지원팀에 이메일 보내기 →support@tabandtap.com

먼저 해 볼 것

  1. 확장 프로그램을 설치하기 전부터 열려 있던 GitHub 탭은 새로고침하세요.
  2. 툴바 아이콘으로 변환기를 열고 .ipynb 파일을 페이지에 끌어다 놓으세요.
  3. 인쇄 대화상자에서 대상을 “PDF로 저장”으로 설정하세요.
  4. 저장하기 전에 PDF 설정에서 페이지 크기, 방향, Show code를 확인하세요.
  5. GitHub 노트북이 다운로드되지 않으면 GitHub의 “Download raw file”을 사용해 받은 파일을 끌어다 놓으세요.

자주 발생하는 문제와 해결 방법

GitHub에 Download PDF 버튼이 보이지 않아요

GitHub 탭을 새로고침하세요. 확장 프로그램을 설치하기 전부터 열려 있던 탭은 새로고침해야 버튼이 생깁니다. 버튼은 노트북 파일 페이지(/blob/이 들어 있고 .ipynb로 끝나는 주소)에서만 Raw 옆에 나타나며, GitHub에 Raw 버튼이 없으면 오른쪽 아래에 나타납니다.

비공개 저장소에서 “Notebook not found on GitHub”라고 나와요

확장 프로그램은 GitHub 로그인 정보로 노트북을 다운로드하므로, 같은 Chrome 프로필에서 GitHub에 로그인한 다음 다시 시도하세요. 그래도 실패하면 GitHub에서 파일을 열고 “Download raw file”을 사용한 뒤 .ipynb를 변환기 페이지에 끌어다 놓으세요.

“This file is a Git LFS pointer” 오류

저장소가 노트북을 Git LFS에 보관하고 있어서 확장 프로그램이 받은 파일은 작은 포인터일 뿐입니다. GitHub에서 “Download raw file”로 실제 .ipynb를 받은 다음 변환기 페이지에 끌어다 놓으세요.

“This file is not valid JSON” 또는 “not a Jupyter notebook”

파일이 손상되었거나 잘렸거나 노트북이 아닙니다. Jupyter, JupyterLab 또는 VS Code에서 열어 다시 저장하거나, 원래 받은 곳에서 다시 다운로드하세요. 노트북은 “cells” 목록이 있는 JSON이어야 합니다.

“Unsupported notebook version” 오류

nbformat 3과 4 노트북만 지원합니다. 최신 Jupyter에서 노트북을 열어 저장하면 nbformat 4로 업그레이드되니, 그다음 다시 변환하세요.

PDF의 모든 페이지에 날짜와 chrome-extension:// 주소가 찍혀요

인쇄 대화상자에서 여백을 기본값으로 되돌리세요. 변환기는 페이지 크기, 방향, 여백을 설정해 Chrome이 자체 머리글과 바닥글을 넣을 공간을 없앱니다. 대화상자에서 여백을 바꾸면 이것이 다시 생길 수 있으며, 그럴 때는 설정 더보기에서 머리글과 바닥글도 해제하세요.

PDF에 차트나 위젯이 빠졌어요

PDF에는 대화형 출력을 담을 수 없으므로, 저장된 정적 이미지가 없는 위젯과 차트에는 “Interactive output omitted”가 표시됩니다. 노트북에서 차트의 정적 이미지(예: PNG 내보내기)를 저장하고, 셀을 실행하고, 노트북을 저장한 뒤 다시 변환하세요. 웹에 링크된 이미지는 불러오지 않으며 “External image not loaded”로 표시됩니다.

큰 노트북은 변환이 느려요

50 MB가 넘는 파일은 경고가 표시되지만 변환은 되며, 시간이 걸릴 수 있습니다. 노트북이 커지는 주된 이유는 포함된 이미지이므로, 필요 없는 출력을 Jupyter에서 지우면 파일이 작아집니다.

노트북 중 하나만 변환됐어요

변환기는 한 번에 노트북 하나만 처리합니다. 여러 파일을 끌어다 놓으면 첫 번째 파일을 변환하고 어떤 파일인지 알려 줍니다. PDF를 저장한 다음 다음 파일을 끌어다 놓으세요.

내 데이터

IPYNB to PDF는 PDF 설정(페이지 크기, 방향, 코드 표시, In/Out 번호, 파일 이름을 제목으로 사용, 페이지 바닥글)만 Chrome의 동기화되는 확장 프로그램 저장소에 보관합니다. 그래서 동기화를 켜고 Chrome에 로그인한 다른 컴퓨터에서도 같은 설정을 쓸 수 있습니다. 노트북은 저장되지 않습니다. 변환기 탭에서 읽히고 탭을 닫으면 사라집니다. 백업할 것은 없습니다. 설정을 초기화하려면 팝업에서 다시 바꾸거나 확장 프로그램을 삭제하세요. 삭제하면 설정도 함께 지워집니다.

확장 프로그램 개인정보처리방침 →

문의하실 때

  • 변환기에 표시된 정확한 오류 메시지.
  • 노트북을 가져온 곳(내 컴퓨터, 공개 또는 비공개 GitHub 저장소, Colab, Kaggle)과 파일 크기.
  • 미리보기나 PDF에서 무엇이 잘못되었는지. 예를 들어 어떤 셀이나 출력이 Jupyter와 다르게 보이는지.
  • 공유할 수 있다면 문제가 나타나는 작은 노트북(선택 사항).
  • 확장 프로그램 이름과 chrome://extensions에 표시된 버전.
  • chrome://settings/help에 표시된 Chrome 버전과 사용 중인 운영체제.
  • 어떤 작업을 했는지, 무엇을 기대했는지, 실제로는 어떻게 되었는지.
  • 화면에 문제가 보인다면 스크린샷.
지원팀에 이메일 보내기 →support@tabandtap.com