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

Aspose.Note FOSS for Python

Læs, gennemse og eksporter Microsoft OneNote (.one)-filer fra Python — gratis og open source, ingen Microsoft Office påkrævet.

Python-bibliotek med åben kildekode til OneNote-filer

FOSS for Python er et 100% gratis, MIT-licenseret bibliotek, der giver dig mulighed for at læse Microsoft OneNote (.one) filer helt fra Python, uden Microsoft Office, ingen COM automatisering og ingen proprietær runtime kræves. Det udsætter en ren offentlig API (aspose.note.*) modelleret på den velkendte Aspose.Note til .NET interface, støttet af en indbygget MS-ONE / OneStore binære parser skrevet i ren Python.

Installer fra PyPI med pip install aspose-note (eller pip install "aspose-note[pdf]" for at aktivere PDF-eksport). Kræver Python 3.10 eller nyere.

Biblioteket er velegnet til dokument automatiseringskripter, indexeringsrørledninger for indhold, arkiveringsværktøjer og enhver server-side arbejdsproces, der skal bruge OneNote-indhold uden afhængighed af Microsoft Office. For virksomhedens produktfamilie se Aspose.Note — Enterprise Product Family.

Læs og gennemgå OneNote-dokumenter

  • Load .one filer: Åbn en hvilken som helst OneNote-sektion fra en filvej eller binær strøm via Document.
  • Fuld DOM-overgang: Navigere Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • Rich text extraction: Læs råtekst via RichText.Text eller tjek TextRun-segmenterne for fed, kursiv, skrifttype, farve og hyperlink metadata.
  • ** Tabelparsing:** Traverse Table → TableRow → TableCell hierarkier; læs kolonnebredde via TableColumn.Width.
  • Tag-inspektion: Læs NoteTag metadata (form, etikette, farve, færdiggørelsesstatus) på tekst-, billede- og tabelknob.

Hvor Aspose.Note FOSS kan anvendes

  • Indeksering af indhold: Udtræk og indeks alle tekster fra OneNote-arkiver til søgemaskiner.
  • ** Dokumentmigration:** Eksport af OneNote-sektioner til PDF, almindelig tekst eller strukturerede data.
  • Arkiveringsværktøjer: Gem indlejrede billeder og vedhæftede filer på disk fra .one-filer.
  • CI/CD-arbejdsstrømme: Valider eller bearbejde OneNote-indhold i Docker-containere.
  • Knowledge-base pipelines: Udtræk struktureret indhold fra OneNote-holdets notesbøger.

Eksport, billeder og vedhæftede filer

  • PDF-eksport: Gem alle indlæste Document til PDF ved hjælp af Document.Save(path, SaveFormat.Pdf). FOSS-udgaven bruger en standard rendering; avancerede per side PDF-indstillinger er ikke tilgængelige i denne udgave.
  • Billedeeksport: Iterer Image-noderne for at hente rå byte (Bytes), filnavn ( FileName) og dimensioner ( OriginalWidth, OriginalHeight).
  • Attachment-besparelse: Iterere AttachedFile -noder for at gemme indlejrede filtilbehør til disk.
  • ** Strømbaseret indlæse:** Åbn .one-filer fra en binær strøm (f.eks. io.BytesIO) uden at skrive til disk.

Udvikleroplevelse

Aspose.Note FOSS installeres med en enkelt pip install aspose-note kommando. Basispakken har ingen valgfrie afhængigheder; PDF-eksport kræver ReportLab, installeret via pip install "aspose-note[pdf]".

Den API er modelleret efter den velkendte Aspose.Note for .NET grænseflade: Document, Page, Outline, RichText, Image, Table, AttachedFile. Biblioteket er MIT-licenseret, open-source, og accepterer fejlrapporter og bidrag på GitHub.

Lade en OneNote-fil og trække al tekst ud

Installer med pip, og derefter videregive en filvej til Document() for at analysere OneNote binære format. GetChildNodes(RichText) udfører en dyb rekursiv søgning og returnerer hver tekstknude i dokumentet, hvilket er nyttigt til fuldtekstindeksering eller migrationsrø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)

Eksport til PDF og gem vedlagte billeder

PDF-eksport kræver den valgfri ReportLab afhængighed. Installer det med pip install "aspose-note[pdf]". Den samme Document objekt kan også gentages for Image noder til at udtrække og gemme alle indlejrede billeder på disk i et enkelt 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 stillede spørgsmål

Hvad er Aspose.Note FOSS for Python?

Det er et gratis, MIT-licenseret Python bibliotek til læsning af Microsoft OneNote (.one) filer uden at kræve Microsoft Office, COM automatisering eller nogen proprietær runtime.

Hvilke OneNote-formatvarianter understøttes?

Alle gyldige .one sektionsfiler kan indlæses.

Hvordan installerer jeg den?

Kør pip install aspose-note til det grundlæggende bibliotek eller pip install "aspose-note[pdf]" for at inkludere den valgfri ReportLab-afhængighed til PDF-eksport.

Kan jeg eksportere OneNote-filer til PDF?

Ja. Ring Document.Save(path, SaveFormat.Pdf). PDF-eksport kræver den valgfri ReportLab afhængighed installeret via ekstraen [pdf] .

Kan jeg indlæse .one filer fra en stream?

Ja. Klassen Document accepterer en binær strøm (fx io.BytesIO eller et HTTP-responslegeme), så du kan behandle filer uden at skrive til disk.

Hvilken Python-version kræves?

Python 3.10 eller nyere er påkrævet.

Kan jeg skrive eller ændre en .one fil?

Nej. Den aktuelle udgave er kun læsning. Det kan åbne og analysere enhver gyldig .one sektionsfil, men skrivning tilbage til OneNote binært format understøttes ikke.

Støttes krypterede OneNote-dokumenter?

Nej. Ved at indlæse en password-beskyttet .one fil opstår et IncorrectPasswordException. Krypterede dokumenter understøttes ikke i den aktuelle udgave.

Hvor kan jeg finde kildekoden?

Biblioteket er MIT-licenseret og hostet på GitHub. Bugrapporter og pullanmodninger er velkomne.

  

Support og læringsressourcer

 Dansk