איך להתחיל עם Aspose.Note FOSS עבור Python

aspose-note עבור Python היא ספרייה חינם, MIT רישיון לקריאה ולימודים. מיקרוסופט OneNote .one קבצים ל- PDF – אין דרישה של Microsoft Office, אין מקומיים פיטון טהור, Python של PyPI.

הדרכה שלב אחר צעד

שלב 1: התקנת החבילה

הפעלת פיפ עם PIP:

pip install aspose-note

בדוק את ההתקנה הנכונה:

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

שלב 2: ייבוא שיעורים נדרשים

ייבוא המודולים הדרושים לך כדי להעלות מסמכים, לעבור את העמודים, ולשמור:

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

שלב 3: הורד קובץ OneNote

עבר מסלול קובץ ל Document כדי להעלות כל פורמט תומך ב- OneNote. FileFormat בדקו באיזה סוג של תפריט התגלתה:

from aspose.note import Document

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

שלב 4: מעבר לדפים ולקרוא את הטקסט

שימוש GetChildNodes() כדי להחזיר את כולם Page נוטים, ואז להוריד את RichText פרקים הקלפים כדי לקרוא את התוכן האמיתי של הטקסט:

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]}")

שלב 5: ייצוא ל- PDF

Document.Save() מקבלת SaveFormat.Pdf לכתוב PDF.הייצוא עובד לחלוטין • ללא כל רנדרה חיצונית:

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) על The Document רותם – לא על א Page נוטים - כאשר אתה מצפה לילדים ברמה של דף.כל רמה על העץ רק חוזר משלו צאצאיו של הסוג הנדרש.

תוצאות PDF הן תוכן לבן או חסר PDF Renderer קורא RichText אם הקובץ מכיל רק תמונות או קבצים מקושרים עם לא RichText העמודים, הדפים של PDF יהיו ריקים.בדוק את עץ המסמך כדי לבדוק זה RichText הקבצים קיימים ומכילים טקסט.

page.Title הוא None לא לכל דף יש כותרת, תמיד שומרים: if page.Title and page.Title.TitleText: ... לפני גישה לטקסט הכותרת כדי להימנע AttributeError.

שאלות נפוצות שואלים

האם הערות aspose דורשות Microsoft Office?

הספרייה קוראת את OneNote בפורמט בינארי ומייצרת ל- PDF באופן מקורי בפייטון טהור ללא כל תלות על 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.