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

Aspose.Note FOSS for Python

Les, traverser og eksporter Microsoft OneNote (.one)-filer fra Python — gratis og open-source, ingen Microsoft Office kreves.

Open-Source Python-bibliotek for OneNote-filer

Aspose.Note FOSS for Python er et 100 % fri, MIT‑lisensiert bibliotek som lar deg lese Microsoft OneNote (.one)-filer helt fra Python, uten Microsoft Office, uten COM‑automatisering, og uten proprietært kjøretidsmiljø. Det eksponerer et rent offentlig API (aspose.note.*) modellert etter det kjente Aspose.Note for .NET-grensesnittet, støttet av en innebygd MS-ONE/OneStore binærparser skrevet i ren Python.

Installer fra PyPI med pip install aspose-note (eller pip install "aspose-note[pdf]" for å aktivere PDF‑eksport). Krever Python 3.10 eller nyere.

Biblioteket er egnet for dokumentautomatiseringsskript, innholdsindekserings‑pipelines, arkiveringsverktøy og enhver server‑side‑arbeidsflyt som trenger å konsumere OneNote‑innhold uten en Microsoft Office‑avhengighet. For produktfamilien for bedrifter, se Aspose.Note — Enterprise Product Family.

Les og traverser OneNote-dokumenter

  • Last inn .one-filer: Åpne en hvilken som helst OneNote‑seksjon fra en filsti eller binær strøm via Document.
  • Full DOM-gjennomgang: Naviger Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile
  • Rik tekstuttrekk: Les råtekst via RichText.Text eller inspiser TextRun segmenter for fet, kursiv, skrifttype, farge og hyperkoblingsmetadata.
  • Tabellparsing: Gå gjennom Table → TableRow → TableCell-hierarkier; les kolonnebredder via TableColumn.Width.
  • Tag inspection: Les NoteTag metadata (shape, label, color, completion state) på tekst-, bilde- og tabellnoder.

Hvor Aspose.Note FOSS kan brukes

  • Innholdsindeksering: Ekstraher og indekser all tekst fra OneNote-arkiver for søkepipelines.
  • Dokumentmigrering: Eksporter OneNote‑seksjoner til PDF, ren tekst eller strukturert data.
  • Arkiveringsverktøy: Lagre innebygde bilder og vedlegg til disk fra .one-filer.
  • CI/CD-arbeidsflyter: Valider eller behandle OneNote-innhold i Docker-containere.
  • Knowledge-base pipelines: Ekstraher strukturert innhold fra teamets OneNote-notatbøker.

Eksporter, bilder og vedlegg

  • PDF-eksport: Lagre enhver lastet Document til PDF ved å bruke Document.Save(path, SaveFormat.Pdf). FOSS-utgaven bruker en standard rendering; avanserte per-side PDF-alternativer er ikke tilgjengelige i denne utgivelsen.
  • Bildeeksport: Iterer Image noder for å hente rå byte (Bytes), filnavn (FileName), og dimensjoner (OriginalWidth, OriginalHeight).
  • Vedleggslagring: Iterer AttachedFile noder for å lagre innebygde filvedlegg til disk.
  • Strømbasert lasting: Åpne .one filer fra en binær strøm (f.eks., io.BytesIO) uten å skrive til disk.

Utvikleropplevelse

Aspose.Note FOSS installeres med en enkelt pip install aspose-note kommando. Basispakken har ingen valgfrie avhengigheter; PDF‑eksport krever ReportLab, installert via pip install "aspose-note[pdf]".

API-et er modellert etter det kjente Aspose.Note for .NET grensesnittet: Document, Page, Outline, RichText, Image, Table, AttachedFile. Biblioteket er MIT-lisensiert, åpen kilde, og godtar feilrapporter og bidrag på GitHub.

Last inn en OneNote-fil og trekk ut all tekst

Installer med pip, og deretter send en filsti til Document() for å analysere OneNote-binærformatet. GetChildNodes(RichText) utfører et dypt rekursivt søk og returnerer hver tekstnode i dokumentet, noe som er nyttig for fulltekstsindeksering eller migrasjonsrørledninger.

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)

Eksporter til PDF og lagre vedlagte bilder

PDF-eksport krever den valgfrie ReportLab‑avhengigheten. Installer den med pip install "aspose-note[pdf]". Det samme Document-objektet kan også itereres for Image-noder for å hente ut og lagre alle innebygde bilder til disk i ett pass.

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)

Ofte stilte spørsmål

Hva er Aspose.Note FOSS for Python?

Det er et gratis, MIT-lisensiert Python bibliotek for å lese Microsoft OneNote (.one)-filer uten å kreve Microsoft Office, COM-automatisering eller noen proprietær kjøretidsmiljø.

Hvilke OneNote-formatvarianter støttes?

OneNote 2010, OneNote Online og OneNote 2007 formatvarianter. Enhver gyldig .one seksjonsfil kan lastes inn.

Hvordan installerer jeg det?

Kjør pip install aspose-note for basisbiblioteket, eller pip install "aspose-note[pdf]" for å inkludere den valgfrie ReportLab‑avhengigheten for PDF‑eksport.

Kan jeg eksportere OneNote-filer til PDF?

Ja. Kall Document.Save(path, SaveFormat.Pdf). PDF‑eksport krever at den valgfrie ReportLab‑avhengigheten er installert via [pdf]-ekstraen.

Kan jeg laste .one-filer fra en strøm?

Ja. Document-klassen godtar en binær strøm (f.eks. io.BytesIO eller en HTTP-responsbody) slik at du kan behandle filer uten å skrive til disk.

Hvilken Python versjon er påkrevd?

Python 3.10 eller nyere kreves.

Kan jeg skrive eller endre en .one-fil?

Nei. Den nåværende utgaven er skrivebeskyttet. Den kan åpne og analysere enhver gyldig .one seksjonsfil, men å skrive tilbake til OneNote‑binærformatet støttes ikke.

Støttes krypterte OneNote-dokumenter?

Nei. Lasting av en passordbeskyttet .one-fil utløser en IncorrectPasswordException. Krypterte dokumenter støttes ikke i den nåværende utgaven.

Hvor kan jeg finne kildekoden?

Biblioteket er lisensiert under MIT og er vert på GitHub. Feilrapporter og pull‑forespørsler er velkomne.

  

Støtte og læringsressurser

 Norsk