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

Aspose.Note FOSS for Python

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

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

Dokumentace GitHub

Pythonová knihovna pro soubory OneNote s otevřeným zdrojovým kódem

FOSS pro Python je 100% bezplatná knihovna s licencí MIT, která vám umožňuje číst soubory Microsoft OneNote (.one) zcela ze Pythonu, aniž by bylo zapotřebí žádné služby Microsoft Office, automatizace COM a vlastnického runtime. Vystavuje čisté veřejné API (aspose.note.*), které je modelováno na známém rozhraní Aspose.Note pro .NET, podporované vestavěným binárním analyzátorem MS-ONE / OneStore napsáným v čistém jazyce Python.

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

Knihovna je vhodná pro skripty automatizace dokumentů, linky indexování obsahu, archivní nástroje a jakýkoli pracovní tok na straně serveru, který potřebuje konzumovat obsah OneNote bez závislosti Microsoft Office. Pro rodinu podnikových produktů viz Aspose.Note — Enterprise Product Family.

Čtení a přepínání dokumentů OneNote

  • Load .one files: Otevřete jakoukoli sekci OneNote ze stezky souboru nebo binárního proudu prostřednictvím Document.
  • Plná přeprava DOM: Navigovat Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • Extrakce bohatého textu: Číst surový text prostřednictvím RichText.Text nebo zkontrolovat segmente TextRun pro tučné, kurzivní, písmo, barvu a hypertextové metadata.
  • ** Parsing tabulky:** Procházka Table → TableRow → TableCell hierarchií; čtení šířek sloupců prostřednictvím TableColumn.Width.
  • Inspekce značek: Číst NoteTag metadata (tvar, nálepka, barva, stav dokončení) na textu, obrázku a uzlech tabulky.

Kde se mohou použít Aspose.Note HNÁDY

  • Indexování obsahu: Vytáhnout a indexovat veškerý text z archivů OneNote pro vyhledávací linky.
  • Migrace dokumentu: Exportovat sekce programu OneNote do formátu PDF, prostého textu nebo strukturovaných dat.
  • Archivační nástroje: Uložte vložené obrázky a přílohy na disk z souborů .one.
  • Převod práce CI/CD: Ověřovat nebo zpracovávat obsah programu OneNote v kontejnerech Dockeru.
  • Pipeliny znalostní základny: Vytáhnout strukturovaný obsah z notebooků týmu OneNote.

Export, obrázky a přílohy

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

Zkušenosti vývojářů

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ý přes pip install "aspose-note[pdf]".

API je modelován na známém Aspose.Note pro rozhraní .NET: 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.

Naložit soubor OneNote a vytáhnout veškerý text

Instalace pomocí pip, poté přeposlechte cestu souboru do Document() pro analýzu binárního formátu OneNote. GetChildNodes(RichText) provádí hluboké rekurzivní vyhledávání a vrací každý textový uzel v dokumentu, což je užitečné pro indexaci plného textu nebo migrační 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)

Export do PDF a ukládání přiložených obrázků

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 k extrakci a ukládání všech vložených obrazů 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?

Je to bezplatná knihovna Python s licencí MIT pro čtení souborů Microsoft OneNote (.one) bez nutnosti automatizace Microsoft Office, COM nebo jakéhokoli vlastního runtime.

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

Formát OneNote 2010, OneNot Online a Onenote 2007 lze načíst v jakémkoli platném souboru .one.

Jak to mám nainstalovat?

Vypněte pip install aspose-note pro základní knihovnu nebo pip install "aspose-note[pdf]", abyste zahrnovali volitelnou závislost ReportLab pro export PDF.

Mohu exportovat soubory programu OneNote do PDF?

Ano. Zavolejte Document.Save(path, SaveFormat.Pdf). PDF export vyžaduje volitelnou závislost ReportLab nainstalovanou prostřednictvím doplňku [pdf] .

Můžu si nahrát .one soubory ze streamu?

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

Jaká verze Pythonu je požadována?

Python 3.10 nebo novější je požadován.

Můžu napsat nebo upravit .one soubor?

Ne. Aktuální verze je pouze pro čtení. Může otevřít a analyzovat jakýkoli platný soubor sekce .one, ale psaní zpět do binárního formátu OneNote není podporováno.

Podporují se šifrované dokumenty OneNote?

Ne. Když se načte soubor .one chráněný heslem, vznikne číslo IncorrectPasswordException. Zašifrované dokumenty nejsou v aktuální edici podporovány.

Kde najdu zdrojový kód?

Knihovna je licencovaná MIT a hostována na GitHub. Zprávy o chybách a žádosti o vytáhnutí jsou vítány.

  

Podpora a vzdělávací materiály

 Čeština