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

Aspose.Note Python için FOSS

Microsoft OneNote (.one) dosyalarını Python üzerinden 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. Tanıdık Aspose.Note for .NET arayüzüne dayanan temiz bir genel API (aspose.note.*) sunar 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 komutuyla 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.

Bu kütüphane, belge otomasyon betikleri, içerik indeksleme 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.

OneNote Belgelerini Oku ve Dolaş

  • .one dosyalarını yükleyin: Document aracılığıyla bir dosya yolu ya da ikili akıştan herhangi bir OneNote bölümünü açın.
  • Tam DOM dolaşımı: Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile yapısında gezin.
  • Zengin metin çıkarma: RichText.Text ile ham metni okuyun veya kalın, italik, yazı tipi, renk ve bağlantı metası gibi bilgileri elde etmek için TextRun segmentlerini inceleyin.
  • Tablo ayrıştırma: Sütun genişlikleri ve kenar görünürlüğüyle Table → TableRow → TableCell hiyerarşilerini dolaşın.
  • Etiket inceleme: Metin, resim ve tablo düğümlerindeki NoteTag meta verilerini (şekil, etiket, renk, tamamlama durumu) okuyun.

Aspose.Note FOSS nerede kullanılabilir

  • İçerik indeksleme: Arama hatları için OneNote arşivlerinden tüm metni çıkarın ve indeksleyin.
  • Belge göçü: OneNote bölümlerini PDF, düz metin veya yapılandırılmış veri formatına dönüştürün.
  • Arşivleme araçları: .one dosyalarından gömülü görselleri ve ekleri diske kaydedin.
  • CI/CD iş akışları: Docker konteynerleri içinde OneNote içeriğini doğrulayın veya işleyin.
  • Bilgi tabanı iş akışları: 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‘i Document.Save(path, SaveFormat.Pdf) kullanarak PDF olarak kaydedin.
  • PDF seçenekleri: Sayfa aralığını, etiket simgesi dizinini, simge boyutunu ve boşluğu PdfSaveOptions aracılığıyla özelleştirin.
  • Görsel dışa aktarımı: Ham baytları, dosya adını, boyutları ve alt metni almak için Image düğümlerini yineleyin.
  • Ek kaydetme: Gömülü dosya eklerini diske kaydetmek için AttachedFile düğümlerini yineleyin.
  • Akış tabanlı yükleme: .one dosyalarını bir ikili akıştan (ör. io.BytesIO) diske yazmadan açın.

Geliştirici Deneyimi

Aspose.Note FOSS tek bir pip install aspose-note komutuyla kurulur. Temel paket hiçbir isteğe bağlı bağımlılık içermez; PDF dışa aktarımı ReportLab gerektirir ve pip install "aspose-note[pdf]" ile kurulur.

API, tanıdık Aspose.Note for .NET arayüzüne benzer şekilde modellenmiştir: Document, Page, Outline, RichText, Image, Table, AttachedFile. Kütüphane MIT lisanslı, açık kaynaklıdır ve GitHub’da 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 bir dosya yolunu Document()‘a 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 iş akışları için faydalıdır.

pip install aspose-note

from aspose.note import Document, RichText

doc = Document("notebook.one")
print(f"Sayfalar: {len(list(doc))}")

# Belgenin tamamındaki tüm metni çıkar
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]" komutuyla kurun. Aynı Document nesnesi, gömülü tüm resimleri tek seferde çıkarmak ve diske kaydetmek için Image düğümleri üzerinde yineleyebilir.

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

doc = Document("notebook.one")

# Belgeyi PDF olarak dışa aktar (aspose-note[pdf] gerektirir)
doc.Save("output.pdf", SaveFormat.Pdf)

# Gömülü tüm resimleri diske kaydet
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 OneNote (.one) dosyalarını Microsoft Office, COM otomasyonu veya herhangi bir tescilli çalışma zamanı gerektirmeden 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.

Nasıl kurarım?

Temel kütüphane için pip install aspose-note komutunu ç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]\" komutunu kullanın.

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

Evet. Document.Save(path, SaveFormat.Pdf) çağrısını yapı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 yeni bir sürüm gereklidir.

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

Hayır. Mevcut sürüm yalnızca okunabilir. Geçerli bir .one bölüm dosyasını açabilir ve 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 IncorrectPasswordException hatasını tetikler. Ş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