1. Products
  2.   Aspose.Note
  3.   Aspose.Note FOSS for Python

Aspose.Note FOSS pre Python

Čítajte, prechádzajte a exportujte Microsoft OneNote (.one) súbory z Python — bezplatne a open-source, nie je potrebný Microsoft Office.

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

Documentation GitHub

Open-Source Python knižnica pre OneNote súbory

Aspose.Note FOSS pre Python je 100 % bezplatná knižnica s licenciou MIT, ktorá vám umožňuje čítať súbory Microsoft OneNote (.one) úplne z Python, bez Microsoft Office, bez COM automatizácie a bez proprietárneho runtime. Poskytuje čisté verejné API (aspose.note.*) modelované na známy Aspose.Note pre .NET rozhranie, podporované vstavaným binárnym parserom MS-ONE/OneStore napísaným v čistom Python.

Inštalujte z PyPI pomocou pip install aspose-note (alebo pip install "aspose-note[pdf]" na povolenie exportu PDF). Vyžaduje Python 3.10 alebo novší.

Knižnica je vhodná pre skripty automatizácie dokumentov, pipeline indexovania obsahu, archivačné nástroje a akýkoľvek server‑side pracovný tok, ktorý potrebuje konzumovať obsah OneNote bez závislosti na Microsoft Office. Pre rodinu podnikových produktov pozri Aspose.Note — Enterprise Product Family.

Čítajte a prechádzajte OneNote dokumenty

  • Načítanie .one súborov: Otvorte akúkoľvek sekciu OneNote z cesty k súboru alebo binárneho prúdu pomocou Document.
  • Úplná prehliadka DOM: Navigovať Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile
  • Extrahovanie formátovaného textu: Prečítajte surový text cez RichText.Text alebo skontrolujte segmenty TextRun pre tučný, kurzívny, písmo, farbu a metadáta hyperodkazov.
  • Rozbor tabuľky: Prechádzajte hierarchie Table → TableRow → TableCell; čítajte šírky stĺpcov cez TableColumn.Width.
  • Tag inspection: Prečítajte NoteTag metadáta (tvar, štítok, farba, stav dokončenia) na textových, obrazových a tabuľkových uzloch.

Kde sa môže Aspose.Note FOSS použiť

  • Indexovanie obsahu: Extrahujte a indexujte všetok text z archívov OneNote pre vyhľadávacie pipeliney.
  • Migrácia dokumentov: Exportovať sekcie OneNote do PDF, obyčajného textu alebo štruktúrovaných údajov.
  • Archivačné nástroje: Uložte vložené obrázky a prílohy na disk zo súborov .one súborov.
  • CI/CD workflows: Validovať alebo spracovať obsah OneNote v Docker kontajneroch.
  • Knowledge-base pipelines: Extrahovať štruktúrovaný obsah z tímových OneNote poznámkových blokov.

Export, obrázky a prílohy

  • Export PDF: Uložte akýkoľvek načítaný Document do PDF pomocou Document.Save(path, SaveFormat.Pdf). Vydanie FOSS používa predvolené vykresľovanie; pokročilé možnosti PDF na stránku nie sú v tomto vydaní k dispozícii.
  • Image export: Iterovať Image uzlov na získanie surových bajtov (Bytes), názvu súboru (FileName) a rozmerov (OriginalWidth, OriginalHeight).
  • Ukladanie príloh: Iterujte AttachedFile uzly na uloženie vložených súborových príloh na disk.
  • Stream-based loading: Otvorte .one súbory z binárneho prúdu (napr. io.BytesIO) bez zápisu na disk.

Skúsenosti vývojára

Aspose.Note FOSS inštaluje pomocou jedného pip install aspose-note príkazu. Základný balík nemá žiadne voliteľné závislosti; export PDF vyžaduje ReportLab, nainštalovaný cez pip install "aspose-note[pdf]".

API je modelované na známy Aspose.Note pre .NET rozhranie: Document, Page, Outline, RichText, Image, Table, AttachedFile. Knižnica je licencovaná pod MIT, je open-source a prijíma hlásenia chýb a príspevky na GitHub.

Načítajte súbor OneNote a extrahujte celý text

Nainštalujte pomocou pip, potom odovzdajte cestu k súboru do Document(), aby ste analyzovali binárny formát OneNote. GetChildNodes(RichText) vykonáva hlboké rekurzívne vyhľadávanie a vracia každý textový uzol v dokumente, čo je užitočné pre full-text indexovanie alebo migračné pipeline.

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)

Exportovať do PDF a uložiť pripojené obrázky

Export PDF vyžaduje voliteľnú závislosť ReportLab. Nainštalujte ju pomocou pip install "aspose-note[pdf]". Ten istý Document objekt je možné tiež iterovať pre Image uzly na extrahovanie a uloženie všetkých vložených obrázkov na disk v jednom kroku.

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)

Frequently Asked Questions

Čo je Aspose.Note FOSS pre Python?

Je to bezplatná knižnica Python s licenciou MIT na čítanie súborov Microsoft OneNote (.one) bez potreby Microsoft Office, COM automatizácie alebo akéhokoľvek proprietárneho runtime.

Ktoré varianty formátu OneNote sú podporované?

OneNote 2010, OneNote Online a varianty formátu OneNote 2007. Akýkoľvek platný súbor sekcie .one môže byť načítaný.

Ako to nainštalujem?

Spustite pip install aspose-note pre základnú knižnicu alebo pip install "aspose-note[pdf]" pre zahrnutie voliteľnej závislosti ReportLab na export PDF.

Môžem exportovať súbory OneNote do PDF?

Áno. Zavolajte Document.Save(path, SaveFormat.Pdf). Export PDF vyžaduje voliteľnú závislosť ReportLab nainštalovanú prostredníctvom rozšírenia [pdf].

Môžem načítať .one súbory zo streamu?

Áno. Trieda Document prijíma binárny prúd (napr. io.BytesIO alebo telo odpovede HTTP), takže môžete spracovávať súbory bez zápisu na disk.

Aká verzia Python je požadovaná?

Python 3.10 alebo novší je vyžadovaný.

Môžem zapísať alebo upraviť .one súbor?

Nie. Aktuálna edícia je len na čítanie. Dokáže otvoriť a analyzovať akýkoľvek platný súbor sekcie .one, ale zápis späť do binárneho formátu OneNote nie je podporovaný.

Sú podporované šifrované dokumenty OneNote?

Nie. Načítanie súboru .one chráneného heslom vyvolá IncorrectPasswordException. Šifrované dokumenty nie sú v aktuálnej edícii podporované.

Kde môžem nájsť zdrojový kód?

Knižnica je licencovaná pod licenciou MIT a je hostovaná na GitHub. Správy o chybách a pull requesty sú vítané.

  

Support and Learning Resources

 Slovenčina