Aspose.Note FOSS for Python Is Now Available

يسعدنا أن نعلن عن توفر Aspose.Note FOSS for Python على PyPI. هذه المكتبة المجانية ومفتوحة المصدر تتيح لمطوري Python قراءة Microsoft OneNote .one ملفات الأقسام، وتستعرض نموذج كائن المستند الكامل، وتستخرج المحتوى، وتصدّر إلى PDF، دون الحاجة إلى Microsoft Office أو أي بيئة تشغيل مملوكة.

قم بتثبيته الآن:

pip install aspose-note

لـ PDF Export :

pip install aspose-note

ما هو Aspose.Note FOSS لـ Python؟?

Aspose.Note FOSS for Python is a 100% free, MIT-licensed Python library that provides an Aspose.Note-shaped public API (aspose.note.*) لقراءة Microsoft OneNote .one ملفات. تعتمد على محلل ثنائي مدمج خالص-Python MS-ONE/OneStore، دون أي تفاعل COM، ولا DLL أصلي للنظام، ولا حاجة لتثبيت Microsoft Office.

واجهة برمجة التطبيقات مصممة على أساس Aspose.Note for .NET,، مما يجعل الانتقال مألوفًا للفرق التي تستخدم بالفعل منتجات Aspose على منصات أخرى.


الكفاءات الرئيسية

اقرأ أي ملف .one

تحميل ملفات OneNote 2010 و OneNote Online و OneNote 2007 من مسار ملف أو أي تدفق ثنائي:

from aspose.note import Document

doc = Document("MyNotes.one")
print(doc.DisplayName)   # Section name
print(len(list(doc)))       # Number of pages

إرسال رسالة خاصة إلى الوثيقة الكاملة DOM

المكتبة تكشف عن نموذج كائن مستند كامل: Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile. استخدم GetChildNodes(Type) للبحث المتكرر، مع تصفية حسب النوع:

from aspose.note import Document, RichText

doc = Document("MyNotes.one")
all_text = [rt.Text for rt in doc.GetChildNodes(RichText) if rt.Text]

استخراج النص مع غنية التكوين

كل RichText العقدة تحتوي على قائمة من TextRun القطاعات. كل تشغيل يحمل لكل حرف TextStyle البيانات الوصفية: غامق، مائل، تحتي، اسم الخط، لون الخط، عنوان الارتباط التشعبي، وأكثر:

from aspose.note import Document, RichText

doc = Document("MyNotes.one")
for rt in doc.GetChildNodes(RichText):
    for run in rt.TextRuns:
        if run.Style.IsHyperlink:
            print(f"  Link: {run.Text} -> {run.Style.HyperlinkAddress}")
        elif run.Style.IsBold:
            print(f"  Bold: {run.Text}")

حفظ الصور والملحقات

احصل على الصور المدمجة كبايتات خام مع اسم الملفات والأبعاد. حفظ الملفات المرفقة إلى القرص:

from aspose.note import Document, Image, AttachedFile

doc = Document("MyNotes.one")
for img in doc.GetChildNodes(Image):
    with open(img.FileName or "image.bin", "wb") as f:
        f.write(img.Bytes)

for af in doc.GetChildNodes(AttachedFile):
    with open(af.FileName or "attachment.bin", "wb") as f:
        f.write(af.Bytes)

جدول زوايا

تجول Table → TableRow → TableCell التسلسلات الهرمية وقراءة محتوى الخلية:

from aspose.note import Document, Table, TableRow, TableCell, RichText

doc = Document("MyNotes.one")
for table in doc.GetChildNodes(Table):
    for row in table.GetChildNodes(TableRow):
        cells = [
            " ".join(rt.Text for rt in cell.GetChildNodes(RichText))
            for cell in row.GetChildNodes(TableCell)
        ]
        print(cells)

كيفية: تصدير إلى PDF

احفظ أي مستند محمَّل إلى PDF باستخدام الخلفية الاختيارية ReportLab. اضبط نطاق الصفحات وعرض أيقونة الوسم باستخدام PdfSaveOptions:

from aspose.note import Document, SaveFormat

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

أنواع المحتوى المدعومة

المحتوىمدعوم
الصفحات وعناوين الصفحاتنعم
نص عادي (RichText.Text)نعم
تشغيلات منسقة (عريض، مائل، تحته خط، خط، لون)نعم
روابط تشعبية في تشغيلات النصنعم
صور مدمجة (بايتات، اسم الملف، الأبعاد)نعم
ملفات مرفقة (بايتات، اسم الملف)نعم
الجداول (الصفوف، الخلايا، عرض الأعمدة)نعم
علامات OneNote (NoteTag: الشكل، التسمية، اللون)نعم
قوائم مرقمة ونقطية (NumberList)نعم
بيانات تعريف الصفحة (المؤلف، وقت الإنشاء، المستوى)نعم
تصدير PDFنعم (ReportLab مطلوب)
الكتابة مرة أخرى إلى .oneغير مدعوم
مستندات مشفرةغير مدعوم

API المألوف للمطورين .NET

الفرق التي تستخدم بالفعل Aspose. ملاحظة لـ .NET ستجد واجهة برمجة التطبيقات Python معروفة على الفور. الفئات الأساسية مثل Document, Page, RichText, Image, DocumentVisitor, و SaveFormat تطابق ما يعادل .NET من حيث الاسم والسلوك.

للحالات التي تتطلب دعم كتابة كامل، أو التحويل إلى صيغ إضافية، أو معالجة المستندات المشفرة، فإن النسخة التجارية Aspose.Note for .NET و Aspose.Note for Java المنتجات متاحة.


تثبيت ملخص

الأمرالغرض
pip install aspose-noteالمكتبة الأساسية (القراءة، التجوال، الوصول إلى DOM)
pip install "aspose-note[pdf]"الأساسي + تصدير PDF (يضيف ReportLab)
pip install -e ".[pdf]"تثبيت قابل للتحرير من المصدر (المساهمون)

المتطلبات: Python 3.10، 3.11 أو 3.12. لا يلزم Microsoft Office.


البدء