Как да започнете с Aspose.Note FOSS за Python

aspose-note Python е безплатна библиотека с лиценз за четене и Преобразуване на Microsoft OneNote .one PDF файлове – няма изискване за Microsoft Office, няма оригинални файлови файли Пътен Python от PyPI.

Стъпка по стъпка ръководство

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())}")

Общи проблеми и фиксиране

ModuleNotFoundError: No module named 'aspose' Пакетът не е инсталиран в активната Python среда. pip install aspose-note в същата виртуална среда, която използвате за изпълнение на вашия скрипт. потвърдете с pip show aspose-note.

FileNotFoundError Когато се обажда Document("path") Пътят, който сте преминали не съществува или използва грешния разделител. pathlib.Path за Изграждане на пътеки портално:

from pathlib import Path
from aspose.note import Document

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

GetChildNodes() Върни празен списък Уверете се, че ви казват GetChildNodes(Page) На този Document Ръце – не на Page нод - когато очаквате деца на ниво страница. всеки етап от дървото само връща своя собствена - пряко потомство на посочения тип.

PDF-изходът е бял или липсващ съдържание PDF Renderer чете RichText ако файлът съдържа само изображения или приложени файлове; С не RichText Вградени в PDF страници, ще бъдат празни.Проверявайте дървото на документа за проверка Това е RichText Нодът е наличен и съдържа текст.

page.Title е None Не всяка страница има заглавие. винаги пазете: if page.Title and page.Title.TitleText: ... преди да се получи текст заглавие, за да не се AttributeError.

Често задавани въпроси

Нуждаете ли се от Microsoft Office?

Библиотеката чете OneNote бинарния формат и изнася до PDF родом в чист Python без каквато и да е зависимост от Microsoft Office, COM автоматизация или Windows API.

Какви версии на Python се поддържат?

Python 3.10 или по-късно. пакета работи на Windows, macOS, Linux, Docker контейнери и безсервърни функции.

Библиотеката е свободна за търговско ползване.?

Да. Тя е издадена под лиценза на MIT. Можете да я използвате, модифицирате и преразпределите за всякакви цели, включително търговски приложения.

Мога ли да напиша нови файлове на OneNote от Scratch?

Да. Изградете документ, който използвате Document(),Добавете Page Нодър чрез AppendChildLast(),Притежавам Outline и RichText деца, и износ в PDF с Document.Save("output.pdf", SaveFormat.Pdf).Спасяване обратно към .one Форматът не се поддържа.

Мога ли да запиша във формати, различни от PDF?

Текущото издание 26.3.2 поддържа експортиране само в PDF. .one формат или експортиране към PNG, HTML или други формати не е наличен в тази версия на FOSS.

Виж също

• FAQ — Aspose.Note FOSS за Python
• Как да експортирате файл на OneNote в PDF в Python
• Как да извлечете текст от OneNote в Python
• Започваме с докторите
• Огнено референтно