مقدمه
این راهنما شما را از pip install به یک اسکریپت کارآمد در چند دقیقه می‌برد. aspose-note یک کتابخانهٔ رایگان با مجوز MIT برای خواندن و ذخیرهٔ فایل‌های Microsoft OneNote به‌صورت کامل در Python است، بدون نیاز به Microsoft Office، خودکارسازی COM، یا هر افزونهٔ بومی.
pip install aspose-note-fossAspose.Note FOSS برای Python چیست؟
OneNote قالب .one یک محفظهٔ باینری مالکیتی است — تجزیه آن بدون کتابخانه‌های خود مایکروسافت به‌طور سنتی نیاز به ابزارهای مهندسی معکوس یا پل‌های COM مخصوص ویندوز داشته است. Aspose.Note FOSS پیاده‌سازی خالص-Python را فراهم می‌کند که قالب را می‌خواند و به PDF صادر می‌کند روی هر پلتفرمی که Python 3.10 یا بالاتر را پشتیبانی کند.
کتابخانه یک مدل شیء‌گرای سند را افشا می‌کند: یک ریشهٔ Document که شامل گره‌های Page است، هر کدام می‌توانند فرزندان Title، Outline، RichText، Image و AttachedFile را در خود داشته باشند. شما درخت را با GetChildNodes() پیمایش می‌کنید و نتیجه را با Document.Save() به PDF صادر می‌کنید. برای مرور کامل قابلیت‌ها — از جمله ساخت یک نوت‌بوک از صفر — به معرفی Aspose.Note FOSS برای Python مراجعه کنید.
شروع سریع
در اینجا کل روند کاری در پنج خط آورده شده است — یک فایل .one را بارگذاری کنید و مستقیماً به 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")
خواندن صفحات و متن
صفحات نودهای Page داخل Document هستند. هر Page دارای ویژگی Title است و می‌تواند عناصر Outline با محتوای RichText را شامل شود. برای پیمایش درخت از GetChildNodes() استفاده کنید:
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]}")
برای نگاهی عمیق‌تر به خواندن متن، تصاویر، پیوست‌ها و جداول، به Reading OneNote .one Files in Python with Aspose.Note FOSS مراجعه کنید.
ذخیره به PDF
به محض اینکه یک Document بارگذاری‌شده داشته باشید، تبدیل آن به PDF تنها با یک فراخوانی انجام می‌شود: مسیر فایل و SaveFormat.Pdf را به Document.Save() بدهید، و کتابخانه نوت‌بوک را به PDF در همان فرآیند رندر می‌کند:
from aspose.note import Document, SaveFormat
doc = Document("notebook.one")
doc.Save("output.pdf", SaveFormat.Pdf)
برای خروجی با بافر در حافظه، تبدیل دسته‌ای، و محدودیت صرفاً خروجی، به Exporting OneNote Files to PDF in Python مراجعه کنید.
فرمت‌های پشتیبانی‌شده
| قالب | پسوند | خواندن | نوشتن |
|---|---|---|---|
| OneNote 2010 | .one | ✓ | — |
| OneNote 2007 | .one | ✓ | — |
| OneNote آنلاین | .one | ✓ | — |
.pdf | — | ✓ |
منبع باز و مجوزدهی
Aspose.Note FOSS برای Python تحت مجوز MIT منتشر شده است. این بسته بر روی PyPI به عنوان aspose-note منتشر می‌شود و استفاده تجاری، تغییر و توزیع مجدد همگی تحت شرایط MIT مجاز هستند.
