البدء

Aspose.Note FOSS for Python is a free, open-source library for reading Microsoft OneNote .one ملفات الأقسام. توفر واجهة برمجة تطبيقات عامة مستندة إلى Aspose.Note لـ .NET، مدعومة بمحلل ثنائي pure-Python لـ MS-ONE/OneStore. لا يلزم تثبيت Microsoft Office.

ما يمكنك القيام به

• قراءة .one ملفات: افتح أي ملف قسم OneNote 2010 أو OneNote Online أو OneNote 2007
• تصفح شجرة DOM للمستند: تنقل بين الصفحات، المخططات، عناصر المخطط، وجميع أنواع المحتوى
• استخراج النص: قراءة النص العادي أو فحص تنسيقات النص الفردية (غامق، مائل، روابط، لون الخط)
• استخراج الصور: استرجاع الصور المدمجة كبايتات خام مع اسم الملف والأبعاد
• استخراج الملفات المرفقة: حفظ مرفقات الملفات المدمجة إلى القرص
• تحليل الجداول: استعراض صفوف الجدول والخلايا، قراءة عرض الأعمدة ومحتوى الخلايا
• فحص العلامات والقوائم: قراءة علامات OneNote (NoteTag) وبيانات التعريف للقوائم المرقمة
• تصدير إلى PDF: حفظ أي مستند محمّل إلى PDF باستخدام الخلفية الاختيارية ReportLab

المتطلبات المسبقة

التثبيت

ثبت المكتبة الأساسية من 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]".

الخطوات التالية

• التثبيت: جميع طرق التثبيت، البيئات الافتراضية، اعتماد PDF
• دليل المطور: مرجع API كامل مع أمثلة للنصوص، الصور، الجداول، الوسوم، و PDF
• نظرة عامة على الميزات: قائمة كاملة بالميزات مع عينات الكود
• مقالات قاعدة المعرفة: أدلة إرشادية عملية
• مرجع API: مرجع كامل للفئات والطرق