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

Aspose.Note FOSS for Python

Citește, parcurge și exportă fișiere Microsoft OneNote (.one) din Python — gratuit și open‑source, fără a necesita Microsoft Office.

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

Documentation GitHub

Biblioteca Python cu sursă deschisă pentru fișiere OneNote

FOSS pentru Python este o bibliotecă 100% gratuită, licențiată de MIT care vă permite să citiți fișierele Microsoft OneNote (.one) în întregime din Python, fără Microsoft Office, nici automatizare COM și niciun timp de rulare proprietar necesar. Expune un API public curat (aspose.note.*) modelat pe interfața familiară Aspose.Note pentru .NET, susținută de un parser binar MS-ONE / OneStore scris în Python pur.

Instalați din PyPI cu pip install aspose-note (sau pip install "aspose-note[pdf]" pentru a permite exportul PDF). Reține Python 3.10 sau mai târziu.

Biblioteca este potrivită pentru scripturi de automatizare a documentelor, pipelines de indexare de conținut, instrumente de arhivare și orice flux de lucru din partea serverului care trebuie să consume conţinutul OneNote fără o dependență Microsoft Office. Pentru familia produselor enterprise, vezi Aspose.Note — Enterprise Product Family.

Citit și traversat documentele OneNote

  • Load .one fișiere: Deschide orice secțiune OneNote dintr-o cale de fișier sau flux binar prin Document.
  • DOM complet traversare: Navigarea Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • Extracția de text bogat: Citește textul brut prin RichText.Text sau inspectează segmentele TextRun pentru metadate în gras, italic, font, culoare și hiperlink.
  • ** Parsarea tabelului:** Traverse Table → TableRow → TableCell ierarhii; citiți lățimi de coloană prin TableColumn.Width.
  • Inspicarea etichetelor: Citirea NoteTag metadatele (forma, eticheta, culoarea, starea de finalizare) pe text, imagine și noduri ale tabelului.

Unde Aspose.Note FOSS poate fi utilizat

  • Indexațiunea conținutului: Extrage și indexază tot textul din arhivele OneNote pentru căutare.
  • Migrația documentului: Exportați secțiuni OneNote în PDF, text simplu sau date structurate.
  • ** Instrumente de arhivare:** Salvați imaginile și atașamentele încorporate pe disc din fișierele .one.
  • ** Fluxuri de lucru CI/CD:** Validarea sau procesarea conținutului OneNote în interiorul containerelor Docker.
  • Pipeline-uri de bază a cunoștințelor: Extrageți conținut structurat din notebookurile echipei OneNote.

Export, imagini și anexe

  • Export PDF: Salvați orice Document încărcat în PDF folosind Document.Save(path, SaveFormat.Pdf). Ediția FOSS utilizează o redare implicită; opțiunile avansate pe pagină nu sunt disponibile în această versiune.
  • Exportul imaginii: Iterarea Image noduri pentru a recupera byte crude (Bytes), numele fișierului ( FileName) și dimensiunile ( OriginalWidth, OriginalHeight).
  • ** Salvarea atașamentelor:** Iterate AttachedFile noduri pentru a salva ataşamente de fișiere încorporate pe disc.
  • ** Încărcarea bazată pe flux:** Deschideți fișierele .one dintr-un flux binar (de exemplu, io.BytesIO) fără a scrie pe disc.

Experiență de dezvoltator

Aspose.Note FOSS se instalează cu o singură comandă pip install aspose-note. Pachetul de bază nu are dependențe opționale; exportul PDF necesită ReportLab, instalat prin pip install "aspose-note[pdf]".

API-ul este modelat pe interfața familiară Aspose.Note pentru .NET: Document, Page , Outline,, RichText ,, Image “, Table”, AttachedFile. Biblioteca are licență MIT, open source și acceptă rapoarte și contribuții pe GitHub.

Încărcați un fișier OneNote și extrageți tot textul

Instalați cu pip, apoi treceți o cale de fișiere la Document() pentru a analiza formatul binar OneNote. GetChildNodes(RichText) efectuează o căutare recursivă profundă și returnă fiecare nod text din document, care este util pentru indexarea full-text sau conducte de migrare.

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)

Exportați în PDF și salvați imaginile atașate

Exportul PDF necesită dependența opțională ReportLab. Instalați-o cu pip install "aspose-note[pdf]". Acelaşi obiect Document poate fi iterat și pentru nodurile Image pentru a extrage și salva toate imaginile încorporate pe disc într-un singur pas.

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

Ce este Aspose.Note FOSS pentru Python?

Este o bibliotecă Python gratuită, licențiată de MIT pentru citirea fișierelor Microsoft OneNote (.one) fără a necesita Microsoft Office, automatizarea COM sau orice runtime proprietar.

Ce variante de format OneNote sunt suportate?

OneNote 2010, OneNOte Online și variantele de format OneNot 2007. Orice fișier valabil .one poate fi încărcat.

Cum îl instalez?

rulați pip install aspose-note pentru biblioteca de bază sau pip install "aspose-note[pdf]" să includeți dependența opțională ReportLab pentru exportul PDF.

Pot exporta fișiere OneNote în PDF?

Da. Apel Document.Save(path, SaveFormat.Pdf). Exportul PDF necesită dependența opțională ReportLab instalată prin intermediul suplimentului [pdf] .

Pot încărca fişiere .one dintr-un flux?

Da. Clasa Document acceptă un flux binar (de exemplu, io.BytesIO sau un corp de răspuns HTTP) astfel încât să puteți procesa fișiere fără a scrie pe disc.

Ce versiune Python este necesar?

Este necesar Python 3.10 sau mai recent.

Pot scrie sau modifica un fişier .one?

Nu. Ediția curentă este doar pentru citire. Poate deschide și analiza orice fișier de secțiune .one valabil, dar scrierea înapoi în formatul binar OneNote nu este suportată.

Sunt suportate documentele OneNote criptate?

Nu. Încărcarea unui fișier protejat cu parolă .one creează un IncorrectPasswordException. Documentele criptate nu sunt suportate în ediția curentă.

Unde pot găsi codul sursă?

Biblioteca este licențiată de MIT și găzduită pe GitHub. Raporturile cu buguri și solicitările sunt binevenite.

  

Support and Learning Resources

 Română