1. المنتجات
  2.   Aspose.Note
  3.   Aspose.Note FOSS for Python

Aspose.Note FOSS لـ Python

قراءة، استكشاف، وتصدير ملفات Microsoft OneNote (.one) من Python — مجانية ومفتوحة المصدر، لا يتطلب Microsoft Office.

Aspose.Note FOSS for Python Aspose.Note FOSS
for Python

توثيق GitHub

مكتبة Python مفتوحة المصدر لملفات OneNote

Aspose.Note FOSS لـ Python هي مكتبة مجانية 100٪ مرخصة تحت MIT تتيح لك قراءة ملفات Microsoft OneNote (.one) بالكامل من Python، دون الحاجة إلى Microsoft Office، ولا أتمتة COM، ولا وقت تشغيل مملوك. تُظهر واجهة برمجة تطبيقات عامة نظيفة (aspose.note.*) مستوحاة من Aspose.Note المألوف لـ .NET، وتستند إلى محلل ثنائي مدمج MS-ONE/OneStore مكتوب بلغة Python النقية.

قم بالتثبيت من PyPI باستخدام pip install aspose-note (أو pip install "aspose-note[pdf]" لتمكين تصدير PDF). يتطلب Python 3.10 أو أحدث.

المكتبة مناسبة لسكربتات أتمتة المستندات، خطوط أنابيب فهرسة المحتوى، أدوات الأرشفة، وأي سير عمل على الخادم يحتاج إلى استهلاك محتوى OneNote دون الاعتماد على Microsoft Office.

قراءة واستكشاف مستندات OneNote

  • تحميل ملفات .one: افتح أي قسم من OneNote من مسار ملف أو تدفق ثنائي عبر Document.
  • التنقل الكامل في DOM: انتقل عبر Document → Page → Outline → OutlineElement → RichText / Image / Table / AttachedFile.
  • استخراج النص المنسق: اقرأ النص الخام عبر RichText.Text أو افحص مقاطع TextRun للحصول على الغامق، المائل، الخط، اللون، وبيانات التعريف للروابط.
  • تحليل الجداول: استعرض هياكل Table → TableRow → TableCell مع عرض الأعمدة ورؤية الحدود.
  • فحص العلامات: اقرأ بيانات التعريف NoteTag (الشكل، التسمية، اللون، حالة الإكمال) على عقد النص، الصورة، والجدول.

أين يمكن استخدام Aspose.Note FOSS

  • فهرسة المحتوى: استخراج وفهرسة كل النص من أرشيفات OneNote لخطوط أنابيب البحث.
  • ترحيل المستندات: تحويل أقسام OneNote إلى PDF أو نص عادي أو بيانات منظمة.
  • أدوات الأرشفة: حفظ الصور والمرفقات المدمجة إلى القرص من ملفات .one.
  • سير عمل CI/CD: التحقق من صحة أو معالجة محتوى OneNote داخل حاويات Docker.
  • خطوط أنابيب قاعدة المعرفة: استخراج محتوى منظم من دفاتر ملاحظات OneNote الخاصة بالفريق.

تصدير، صور، ومرفقات

  • تصدير PDF: احفظ أي Document محمَّل إلى PDF باستخدام Document.Save(path, SaveFormat.Pdf).
  • خيارات PDF: خصّص نطاق الصفحات، دليل أيقونات العلامة، حجم الأيقونة، والفجوة عبر PdfSaveOptions.
  • تصدير الصورة: استعرض عقد Image لاسترجاع البايتات الخام، اسم الملف، الأبعاد، ونص alt.
  • حفظ المرفقات: تكرار عقد AttachedFile لحفظ المرفقات المدمجة إلى القرص.
  • التحميل المستند إلى التدفق: فتح ملفات .one من تدفق ثنائي (مثال: io.BytesIO) دون كتابة إلى القرص.

تجربة المطور

Aspose.Note تثبيتات FOSS بأمر واحد pip install aspose-note. الحزمة الأساسية لا تحتوي على تبعيات اختيارية؛ تصدير PDF يتطلب ReportLab، يتم تثبيته عبر pip install "aspose-note[pdf]".

تم نمذجة واجهة برمجة التطبيقات على أساس Aspose.Note المألوف لواجهة .NET: Document، Page، Outline، RichText، Image، Table، AttachedFile. المكتبة مرخصة بموجب رخصة MIT، مفتوحة المصدر، وتقبل تقارير الأخطاء والمساهمات على GitHub.

تحميل ملف OneNote واستخراج كل النص

قم بالتثبيت باستخدام pip، ثم مرّر مسار ملف إلى Document() لتحليل تنسيق OneNote الثنائي. GetChildNodes(RichText) يجري بحثًا عميقًا متكررًا ويعيد كل عقدة نصية في المستند، وهو مفيد لفهرسة النص الكامل أو خطوط أنابيب الترحيل.

pip install aspose-note

from aspose.note import Document, RichText

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

# استخراج كل النص عبر المستند بأكمله
texts = [rt.Text for rt in doc.GetChildNodes(RichText) if rt.Text]
for text in texts:
    print(text)

تصدير إلى PDF وحفظ الصور المرفقة

يتطلب تصدير PDF الاعتماد الاختياري ReportLab. قم بتثبيته باستخدام pip install "aspose-note[pdf]". يمكن أيضًا تكرار كائن Document نفسه للحصول على عقد Image لاستخراج وحفظ جميع الصور المدمجة إلى القرص في عملية واحدة.

from aspose.note import Document, SaveFormat, Image
import pathlib

doc = Document("notebook.one")

# تصدير المستند إلى PDF (يتطلب aspose-note[pdf])
doc.Save("output.pdf", SaveFormat.Pdf)

# حفظ جميع الصور المدمجة إلى القرص
out_dir = pathlib.Path("images")
out_dir.mkdir(exist_ok=True)
for i, img in enumerate(doc.GetChildNodes(Image))
    name = img.FileName or f"image_{i}.bin"
    (out_dir / name).write_bytes(img.Bytes)

الأسئلة الشائعة

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

إنها مكتبة Python مجانية مرخصة بموجب رخصة MIT لقراءة ملفات Microsoft OneNote (.one) دون الحاجة إلى Microsoft Office أو أتمتة COM أو أي بيئة تشغيل مملوكة.

ما هي صيغ OneNote المتنوعة المدعومة؟

OneNote 2010، OneNote Online، وإصدارات تنسيق OneNote 2007. يمكن تحميل أي ملف قسم .one صالح.

كيف أقوم بتثبيته؟

قم بتشغيل pip install aspose-note للحصول على المكتبة الأساسية، أو pip install "aspose-note[pdf]" لتضمين الاعتماد الاختياري ReportLab لتصدير PDF.

هل يمكنني تصدير ملفات OneNote إلى PDF؟

نعم. استدعِ Document.Save(path, SaveFormat.Pdf). يتطلب تصدير PDF الاعتماد الاختياري ReportLab المثبت عبر الإضافة [pdf].

هل يمكنني تحميل ملفات .one من تدفق؟

نعم. تقبل فئة Document تدفقًا ثنائيًا (مثل io.BytesIO أو جسم استجابة HTTP) بحيث يمكنك معالجة الملفات دون الكتابة إلى القرص.

ما هو الإصدار Python المطلوب؟

Python 3.10 أو أحدث مطلوب.

هل يمكنني كتابة أو تعديل ملف .one؟

لا. الإصدار الحالي للقراءة فقط. يمكنه فتح وتحليل أي ملف قسم .one صالح، لكن كتابة البيانات مرة أخرى إلى تنسيق OneNote الثنائي غير مدعومة.

هل يتم دعم مستندات OneNote المشفرة؟

لا. تحميل ملف .one محمي بكلمة مرور يثير استثناء IncorrectPasswordException. المستندات المشفرة غير مدعومة في الإصدار الحالي.

أين يمكنني العثور على الكود المصدري؟

يتم تصنيف المكتبة على GitHub.ملاحظات البغاء والتسجيلات هي مرحبا.

  

الدعم وموارد التعلم

 العربية