Ödev Jupyter’da bitti, teslim sistemi ise PDF istiyor. “PDF olarak indir”i seçiyor ya da jupyter nbconvert --to pdf komutunu çalıştırıyorsunuz ve bir hata alıyorsunuz: xelatex bulunamadı ya da pandoc eksik. nbconvert PDF’lerini LaTeX üzerinden üretir; bu yüzden herhangi bir şey çıkarabilmesi için önce eksiksiz bir TeX dağıtımının kurulu olması gerekir.

Look Scanned artık .ipynb dosyalarını doğrudan açabiliyor. Not defterinizi Jupyter Notebook’u taranmış PDF’ye dönüştürün sayfasında seçin; tarayıcınızın içinde hemen sayfalara dizilir: Markdown hücreleri, kod ve dosyayla birlikte kaydedilen çıktılar. Önizlemede sayfaları kontrol edin ve PDF’yi indirin. Kurulacak hiçbir şey yok ve not defteri hiçbir yere yüklenmiyor.

Baştan bir şeyi belirtelim: Look Scanned belgeleri taranmış gibi gösterir, PDF de tam olarak böyle görünür. Basılıp taranmış bir kopya olarak teslim edilmesi gereken ya da sadece kâğıt gibi görünmesi istenen bir not defteri için bu idealdir. Daha temiz bir sayfa için döndürme, bulanıklık ve gürültüyü sıfıra indirebilirsiniz; ama her sayfa yine bir görüntüdür, yani PDF’deki metin seçilemez ve aranamaz.

.ipynb dosyası taranmış PDF’ye nasıl dönüştürülür?

  1. Not defterini Jupyter, JupyterLab, VS Code veya Google Colab’de çalıştırıp kaydedin; böylece çıktılar dosyanın içinde saklanır. Colab’de Dosya → İndir → .ipynb dosyasını indir yolunu kullanın.
  2. Jupyter Notebook’u taranmış PDF’ye dönüştürün sayfasını açın ve .ipynb dosyasını seçin.
  3. Önizlemeyi sayfa sayfa gözden geçirin. Kodu, tabloları ve grafikleri kontrol edin; kâğıt boyutunu ve kenar boşluklarını ayarlayın.
  4. Tarama efektini ayarlayın. Küçük punto kodun okunabilir kalması için bulanıklığı ve gürültüyü düşük tutun. Sayfalar varsayılan olarak gri tonlamalıdır; grafiklerin renklerini korumak için “Renkli”yi seçin.
  5. Taranmış PDF’yi oluşturun ve indirin.

Görüntü tercih ederseniz her sayfayı JPG veya PNG olarak da dışa aktarabilirsiniz. PDF, JPG ve PNG rehberimiz hangisinin ne zaman işe yaradığını anlatıyor. Pro ile Toplu Tarama birden çok .ipynb dosyasını aynı anda işler.

Sayfada neler görünür?

  • Markdown hücreleri: başlıklar, listeler, tablolar, bağlantılar ve görseller; hücreye doğrudan yapıştırılmış görseller de dahil.
  • Kod hücreleri, not defterinin diline göre sözdizimi vurgulamasıyla ve In [1]: istemleriyle. Uzun satırlar sayfadan taşmak yerine alt satıra kayar.
  • Kayıtlı çıktılar, Out[1]: istemlerinin altında: yazdırılan metin, dönüş değerleri, pandas DataFrame gibi HTML tabloları ve görseller; yani matplotlib veya seaborn grafikleri de yerinde olur.
  • Hatalar, tam traceback ile birlikte.
  • Terminal çıktısı, bir terminalin gösterdiği gibi. Renk kodları kaldırılır; tqdm gibi bir ilerleme çubuğu her güncellemeyi değil, yalnızca son durumunu gösterir.

Başlamadan önce bilmeniz gerekenler

  • Hücreler çalıştırılmaz. Look Scanned dosyada kayıtlı olanı okur; bir çekirdek (kernel) yoktur. Hiç çalıştırmadığınız bir hücre ya da çıktıları temizlenerek kaydedilmiş bir not defteri, altında hiçbir şey olmayan kod gösterir. Dosyayı seçmeden önce tüm hücreleri çalıştırıp kaydedin.
  • Formüller TeX kaynağı olarak kalır. Markdown hücrelerinde $…$ veya $$…$$ şeklinde yazılan formüller, örneğin $\alpha + \beta$, yazıldığı gibi görünür; dizilmiş matematik olarak değil.
  • Etkileşimli çıktılar görüntülenmez. Plotly, Bokeh ve ipywidgets JavaScript ile çizer ve JavaScript çalıştırılmaz. Not defterinin yanına kaydettiği statik sürümü görürsünüz; bu çoğu zaman kısa bir metin satırından ibarettir, hatta hiçbir şey görünmeyebilir. matplotlib’inkiler gibi görüntü olarak kaydedilen grafiklerde sorun yoktur.
  • Not defteri nbformat 4 olmalıdır. Jupyter, JupyterLab, VS Code ve Colab’in güncel sürümleri bu biçimde kaydeder. Çok eski bir nbformat 3 not defteri reddedilir; güncel bir Jupyter’da açıp yeniden kaydederek yükseltebilirsiniz.
  • Geniş tablolar daralır. Tablolar sayfa genişliğine sığdırılır; bu yüzden çok sütunlu bir DataFrame dar ve kaydırılmış sütunlarla görünür.
  • Not defterinizi saklayın. Gerçek bir tarama gibi PDF de sayfa görüntülerinden oluşur. Kodu çalıştırmak ve düzenlemek için .ipynb dosyasını saklayın.

Not defteri kendi cihazınızda okunur ve sayfalara dizilir; hiçbir sunucuya yüklenmez. Tek istisna, bir görseli web adresiyle gösteren Markdown hücresidir: tarayıcınız o görseli barındığı siteden indirir, tıpkı Jupyter’ın yapacağı gibi.

nbconvert ne zaman daha iyi bir seçimdir?

Seçilebilir metne, dizilmiş formüllere ya da Jupyter’ın kendi dışa aktarımıyla birebir aynı bir PDF’ye ihtiyacınız varsa doğru araç hâlâ nbconvert’tir. Bir TeX dağıtımı kurup jupyter nbconvert --to pdf komutunu çalıştırın ya da --to webpdf seçeneğini kullanın; bu seçenek arayüzsüz (headless) bir Chromium tarayıcısıyla yazdırır ve LaTeX’e hiç ihtiyaç duymaz. Her iki durumda da ortaya çıkan PDF’ye daha sonra Look Scanned’de tarama efekti ekleyebilirsiniz.

Çalışmanız bir not defteri değil de Markdown veya LaTeX dosyası mı? Onlar da açılır: Markdown ve HTML’yi taranmış PDF’ye dönüştürme ve LaTeX’i taranmış PDF’ye dönüştürme yazılarına göz atın.

PDF olarak teslim etmeniz gereken bir not defteriniz mi var? Hemen deneyin.