شروع کار

Aspose.Note FOSS for Python is a free, open-source library for reading Microsoft OneNote .one فایل‌های بخش. این یک API عمومی ارائه می‌دهد که بر پایه Aspose.Note برای .NET مدل‌سازی شده است و توسط یک تجزیه‌گر باینری خالص-Python MS-ONE/OneStore پشتیبانی می‌شود. نیازی به نصب Microsoft Office نیست.

کارهایی که می‌توانید انجام دهید

  • خواندن .one فایل‌ها: باز کردن هر فایل بخش OneNote 2010، OneNote Online یا OneNote 2007
  • پیمایش DOM سند: مرور صفحات، سرفصل‌ها، عناصر سرفصل و تمام انواع محتوا
  • استخراج متن: خواندن متن ساده یا بررسی بخش‌های فرمت‌بندی جداگانه (پررنگ، ایتالیک، پیوندها، رنگ قلم)
  • استخراج تصاویر: بازیابی تصاویر جاسازی‌شده به صورت بایت‌های خام همراه با نام فایل و ابعاد
  • استخراج فایل‌های پیوست شده: ذخیرهٔ پیوست‌های فایل جاسازی‌شده در دیسک
  • تجزیه جداول: پیمایش سطرها و سلول‌های جدول، خواندن عرض ستون‌ها و محتوای سلول‌ها
  • بازرسی برچسب‌ها و فهرست‌ها: خواندن برچسب‌های OneNote (NoteTag) و فرادادهٔ فهرست شماره‌دار
  • صادرات به PDF: ذخیرهٔ هر سند بارگذاری‌شده به PDF با استفاده از پشتیبان ReportLab اختیاری

پیش‌نیازها

نیازمندیجزئیات
Python3.10 or later
سیستم‌عاملهر (Windows, Linux, macOS)، مستقل از سیستم‌عامل
Microsoft Officeنیاز نیست
صادرات PDFنیاز دارد reportlab>=3.6; نصب از طریق [pdf] اضافی

نصب

نصب کتابخانهٔ اصلی از PyPI:

pip install aspose-note

اگر قصد دارید اسناد را به PDF صادر کنید، با این نصب کنید [pdf] اضافی:

pip install "aspose-note[pdf]"

برای گزینه‌های نصب دقیق (نصب‌های قابل ویرایش، محیط‌های مجازی)، به راهنمای نصب.

اسکریپت اول شما

اسکریپت زیر یک فایل بخش OneNote را بارگذاری می‌کند، نام نمایشی بخش و تعداد صفحات را چاپ می‌کند، سپس عنوان هر صفحه را فهرست می‌نماید:

from aspose.note import Document

doc = Document("MyNotes.one")
print(f"Section: {doc.DisplayName}")
print(f"Pages:   {len(list(doc))}")

for page in doc:
    title = (
        page.Title.TitleText.Text
        if page.Title and page.Title.TitleText
        else "(untitled)"
    )
    print(f"  - {title}")

مهم: مسیر عمومی واردات است from aspose.note import .... از استفاده نکنید import aspose_note یا from onenote import ..., زیرا این‌ها نام‌های بسته صحیح نیستند.

استخراج تمام متن

from aspose.note import Document, RichText

doc = Document("MyNotes.one")
for rt in doc.GetChildNodes(RichText):
    if rt.Text:
        print(rt.Text)

صادرات به PDF

from aspose.note import Document, SaveFormat

doc = Document("MyNotes.one")
doc.Save("output.pdf", SaveFormat.Pdf)

نیازمند pip install "aspose-note[pdf]".

مراحل بعدی

 فارسی