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

Aspose.Note FOSS voor Python

Lees, doorloop en exporteer Microsoft OneNote (.one)-bestanden vanuit Python — gratis en open-source, geen Microsoft Office vereist.

Open-Source Python Bibliotheek voor OneNote-bestanden

Aspose.Note FOSS voor Python is een 100 % gratis, MIT‑gelicentieerde bibliotheek die je Microsoft OneNote (.one)-bestanden volledig vanuit Python laat lezen, zonder Microsoft Office, zonder COM‑automatisering en zonder een propriëtaire runtime. Het biedt een schone openbare API (aspose.note.*) die is gemodelleerd naar de bekende Aspose.Note voor .NET interface, ondersteund door een ingebouwde MS-ONE/OneStore binaire parser geschreven in pure Python.

Installeer vanaf PyPI met pip install aspose-note (of pip install "aspose-note[pdf]" om PDF‑export mogelijk te maken). Vereist Python 3.10 of later.

De bibliotheek is geschikt voor documentautomatiseringsscripts, contentindexeringspijplijnen, archiveringshulpmiddelen en elke server‑side workflow die OneNote‑inhoud moet verwerken zonder een Microsoft Office‑afhankelijkheid. Voor de enterprise‑productfamilie, zie Aspose.Note — Enterprise Product Family.

Lees en doorloop OneNote-documenten

  • Laad .one-bestanden: Open een willekeurige OneNote-sectie vanaf een bestandspad of binaire stream via Document.
  • Volledige DOM-traversal: Navigeer Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • Rich text extraction: Lees ruwe tekst via RichText.Text of inspecteer TextRun segmenten voor vet, cursief, lettertype, kleur en hyperlinkmetadata.
  • Tabelparsing: Doorloop Table → TableRow → TableCell hiërarchieën; lees kolombreedtes via TableColumn.Width.
  • Tag inspection: Lees NoteTag metadata (vorm, label, kleur, voltooiingsstatus) op tekst-, afbeelding- en tabelknooppunten.

Waar Aspose.Note FOSS kan worden gebruikt

  • Inhoudsindexering: Extraheer en indexeer alle tekst uit OneNote-archieven voor zoekpijplijnen.
  • Documentmigratie: Export OneNote-secties naar PDF, platte tekst, of gestructureerde gegevens.
  • Archiveringshulpmiddelen: Sla ingesloten afbeeldingen en bijlagen op schijf vanuit .one bestanden.
  • CI/CD-workflows: Valideer of verwerk OneNote-inhoud binnen Docker-containers.
  • Kennisbank-pijplijnen: Extraheer gestructureerde inhoud uit team OneNote-notitieblokken.

Exporteren, afbeeldingen en bijlagen

  • PDF-export: Sla elke geladen Document op als PDF met Document.Save(path, SaveFormat.Pdf). De FOSS-editie gebruikt een standaardrendering; geavanceerde per-pagina PDF-opties zijn niet beschikbaar in deze release.
  • Afbeeldingsexport: Itereer Image knooppunten om ruwe bytes (Bytes), bestandsnaam (FileName) en afmetingen (OriginalWidth, OriginalHeight) op te halen.
  • Bijlage opslaan: Itereer AttachedFile knooppunten om ingebedde bestandsbijlagen op schijf op te slaan.
  • Stream-gebaseerd laden: Open .one bestanden vanuit een binaire stream (bijv., io.BytesIO) zonder naar schijf te schrijven.

Ontwikkelaarservaring

Aspose.Note FOSS installeert met een enkele pip install aspose-note opdracht. Het basispakket heeft geen optionele afhankelijkheden; PDF‑export vereist ReportLab, geïnstalleerd via pip install "aspose-note[pdf]".

De API is gemodelleerd op de bekende Aspose.Note voor .NET interface: Document, Page, Outline, RichText, Image, Table, AttachedFile. De bibliotheek is MIT-licentie, open-source, en accepteert bugrapporten en bijdragen op GitHub.

Laad een OneNote-bestand en haal alle tekst op

Installeer met pip, geef vervolgens een bestandspad door aan Document() om het OneNote-binaire formaat te parseren. GetChildNodes(RichText) voert een diepe recursieve zoekopdracht uit en retourneert elke tekstknoop in het document, wat nuttig is voor full‑text indexering of migratiepijplijnen.

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)

Exporteren naar PDF en bijgevoegde afbeeldingen opslaan

PDF‑export vereist de optionele ReportLab‑afhankelijkheid. Installeer deze met pip install "aspose-note[pdf]". Hetzelfde Document object kan ook worden doorlopen voor Image knooppunten om alle ingesloten afbeeldingen in één keer naar schijf te extraheren en op te slaan.

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)

Veelgestelde vragen

Wat is Aspose.Note FOSS voor Python?

Het is een gratis, MIT-gelicentieerde Python bibliotheek voor het lezen van Microsoft OneNote (.one)-bestanden zonder Microsoft Office, COM-automatisering of enige propriëtaire runtime te vereisen.

Welke OneNote-formaatvarianten worden ondersteund?

OneNote 2010, OneNote Online en OneNote 2007-formaatvarianten. Elk geldig .one sectiebestand kan worden geladen.

Hoe installeer ik het?

Voer pip install aspose-note uit voor de basisbibliotheek, of pip install "aspose-note[pdf]" om de optionele ReportLab‑afhankelijkheid voor PDF-export op te nemen.

Kan ik OneNote-bestanden exporteren naar PDF?

Ja. Roep Document.Save(path, SaveFormat.Pdf) aan. PDF-export vereist de optionele ReportLab‑afhankelijkheid die via de [pdf] extra is geïnstalleerd.

Kan ik .one-bestanden laden vanuit een stream?

Ja. De Document-klasse accepteert een binaire stream (bijv. io.BytesIO of een HTTP-responslichaam) zodat je bestanden kunt verwerken zonder ze naar schijf te schrijven.

Welke Python versie is vereist?

Python 3.10 of hoger is vereist.

Kan ik een .one-bestand schrijven of wijzigen?

Nee. De huidige editie is alleen-lezen. Hij kan elk geldig .one sectiebestand openen en parseren, maar terugschrijven naar het OneNote-binaire formaat wordt niet ondersteund.

Worden versleutelde OneNote-documenten ondersteund?

Nee. Het laden van een met wachtwoord beveiligd .one-bestand veroorzaakt een IncorrectPasswordException. Versleutelde documenten worden niet ondersteund in de huidige editie.

Waar kan ik de broncode vinden?

De bibliotheek is gelicentieerd onder de MIT-licentie en gehost op GitHub. Bugrapporten en pull‑requests zijn welkom.

  

Ondersteuning en leermiddelen

 Nederlands