Jak zacząć z Aspose.Note FOSS dla Pythona

aspose-note Python to darmowa biblioteka licencjonowana przez MIT do czytania i Konwersja programu Microsoft OneNote .one pliki do PDF – nie wymagane Microsoft Office, nie native Rozszerzenia, czysty Python z PyPI.

Przewodnik krok po kroku

pip install aspose-note>=26.3.2

from aspose.note import Document
print("aspose-note is ready.")

from aspose.note import Document, Page, Outline, RichText, SaveFormat

from aspose.note import Document

doc = Document("notebook.one")
print(f"Format : {doc.FileFormat}")
print(f"Pages  : {len(list(doc))}")

from aspose.note import Document, Page, RichText

doc = Document("notebook.one")
for page in doc.GetChildNodes(Page):
    if page.Title and page.Title.TitleText:
        print(f"Page: {page.Title.TitleText}")
    for rt in page.GetChildNodes(RichText):
        text = "".join(rt)
        if text.strip():
            print(f"  {text[:120]}")

import io
from aspose.note import Document, SaveFormat

doc = Document("notebook.one")

# Save to a file
doc.Save("output.pdf", SaveFormat.Pdf)

# Save to an in-memory buffer
buf = io.BytesIO()
doc.Save(buf, SaveFormat.Pdf)
print(f"PDF bytes: {len(buf.getvalue())}")

Wspólne problemy i rozwiązania

ModuleNotFoundError: No module named 'aspose' Pakiet nie jest zainstalowany w aktywnym środowisku Python. pip install aspose-note w tym samym środowisku wirtualnym, które używasz do uruchomienia skryptów. potwierdź pip show aspose-note.

FileNotFoundError Kiedy zadzwonić Document("path") Droga, którą przeszedłeś nie istnieje lub używa błędnego oddzielnika. pathlib.Path do Wprowadzenie do portu dróg:

from pathlib import Path
from aspose.note import Document

doc = Document(str(Path("folder") / "notebook.one"))

GetChildNodes() Wróć do Pustych list Upewnij się, że zadzwoń GetChildNodes(Page) Na The Document RODO – nie na A Page węzły - kiedy oczekujesz dzieci na poziomie strony. Każdy poziom drzewa tylko zwróci swój własny bezpośredni potomek określonego typu.

Wytwórnia PDF jest niewyjaśniona lub brakuje treści PDF renderer czyta RichText węzły. jeśli plik zawiera tylko obrazy lub załączone pliki z nie RichText węzły, strony PDF będą puste. sprawdź drzewo dokumentów do weryfikacji To to RichText Węzły są obecne i zawierają tekst.

page.Title Jest None Nie każda strona ma tytuł. zawsze trzymaj: if page.Title and page.Title.TitleText: ... przed rozpoczęciem pisania tekstu, aby uniknąć AttributeError.

Często zadawane pytania

Czy notatka aspose wymaga Microsoft Office?

Biblioteka czyta format binarny OneNote i eksportuje go do PDF w oryginalnym Pythonie bez uzależnienia od Microsoft Office, automatyzacji COM lub API systemu Windows.

Jakie wersje Python są obsługiwane?

Pakiet działa na Windows, macOS, Linux, kontażach Docker i bezserwerowych funkcjach.

Czy biblioteka jest wolna do użytku komercyjnego?

Jest on wydany na podstawie licencji MIT. Możesz używać, modyfikować i redistribuować go do jakiegokolwiek celu, w tym aplikacji komercyjnych.

Czy mogę napisać nowe pliki OneNote z scratch?

Tak. Tworzenie dokumentu za pomocą Document(),Dodaj → Page Węzły przez AppendChildLast(),Aplikacja Outline i RichText dzieci, i eksportować do PDF z Document.Save("output.pdf", SaveFormat.Pdf).- oszczędzanie z powrotem do .one Format nie jest obsługiwany.

Czy mogę zapisać w formach innych niż PDF?

Obecna wersja 26.3.2 obsługuje tylko eksportowanie do pliku PDF. .one Format lub eksportowanie do PNG, HTML lub innych formatów nie jest dostępny w tym wydaniu FOSS.

Zobacz również

• FAQ — Aspose.Note FOSS dla Pythona
• Jak eksportować plik OneNote do PDF w Pythonie
• Jak wyciągnąć tekst z OneNote w Pythonie
• Zaczyna się od doku
• Referencje API