IPYNB to PDF 說明與支援
這裡整理了用 IPYNB to PDF 將 Jupyter 筆記本轉成 PDF 時最常見問題的解決方法。如果沒有列出你的問題,請寄信給支援團隊,我們會協助查看。
先試試這些
- 安裝擴充功能前就已開啟的 GitHub 分頁,請重新載入。
- 從工具列圖示開啟轉換器,將 .ipynb 檔案拖放到頁面上。
- 在列印對話方塊中,將目的地設為「另存為 PDF」。
- 儲存前,請在 PDF 設定中確認頁面大小、方向和 Show code。
- 如果 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 版本,以及你的作業系統。- 你做了什麼、預期會發生什麼,以及實際發生了什麼。
- 如果問題顯示在畫面上,請附上螢幕截圖。