Wstęp
Ten przewodnik przeprowadzi Cię od pip install do działającego skryptu w kilka minut. aspose-note jest darmową, na licencji MIT biblioteką do odczytywania i zapisywania plików Microsoft OneNote w pełni w Python, bez zależności od Microsoft Office, automatyzacji COM ani żadnych natywnych rozszerzeń.
pip install aspose-note-fossCzym jest Aspose.Note FOSS dla Python?
OneNote format .one jest własnościowym kontenerem binarnym — analizowanie go bez własnych bibliotek Microsoft tradycyjnie wymagało narzędzi odwróconych inżynieryjnie lub specyficznych dla Windows mostów COM. Aspose.Note FOSS zapewnia czystą implementację w Python, która odczytuje format i eksportuje do PDF na każdej platformie obsługującej Python 3.10 lub nowszą.
Biblioteka udostępnia model obiektowy dokumentu: korzeń Document, który zawiera węzły Page, z których każdy może mieć dzieci Title, Outline, RichText, Image i AttachedFile. Drzewo przeglądasz za pomocą GetChildNodes(), a wynik eksportujesz do PDF przy użyciu Document.Save(). Pełną prezentację możliwości — w tym tworzenie notatnika od podstaw — znajdziesz w Introducing Aspose.Note FOSS for Python.
Szybki start
Oto cały przepływ pracy w pięciu linijkach — załaduj plik .one i zapisz go od razu do PDF:
from aspose.note import Document, SaveFormat
# Load a .one file
doc = Document("notebook.one")
print(f"Format: {doc.FileFormat}")
# Save to PDF
doc.Save("notebook.pdf", SaveFormat.Pdf)
print("Saved notebook.pdf")
Odczytywanie stron i tekstu
Strony są węzłami Page wewnątrz Document. Każdy Page ma własność Title i może zawierać elementy Outline z treścią RichText. Użyj GetChildNodes(), aby przejść po drzewie:
from aspose.note import Document, Page, RichText
doc = Document("notebook.one")
for page in doc.GetChildNodes(Page):
title = page.Title
if title and title.TitleText:
print(f"Page: {title.TitleText}")
for rt in page.GetChildNodes(RichText):
text = "".join(rt)
if text.strip():
print(f" Text: {text[:80]}")
Aby uzyskać bardziej szczegółowy wgląd w odczytywanie tekstu, obrazów, załączników i tabel, zobacz Reading OneNote .one Files in Python with Aspose.Note FOSS.
Zapisywanie do PDF
Gdy masz już załadowany Document, konwersja do PDF wymaga jednego wywołania: przekaż ścieżkę do pliku i SaveFormat.Pdf do Document.Save(), a biblioteka renderuje notebook do PDF w trakcie procesu:
from aspose.note import Document, SaveFormat
doc = Document("notebook.one")
doc.Save("output.pdf", SaveFormat.Pdf)
Aby uzyskać informacje o wyjściu do bufora w pamięci, konwersji wsadowej oraz ograniczeniu eksportu-tylko, zobacz Exporting OneNote Files to PDF in Python.
Obsługiwane formaty
| Format | Rozszerzenie | Odczyt | Zapis |
|---|---|---|---|
| OneNote 2010 | .one | ✓ | — |
| OneNote 2007 | .one | ✓ | — |
| OneNote Online | .one | ✓ | — |
.pdf | — | ✓ |
Open Source i licencjonowanie
Aspose.Note FOSS dla Python jest udostępniony na licencji MIT. Pakiet jest opublikowany na PyPI jako aspose-note, a użycie komercyjne, modyfikacja i redystrybucja są dozwolone na warunkach licencji MIT.
