كيفية البدء مع Aspose.Note FOSS لـ Python

aspose-note لـ Python هو مكتبة مجانية ومعتمدة من قبل MIT للقراءة والوصول إلى تحويل Microsoft OneNote .one ملفات PDF - لا مطلوب Microsoft Office ، لا أصلية التمديدات ، Python النقي من PyPI.

خطوة بخطوة دليل

pip install aspose-note>=26.3.2

from aspose.note import Document
print("aspose-note is ready.")

from aspose.note import Document, Page, Outline, RichText, SaveFormat

from aspose.note import Document

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

from aspose.note import Document, Page, RichText

doc = Document("notebook.one")
for page in doc.GetChildNodes(Page):
    if page.Title and page.Title.TitleText:
        print(f"Page: {page.Title.TitleText}")
    for rt in page.GetChildNodes(RichText):
        text = "".join(rt)
        if text.strip():
            print(f"  {text[:120]}")

import io
from aspose.note import Document, SaveFormat

doc = Document("notebook.one")

# Save to a file
doc.Save("output.pdf", SaveFormat.Pdf)

# Save to an in-memory buffer
buf = io.BytesIO()
doc.Save(buf, SaveFormat.Pdf)
print(f"PDF bytes: {len(buf.getvalue())}")

مشكلات و تصحيحات مشتركة

ModuleNotFoundError: No module named 'aspose' لا يتم تثبيت الحزمة في بيئة Python النشطة. pip install aspose-note في نفس البيئة الافتراضية التي تستخدمها لتشغيل السيناريو. pip show aspose-note.

FileNotFoundError عندما يطلب Document("path") المسار الذي مررت به لا يوجد أو يستخدم المنفصل الخاطئ. pathlib.Path إلى بناء المسارات المحمولة:

from pathlib import Path
from aspose.note import Document

doc = Document(str(Path("folder") / "notebook.one"))

GetChildNodes() إرجاع قائمة فارغة تأكد من أنك تدعو GetChildNodes(Page) على أ Document الرماد - لا على A Page العقدة - عندما تتوقع الأطفال على مستوى الصفحة.كل مستوى من الشجرة يعود فقط الخاص به من أصل المحدد.

إصدار PDF هو محتوى فارغ أو مفقود PDF Render يقرأ RichText إذا كان الملف يحتوي فقط على الصور أو المرفقات مع لا RichText في النوافذ، ستكون صفحات PDF فارغة.تحقق من شجرة المستند للتحكم هذا هو RichText النقاط موجودة وتحتوي على النص.

page.Title هو None ليس كل صفحة لها عنوان، ولكن دائماً: if page.Title and page.Title.TitleText: ... قبل الوصول إلى عنوان النص لتجنب AttributeError.

الأسئلة المتكررة

هل تحتاج ملاحظات aspose إلى Microsoft Office؟?

لا. تقرأ المكتبة تنسيق OneNote الثنائي وتصديرها إلى PDF بشكل أصلية في Python النقي دون أي إدمان على Microsoft Office أو COM الأتمتة أو Windows APIs.

ما هي الإصدارات التي تدعمها Python؟?

Python 3.10 أو أحدث.الخزانة تعمل على Windows و macOS و Linux و Docker و وظائف خالية من الخادم.

هل المكتبة مجانية للاستخدام التجاري؟?

نعم يتم إصدارها بموجب ترخيص MIT. يمكنك استخدامها وتعديلها وإعادة توزيعها لأي غرض، بما في ذلك التطبيقات التجارية.

هل يمكنني كتابة ملفات OneNote الجديدة من Scratch؟?

نعم.إنشاء وثيقة باستخدام Document(),إضافة Page النود عبر AppendChildLast(),إلينا attach Outline و RichText الأطفال، وتصديرها إلى PDF مع Document.Save("output.pdf", SaveFormat.Pdf).- توفير المال مرة أخرى إلى .one لا يتم دعم النموذج.

هل يمكنني حفظها في تنسيقات أخرى غير PDF؟?

الإصدار الحالي 26.3.2 يدعم تصدير إلى PDF فقط. .one تنسيق أو تصدير إلى PNG, HTML, أو غيرها من التنسيقات ليست متاحة في هذا الإصدار FOSS.

انظر أيضا

• FAQ — Aspose.Note FOSS لـ Python
• كيفية تصدير ملف OneNote إلى PDF في Python
• كيفية استخراج النص من OneNote في Python
• بدء الدوكتاتوريات
• إشارة API