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. لعائلة منتجات المؤسسة، راجع Aspose.Note — Enterprise Product Family.

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

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

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

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

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

  • PDF export: احفظ أي Document تم تحميله إلى PDF باستخدام Document.Save(path, SaveFormat.Pdf). يستخدم إصدار FOSS عرضًا افتراضيًا؛ خيارات PDF المتقدمة لكل صفحة غير متوفرة في هذا الإصدار.
  • تصدير الصورة: تكرار عقد Image لاسترجاع البايتات الخام (Bytes)، اسم الملف (FileName)، والأبعاد (OriginalWidth، OriginalHeight).
  • حفظ المرفقات: تكرار عقد 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))}")
# Extract all text across the entire document
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")

# Export the document to PDF (requires aspose-note[pdf])
doc.Save("output.pdf", SaveFormat.Pdf)

# Save all embedded images to disk
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. المستندات المشفرة غير مدعومة في الإصدار الحالي.

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

المكتبة مرخصة تحت رخصة MIT ومستضافة على GitHub. تقارير الأخطاء وطلبات السحب مرحب بها.

  

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

 العربية