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.