1. Ürünler
  2.   Aspose.Note
  3.   Aspose.Note FOSS for Python

Aspose.Note FOSS - Aspose.Note Python için FOSS

Microsoft OneNote (.one) dosyalarını Python ile okuyun, dolaşın ve dışa aktarın — ücretsiz ve açık kaynaklı, Microsoft Office gerekmez.

Aspose.Note FOSS for Python Aspose.Note FOSS
for Python

Belgelendirme GitHub

OneNote Dosyaları için Açık Kaynaklı Python Kütüphanesi

Aspose.Note FOSS for Python, %100 ücretsiz, MIT lisanslı bir kütüphanedir ve Microsoft OneNote (.one) dosyalarını tamamen Python üzerinden okumanızı sağlar; Microsoft Office, COM otomasyonu ve özel bir çalışma zamanı gerektirmez. Temiz bir genel API (aspose.note.*) sunar; bu API, tanıdık Aspose.Note for .NET arayüzüne dayanır ve saf Python ile yazılmış yerleşik bir MS-ONE/OneStore ikili ayrıştırıcı tarafından desteklenir.

PyPI’dan pip install aspose-note ile kurun (veya PDF dışa aktarmayı etkinleştirmek için pip install "aspose-note[pdf]"). Python 3.10 veya daha yeni bir sürüm gerektirir.

Kütüphane, belge otomasyon betikleri, içerik indeksleme boru hatları, arşivleme araçları ve Microsoft Office bağımlılığı olmadan OneNote içeriğini tüketmesi gereken herhangi bir sunucu tarafı iş akışı için uygundur. Kurumsal ürün ailesi için, Aspose.Note — Enterprise Product Family adresine bakın.

OneNote Belgelerini Oku ve Dolaş

  • .one dosyalarını yükle: Bir dosya yolu veya ikili akış üzerinden Document ile herhangi bir OneNote bölümünü açın.
  • Full DOM traversal: Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile‘a gidin.
  • Zengin metin çıkarma: Ham metni RichText.Text aracılığıyla okuyun veya TextRun bölümlerini kalın, italik, yazı tipi, renk ve hiperlink meta verileri için inceleyin.
  • Tablo ayrıştırma: Table → TableRow → TableCell hiyerarşilerini dolaşın; TableColumn.Width aracılığıyla sütun genişliklerini okuyun.
  • Etiket denetimi: Metin, resim ve tablo düğümlerindeki NoteTag meta verilerini (şekil, etiket, renk, tamamlama durumu) okuyun.

Aspose.Note FOSS nerede kullanılabilir

  • İçerik indeksleme: OneNote arşivlerinden tüm metni çıkarın ve indeksleyin arama boru hatları için.
  • Belge taşıma: OneNote bölümlerini PDF, düz metin veya yapılandırılmış veri olarak dışa aktar.
  • Arşivleme araçları: Gömülü resimleri ve ekleri .one dosyalarından diske kaydedin.
  • CI/CD workflows: Docker konteynerleri içinde OneNote içeriğini doğrulayın veya işleyin.
  • Knowledge-base pipelines: Takım OneNote defterlerinden yapılandırılmış içeriği çıkarın.

Dışa Aktar, Görüntüler ve Ekler

  • PDF dışa aktarımı: Yüklenmiş herhangi bir Document PDF olarak Document.Save(path, SaveFormat.Pdf) kullanarak kaydedin. FOSS sürümü varsayılan bir render kullanır; gelişmiş sayfa başına PDF seçenekleri bu sürümde mevcut değildir.
  • Görüntü dışa aktarımı: Image düğümlerini yineleyerek ham baytları (Bytes), dosya adını (FileName) ve boyutları (OriginalWidth, OriginalHeight) alın.
  • Ek kaydetme: AttachedFile düğümlerini yineleyerek gömülü dosya eklerini diske kaydedin.
  • Akış tabanlı yükleme: .one dosyalarını ikili bir akıştan (ör. io.BytesIO) diske yazmadan açın.

Geliştirici Deneyimi

Aspose.Note FOSS tek bir pip install aspose-note komutuyla kurulur. Temel paketin isteğe bağlı bağımlılıkları yoktur; PDF dışa aktarımı ReportLab gerektirir, pip install "aspose-note[pdf]" aracılığıyla kurulur.

API, tanıdık Aspose.Note for .NET arayüzüne dayanarak modellenmiştir: Document, Page, Outline, RichText, Image, Table, AttachedFile. Kütüphane MIT lisanslı, açık kaynaklıdır ve GitHub’ta hata raporları ve katkıları kabul eder.

Bir OneNote dosyasını yükle ve tüm metni çıkar

pip ile kurun, ardından OneNote ikili formatını ayrıştırmak için Document() öğesine bir dosya yolu geçirin. GetChildNodes(RichText) derin bir özyinelemeli arama yapar ve belgedeki her metin düğümünü döndürür; bu, tam metin indekslemesi veya taşıma boru hatları için faydalıdır.

pip install aspose-note

from aspose.note import Document, RichText
doc = Document("notebook.one")
print(f"Pages: {len(list(doc))}")
# Extract all text across the entire document
texts = [rt.Text for rt in doc.GetChildNodes(RichText) if rt.Text]
for text in texts:
   print(text)

PDF’ye Dışa Aktar ve Ekli Görselleri Kaydet

PDF dışa aktarma, isteğe bağlı ReportLab bağımlılığını gerektirir. pip install "aspose-note[pdf]" ile kurun. Aynı Document nesnesi, Image düğümleri için yineleyerek tüm gömülü görüntüleri tek seferde diske çıkarmak ve kaydetmek için kullanılabilir.

from aspose.note import Document, SaveFormat, Image
import pathlib

doc = Document("notebook.one")

# Export the document to PDF (requires aspose-note[pdf])
doc.Save("output.pdf", SaveFormat.Pdf)

# Save all embedded images to disk
out_dir = pathlib.Path("images")
out_dir.mkdir(exist_ok=True)
for i, img in enumerate(doc.GetChildNodes(Image)):
   name = img.FileName or f"image_{i}.bin"
   (out_dir / name).write_bytes(img.Bytes)

Sıkça Sorulan Sorular

Aspose.Note FOSS, Python için nedir?

Microsoft Office, COM otomasyonu veya herhangi bir tescilli çalışma zamanına ihtiyaç duymadan Microsoft OneNote (.one) dosyalarını okumak için ücretsiz, MIT lisanslı Python kütüphanesidir.

Hangi OneNote format varyantları destekleniyor?

OneNote 2010, OneNote Online ve OneNote 2007 format varyantları. Geçerli herhangi bir .one bölüm dosyası yüklenebilir.

Bunu nasıl kurarım?

Temel kütüphane için pip install aspose-note çalıştırın, ya da PDF dışa aktarma için isteğe bağlı ReportLab bağımlılığını eklemek üzere pip install "aspose-note[pdf]" kullanın.

OneNote dosyalarını PDF’ye dışa aktarabilir miyim?

Evet. Document.Save(path, SaveFormat.Pdf) çağırın. PDF dışa aktarma, [pdf] ekstra paketi aracılığıyla kurulan isteğe bağlı ReportLab bağımlılığını gerektirir.

.one dosyalarını bir akıştan yükleyebilir miyim?

Evet. Document sınıfı bir ikili akışı (ör. io.BytesIO veya bir HTTP yanıt gövdesi) kabul eder, böylece dosyaları diske yazmadan işleyebilirsiniz.

Hangi Python sürümü gerekiyor?

Python 3.10 veya daha yenisi gereklidir.

.one dosyasını yazabilir veya değiştirebilir miyim?

Hayır. Mevcut sürüm yalnızca okunabilir. Geçerli herhangi bir .one bölüm dosyasını açıp ayrıştırabilir, ancak OneNote ikili formatına geri yazma desteklenmez.

Şifreli OneNote belgeleri destekleniyor mu?

Hayır. Şifre korumalı bir .one dosyasını yüklemek bir IncorrectPasswordException hatası oluşturur. Şifreli belgeler mevcut sürümde desteklenmez.

Kaynak kodunu nerede bulabilirim?

Kütüphane MIT lisanslıdır ve GitHub’da barındırılmaktadır. Hata raporları ve pull request’ler memnuniyetle karşılanır.

  

Destek ve Öğrenme Kaynakları

 Türkçe