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

Aspose.Note FOSS for Python

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

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

Aprèn GitHub

Biblioteca Python de codi obert per a fitxers d'OneNote

FOSS per Python és una biblioteca 100% gratuïta, amb llicència MIT que et permet llegir els arxius de Microsoft OneNote (.one) completament a partir de Python, sense Microsoft Office, cap automatització COM i no es requereix temps d’execució propietari. Exposeix una API pública neta (aspose.note.*) modelada sobre la familiar Aspose.Note per .NET interfície, recolzada per un parser binari integrat MS-ONE / OneStore escrit en pura Python.

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

La biblioteca és adequada per a scripts d’automatització de documents, línies d ‘indexament de continguts, eines d “archivatge i qualsevol flux de treball del costat del servidor que necessita consumir contingut OneNote sense una dependència de Microsoft Office. Per la família de productes empresarial, vegeu Aspose.Note — Enterprise Product Family.

Llegir i desplaçar-se per documents d’OneNote

  • ** Carregar .un arxiu:** Obrir qualsevol secció d’OneNote des d ‘una ruta de fitxer o flux binari a través de Document.
  • Tresor complet DOM: Navegar Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • ** Extracció de text ric:** Llegeix el text brut a través de RichText.Text o inspecciona els segments d’TextRun per obtenir metadades en negrit, cursiva, font, color i hipervincle.
  • ** Parseig de taula:** Traversar les jerarquies Table → TableRow → TableCell; llegir els amplors de columnes a través d’TableColumn.Width.
  • ** Inspecció de les etiquetes:** Llegir NoteTag metadades (forma, etiqueta, color, estat d’acabat) sobre el text, la imatge i els nodes de taula.

On es pot utilitzar Aspose.Note FOSS

  • Indexació de contingut: Extrac i indexa tot el text dels arxius d’OneNote per a la recerca.
  • Migració de document: Exportacions a PDF, text en pla o dades estructurades.
  • ** Fermeria d’arxiu:** Salvar imatges i adjuntaments incrustats al disc des dels arxius .one.
  • ** Fluxos de treball CI/CD:** Validar o processar el contingut d’OneNote dins dels contenidors Docker.
  • Pipelines de base de coneixements: Extracció de contingut estructurat dels quaderns d’equip OneNote.

Exportació, imatges i apanyaments

  • Exportació PDF: Desar qualsevol Document carregat a PDF mitjançant Document.Save(path, SaveFormat.Pdf). L’edició FOSS utilitza un renderitzat per defecte; les opcions avançades de PDF per pàgina no estan disponibles en aquesta versió.
  • Exportació d’imatge: Iterar nodes Image per obtenir bytes en brut (Bytes), nom de fitxer (FileName) i dimensions (OriginalWidth, OriginalHeight).
  • Desament d’adjuncions: Iterar nodes AttachedFile per desar els fitxers adjunts incrustats al disc.
  • Càrrega basada en flux: Obrir fitxers .one des d’un flux binari (p. ex., io.BytesIO) sense escriure al disc.

Experiència de desenvolupador

Aspose.Note FOSS s’instal·la amb una única 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]".

El API està modelat sobre el familiar 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.

Carregar un fitxer de OneNote i extraure tot el text

Instal·lar amb pip, després passar una ruta de fitxer a Document() per analitzar el format binari d’OneNote. GetChildNodes(RichText) realitza una cerca recursiva profunda i retorna cada node de text del document, que és útil per a indexar o migrar canonades de texts complets.

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)

Exportar a PDF i guardar les imatges adjuntades

L’exportació de PDF requereix la dependència opcional ReportLab. Installa-la amb pip install "aspose-note[pdf]". El mateix objecte Document també es pot iterar per als nodes Image per extraure i guardar totes les imatges incrustades al disc en un sol 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)

Preguntes freqüents

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

És una biblioteca Python lliure, amb llicència MIT per llegir arxius de Microsoft OneNote (.one) sense requerir Office de la Microsoft, l’automatització COM o qualsevol temps d’execució propietari.

Quines variants de formats d’OneNote són compatibles?

Es poden carregar qualsevol fitxer de secció .one vàlid.

Com ho instal·lo?

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

Puc exportar arxius de OneNote a PDF?

Sí. Calla Document.Save(path, SaveFormat.Pdf). Exportació PDF requereix la dependència opcional ReportLab instal·lada a través de l’extra [pdf] .

Puc carregar .one arxius d’un flux?

Sí. La classe Document accepta un flux binari (per exemple, io.BytesIO o un cos de resposta HTTP) per tal que pugui processar fitxers sense escriure al disc.

Quina versió de Python és necessària?

Es requereix Python 3.10 o posterior.

Puc escriure o modificar un fitxer .one?

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

S’admeten documents d’OneNote xifrats?

No. Carregar un fitxer protegit per contrasenya .one genera una IncorrectPasswordException. Els documents xifrats no són compatibles en l’edició actual.

On puc trobar el codi font?

La biblioteca està llicenciada pel MIT i allotjada a GitHub. Les informacions de bugs i les sol·licituds d’extracció són benvingudes.

  

Suport i recursos d aprenentatge

 Català