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

Aspose.Note FOSS for Python

قراءة، استعراض، وتصدير ملفات Microsoft OneNote (.one) من Python — مجاني ومفتوح المصدر، لا يلزم وجود Microsoft Office.

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

توثيق GitHub

مكتبة بايثون مفتوحة المصدر لملفات OneNote

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

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

المكتبة مناسبة لنصوص التشغيل الآلي للوثائق، وأنابيب فهرس المحتوى، وأدوات الأرشيف، وكل سير عمل على جانب الخادم يحتاج إلى استهلاك محتوى OneNote دون اعتماد Microsoft Office. لمجموعة منتجات المؤسسة، انظر Aspose.Note — Enterprise Product Family.

قراءة وتحويل مستندات OneNote

  • حمل .ملف واحد: افتتح أي قسم من 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:** التحقق من صحة أو معالجة محتوى OneNote داخل حاويات Docker.
  • مخططات قاعدة المعرفة: استخراج المحتوى المهيكّل من دفتر ملاحظات فريق OneNote.

تصدير الصور والملحقات

  • PDF export: احفظ أي Document تم تحميله إلى PDF باستخدام Document.Save(path, SaveFormat.Pdf). يستخدم إصدار FOSS عرضًا افتراضيًا؛ خيارات PDF المتقدمة لكل صفحة غير متوفرة في هذا الإصدار.
  • Image export: كرر عقد Image لاسترجاع البايتات الخام (Bytes)، اسم الملف (FileName)، والأبعاد (OriginalWidth، OriginalHeight).
  • Attachment saving: كرر عقد AttachedFile لحفظ المرفقات المدمجة إلى القرص.
  • Stream-based loading: افتح ملفات .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؟

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

ما هي أنماط OneNote المدعومة؟

يمكن تحميل أي ملف قسم .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) بحيث يمكنك معالجة الملفات دون الكتابة إلى القرص.

ما هي إصدار بايثون المطلوب؟

مطلوب بايثون 3.10 أو أحدث.

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

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

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

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

أين يمكنني أن أجد الشفرة المصدر؟

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

  

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

 العربية