Tapos na ang assignment sa Jupyter, pero PDF ang hinihingi ng submission portal. Pinili mo ang "Download as PDF" o pinatakbo ang jupyter nbconvert --to pdf, at lumabas ang error: hindi makita ang xelatex, o kulang ang pandoc. Dumaraan sa LaTeX ang nbconvert para gumawa ng PDF, kaya kailangan muna nito ng kumpletong TeX distribution na naka-install bago ito makapaglabas ng kahit ano.

Kaya na ng Look Scanned na buksan nang direkta ang mga .ipynb file. Piliin ang notebook mo sa pahinang Jupyter Notebook to Scanned PDF, at aayusin agad ang layout nito sa browser mo: ang mga Markdown cell, ang code at ang mga output na naka-save kasama nito. Tingnan ang mga pahina sa preview at i-download ang PDF. Walang kailangang i-install, at hindi ina-upload ang notebook.

Isang paalala muna: pinapamukhang na-scan ng Look Scanned ang mga dokumento, kaya ganoon din ang itsura ng PDF. Bagay ito sa notebook na kailangang ipasa bilang naka-print at na-scan na kopya, o sa notebook na gusto mo lang magmukhang papel. Puwede mong ibaba sa zero ang rotation, blur at noise para mas malinis ang pahina, pero larawan pa rin ang bawat pahina, kaya hindi mapipili o mahahanap ang text sa PDF.

Paano gawing scanned PDF ang isang .ipynb file

  1. Patakbuhin ang notebook at i-save ito sa Jupyter, JupyterLab, VS Code o Google Colab para maitabi sa file ang mga output. Sa Colab, gamitin ang File → Download → Download .ipynb.
  2. Buksan ang Jupyter Notebook to Scanned PDF at piliin ang .ipynb file. Nasa English ang page na ito.
  3. Tingnan ang preview isa-isang pahina. Suriin ang code, mga table at chart, at itakda ang laki ng papel at mga margin.
  4. Ayusin ang scan effect. Panatilihing mababa ang blur at noise para mabasa pa rin ang maliit na code. Grayscale ang mga pahina bilang default; piliin ang Colorful kung gusto mong manatili ang kulay ng mga chart mo.
  5. I-generate ang scanned PDF at i-download ito.

Kung mas gusto mo ng larawan, puwede mong i-export ang bawat pahina bilang JPG o PNG. Ipinapaliwanag ng aming gabay sa PDF, JPG at PNG kung kailan bagay ang bawat isa. Kung may Pro ka, kaya ng Bulk Scan ang ilang .ipynb file nang sabay-sabay.

Ano ang lumalabas sa pahina

  • Mga Markdown cell: mga heading, listahan, table, link at larawan, pati ang mga larawang direktang idinikit sa cell.
  • Mga code cell, may syntax highlighting ayon sa wika ng notebook at may mga In [1]: prompt. Bumababa sa susunod na linya ang mahahabang linya sa halip na lumampas sa pahina.
  • Mga naka-save na output, sa ilalim ng mga Out[1]: prompt: naka-print na text, mga return value, mga HTML table gaya ng pandas DataFrame, at mga larawan, kaya lumalabas ang mga chart mula sa matplotlib o seaborn.
  • Mga error, kasama ang buong traceback.
  • Output ng terminal gaya ng ipinapakita ng terminal. Inaalis ang mga color code, at ang progress bar gaya ng tqdm ay huling estado lang nito ang natitira sa halip na bawat update.

Mga dapat malaman bago magsimula

  • Hindi pinapatakbo ang mga cell. Binabasa ng Look Scanned ang naka-save sa file; walang kernel. Ang cell na hindi mo pinatakbo kahit kailan, o ang notebook na sine-save matapos burahin ang mga output, ay code lang ang ipapakita at wala sa ilalim nito. Patakbuhin ang lahat ng cell at mag-save bago piliin ang file.
  • Nananatiling TeX source ang mga formula. Ang mga formula na isinulat bilang $…$ o $$…$$ sa mga Markdown cell ay lalabas nang eksakto kung paano ito tinype, halimbawa $\alpha + \beta$, at hindi bilang naka-typeset na math.
  • Hindi ipinapakita ang interactive na output. Gumuguhit ang Plotly, Bokeh at ipywidgets gamit ang JavaScript, na hindi pinapatakbo. Ang makikita mo ay ang static na bersyong sine-save ng notebook kasabay nito, na kadalasan ay isang maikling linya lang ng text, o wala talaga. Ayos lang ang mga chart na naka-save bilang larawan, gaya ng sa matplotlib.
  • Dapat nbformat 4 ang notebook. Ito ang isinusulat ng kasalukuyang Jupyter, JupyterLab, VS Code at Colab. Tinatanggihan ang napakalumang nbformat 3 na notebook; buksan ito sa bagong Jupyter at i-save ulit para ma-upgrade.
  • Sumisikip ang malalapad na table. Pinagkakasya ang mga table sa lapad ng pahina, kaya ang DataFrame na maraming column ay magkakaroon ng makikitid na column na may bumababang text.
  • Itabi ang notebook mo. Gaya ng totoong scan, gawa sa mga larawan ng pahina ang PDF. Itabi ang .ipynb file para mapatakbo at ma-edit ang code.

Binabasa at inaayos ang notebook sa sarili mong device at hindi ina-upload sa anumang server. Ang tanging eksepsiyon ay ang Markdown cell na nagpapakita ng larawan gamit ang web address nito: kukunin ng browser mo ang larawang iyon mula sa site na nagho-host nito, gaya ng gagawin ng Jupyter.

Kailan mas mainam ang nbconvert

Kung kailangan mo ng text na napipili, naka-typeset na formula, o PDF na kaparehong-kapareho ng sariling export ng Jupyter, nbconvert pa rin ang tamang tool. Mag-install ng TeX distribution at patakbuhin ang jupyter nbconvert --to pdf, o gamitin ang --to webpdf, na nagpi-print sa pamamagitan ng headless na Chromium browser at hindi na kailangan ng LaTeX. Alinman ang piliin mo, puwede mo pagkatapos idagdag ang scan effect sa PDF na iyon sa Look Scanned.

Markdown o LaTeX file ba ang report mo sa halip na notebook? Nabubuksan din ang mga iyon: tingnan ang Markdown at HTML papuntang scanned PDF at LaTeX papuntang scanned PDF.

May notebook ka bang kailangang ipasa bilang PDF? Subukan na ngayon.