Introduzione
Questa guida ti porta da pip install a uno script funzionante in pochi minuti. aspose-note è una libreria gratuita, con licenza MIT, per la lettura e il salvataggio dei file Microsoft OneNote interamente in Python, senza dipendere da Microsoft Office, automazione COM o qualsiasi estensione nativa.
pip install aspose-note-fossChe cos’è Aspose.Note FOSS per Python?
Il formato .one di OneNote è un contenitore binario proprietario — l’analisi senza le librerie Microsoft richiedeva tradizionalmente strumenti di reverse engineering o bridge COM specifici per Windows. Aspose.Note FOSS fornisce un’implementazione pure-Python che legge il formato ed esporta in PDF su qualsiasi piattaforma che supporti Python 3.10 o successive.
La libreria espone un modello oggetto documento: una radice Document che contiene nodi Page, ognuno dei quali può contenere figli Title, Outline, RichText, Image e AttachedFile. Si attraversa l’albero con GetChildNodes() ed esporta il risultato in PDF con Document.Save(). Per una panoramica completa delle funzionalità — inclusa la creazione di un notebook da zero — vedere Presentazione di Aspose.Note FOSS per Python.
Avvio rapido
Ecco l’intero flusso di lavoro in cinque righe — carica un file .one e salvalo direttamente in PDF:
from aspose.note import Document, SaveFormat
# Load a .one file
doc = Document("notebook.one")
print(f"Format: {doc.FileFormat}")
# Save to PDF
doc.Save("notebook.pdf", SaveFormat.Pdf)
print("Saved notebook.pdf")
Lettura di pagine e testo
Le pagine sono nodi Page all’interno del Document. Ogni Page ha una proprietà Title e può contenere elementi Outline con contenuto RichText. Usa GetChildNodes() per attraversare l’albero:
from aspose.note import Document, Page, RichText
doc = Document("notebook.one")
for page in doc.GetChildNodes(Page):
title = page.Title
if title and title.TitleText:
print(f"Page: {title.TitleText}")
for rt in page.GetChildNodes(RichText):
text = "".join(rt)
if text.strip():
print(f" Text: {text[:80]}")
Per un’analisi più approfondita della lettura di testo, immagini, allegati e tabelle, vedi Reading OneNote .one Files in Python with Aspose.Note FOSS.
Salvataggio in PDF
Una volta caricato un Document, convertirlo in PDF è una singola chiamata: passa un percorso file e SaveFormat.Pdf a Document.Save(), e la libreria rende il notebook in PDF in-processo:
from aspose.note import Document, SaveFormat
doc = Document("notebook.one")
doc.Save("output.pdf", SaveFormat.Pdf)
Per l’output in buffer in memoria, la conversione batch e la limitazione di esportazione solo, vedi Exporting OneNote Files to PDF in Python.
Formati supportati
| Formato | Estensione | Leggi | Scrivi |
|---|---|---|---|
| OneNote 2010 | .one | ✓ | — |
| OneNote 2007 | .one | ✓ | — |
| OneNote Online | .one | ✓ | — |
.pdf | — | ✓ |
Open Source e Licenze
Aspose.Note FOSS per Python è rilasciato sotto la Licenza MIT. Il pacchetto è pubblicato su PyPI come aspose-note e l’uso commerciale, la modifica e la redistribuzione sono tutti consentiti ai sensi dei termini MIT.
