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

Aspose.Note FOSS for Python

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

Pythonová knižnica pre OneNote súbory s otvoreným zdrojom

FOSS pre Python je 100% bezplatná knižnica s licenciou MIT, ktorá vám umožňuje čítať súbory Microsoft OneNote (.one) úplne z Pythonu, bez potreby Microsoft Office, automatizácie COM a vlastného času spúšťania. Vystihuje čisté verejné API (aspose.note.*), ktoré je modelované na známej Aspose.Note pre .NET rozhranie, podporené zabudovaným binárnym analyzátorom MS-ONE / OneStore napísaným v čisto Python.

Inštalovať z PyPI pomocou pip install aspose-note (alebo pip install "aspose-note[pdf]" na aktiváciu vývozu PDF). Vyžaduje Python 3.10 alebo novší.

Knižnica je vhodná pre skripty automatizácie dokumentov, potrubia indexovania obsahu, archivné nástroje a akýkoľvek pracovný postup na strane servera, ktorý potrebuje spotrebovať obsah OneNote bez závislosti od Microsoft Office. Pre rodinu produktov v rámci podniku pozri Aspose.Note — Enterprise Product Family.

Prečítať a prechádzať OneNote dokumenty

  • Load .one files: Otvorte ľubovoľnú sekciu programu OneNote z cesty súboru alebo binárneho prúdu prostredníctvom Document.
  • Full DOM traversal: Navigovať Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • Extrakcia bohatého textu: Čítať surový text prostredníctvom RichText.Text alebo kontrolovať segmenty TextRun pre tučné, kurzivné písmo, farbu a hypertextové metadaty.
  • ** Parsing tabuľky:** Prechádzajte hierarchiami Table → TableRow → TableCell; čítajte šírky stĺpcov prostredníctvom TableColumn.Width.
  • Inšpekcia štítkov: Prečítajte si NoteTag metadaty (tvar, označenie, farba, stav dokončenia) na textových, obrázkových a tabuľkových uzloch.

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

  • Indexovanie obsahu: Vyťahujte a indexujte všetok text z archívov OneNote pre vyhľadávacie linky.
  • Migrácia dokumentu: Exportovať sekcie programu OneNote do formátu PDF, plain text alebo štruktúrovaných údajov.
  • Archivačné nástroje: Uložiť vložené obrázky a prílohy na disk z .one súborov.
  • Prípady práce CI/CD: Validovať alebo spracovávať obsah programu OneNote v kontejneroch Dockeru.
  • Pipeliny znalostnej základne: Vytlačiť štruktúrovaný obsah z notebookov tímu OneNote.

Export, obrázky a prílohy

  • PDF export: Uložte akýkoľvek načítaný Document do PDF pomocou Document.Save(path, SaveFormat.Pdf). FOSS edícia používa predvolené vykresľovanie; pokročilé možnosti PDF na úrovni stránok nie sú v tomto vydaní k dispozícii.
  • Image export: Prejdite Image uzly a získajte surové bajty (Bytes), názov súboru (FileName) a rozmery (OriginalWidth, OriginalHeight).
  • Attachment saving: Prejdite AttachedFile uzly a uložte vložené prílohy súborov 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 sa inštaluje s jedným príkazom pip install aspose-note. 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 základe známeho Aspose.Note pre rozhranie .NET: 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.

Zabaliť súbor OneNote a vytiahnuť všetok text

Inštalovať pomocou pip, potom prejsť cestu súboru na Document() analyzovať binárny formát OneNote. GetChildNodes(RichText) vykonáva hlboký rekurzívny vyhľadávanie a vráti každý textový uzol v dokumente, čo je užitočné pre indexovanie plného textu alebo migrácie potrubí.

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. Inštalujte ju pomocou pip install "aspose-note[pdf]". Rovnaký objekt Document môže byť iterovaný aj pre uzly Image na vyberanie a ukladanie všetkých vložených obrázkov do disku v jednom priechode.

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 nutnosti využívania služieb Microsoft Office, automatizácie COM alebo vlastného času spúšťania.

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

OneNote 2010, OneNote Online a varianty formátu OneNot 2007. Každý platný súbor sekcie .one sa môže načítať.

Ako ho nainštalujem?

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

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

Áno. Volanie Document.Save(path, SaveFormat.Pdf). PDF export vyžaduje inštaláciu voliteľnej závislosti ReportLab prostredníctvom doplnku [pdf] .

Môžem si nahrať .one súbory z streamu?

Áno. Klasa Document prijíma binárny prúd (napr. io.BytesIO alebo telo odpovede HTTP), takže môžete spracovať súbory bez písania na disk.

Aká verzia Pythonu je potrebná?

Vyžaduje sa Python 3.10 alebo novší.

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

Nie. Aktuálna verzia je iba pre čítanie. Môže otvoriť a analyzovať akýkoľvek platný súbor sekcie .one, ale písanie späť do binárneho formátu OneNote nie je podporované.

Podporujú sa šifrované dokumenty programu OneNote?

Nie. Vyučovanie súborov .one chránených heslom vyvolá IncorrectPasswordException. Šifrované dokumenty nie sú podporované v aktuálnej verzii.

Kde nájdem zdrojový kód?

Knižnica je licencovaná MIT a hosťovaná na GitHub.

  

Support and Learning Resources

 Slovenčina