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

Aspose.Note FOSS pro Python

Čtěte, procházejte a exportujte Microsoft OneNote (.one) soubory z Python — zdarma a open-source, není vyžadován Microsoft Office.

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

Dokumentace GitHub

Open-Source Python knihovna pro OneNote soubory

Aspose.Note FOSS pro Python je 100 % zdarma, knihovna licencovaná pod MIT, která vám umožní číst soubory Microsoft OneNote (.one) kompletně z Python, bez Microsoft Office, bez COM automatizace a bez nutnosti proprietárního runtime. Poskytuje čisté veřejné API (aspose.note.*) modelované na známém rozhraní Aspose.Note pro .NET, podpořené vestavěným binárním parserem MS-ONE/OneStore napsaným v čistém Python.

Instalujte z PyPI pomocí pip install aspose-note (nebo pip install "aspose-note[pdf]" pro povolení exportu PDF). Vyžaduje Python 3.10 nebo novější.

Knihovna je vhodná pro skripty automatizace dokumentů, pipeline pro indexaci obsahu, archivní nástroje a jakýkoli server‑side workflow, který potřebuje zpracovávat obsah OneNote bez závislosti na Microsoft Office. Pro rodinu podnikových produktů viz Aspose.Note — Enterprise Product Family.

Čtěte a procházejte OneNote dokumenty

  • Načíst soubory .one: Otevřete libovolnou sekci OneNote ze souborové cesty nebo binárního proudu pomocí Document.
  • Úplná prohlídka DOM: Navigujte Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile
  • Extrahování formátovaného textu: Přečtěte si surový text pomocí RichText.Text nebo prozkoumejte segmenty TextRun pro metadata tučného, kurzívního, písma, barvy a hypertextových odkazů.
  • Parsování tabulky: Procházejte hierarchie Table → TableRow → TableCell; načtěte šířky sloupců pomocí TableColumn.Width.
  • Tag inspection: Přečíst NoteTag metadata (tvar, štítek, barva, stav dokončení) na textových, obrazových a tabulkových uzlech.

Kde lze použít Aspose.Note FOSS

  • Obsahové indexování: Extrahujte a indexujte veškerý text z archivů OneNote pro vyhledávací pipeline.
  • Migrace dokumentů: Exportujte sekce OneNote do PDF, prostého textu nebo strukturovaných dat.
  • Archivní nástroje: Uložte vložené obrázky a přílohy na disk ze souborů .one.
  • CI/CD workflows: Ověřte nebo zpracovávejte obsah OneNote uvnitř kontejnerů Docker.
  • Pipelines znalostní báze: Extrahovat strukturovaný obsah z týmových poznámkových bloků OneNote.

Export, obrázky a přílohy

  • PDF export: Uložte jakýkoli načtený Document do PDF pomocí Document.Save(path, SaveFormat.Pdf). Edice FOSS používá výchozí vykreslování; pokročilé možnosti PDF na stránku nejsou v tomto vydání k dispozici.
  • Export obrázku: Procházejte uzly Image a získejte surová data (Bytes), název souboru (FileName) a rozměry (OriginalWidth, OriginalHeight).
  • Attachment saving: Iterujte AttachedFile uzly pro uložení vložených souborových příloh na disk.
  • Načítání ze streamu: Otevřete soubory .one z binárního proudu (např. io.BytesIO) bez zápisu na disk.

Zkušenost vývojáře

Aspose.Note FOSS se instaluje jedním příkazem pip install aspose-note. Základní balíček nemá žádné volitelné závislosti; export PDF vyžaduje ReportLab, nainstalovaný pomocí pip install "aspose-note[pdf]".

API je modelována na známém Aspose.Note pro .NET rozhraní: Document, Page, Outline, RichText, Image, Table, AttachedFile. Knihovna je licencována pod MIT, je open-source a přijímá hlášení chyb a příspěvky na GitHubu.

Načíst soubor OneNote a extrahovat celý text

Nainstalujte pomocí pip, pak předávejte cestu k souboru do Document(), aby se analyzoval binární formát OneNote. GetChildNodes(RichText) provádí hluboké rekurzivní vyhledávání a vrací každý textový uzel v dokumentu, což je užitečné pro full‑textové indexování nebo 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)

Exportovat do PDF a uložit připojené obrázky

Export PDF vyžaduje volitelnou závislost ReportLab. Nainstalujte ji pomocí pip install "aspose-note[pdf]". Stejný objekt Document lze také iterovat pro uzly Image a extrahovat a uložit všechny vložené obrázky na disk v jednom průchodu.

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)

Často kladené dotazy

Co je Aspose.Note FOSS pro Python?

Jedná se o volně dostupnou knihovnu Python s licencí MIT pro čtení souborů Microsoft OneNote (.one) bez nutnosti Microsoft Office, COM automatizace nebo jakéhokoli proprietárního runtime.

Které varianty formátu OneNote jsou podporovány?

OneNote 2010, OneNote Online a varianty formátu OneNote 2007. Jakýkoli platný soubor sekce .one lze načíst.

Jak to nainstaluji?

Spusťte pip install aspose-note pro základní knihovnu, nebo pip install "aspose-note[pdf]" pro zahrnutí volitelné závislosti ReportLab pro export do PDF.

Mohu exportovat soubory OneNote do PDF?

Ano. Zavolejte Document.Save(path, SaveFormat.Pdf). Export do PDF vyžaduje volitelnou závislost ReportLab nainstalovanou pomocí rozšíření [pdf].

Mohu načíst soubory .one ze streamu?

Ano. Třída Document přijímá binární proud (např. io.BytesIO nebo tělo odpovědi HTTP), takže můžete zpracovávat soubory bez zápisu na disk.

Jaká verze Python je vyžadována?

Je vyžadováno Python 3.10 nebo novější.

Mohu zapisovat nebo upravovat soubor .one?

Ne. Současná edice je jen pro čtení. Dokáže otevřít a analyzovat libovolný platný soubor sekce .one, ale zápis zpět do binárního formátu OneNote není podporován.

Jsou podporovány šifrované dokumenty OneNote?

Ne. Načtení souboru .one chráněného heslem vyvolá IncorrectPasswordException. Šifrované dokumenty nejsou v současné edici podporovány.

Kde mohu najít zdrojový kód?

Knihovna je licencována pod MIT a je hostována na GitHubu. Hlášení chyb a pull requesty jsou vítány.

  

Podpora a vzdělávací materiály

 Čeština