مقدمة
Aspose.Note FOSS for Python is a free, MIT-licensed library for reading Microsoft OneNote .one يوفر نموذج كامل لنموذجة الوثيقة (DOM) للصفحات، واستخراج النص والصور، وتصنيع اللوحات المقطوعة، وكتابة ملفات النتيجة PDF – كلها دون Microsoft Office أو أي وقت التشغيل الخاص.
تثبيت باستخدام أمر واحد:
pip install aspose-note>=26.3.2
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[pdf]"
ما هو 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 يتم دعمها بواسطة بطاقة MS-ONE / OneStore الخلفية المدمجة ، مع عدم وجود تبادل COM ، لا DLL المنشأ من منصة ، ولا أي تركيب Microsoft Office مطلوب.
يتم تشكيل سطح API بعد Aspose.Note for .NET, جعل الانتقال مألوف للفريقين الذين يستخدمون بالفعل منتجات Aspose على منصات أخرى.
الكفاءات الرئيسية
اقرأ أي ملف .one
تحميل ملفات OneNote 2010 وOneNota Online و OneToo 2007 من مسار الملف أو أي تدفق ثنائي:
from aspose.note import Document
doc = Document("MyNotes.one")
إرسال رسالة خاصة إلى الوثيقة الكاملة 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
# ------ Step 1: Open the document ------
doc = Document("MyNotes.one")
# ------ Step 2: Write the file (PDF format, export-only) ------
output_path = "output.pdf"
doc.Save(output_path, SaveFormat.Pdf)
أنواع المحتوى المدعومة
| متعة | دعم |
|---|---|
| صفحة ورقم الصفحات | نعم |
النص المباشر (RichText.Text) | نعم |
| تشكيلات (بالد، الإيطالية، تحت الخط، الخطوط، اللون) | نعم |
| الارتباطات في النص يحدث | نعم |
| صور مدمجة (بيتات، أسماء الفيل، أبعاد) | نعم |
| ملفات متصلة (مقاطع، اسم الملفات) | نعم |
| اللوحات (السلاسل والخلايا وعرض الأعمدة) | نعم |
OneNote Tags (ملاحظات: Icon, Label, Highlight, CreationTime, CompletedTime) | نعم |
| قائمة الأرقام والرصاص (NumberList) | نعم |
| بيانات الصفحة (المؤلف، وقت الإبداع، المستوى) | نعم |
| PDF تصدير | نعم (مطلوب تقرير) |
اكتب مرة أخرى إلى .one | غير مدعوم |
| وثائق مشفرة | غير مدعوم |
API المألوف للمطورين .NET
سوف تجد الفرق التي تستخدم بالفعل Aspose.Note for .NET API قابلة للتعرف على الفور. Document, Page, RichText, Image, DocumentVisitor,و ، و SaveFormat يتماشى مع ما يعادل .NET في الاسم والسلوك.
بالنسبة للمشاهد التي تتطلب دعم الكتابة الكامل، أو التحويل إلى تنسيقات إضافية، وإلا فإن المعالجة المستندة المشفرة، Aspose.Note for .NET و Aspose.Note for Java المنتجات متاحة.
بدءاً من
ارفع وارتفع في ثلاث خطوات:
- تثبيت:
pip install aspose-note>=26.3.2 - مفتوحة:
doc = Document("notebook.one")- يدعم OneNote 2007 و 2010 وتشمل تنسيقات الإنترنت. - عبرة:
doc.GetChildNodes(RichText)- البحث الترددي المصفى نوعاً - تصدير إلى الملفات:
doc.Save("output.pdf", SaveFormat.Pdf)- إنتاج PDF (صرفاً عن الصادرات); مطلوبpip install "aspose-note[pdf]>=26.3.2"
يظهر المثال التالي الخطوات 2 و 3 (لا حاجة إلى PDF):
from aspose.note import Document, RichText
doc = Document("notebook.one")
texts = [rt.Text for rt in doc.GetChildNodes(RichText) if rt.Text]
print("\n".join(texts[:5]))
بدء سريع
from aspose.note import Document, SaveFormat
# ------ Step A: Open the OneNote file ------
doc = Document("MyNotes.one")
# ------ Step B: Generate PDF (export-only) ------
# Requires: pip install "aspose-note[pdf]>=26.3.2"
output_file = "output.pdf"
doc.Save(output_file, SaveFormat.Pdf)
print("PDF generated successfully.")
تثبيت ملخص
| القيادة | الهدف |
|---|---|
pip install aspose-note | مكتبة أساسية (قراءة، عبرة، الوصول إلى DOM) |
pip install "aspose-note[pdf]" | Core + PDF Export (إضافة إلى ReportLab) |
pip install -e ".[pdf]" | إعدادات من المصدر (المساهمين) |
متطلبات: Python 3.10 أو 3.11 أو 3.2 لا يتطلب Microsoft Office.