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

Aspose.Note FOSS für Python

Lesen, durchlaufen und exportieren Sie Microsoft OneNote (.one)-Dateien mit Python — kostenlos und Open-Source, kein Microsoft Office erforderlich.

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

Dokumentation GitHub

Open-Source Python-Bibliothek für OneNote-Dateien

Aspose.Note FOSS für Python ist eine zu 100 % kostenlose, MIT-lizenzierte Bibliothek, die es ermöglicht, Microsoft OneNote (.one)-Dateien vollständig aus Python zu lesen, ohne Microsoft Office, ohne COM-Automatisierung und ohne proprietäre Laufzeit. Sie stellt eine saubere öffentliche API (aspose.note.*) bereit, die an die vertraute Aspose.Note für .NET-Schnittstelle angelehnt ist und von einem integrierten MS-ONE/OneStore-Binärparser unterstützt wird, der in reinem Python geschrieben ist.

Installation von PyPI mit pip install aspose-note (oder pip install "aspose-note[pdf]" um den PDF-Export zu aktivieren). Benötigt Python 3.10 oder später.

Die Bibliothek eignet sich für Dokumentenautomatisierungsskripte, Inhaltsindizierungspipelines, Archivierungswerkzeuge und jede serverseitige Arbeitsablauf, der OneNote‑Inhalte ohne Microsoft‑Office‑Abhängigkeit verarbeiten muss. Für die Enterprise‑Produktfamilie siehe Aspose.Note — Enterprise Product Family.

OneNote-Dokumente lesen und durchlaufen

  • Laden von .one-Dateien: Öffnen Sie einen beliebigen OneNote-Abschnitt über einen Dateipfad oder einen Binärstrom mittels Document.
  • Vollständige DOM-Durchquerung: Navigieren Sie Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • Rich-Text-Extraktion: Lesen Sie Rohtext über RichText.Text oder prüfen Sie TextRun-Segmente auf fette, kursive, Schriftart, Farbe und Hyperlink-Metadaten.
  • Tabellenparsing: Durchlaufen Table → TableRow → TableCell-Hierarchien; Spaltenbreiten über TableColumn.Width lesen.
  • Tag-Inspektion: Lese NoteTag Metadaten (Form, Bezeichnung, Farbe, Abschlussstatus) in Text-, Bild- und Tabellenknoten.

Wo Aspose.Note FOSS verwendet werden kann

  • Inhaltsindizierung: Extrahieren und indizieren Sie den gesamten Text aus OneNote-Archiven für Suchpipelines.
  • Dokumentenmigration: Exportieren Sie OneNote-Abschnitte in PDF, Nur-Text oder strukturierte Daten.
  • Archivierungswerkzeuge: Speichern Sie eingebettete Bilder und Anhänge auf die Festplatte aus .one-Dateien.
  • CI/CD-Workflows: Validieren oder verarbeiten Sie OneNote-Inhalte in Docker-Containern.
  • Knowledge-base pipelines: Extrahieren Sie strukturierte Inhalte aus Team-OneNote-Notizbüchern.

Export, Bilder und Anhänge

  • PDF-Export: Speichern Sie jedes geladene Document als PDF mit Document.Save(path, SaveFormat.Pdf). Die FOSS-Edition verwendet ein Standard-Rendering; erweiterte pro‑Seite‑PDF‑Optionen sind in dieser Version nicht verfügbar.
  • Bildexport: Durchlaufen Sie Image Knoten, um Rohbytes (Bytes), Dateinamen (FileName) und Abmessungen (OriginalWidth, OriginalHeight) abzurufen.
  • Speichern von Anhängen: Durchlaufen Sie AttachedFile Knoten, um eingebettete Dateianhänge auf die Festplatte zu speichern.
  • Stream-basiertes Laden: Öffnen Sie .one-Dateien aus einem Binärstrom (z. B. io.BytesIO) ohne auf die Festplatte zu schreiben.

Entwicklererfahrung

Aspose.Note FOSS installiert sich mit einem einzigen pip install aspose-note-Befehl. Das Basispaket hat keine optionalen Abhängigkeiten; der PDF‑Export erfordert ReportLab, das über pip install "aspose-note[pdf]" installiert wird.

Die API ist nach der bekannten Aspose.Note für .NET Schnittstelle modelliert: Document, Page, Outline, RichText, Image, Table, AttachedFile. Die Bibliothek ist MIT-lizenziert, Open-Source und akzeptiert Fehlermeldungen und Beiträge auf GitHub.

Lade eine OneNote-Datei und extrahiere den gesamten Text

Installieren Sie mit pip und übergeben Sie dann einen Dateipfad an Document(), um das OneNote‑Binärformat zu analysieren. GetChildNodes(RichText) führt eine tiefe rekursive Suche durch und gibt jeden Textknoten im Dokument zurück, was für die Volltextindizierung oder Migrationspipelines nützlich ist.

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)

Exportieren als PDF und angehängte Bilder speichern

Der PDF‑Export erfordert die optionale ReportLab‑Abhängigkeit. Installieren Sie sie mit pip install "aspose-note[pdf]". Das gleiche Document-Objekt kann auch für Image-Knoten iteriert werden, um alle eingebetteten Bilder in einem Durchgang zu extrahieren und auf die Festplatte zu speichern.

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)

Häufig gestellte Fragen

Was ist Aspose.Note FOSS für Python?

Es ist eine kostenlose, MIT-lizenzierte Python-Bibliothek zum Lesen von Microsoft OneNote (.one)-Dateien, ohne Microsoft Office, COM-Automatisierung oder irgendeine proprietäre Laufzeit zu benötigen.

Welche OneNote-Formatvarianten werden unterstützt?

OneNote 2010, OneNote Online und OneNote 2007 Formatvarianten. Jede gültige .one Abschnittsdatei kann geladen werden.

Wie installiere ich es?

Führen Sie pip install aspose-note für die Basisbibliothek aus, oder pip install "aspose-note[pdf]", um die optionale ReportLab‑Abhängigkeit für den PDF‑Export einzuschließen.

Kann ich OneNote-Dateien in PDF exportieren?

Ja. Rufen Sie Document.Save(path, SaveFormat.Pdf) auf. Der PDF‑Export erfordert die optionale ReportLab‑Abhängigkeit, die über das [pdf]‑Extra installiert wird.

Kann ich .one-Dateien aus einem Stream laden?

Ja. Die Klasse Document akzeptiert einen Binär‑Stream (z. B. io.BytesIO oder einen HTTP-Antwortkörper), sodass Sie Dateien verarbeiten können, ohne sie auf die Festplatte zu schreiben.

Welche Python-Version ist erforderlich?

Python 3.10 oder höher ist erforderlich.

Kann ich eine .one-Datei schreiben oder ändern?

Nein. Die aktuelle Ausgabe ist schreibgeschützt. Sie kann jede gültige .one Abschnittsdatei öffnen und analysieren, aber das Zurückschreiben in das OneNote‑Binärformat wird nicht unterstützt.

Werden verschlüsselte OneNote-Dokumente unterstützt?

Nein. Das Laden einer passwortgeschützten .one-Datei löst einen IncorrectPasswordException aus. Verschlüsselte Dokumente werden in der aktuellen Ausgabe nicht unterstützt.

Wo finde ich den Quellcode?

Die Bibliothek ist unter der MIT-Lizenz veröffentlicht und auf GitHub gehostet. Fehlerberichte und Pull‑Requests sind willkommen.

  

Support und Lernressourcen

 Deutsch