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

Aspose.Note FOSS per a Python

Llegeix, recorre i exporta fitxers Microsoft OneNote (.one) des de Python — gratuït i de codi obert, no cal Microsoft Office.

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

Aprèn GitHub

Biblioteca Python de codi obert per a fitxers OneNote

Aspose.Note FOSS per a Python és una biblioteca 100% gratuïta, amb llicència MIT, que permet llegir fitxers Microsoft OneNote (.one) completament des de Python, sense Microsoft Office, sense automatització COM i sense cap entorn d’execució propietari. Exposa una API pública neta (aspose.note.*) modelada segons la coneguda interfície Aspose.Note per a .NET, recolzada per un analitzador binari MS-ONE/OneStore integrat escrit íntegrament en Python.

Instal·la des de PyPI amb pip install aspose-note (o pip install "aspose-note[pdf]" per habilitar l’exportació PDF). Requereix Python 3.10 o posterior.

La biblioteca és adequada per a scripts d’automatització de documents, canals d’indexació de contingut, eines d’arxiu i qualsevol flux de treball del costat del servidor que necessiti consumir contingut de OneNote sense una dependència de Microsoft Office. Per a la família de productes empresarials, vegeu Aspose.Note — Enterprise Product Family.

Llegeix i recorre documents OneNote

  • Carrega fitxers .one: Obre qualsevol secció de OneNote des d’un camí de fitxer o flux binari mitjançant Document.
  • Recorregut complet del DOM: Navega Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • Extracció de text enriquit: Llegeix el text en brut mitjançant RichText.Text o inspecciona segments TextRun per a metadades de negreta, cursiva, tipografia, color i enllaç.
  • Anàlisi de taules: Recorre les jerarquies Table → TableRow → TableCell; llegeix les amplades de columna via TableColumn.Width.
  • Tag inspection: Llegeix les metadades NoteTag (forma, etiqueta, color, estat de completament) en nodes de text, imatge i taula.

On es pot utilitzar Aspose.Note FOSS

  • Indexació de contingut: Extreu i indexa tot el text dels arxius OneNote per a les pipelines de cerca.
  • Migració de documents: Exporta seccions de OneNote a PDF, text pla o dades estructurades.
  • Eines d’arxiu: Desa les imatges incrustades i els fitxers adjunts al disc des de fitxers .one.
  • Fluxos de treball CI/CD: Valida o processa el contingut de OneNote dins de contenidors Docker.
  • Knowledge-base pipelines: Extreu contingut estructurat dels quaderns d’OneNote de l’equip.

Exporta, imatges i fitxers adjunts

  • Exportació PDF: Desa qualsevol Document carregat a PDF mitjançant Document.Save(path, SaveFormat.Pdf). L’edició FOSS utilitza una renderització per defecte; les opcions avançades de PDF per pàgina no estan disponibles en aquesta versió.
  • Exportació d’imatge: Itera els nodes Image per recuperar els bytes en brut (Bytes), el nom de fitxer (FileName) i les dimensions (OriginalWidth, OriginalHeight).
  • Desament d’adjuncions: Itera els nodes AttachedFile per desar les adjuncions de fitxer incrustades al disc.
  • Stream-based loading: Obre fitxers .one des d’un flux binari (p. ex., io.BytesIO) sense escriure al disc.

Experiència del desenvolupador

Aspose.Note FOSS s’instal·la amb una sola comanda pip install aspose-note. El paquet base no té dependències opcionals; l’exportació a PDF requereix ReportLab, instal·lat via pip install "aspose-note[pdf]".

L’API està modelada en la coneguda Aspose.Note per a la interfície .NET: Document, Page, Outline, RichText, Image, Table, AttachedFile. La biblioteca té llicència MIT, és de codi obert i accepta informes d’errors i contribucions a GitHub.

Carrega un fitxer OneNote i extreu tot el text

Instal·la amb pip, després passa una ruta del fitxer a Document() per analitzar el format binari de OneNote. GetChildNodes(RichText) realitza una cerca recursiva profunda i retorna cada node de text del document, la qual cosa és útil per a la indexació de text complet o per a canals de migració.

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 a PDF i desa les imatges adjuntes

L’exportació PDF requereix la dependència opcional ReportLab. Instal·la-la amb pip install "aspose-note[pdf]". El mateix objecte Document també es pot iterar per nodes Image per extreure i desar totes les imatges incrustades al disc en una sola passada.

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)

Preguntes freqüents

Què és Aspose.Note FOSS per a Python?

És una biblioteca Python gratuïta, amb llicència MIT, per llegir fitxers Microsoft OneNote (.one) sense requerir Microsoft Office, automatització COM o cap entorn d’execució propietari.

Quines variants del format OneNote són compatibles?

OneNote 2010, OneNote Online i variants de format OneNote 2007. Qualsevol fitxer de secció .one vàlid es pot carregar.

Com l’instal·lo?

Executeu pip install aspose-note per a la biblioteca base, o pip install "aspose-note[pdf]" per incloure la dependència opcional ReportLab per a l’exportació PDF.

Puc exportar fitxers OneNote a PDF?

Sí. Crideu Document.Save(path, SaveFormat.Pdf). L’exportació PDF requereix la dependència opcional ReportLab instal·lada mitjançant l’extra [pdf].

Puc carregar fitxers .one des d’un flux?

Sí. La classe Document accepta un flux binari (p. ex., io.BytesIO o un cos de resposta HTTP) perquè pugueu processar fitxers sense escriure’ls al disc.

Quina versió de Python es requereix?

Es requereix Python 3.10 o posterior.

Puc escriure o modificar un fitxer .one?

No. L’edició actual és només de lectura. Pot obrir i analitzar qualsevol fitxer de secció .one vàlid, però l’escriptura de tornada al format binari OneNote no està suportada.

Es suporten els documents OneNote xifrats?

No. Carregar un fitxer .one protegit amb contrasenya genera un IncorrectPasswordException. Els documents encriptats no són compatibles amb l’edició actual.

On puc trobar el codi font?

La biblioteca té llicència MIT i està allotjada a GitHub. Els informes d’errors i les pull requests són benvinguts.

  

Suport i recursos d aprenentatge

 Català